yandex-tracker-mcp

MCP-сервер для Yandex Tracker API. Позволяет AI-ассистентам (Claude Desktop, Claude Code, Cursor, ChatGPT и др.) искать, читать, создавать и редактировать задачи, а также работать с комментариями, вложениями и связями в Yandex Tracker.

Установка и использование

Важно: Во всех примерах ниже используется --org-id. Выберите правильный флаг в зависимости от типа вашей организации:

• --org-id — если Трекер привязан к организации Яндекс 360 для бизнеса
• --cloud-org-id — если Трекер привязан к организации Yandex Cloud Organization

Необходимо указать ровно один из двух.

Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "yandex-tracker": {
      "command": "npx",
      "args": ["-y", "yandex-tracker-mcp", "--org-id", "YOUR_ORG_ID"]
    }
  }
}

Для организаций Yandex Cloud используйте --cloud-org-id вместо --org-id:

{
  "mcpServers": {
    "yandex-tracker": {
      "command": "npx",
      "args": ["-y", "yandex-tracker-mcp", "--cloud-org-id", "YOUR_CLOUD_ORG_ID"]
    }
  }
}

Claude Code

claude mcp add --scope user yandex-tracker -- npx -y yandex-tracker-mcp --org-id YOUR_ORG_ID

Для организаций Yandex Cloud:

claude mcp add --scope user yandex-tracker -- npx -y yandex-tracker-mcp --cloud-org-id YOUR_CLOUD_ORG_ID

Cursor

Или откройте Cursor Settings → MCP → Add new MCP server, или добавьте в ~/.cursor/mcp.json:

{
  "mcpServers": {
    "yandex-tracker": {
      "command": "npx",
      "args": ["-y", "yandex-tracker-mcp", "--org-id", "YOUR_ORG_ID"]
    }
  }
}

Codex

codex mcp add yandex-tracker -- npx -y yandex-tracker-mcp --org-id YOUR_ORG_ID

Конфигурация

| Параметр | Описание | |----------|----------| | --org-id <value> | Идентификатор организации Яндекс 360 для бизнеса (заголовок X-Org-ID) | | --cloud-org-id <value> | Идентификатор организации Yandex Cloud (заголовок X-Cloud-Org-ID) |

Необходимо указать ровно один из двух. При первом запуске сервер автоматически откроет браузер для авторизации через Yandex OAuth.

Доступные инструменты

| Инструмент | Описание | |------------|----------| | get_issue | Получить задачу по ключу (например QUEUE-123) | | search_issues | Поиск задач на языке запросов Трекера (например Queue: MYQUEUE AND Status: Open) | | create_issue | Создать новую задачу (очередь, название, описание, тип, приоритет, исполнитель и др.) | | update_issue | Изменить существующую задачу (название, описание, приоритет, исполнитель и др.) | | get_transitions | Получить доступные переходы статуса для задачи | | transition_issue | Перевести задачу в другой статус (выполнить переход) | | get_comments | Получить все комментарии к задаче | | get_attachments | Получить метаданные вложений (имя, размер, MIME-тип, id) | | download_attachment | Скачать вложение в base64. Изображения возвращаются как image-блоки | | get_issue_links | Получить все связи задачи | | get_checklist | Получить чеклист задачи | | get_statuses | Получить список всех статусов | | get_issue_types | Получить список типов задач (задача, баг, история и т.д.) | | get_resolutions | Получить список резолюций | | get_priorities | Получить список приоритетов | | get_queues | Получить список очередей | | get_queue_local_fields | Получить локальные (кастомные) поля очереди | | get_global_fields | Получить глобальные (системные) поля | | get_entity | Получить параметры сущности (проект, портфель) по типу и ID |

Лицензия

MIT