jira-mcp: ведите бэклог и спринты Jira прямо из чата с ИИ
← Назад в блог

jira-mcp: ведите бэклог и спринты Jira прямо из чата с ИИ

Опубликовано
4 мин чтения
--- просмотров
jira-mcp — Jira для вашего ИИ-ассистента

Я трачу больше времени, чем хотелось бы, на перевод между ИИ-ассистентом и Jira: он предлагает план, а я иду и вручную вставляю его в тикеты. У модели есть весь контекст; она просто не может тронуть доску. Поэтому я написал jira-mcp: сервер Model Context Protocol на Go, который позволяет Claude, Cursor и любому MCP-клиенту искать issue, работать со спринтами, создавать и редактировать work item — прямо из чата.

Идея простая: Jira для вашего ИИ-ассистента, и ничего нового аутентифицировать не нужно.

Что вы можете делать

  • 🔍 Разговаривайте со своим бэклогом — ищите по полному JQL, просматривайте issue, выводите работу спринта — всё на естественном языке.
  • ✏️ Создавайте и редактируйте, не выходя из чата — открывайте тикеты, редактируйте поля, переводите статусы, назначайте владельцев, оставляйте комментарии.
  • 🏃 Осведомлённость о спринтах — просматривайте спринты, выводите их work item, создавайте новые спринты на доске.
  • 🧰 Ноль дополнительной аутентификации — работает поверх Atlassian CLI (acli), в который вы уже залогинены; настраивать ничего нового не нужно.
  • Один статический бинарник — чистый Go, работает через stdio, встраивается в любой MCP-клиент за секунды.

Четвёртый пункт — это дизайн-решение, которым я доволен больше всего. Вместо того чтобы просить вас сгенерировать API-токен, хранить его и ротировать, сервер опирается на acli — официальный Atlassian CLI. Вы логинитесь один раз с помощью инструмента, который Atlassian уже поставляет; jira-mcp наследует сессию. Никаких секретов в репозитории, никаких в вашем MCP-конфиге.

Набор инструментов

Шестнадцать инструментов покрывают весь цикл — чтение, запись, спринты и навигацию по проектам/доскам:

ИнструментПараметрыОписание
jira_auth_statusПроверяет статус аутентификации acli
jira_searchjql, fields?, limit?Ищет work item по JQL
jira_viewkey, fields?Показывает полные детали work item
jira_createsummary, project, type, description?, assignee?, labels?, parent?Создаёт новый work item
jira_editkey, summary?, description?, assignee?, labels?, type?Редактирует один или несколько work item
jira_transitionkey, statusПереводит work item в новый статус
jira_assignkey, assigneeНазначает work item пользователю
jira_comment_addkey, bodyДобавляет комментарий к work item
jira_comment_listkey, limit?, order?, paginate?, start_date?Выводит комментарии к work item
jira_sprint_viewidПоказывает детали спринта по ID
jira_sprint_list_workitemssprint, board, jql?, limit?, fields?Выводит work item в спринте
jira_sprint_createname, board, start?, end?, goal?Создаёт новый спринт
jira_project_listlimit?, recent?Выводит видимые проекты
jira_project_viewkeyПоказывает детали проекта
jira_board_searchname?, project?, type?, limit?Ищет доски
jira_board_list_sprintsid, state?, limit?Выводит спринты доски

Поскольку jira_search принимает сырой JQL, модель может отвечать на вопросы вроде "что назначено на меня и всё ещё открыто в этом спринте?", самостоятельно составляя запрос, а затем передавать результаты в jira_transition или jira_comment_add, не трогая интерфейс.

Настройка

Предварительные требования

Установите и аутентифицируйте Atlassian CLI:

acli jira auth login

Установка

Сервер — это единый бинарник на Go:

go install github.com/artschekoff/jira-mcp/cmd/jira-mcp@latest
# or
git clone https://github.com/artschekoff/jira-mcp.git && cd jira-mcp && make install

Подключение к вашему MCP-клиенту

Добавьте запись сервера в MCP-конфиг вашего клиента — без env, без токена, потому что acli уже хранит сессию:

{
  "mcpServers": {
    "jira": {
      "command": "jira-mcp"
    }
  }
}

Проверьте, что всё работает:

acli jira auth status

Перезапустите клиент, и ваш ассистент сможет начать работать с доской.

Почему опираться на CLI, а не на REST API

Я мог бы подключиться напрямую к REST API Jira — и унаследовать управление токенами, scope'ы, обновление и намного большую поверхность, которую нужно защищать. Вместо этого сервер опирается на acli, который поддерживает Atlassian и который уже обрабатывает аутентификацию так, как этого ожидает ваша организация (SSO, MFA и всё остальное). Сервер просто переводит вызовы MCP-инструментов в вызовы CLI и разбирает вывод обратно в чистые структурированные данные, над которыми модель может рассуждать.

Это тот же принцип, что и в моих других MCP-серверах — обернуть зрелый, доверенный инструмент, выставить ровно те операции, которые нужны агенту, и держать credentials вне репозитория и вне транскрипта целиком.

Проект открыт на GitHub: github.com/artschekoff/jira-mcp — чистый Go, работает через stdio. Issues и пул-реквесты приветствуются.

Открыт для работы по контракту

Я доступен для работы по контракту. Если у вас есть интересная идея проекта — запишитесь на звонок через Calendly.

Записаться на 30-минутный звонок