@mmtr-tech/jira-mcp

MCP-сервер для Jira Data Center (REST API v2). Даёт ИИ-клиентам (Cursor и др.) искать/читать задачи и выполнять запись под флагом.

English version

Платформа: Jira Data Center. Jira Cloud — позже.
Безопасность: write-tools заблокированы, пока не выставить JIRA_READ_ONLY=false.

Установка / запуск в Cursor

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "@mmtr-tech/jira-mcp"],
      "env": {
        "JIRA_URL": "https://jira.company.com",
        "JIRA_TOKEN": "your-pat",
        "JIRA_READ_ONLY": "true"
      }
    }
  }
}

Для локальной разработки без публикации — абсолютный путь к tsx, см. Локальная разработка.

После смены конфига — Restart Cursor (toggle MCP часто недостаточен).

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

| Переменная | Обязательно | Описание | |------------|-------------|----------| | JIRA_URL | да | URL инстанса без trailing slash | | JIRA_TOKEN | да | Personal Access Token (Bearer) | | JIRA_READ_ONLY | нет | По умолчанию read-only (true / unset). Запись только при false | | JIRA_SSL_VERIFY | нет | По умолчанию true; false для self-signed | | JIRA_TIMEOUT_MS | нет | HTTP timeout в мс (по умолчанию 30000) |

Токены не коммитьте. Лучше env хоста / секрет-хранилище, а не mcp.json в git.

Tools

Read: ping, get_current_user, search_users, list_projects, get_project, search_issues, get_issue, get_create_meta, list_issue_comments, list_transitions, list_assignable_users, list_attachments, list_worklogs, list_issue_links, list_remote_links

Write (нужен JIRA_READ_ONLY=false): create_issue, update_issue, add_comment, transition_issue, assign_issue, link_issues, unlink_issues, add_remote_link

Типовой поток: search_issues (дедуп) → get_create_meta → create_issue (+ fields_json) → link_issues / add_remote_link.
Changelog: get_issue с expand=changelog.
Смена статуса: list_transitions → transition_issue.

Вне скоупа: Agile (boards/sprints), add_worklog, скачивание attachment bytes, Jira Cloud.

Локальная разработка

cp .env.example .env
npm install
npm run test:unit
npm run typecheck
npm run build
npm run dev

Стабильный Cursor-конфиг без npm:

{
  "mcpServers": {
    "jira": {
      "command": "/ABS/PATH/TO/jira/node_modules/.bin/tsx",
      "args": ["/ABS/PATH/TO/jira/src/index.ts"],
      "env": {
        "JIRA_URL": "https://jira.company.com",
        "JIRA_TOKEN": "…",
        "JIRA_READ_ONLY": "true"
      }
    }
  }
}

Skills

Skill jira — в .cursor / .claude / .agents (см. docs/SKILLS.md). Для потребительского проекта (например PRMO) скопируйте в его .cursor/skills.

License

MIT