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 installed
Maintenance
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
- AlicenseCqualityDmaintenanceConnects Jira with Claude, enabling users to search issues, view issue details, update issues, add comments, and retrieve project information through natural language commands.1981MIT
- 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.14,79972ISC
- AlicenseNot gradedqualityAmaintenanceProvides 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
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
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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