Jira MCP Server
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
Перейдите в Токены API Atlassian
Нажмите "Create API token"
Введите метку (например, "Claude Code MCP")
Нажмите "Create"
Скопируйте токен (вы не сможете увидеть его снова)
Шаг 3: Настройка учетных данных
Запустите настройку с вашими учетными данными:
npx @rui.branco/jira-mcp setup "your@email.com" "YOUR_API_TOKEN" "https://company.atlassian.net"Параметр | Описание | Пример |
Email вашей учетной записи Atlassian |
| |
API Token | Токен, созданный на шаге 2 |
|
Base URL | URL вашего экземпляра Jira |
|
Или запустите в интерактивном режиме (система запросит каждое значение):
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:
Установите и настройте figma-mcp
Перезапустите Claude Code
Ссылки Figma будут автоматически загружаться при получении тикета
Справочник API
Инструменты
Инструмент | Описание | Параметры |
| Получить accountId и информацию текущего аутентифицированного пользователя (используйте для назначения тикетов) | нет |
| Получить тикет по ключу с описанием, комментариями, вложениями и дизайнами Figma |
|
| Поиск тикетов с использованием JQL |
|
| Добавить комментарий к тикету (поддерживает @упоминания) |
|
| Ответить на конкретный комментарий с цитатой и упоминанием |
|
| Редактировать существующий комментарий (поддерживает @упоминания) |
|
| Удалить комментарий (необратимо) |
|
| Изменить статус тикета по имени или ID (автоматически обрабатывает промежуточные шаги) |
|
| Обновить поля тикета (сводка, описание, исполнитель, приоритет, метки) |
|
Инструменты Confluence
Этот MCP также предоставляет доступ к Confluence через те же учетные данные Atlassian. В Atlassian Cloud токен API, настроенный вами для Jira, также работает для Confluence, а базовый URL Confluence выводится как <jiraBaseUrl>/wiki — дополнительная настройка не требуется. Просто используйте инструменты confluence_* ниже для любого настроенного экземпляра.
Для развертываний Server / Data Center, где Confluence находится на другом хосте, явно укажите confluenceBaseUrl для сохраненного экземпляра в config.json.
Инструмент | Описание | Параметры |
| Список глобальных пространств ( |
|
| Получить одно пространство с описанием и домашней страницей |
|
| Создать новое глобальное пространство |
|
| Обновить имя и/или описание пространства |
|
| Удалить пространство (асинхронно в Cloud) |
|
| Текстовый поиск CQL ( |
|
| Страницы, измененные за последние N дней |
|
| Страницы верхнего уровня в пространстве с |
|
| Прямые дочерние страницы страницы |
|
| Полная страница с |
|
| Список комментариев на странице |
|
| Добавить комментарий в нижнюю часть (по умолчанию обычный текст преобразуется в storage XHTML) |
|
| Обновить заголовок/тело; автоматически увеличивает версию, если не указана |
|
| Создать страницу с необязательным родителем |
|
| Удалить страницу |
|
| Список меток на странице |
|
| Добавить метку на страницу |
|
| Удалить метку со страницы |
|
| Список вложений на странице |
|
| Загрузить файл с диска или содержимое base64 |
|
| Скачать вложение по имени файла в локальную папку вложений |
|
Почему 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, подождите несколько минут |
| Проверьте токен Figma или права доступа к файлу |
| Установите и настройте figma-mcp |
Безопасность
Токены API хранятся локально в
~/.config/jira-mcp/config.jsonФайлы конфигурации исключаются из git через
.gitignoreТокены никогда не записываются в журналы и не передаются никуда, кроме API Jira/Figma
Вложения загружаются в
~/.config/jira-mcp/attachments/
Лицензия
MIT
См. также
figma-mcp - MCP-сервер Figma для Claude Code
Model Context Protocol - Спецификация MCP
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
Connect your team's living knowledge base — docs, data, issues, CRM — to Claude and ChatGPT.
- platform7nOAuthtech.p7n
Connect Claude to your Platform7n workspaces — chat, links, and tasks. One-click OAuth.
- WhoogyOAuthcom.whoogy
Compare Figma designs against live websites and get visual + content QA reports, from inside Claude.
Related MCP Servers
- AlicenseCqualityDmaintenanceConnects Jira with Claude, enabling users to search issues, view issue details, update issues, add comments, and retrieve project information through natural language commands.154 npm1MIT
- AlicenseNot gradedqualityDmaintenanceEnables 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
- AlicenseNot gradedqualityDmaintenanceConnects 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.15,269 npm77ISC
- FlicenseBqualityDmaintenanceConnects Claude to Jira, allowing users to query tasks, log work, add comments, and execute JQL queries through conversational AI.22-