Jira MCP

sooperset/mcp-atlassian· Проверено 12.11.2026· 6,1 тыс.на GitHub

Подключает агента к Jira и Confluence: поиск задач по JQL, создание и правка задач, статусы, спринты, страницы и комментарии. Есть удалённый сервер Atlassian с OAuth и локальный mcp-atlassian.

2 реализации:

Локальный сервер на Python: 98 инструментов для Jira и Confluence, работает с Cloud и Server/Data Center.

Как подключить

Что сделать до подключения

uv для запуска через uvx

JIRA_API_TOKEN, CONFLUENCE_API_TOKEN

id.atlassian.com/manage-profile/security/api-tokens → создать токен

JIRA_PERSONAL_TOKEN

для Server/Data Center вместо JIRA_USERNAME и JIRA_API_TOKEN: Personal Access Token

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'JIRA_URL=https://<ваша-компания>.atlassian.net' --env 'JIRA_USERNAME=<email>' --env 'JIRA_API_TOKEN=<API-токен>' --env 'CONFLUENCE_URL=https://<ваша-компания>.atlassian.net/wiki' --env 'CONFLUENCE_USERNAME=<email>' --env 'CONFLUENCE_API_TOKEN=<API-токен>' --transport stdio jira \
  -- uvx mcp-atlassian

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.jira]
command = "uvx"
args = ["mcp-atlassian"]

[mcp_servers.jira.env]
JIRA_URL = "https://<ваша-компания>.atlassian.net"
JIRA_USERNAME = "<email>"
JIRA_API_TOKEN = "<API-токен>"
CONFLUENCE_URL = "https://<ваша-компания>.atlassian.net/wiki"
CONFLUENCE_USERNAME = "<email>"
CONFLUENCE_API_TOKEN = "<API-токен>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "jira": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://<ваша-компания>.atlassian.net",
        "JIRA_USERNAME": "<email>",
        "JIRA_API_TOKEN": "<API-токен>",
        "CONFLUENCE_URL": "https://<ваша-компания>.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "<email>",
        "CONFLUENCE_API_TOKEN": "<API-токен>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "jira": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://<ваша-компания>.atlassian.net",
        "JIRA_USERNAME": "<email>",
        "JIRA_API_TOKEN": "<API-токен>",
        "CONFLUENCE_URL": "https://<ваша-компания>.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "<email>",
        "CONFLUENCE_API_TOKEN": "<API-токен>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "jira": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://<ваша-компания>.atlassian.net",
        "JIRA_USERNAME": "<email>",
        "JIRA_API_TOKEN": "<API-токен>",
        "CONFLUENCE_URL": "https://<ваша-компания>.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "<email>",
        "CONFLUENCE_API_TOKEN": "<API-токен>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "jira": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://<ваша-компания>.atlassian.net",
        "JIRA_USERNAME": "<email>",
        "JIRA_API_TOKEN": "<API-токен>",
        "CONFLUENCE_URL": "https://<ваша-компания>.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "<email>",
        "CONFLUENCE_API_TOKEN": "<API-токен>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "jira": {
        "type": "local",
        "command": ["uvx", "mcp-atlassian"],
        "environment": {
          "JIRA_URL": "https://<ваша-компания>.atlassian.net",
          "JIRA_USERNAME": "<email>",
          "JIRA_API_TOKEN": "<API-токен>",
          "CONFLUENCE_URL": "https://<ваша-компания>.atlassian.net/wiki",
          "CONFLUENCE_USERNAME": "<email>",
          "CONFLUENCE_API_TOKEN": "<API-токен>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "jira": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://<ваша-компания>.atlassian.net",
        "JIRA_USERNAME": "<email>",
        "JIRA_API_TOKEN": "<API-токен>",
        "CONFLUENCE_URL": "https://<ваша-компания>.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "<email>",
        "CONFLUENCE_API_TOKEN": "<API-токен>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "jira": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://<ваша-компания>.atlassian.net",
        "JIRA_USERNAME": "<email>",
        "JIRA_API_TOKEN": "<API-токен>",
        "CONFLUENCE_URL": "https://<ваша-компания>.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "<email>",
        "CONFLUENCE_API_TOKEN": "<API-токен>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

jira_searchищет задачи по JQL

jira_get_issueчитает задачу

jira_create_issueсоздаёт задачу

jira_batch_create_issuesсоздаёт задачи пачкой

jira_update_issueменяет задачу

jira_get_transitionsпоказывает доступные переходы

jira_transition_issueменяет статус

jira_add_commentдобавляет комментарий

jira_add_worklogсписывает время

jira_get_sprints_from_boardпоказывает спринты доски

jira_create_sprintсоздаёт спринт

jira_link_to_epicпривязывает задачу к эпику

jira_get_issue_slaпоказывает SLA задачи

confluence_searchищет в Confluence по CQL

confluence_get_pageчитает страницу

confluence_create_pageсоздаёт страницу

confluence_update_pageправит страницу

confluence_add_commentкомментирует страницу

Показано 18 из 98.

Удалённый сервер Atlassian: вход через OAuth 2.1, кроме Jira и Confluence есть Jira Service Management, Bitbucket, Compass и Loom; только Atlassian Cloud.

Как подключить

Что сделать до подключения

Сайт Atlassian Cloud с Jira, Confluence, Jira Service Management, Bitbucket или Compass

Браузер для входа через OAuth 2.1

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http atlassian-mcp-server https://mcp.atlassian.com/v2/mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.atlassian-mcp-server]
url = "https://mcp.atlassian.com/v2/mcp"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "atlassian-mcp-server": {
      "url": "https://mcp.atlassian.com/v2/mcp"
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "atlassian-mcp-server": {
      "type": "http",
      "url": "https://mcp.atlassian.com/v2/mcp"
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "atlassian-mcp-server": {
      "httpUrl": "https://mcp.atlassian.com/v2/mcp"
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "atlassian-mcp-server": {
      "httpUrl": "https://mcp.atlassian.com/v2/mcp"
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "atlassian-mcp-server": {
        "type": "remote",
        "url": "https://mcp.atlassian.com/v2/mcp"
      }
    }
  }
}

Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://mcp.atlassian.com/v2/mcp

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "atlassian-mcp-server": {
      "url": "https://mcp.atlassian.com/v2/mcp"
    }
  }
}

Что попросить агента

«Найди задачи, назначенные на меня в проекте <ключ проекта>»Агент вызовет jira_search с JQL по исполнителю и проекту и покажет список задач

«Заведи баг про ошибку входа: <описание>»Агент вызовет jira_create_issue с типом Bug и заполнит заголовок и описание

«Сделай пять задач из этих заметок со встречи: <текст>»Агент разобьёт заметки на задачи и создаст их одним вызовом jira_batch_create_issues

«Переведи <ключ задачи> в In Review и напиши, что PR готов»Агент вызовет jira_get_transitions, затем jira_transition_issue и jira_add_comment

«Найди в Confluence документацию по онбордингу и перескажи её»Агент вызовет confluence_search, откроет найденное через confluence_get_page и перескажет

Для каких задач

Найти задачи, назначенные на вас в проекте, или все открытые баги

Завести баг или историю и сразу заполнить поля

Сделать несколько задач из заметок со встречи

Перевести задачу в другой статус и оставить комментарий

Пересказать страницу Confluence или найти документацию

Связать задачи Jira со страницей Confluence

Ограничения

Удалённый сервер Atlassian работает только с Atlassian Cloud; для Jira Server/Data Center подходит mcp-atlassian

Удаление и администрирование Jira в удалённом сервере выключены по умолчанию и включаются администратором организации

Инструменты Jira Service Management в удалённом сервере доступны только по API-токену, и его вход должен разрешить администратор

Агент действует с вашими правами; задачи и страницы могут содержать внедрённые инструкции, поэтому опасные действия подтверждайте вручную

Если не работает

401 Unauthorized при работе с Jira Cloud

Проверьте токен на id.atlassian.com/manage-profile/security/api-tokens и что JIRA_USERNAME совпадает с email, к которому выпущен токен.

Ошибка Field 'customfield_XXXXX' not found при создании задачи

Найдите правильный ID поля инструментом jira_search_fields и проверьте, что поле есть на экране этого типа задачи. ID полей в Cloud и Server/Data Center различаются.

На Jira Server ключ проекта отклоняется с ошибкой String should match pattern

Расширьте шаблоны переменными JIRA_PROJECT_KEY_PATTERN и JIRA_ISSUE_KEY_PATTERN под формат ключей вашего сервера и перезапустите сервер.

Ошибки SSL на сервере с самоподписанным сертификатом

Если сертификата нет в системном хранилище, задайте JIRA_SSL_VERIFY=false и CONFLUENCE_SSL_VERIFY=false.

Удалённый сервер пишет You don't have permission to connect from this IP address

В организации включён список разрешённых IP. Облачные клиенты ходят с адресов своего провайдера, поэтому попросите администратора добавить эти диапазоны.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
MCP Atlassian	sooperset	6,1 тыс.	локально	токен	98	12 ноября 2026
Atlassian MCP Serverразработчик сервиса	Atlassian	1,2 тыс.	HTTP	вход	—	7 ноября 2026

Частые вопросы

Какой вариант выбрать?

Если у вас Atlassian Cloud и клиент умеет OAuth, подключите https://mcp.atlassian.com/v2/mcp: вход в браузере, ключи не нужны. Если Jira стоит на своём сервере или нужен полный контроль над набором инструментов, берите mcp-atlassian.

Как оставить агенту только чтение?

В mcp-atlassian задайте READ_ONLY_MODE=true: останутся только операции чтения. Набор инструментов сужают TOOLSETS и ENABLED_TOOLS.

Как подключить удалённый сервер в Claude Code?

Выполните claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp, затем в сессии запустите /mcp и войдите через браузер.

Можно подключиться к удалённому серверу без браузера?

Да, по API-токену: личный токен в заголовке Authorization: Basic <base64(email:api_token)> или ключ сервисного аккаунта в Authorization: Bearer. Вход по токену сначала должен включить администратор в Atlassian Administration → Rovo → Rovo MCP server → Authentication.

Какие версии Server/Data Center поддерживает mcp-atlassian?

Jira Server/Data Center с версии 8.14 и Confluence с версии 6.0. Cloud-версии поддерживаются полностью.

Работает ли сервер из России?

mcp-atlassian запускается на вашем компьютере и подключается к вашей Jira, в том числе к Server/Data Center; удалённому серверу нужен сайт Atlassian Cloud.

Jira MCP

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы