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

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_search`	`jql`, `fields?`, `limit?`	Ищет work item по JQL
`jira_view`	`key`, `fields?`	Показывает полные детали work item
`jira_create`	`summary`, `project`, `type`, `description?`, `assignee?`, `labels?`, `parent?`	Создаёт новый work item
`jira_edit`	`key`, `summary?`, `description?`, `assignee?`, `labels?`, `type?`	Редактирует один или несколько work item
`jira_transition`	`key`, `status`	Переводит work item в новый статус
`jira_assign`	`key`, `assignee`	Назначает work item пользователю
`jira_comment_add`	`key`, `body`	Добавляет комментарий к work item
`jira_comment_list`	`key`, `limit?`, `order?`, `paginate?`, `start_date?`	Выводит комментарии к work item
`jira_sprint_view`	`id`	Показывает детали спринта по ID
`jira_sprint_list_workitems`	`sprint`, `board`, `jql?`, `limit?`, `fields?`	Выводит work item в спринте
`jira_sprint_create`	`name`, `board`, `start?`, `end?`, `goal?`	Создаёт новый спринт
`jira_project_list`	`limit?`, `recent?`	Выводит видимые проекты
`jira_project_view`	`key`	Показывает детали проекта
`jira_board_search`	`name?`, `project?`, `type?`, `limit?`	Ищет доски
`jira_board_list_sprints`	`id`, `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 и пул-реквесты приветствуются.