Skip to main content
Glama

Jira MCP Server

Сервер Model Context Protocol (MCP), который переносит контекст тикетов Jira непосредственно в Claude Code. Получайте полную информацию о тикетах, включая описания, комментарии, вложения и связанные дизайны Figma, не покидая свою среду разработки.

Обзор

При работе над задачами разработки переключение контекста между Jira и редактором кода нарушает рабочий процесс и тратит время впустую. Этот MCP-сервер решает эту проблему следующим образом:

  • Получение полного контекста тикета — мгновенное получение описаний, комментариев, статуса и метаданных

  • Загрузка вложений — вложения в виде изображений загружаются и отображаются в тексте

  • Автоматическая загрузка дизайнов Figma — связанные URL-адреса Figma автоматически обнаруживаются и экспортируются как изображения

  • Поддержка естественных запросов — поиск тикетов с помощью JQL непосредственно из Claude Code

Related MCP server: JIRA MCP Server

Возможности

Функция

Описание

Полные сведения о тикете

Сводка, описание, статус, приоритет, исполнитель, автор, спринт, родительский тикет

Комментарии

Все комментарии с указанием автора и времени

Вложения

Автоматическая загрузка вложений-изображений (PNG, JPG, GIF, WebP)

Связанные задачи

Просмотр связанных тикетов и их взаимосвязей

Интеграция с Figma

Автоматическое обнаружение и экспорт дизайнов Figma, связанных в тикетах

Поиск JQL

Поиск по вашему экземпляру Jira с помощью мощных запросов

Установка

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

  • Node.js 18+

  • CLI Claude Code

  • Учетная запись Jira Cloud с доступом к API

Шаг 1: Добавление в Claude Code

claude mcp add --transport stdio jira -- npx -y @rui.branco/jira-mcp

Шаг 2: Получение токена API Jira

  1. Перейдите в Токены API Atlassian

  2. Нажмите "Create API token"

  3. Введите метку (например, "Claude Code MCP")

  4. Нажмите "Create"

  5. Скопируйте токен (вы не сможете увидеть его снова)

Шаг 3: Настройка учетных данных

Запустите настройку с вашими учетными данными:

npx @rui.branco/jira-mcp setup "your@email.com" "YOUR_API_TOKEN" "https://company.atlassian.net"

Параметр

Описание

Пример

Email

Email вашей учетной записи Atlassian

john@company.com

API Token

Токен, созданный на шаге 2

ATATT3xFfGF0...

Base URL

URL вашего экземпляра Jira

https://company.atlassian.net

Или запустите в интерактивном режиме (система запросит каждое значение):

npx @rui.branco/jira-mcp setup

Шаг 4: Проверка

Перезапустите Claude Code и выполните /mcp, чтобы убедиться, что сервер подключен.

Альтернатива: Ручная установка

Если вы предпочитаете устанавливать вручную:

git clone https://github.com/rui-branco/jira-mcp.git ~/.config/jira-mcp
cd ~/.config/jira-mcp && npm install
node setup.js

Затем добавьте в Claude Code:

claude mcp add --transport stdio jira -- node $HOME/.config/jira-mcp/index.js

Использование

Получение тикета

> Get ticket PROJ-123

# Returns full ticket with description, comments, attachments, and Figma designs

Поиск тикетов

> Search for my open tickets

# Uses JQL: assignee = currentUser() AND status != Done

Добавление комментариев с упоминаниями

Используйте синтаксис @Имя Фамилия для упоминания пользователей в комментариях:

> Add a comment to PROJ-123: "@John Doe Please review this implementation"

# The mention is automatically resolved and the user gets notified

Пример вывода

# PROJ-123: Implement user authentication

Status: In Progress | Type: Story | Priority: High
Assignee: John Doe | Reporter: Jane Smith

## Description
Implement OAuth2 authentication flow...

## Comments (2)
### Jane Smith - Jan 15, 2025
Please ensure we support Google SSO...

## Attachments (1)
- mockup.png (image/png, 245KB)
  [Image displayed inline]

## Figma Designs (1)
### Auth Flow Design - Login Screen
- Exported 3 image(s):
  - Login Form: ~/.config/figma-mcp/exports/...
  - Error States: ~/.config/figma-mcp/exports/...
  - Success State: ~/.config/figma-mcp/exports/...

Интеграция с Figma

Этот MCP автоматически обнаруживает URL-адреса Figma в описаниях тикетов и комментариях. Когда настроен figma-mcp:

  • Ссылки Figma загружаются автоматически

  • Большие фреймы разбиваются на разделы для лучшей читаемости

  • Изображения экспортируются в масштабе 2x для четкости

  • Все изображения отображаются в тексте в Claude Code

Чтобы включить интеграцию с Figma:

  1. Установите и настройте figma-mcp

  2. Перезапустите Claude Code

  3. Ссылки Figma будут автоматически загружаться при получении тикета

Справочник API

Инструменты

Инструмент

Описание

Параметры

jira_get_myself

Получить accountId и информацию текущего аутентифицированного пользователя (используйте для назначения тикетов)

нет

jira_get_ticket

Получить тикет по ключу с описанием, комментариями, вложениями и дизайнами Figma

issueKey (обязательно), downloadImages, fetchFigma

jira_search

Поиск тикетов с использованием JQL

jql (обязательно), maxResults

jira_add_comment

Добавить комментарий к тикету (поддерживает @упоминания)

issueKey (обязательно), comment (обязательно)

jira_reply_comment

Ответить на конкретный комментарий с цитатой и упоминанием

issueKey (обязательно), commentId (обязательно), reply (обязательно)

jira_edit_comment

Редактировать существующий комментарий (поддерживает @упоминания)

issueKey (обязательно), commentId (обязательно), comment (обязательно)

jira_delete_comment

Удалить комментарий (необратимо)

issueKey (обязательно), commentId (обязательно)

jira_transition

Изменить статус тикета по имени или ID (автоматически обрабатывает промежуточные шаги)

issueKey (обязательно), targetStatus или transitionId

jira_update_ticket

Обновить поля тикета (сводка, описание, исполнитель, приоритет, метки)

issueKey (обязательно), плюс дополнительные параметры полей

Инструменты Confluence

Этот MCP также предоставляет доступ к Confluence через те же учетные данные Atlassian. В Atlassian Cloud токен API, настроенный вами для Jira, также работает для Confluence, а базовый URL Confluence выводится как <jiraBaseUrl>/wikiдополнительная настройка не требуется. Просто используйте инструменты confluence_* ниже для любого настроенного экземпляра.

Для развертываний Server / Data Center, где Confluence находится на другом хосте, явно укажите confluenceBaseUrl для сохраненного экземпляра в config.json.

Инструмент

Описание

Параметры

confluence_get_spaces

Список глобальных пространств (key, name, id)

instance

confluence_get_space

Получить одно пространство с описанием и домашней страницей

spaceKey (обязательно), instance

confluence_create_space

Создать новое глобальное пространство

spaceKey (обязательно), name (обязательно), description, instance

confluence_update_space

Обновить имя и/или описание пространства

spaceKey (обязательно), name, description, instance

confluence_delete_space

Удалить пространство (асинхронно в Cloud)

spaceKey (обязательно), instance

confluence_search

Текстовый поиск CQL (text ~ "<query>" AND type = <type>)

query (обязательно), spaceKey, type, limit, instance

confluence_get_recent_pages

Страницы, измененные за последние N дней

sinceDays (по умолчанию 30), spaceKey, limit, instance

confluence_get_space_root_pages

Страницы верхнего уровня в пространстве с childTypes.page

spaceKey (обязательно), limit, instance

confluence_get_page_children

Прямые дочерние страницы страницы

pageId (обязательно), limit, instance

confluence_get_page

Полная страница с body.view, body.storage и (по умолчанию) объединенным v2 body.atlas_doc_format

pageId (обязательно), includeAdf, instance

confluence_get_comments

Список комментариев на странице

pageId (обязательно), limit, instance

confluence_add_comment

Добавить комментарий в нижнюю часть (по умолчанию обычный текст преобразуется в storage XHTML)

pageId (обязательно), body (обязательно), format (text/storage), instance

confluence_update_page

Обновить заголовок/тело; автоматически увеличивает версию, если не указана

pageId (обязательно), title, body (storage XHTML), version, instance

confluence_create_page

Создать страницу с необязательным родителем

spaceKey, title, body (storage XHTML) (все обязательно), parentId, instance

confluence_delete_page

Удалить страницу

pageId (обязательно), instance

confluence_get_labels

Список меток на странице

pageId (обязательно), instance

confluence_add_label

Добавить метку на страницу

pageId (обязательно), label (обязательно), instance

confluence_remove_label

Удалить метку со страницы

pageId (обязательно), label (обязательно), instance

confluence_list_attachments

Список вложений на странице

pageId (обязательно), limit, instance

confluence_upload_attachment

Загрузить файл с диска или содержимое base64

pageId (обязательно), filePath или fileContent+fileName, comment, instance

confluence_download_attachment

Скачать вложение по имени файла в локальную папку вложений

pageId (обязательно), filename (обязательно), instance

Почему ADF для confluence_get_page? Расширение v1 body.atlas_doc_format ненадежно на современных страницах Cloud — цвета фона ячеек таблицы и некоторые новые типы узлов сохраняются только в конечной точке v2 /api/v2/pages/<id>?body-format=atlas_doc_format. Поэтому confluence_get_page выполняет оба запроса параллельно и объединяет тело v2 ADF с ответом v1, чтобы вызывающие стороны получали body.view, body.storage и body.atlas_doc_format за один раз.

Конфигурация

Конфигурация хранится в ~/.config/jira-mcp/config.json:

{
  "email": "your@email.com",
  "token": "YOUR_API_TOKEN",
  "baseUrl": "https://company.atlassian.net"
}

Обработка ошибок

Сервер предоставляет понятные сообщения об ошибках:

Ошибка

Значение

Figma API rate limit exceeded

Слишком много запросов к Figma, подождите несколько минут

Figma access denied

Проверьте токен Figma или права доступа к файлу

Figma not configured

Установите и настройте figma-mcp

Безопасность

  • Токены API хранятся локально в ~/.config/jira-mcp/config.json

  • Файлы конфигурации исключаются из git через .gitignore

  • Токены никогда не записываются в журналы и не передаются никуда, кроме API Jira/Figma

  • Вложения загружаются в ~/.config/jira-mcp/attachments/

Лицензия

MIT

См. также

A
license - permissive license
Not graded
quality - not tested
A
maintenance

Maintenance

Maintainers
Response time
7moRelease cycle
2Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    C
    quality
    D
    maintenance
    Connects Jira with Claude, enabling users to search issues, view issue details, update issues, add comments, and retrieve project information through natural language commands.
    1
    98
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables Claude AI to interact with JIRA for project management and issue tracking, supporting JQL queries, comprehensive issue details retrieval with subtasks and linked issues, and release planning analysis.
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Connects AI assistants like Claude to Jira projects, enabling natural language queries and operations for issue management, project tracking, comments, and workflows through the Jira REST API.
    14,799
    72
    ISC
  • A
    license
    Not graded
    quality
    A
    maintenance
    Provides Jira Cloud integration for AI agents, enabling them to search issues with JQL, retrieve detailed issue information, and create new tickets. It supports multiple Jira configurations and provides tools for managing attachments and comments through natural language.
    MIT

View all related MCP servers

Related MCP Connectors

  • Connect to Atlassian Jira, Confluence, and Compass to search, create, and manage your work.

  • Connect your team's living knowledge base — docs, data, issues, CRM — to Claude and ChatGPT.

  • Connect Claude to Fathom meeting recordings, transcripts, and summaries

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/rui-branco/jira-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server