jira-mcp

MCP-сервер для работы с Jira из Claude Code, Cline и других MCP-клиентов.

Быстрый старт

Через npx (без установки)

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "@rokealvo/jira-mcp"],
      "env": {
        "JIRA_BASE_URL": "https://your-domain.atlassian.net",
        "JIRA_USER_EMAIL": "[email protected]",
        "JIRA_API_TOKEN": "your_token"
      }
    }
  }
}

Из исходников

git clone https://github.com/cosmix/jira-mcp.git
cd jira-mcp
npm install && npm run build

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/jira-mcp/build/index.js"],
      "env": {
        "JIRA_BASE_URL": "https://your-domain.atlassian.net",
        "JIRA_USER_EMAIL": "[email protected]",
        "JIRA_API_TOKEN": "your_token"
      }
    }
  }
}

Переменные окружения

| Переменная | Описание | По умолчанию | |------------|----------|--------------| | JIRA_BASE_URL | URL вашего Jira | — | | JIRA_USER_EMAIL | Email пользователя | — | | JIRA_API_TOKEN | API токен или PAT | — | | JIRA_TYPE | cloud или server | cloud | | JIRA_AUTH_TYPE | basic или bearer | basic |

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

Jira Cloud:

• Создать API токен
• Использовать JIRA_AUTH_TYPE=basic

Jira Server/Data Center:

• Basic auth: логин/пароль или токен
• Bearer auth (DC 8.14+): Personal Access Token в настройках профиля, JIRA_AUTH_TYPE=bearer

Инструменты

| Инструмент | Описание | |------------|----------| | search_issues | Поиск задач по JQL | | get_issue | Детали задачи с комментариями | | create_issue | Создание задачи | | update_issue | Обновление полей задачи | | add_comment | Добавление комментария | | get_transitions | Доступные переходы статуса | | transition_issue | Смена статуса задачи | | get_epic_children | Задачи в эпике | | add_attachment | Прикрепление файла | | get_create_meta | Схема полей для создания задачи | | get_field_options | Варианты значений поля | | get_projects | Список проектов | | get_users | Поиск пользователей | | get_server_info | Информация о сервере | | delete_issue | Удаление задачи |

Разработка

npm install      # установка зависимостей
npm run build    # сборка
npm test         # тесты
npm run test:watch  # тесты в watch-режиме

Требования

• Node.js 18+

Лицензия

MIT