MCP-сервер для Jira: задачи и комментарии прямо из агента

Задачи в Jira обычно живут отдельно от кода: открыть вкладку, найти тикет, скопировать описание, написать комментарий. MCP-сервер для Jira убирает эту беготню: агент сам читает задачу, ищет по JQL, пишет комментарии и двигает статусы. Ниже — как подключить официальный сервер Atlassian к Claude Code, какие действия ему доступны, как ограничить права и сколько токенов это съедает. Подключение описано по документации Atlassian на октябрь 2026; они обновляют сервер, поэтому адреса и названия пунктов сверяйте с ней.

MCP сервер для Jira: какой выбрать

MCP (Model Context Protocol) — стандартный способ дать агенту набор инструментов. Для Jira есть два варианта:

• Официальный удалённый сервер Atlassian. Адрес https://mcp.atlassian.com/v2/mcp, авторизация через OAuth 2.1 с учётом ваших существующих прав в Jira. Документация Atlassian называет текущую версию v2; сервер работает не только с Jira, но и с Confluence, Bitbucket и другими продуктами.
• Серверы сообщества. Обычно запускаются локально и ходят в Jira по API-токену. Набор инструментов и безопасность у каждого свои, поэтому до подключения изучите документацию конкретного проекта и исходный код.

Дальше в статье — официальный сервер, потому что его документация открыта и права привязаны к вашей учётной записи.

Подключение к Claude Code

Claude Code умеет подключать удалённые MCP-серверы одной командой. Для Atlassian документация предлагает:

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

Затем откройте сессию claude и выполните /mcp: Claude Code запустит вход через браузер. После согласия на доступ сервер перейдёт в статус подключённого. Проверить состояние можно командами claude mcp list и claude mcp get atlassian.

Где хранится конфигурация, зависит от области (scope). По документации Claude Code, по умолчанию сервер добавляется в локальную область: он виден только вам и только в текущем проекте. Опция --scope user делает его доступным во всех ваших проектах, а --scope project пишет настройку в файл .mcp.json в корне репозитория, чтобы её увидела вся команда. Для Jira обычно хватает варианта по умолчанию или user: общий файл в репозитории удобен, только если в нём нет секретов.

Сам Claude Code работает через шлюз

MCP-сервер Atlassian — это инструменты. Какая модель ими управляет, определяется настройкой самого Claude Code. Если вы подключили его к Zukko, переменные те же, что в обычной инструкции:

export ANTHROPIC_BASE_URL=https://api.zukko.pro
export ANTHROPIC_AUTH_TOKEN=fetch_ваш_ключ
export ANTHROPIC_MODEL=claude-sonnet-5-5

Здесь адрес без /v1, а токен идёт именно в ANTHROPIC_AUTH_TOKEN. Полная настройка описана в инструкции по Claude Code↗. Данные из Jira попадут в запросы к модели, поэтому убедитесь, что политика вашей компании это допускает.

Что умеет сервер: задачи, комментарии, JQL

В справочнике инструментов Atlassian инструменты Jira разбиты на группы разрешений. Названия приведены из этого справочника:

Администратор организации выдаёт и отзывает доступ на уровне группы, каждый инструмент наследует права своей группы. Первым вызовом агент обычно получает список доступных вам сайтов Atlassian, поскольку каждому вызову нужен идентификатор сайта (cloudId).

Типичные запросы к агенту:

Найди мои задачи в статусе In Progress в проекте PAY, обновлённые за последнюю неделю,
и скажи, какие из них без комментариев больше трёх дней.

Агент превратит это в запрос на JQL примерно такого вида:

project = PAY AND status = "In Progress" AND assignee = currentUser() AND updated >= -7d ORDER BY updated DESC

Второй типичный сценарий: «Прочитай PAY-412, посмотри ветку в репозитории и добавь комментарий, что исправление готово к ревью». Агент прочитает задачу, найдёт нужный коммит и оставит текст комментария.

Для бизнеса из этого складываются конкретные сценарии ИИ-агента: утренняя сводка по спринту, разбор новых багов по приоритету, подготовка статуса для руководителя, создание задач из заметок со встречи. Запись в Jira везде лучше оставлять под вашим подтверждением.

Права доступа и безопасный токен

OAuth 2.1 работает от вашего имени, и всё, что может агент, можете и вы. Поэтому правила простые:

1. Минимум прав. Если агенту нужно только читать, не давайте записи. Atlassian в предупреждении к своему серверу советует принцип наименьших привилегий, проверку важных изменений до подтверждения и мониторинг журналов аудита.
2. Правила в Claude Code. Разрешите безопасное без вопросов, а опасное запретите. Имена инструментов MCP строятся как mcp__<сервер>__<инструмент>:

{
  "permissions": {
    "allow": [
      "mcp__atlassian__getJiraIssue",
      "mcp__atlassian__searchJiraIssuesUsingJql"
    ],
    "deny": [
      "mcp__atlassian__executeDestructive"
    ]
  }
}

Остальные вызовы Claude Code по умолчанию будет подтверждать у вас. Реальные имена инструментов посмотрите командой /mcp в своей сессии: Atlassian показывает агенту короткий список основных инструментов и открывает остальные через поиск и «выполнение», поэтому набор может выглядеть иначе.

1. API-токен вместо OAuth только по необходимости. Atlassian допускает вход без интерактивного окна через персональный API-токен (Basic-авторизация из пары «почта:токен» в кодировке base64) или ключ сервисного аккаунта (Bearer), если это включил администратор. Набор инструментов в таком режиме может быть меньше. Токен передают заголовком:

claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp \
  --header "Authorization: Bearer $ATLASSIAN_SERVICE_KEY"

Выпускайте для этого отдельный сервисный аккаунт с ограниченными правами, не используйте свой токен и не коммитьте заголовок в .mcp.json. В этом файле Claude Code поддерживает подстановку переменных окружения вида ${VAR}, так что секрет можно держать вне репозитория. Те же правила, что и для ключа шлюза, разобраны в статье о безопасности API-ключей↗.

1. Недоверенный текст. Описания и комментарии в Jira может писать кто угодно, в том числе с инструкциями, адресованными агенту. Не включайте автоподтверждение записи, пока агент читает тикеты, которые писали посторонние.

Сколько это стоит

Токены тратит модель, а не Jira. Расчёт для примера: разбор 30 задач по 1 500 токенов каждая даёт 45 000 токенов входа и около 3 000 токенов выхода. На claude-sonnet-5-5 (вход 0.4, выход 2, $ за 1M токенов, на 18 октября 2026): 0.045 × 0.4 + 0.003 × 2 = 0.018 + 0.006 = $0.024.

Но агент работает циклами, и накопленный контекст отправляется заново на каждом шаге. Допустим, 10 шагов по 30 000 токенов контекста: 0.3 × 0.4 = $0.12, если весь вход считается как свежий. Claude Code ходит в Anthropic-формате, где виден кэш, а чтение кэша для claude-sonnet-5-5 стоит 0.05: если большая часть контекста читается из кэша, вход обойдётся примерно в 0.3 × 0.05 = $0.015 плюс запись новой части. Цифры условные, реальный расход смотрите в кабинете. Отдельно, по документации Atlassian, вызовы через MCP расходуют кредиты Rovo из общего пула организации: условия и пороги смотрите в справке Atlassian.

Чтобы попробовать, создайте ключ в кабинете↗, подключите Claude Code и добавьте сервер командой выше. Подробнее о самом протоколе — в статьях «Что такое MCP-сервер»↗ и про MCP-серверы в Claude Code↗.

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

Нужен ли отдельный платный продукт Atlassian для MCP?

Условия доступа и лимиты зависят от вашего тарифа Atlassian и настроек администратора: смотрите справку Atlassian и спросите администратора вашего сайта. Здесь мы цены на их продукты не приводим.

Почему сервер просит администратора?

Доступ выдаётся по группам разрешений, и часть групп (например, удаление) по умолчанию выключена. Без согласия администратора соответствующие инструменты недоступны.

Можно ли подключить Jira к агенту без Claude Code?

Да. В документации Atlassian перечислены другие клиенты с поддержкой MCP: редакторы, чат-клиенты, консольные агенты. Адрес сервера одинаковый, способ добавления зависит от клиента.

Агент написал комментарий не туда. Как откатить?

Комментарий можно отредактировать или удалить вручную в Jira. Поэтому запись лучше оставлять с подтверждением, а удаление не выдавать агенту вовсе.