Сервер Jira MCP
Общайтесь с Jira на естественном языке, чтобы получать информацию и изменять свой проект. Используйте его с Claude Desktop в сочетании с пользовательским README, который вы создадите с информацией о проекте, чтобы вы могли делегировать задачи PM (например, если у вас есть список моей команды и их специализаций, назначайте любую новую задачу наиболее подходящему человеку).
Создано с использованием протокола контекста модели .
Сервер позволяет:
Создание и настройка проекта
Управление проблемами и подзадачами
Связывание проблем и зависимости
Автоматизированные рабочие процессы по решению проблем
Конфигурация
Необходимые переменные среды:
JIRA_HOST: имя хоста вашего экземпляра JiraJIRA_EMAIL: Электронная почта вашего аккаунта JiraJIRA_API_TOKEN: токен API из https://id.atlassian.com/manage-profile/security/api-tokens
Related MCP server: JIRA MCP Tools
Доступные инструменты
1. Управление пользователями
// Get user's account ID by email
{
email: "user@example.com";
}2. Управление типами проблем
// List all available issue types
// Returns: id, name, description, subtask status
// No parameters required3. Типы ссылок на проблемы
// List all available issue link types
// Returns: id, name, inward/outward descriptions
// No parameters required4. Управление проблемами
Получение проблем
// Get all issues in a project
{
projectKey: "PROJECT"
}
// Get issues with JQL filtering
{
projectKey: "PROJECT",
jql: "status = 'In Progress' AND assignee = currentUser()"
}
// Get issues assigned to user
{
projectKey: "PROJECT",
jql: "assignee = 'user@example.com' ORDER BY created DESC"
}Создание проблем
// Create a standard issue
{
projectKey: "PROJECT",
summary: "Issue title",
issueType: "Task", // or "Story", "Bug", etc.
description: "Detailed description",
assignee: "accountId", // from get_user tool
labels: ["frontend", "urgent"],
components: ["ui", "api"],
priority: "High"
}
// Create a subtask
{
parent: "PROJECT-123",
projectKey: "PROJECT",
summary: "Subtask title",
issueType: "Subtask",
description: "Subtask details",
assignee: "accountId"
}Проблемы с обновлением
// Update issue fields
{
issueKey: "PROJECT-123",
summary: "Updated title",
description: "New description",
assignee: "accountId",
status: "In Progress",
priority: "High"
}Зависимости проблемы
// Create issue link
{
linkType: "Blocks", // from list_link_types
inwardIssueKey: "PROJECT-124", // blocked issue
outwardIssueKey: "PROJECT-123" // blocking issue
}Удаление проблем
// Delete single issue
{
issueKey: "PROJECT-123"
}
// Delete issue with subtasks
{
issueKey: "PROJECT-123",
deleteSubtasks: true
}
// Delete multiple issues
{
issueKeys: ["PROJECT-123", "PROJECT-124"]
}Форматирование поля
Описание Поле
Поле описания поддерживает форматирование в стиле markdown:
Используйте пустые строки между абзацами.
Используйте «-» для маркеров.
Используйте «1.» для нумерованных списков.
Используйте заголовки, заканчивающиеся на «:» (с последующей пустой строкой)
Пример:
Task Overview:
This task involves implementing new features:
- Feature A implementation
- Feature B testing
Steps:
1. Design component
2. Implement logic
3. Add tests
Acceptance Criteria:
- All tests passing
- Documentation updatedОбработка ошибок
Сервер предоставляет подробные сообщения об ошибках для:
Недействительные ключи выпуска
Отсутствуют обязательные поля
Проблемы с разрешениями
Ограничения скорости API
Инструкции по установке
Клонируйте репозиторий:
git clone https://github.com/George5562/Jira-MCP-Server.git cd Jira-MCP-ServerУстановите зависимости:
npm installНастройте переменные среды: Создайте файл
.envв корневом каталоге:JIRA_HOST=your-instance.atlassian.net JIRA_EMAIL=your-email@example.com JIRA_API_TOKEN=your-api-tokenСоздайте проект:
npm run buildЗапустите сервер:
npm start
Настройка рабочего стола Claude
Чтобы использовать этот MCP-сервер с Claude Desktop:
Найдите файл конфигурации Claude Desktop:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%/Claude/claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json
Добавьте сервер Jira MCP в свою конфигурацию:
{ "mcpServers": { "jira-server": { "name": "jira-server", "command": "/path/to/node", "args": ["/path/to/jira-server/build/index.js"], "cwd": "/path/to/jira-server", "env": { "JIRA_HOST": "your-jira-instance.atlassian.net", "JIRA_EMAIL": "your-email@example.com", "JIRA_API_TOKEN": "your-api-token" } } } }Замените
/path/to/jira-serverна абсолютный путь к вашему клонированному репозиторию. Замените/path/to/nodeна абсолютный путь к исполняемому файлу Node.js (обычно его можно найти, запустивwhich nodeилиwhere nodeв терминале). Для надежности рекомендуется использовать прямой путь к исполняемому файлу Node.js и собранному файлу JavaScript (build/index.jsпосле запускаnpm run build).Перезапустите Claude Desktop, чтобы изменения вступили в силу.
Настройка курсора
Чтобы использовать этот сервер Jira MCP с Cursor:
Убедитесь, что сервер собран: запустите
npm run buildв каталогеJira-MCP-Serverчтобы создать необходимый файлbuild/index.js.Найдите или создайте файл конфигурации MCP курсора:
Для конфигурации, специфичной для проекта:
.cursor/mcp.jsonв корневом каталоге вашего проекта.Для глобальной конфигурации (все проекты):
~/.cursor/mcp.jsonв вашем домашнем каталоге.
Добавьте конфигурацию сервера Jira MCP в
{ "mcpServers": { "jira-mcp-server": { "command": "node", // Or provide the absolute path to your Node.js executable "args": [ "/path/to/your/Jira-MCP-Server/build/index.js" // Absolute path to the server's built index.js ], "cwd": "/path/to/your/Jira-MCP-Server", // Absolute path to the Jira-MCP-Server directory "env": { "JIRA_HOST": "your-jira-instance.atlassian.net", "JIRA_EMAIL": "your-email@example.com", // Your Jira email "JIRA_API_TOKEN": "your-api-token" // Your Jira API token } } // You can add other MCP server configurations here } }Замените
/path/to/your/Jira-MCP-Serverна правильный абсолютный путь к месту, куда вы клонировали репозиторийJira-MCP-Server.Если
nodeотсутствует в системной переменной PATH или вы предпочитаете абсолютный путь, замените"node"на полный путь к исполняемому файлу Node.js (например,/usr/local/bin/nodeилиC:\Program Files\nodejs\node.exe).Убедитесь, что данные вашего экземпляра Jira и токен API правильно заполнены в разделе
env.
Перезапустите курсор , чтобы изменения вступили в силу.
Использование правил курсора для контекста Jira
Чтобы сделать взаимодействие с Jira более плавным, вы можете определить свой проект Jira по умолчанию и идентификатор пользователя в правилах Cursor. Это помогает ИИ Cursor понимать ваш контекст без необходимости указывать его в каждом запросе.
Создайте или отредактируйте файл правил курсора (например, в вашем проекте .cursor/rules.json или глобальном ~/.cursor/rules.json (точный файл и метод для правил могут отличаться, см. документацию по курсору в разделе «Правила» или «Управление контекстом»). Добавьте записи, например:
As an AI assistant, when I am asked about Jira tasks:
- Assume the primary Jira project key is 'YOUR_PROJECT_KEY_HERE'.
- Assume 'my assigned tasks' or tasks assigned to 'me' refer to the Jira user with the email 'your_jira_email@example.com' (or your Jira Account ID).
You can then use these in your JQL queries, for example: project = YOUR_PROJECT_KEY_HERE AND assignee = 'your_jira_email@example.com'.Замените YOUR_PROJECT_KEY_HERE и your_jira_email@example.com на свои фактические данные.
Пример использования в курсорном чате
После настройки (особенно с использованием правил курсора для контекста) вы можете задать курсору:
"Using Jira MCP, list my assigned tasks. Then, based on these tasks, come up with an implementation plan and work schedule."
Если вы не установили правила или вам нужно указать другой проект или пользователя, вы можете сделать это более явно:
"Using Jira MCP, list tasks assigned to 'user@example.com' in project 'PROJECT_KEY'. Then, based on these tasks, come up with an implementation plan and work schedule."
Искусственный интеллект Cursor будет использовать сервер Jira MCP для извлечения задач, а затем приступит к выполнению запроса на планирование и составление графика.
Установка через Smithery
Чтобы автоматически установить Jira MCP Server для Claude Desktop через Smithery :
npx -y @smithery/cli install @George5562/Jira-MCP-Server --client claudeРучная установка
Клонируйте репозиторий:
git clone https://github.com/George5562/Jira-MCP-Server.git cd Jira-MCP-ServerУстановите зависимости:
npm installНастройте переменные среды: Создайте файл
.envв корневом каталоге:JIRA_HOST=your-instance.atlassian.net JIRA_EMAIL=your-email@example.com JIRA_API_TOKEN=your-api-tokenСоздайте проект:
npm run buildЗапустите сервер:
npm start
Ссылки
This server cannot be installed
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.