Яндекс Трекер MCP

aikts/yandex-tracker-mcp· Проверено 12.11.2026· 123на GitHub

Даёт агенту задачи, очереди, комментарии, учёт времени, доски и спринты Яндекс Трекера. Агент ищет задачи языком запросов Трекера, создаёт и двигает их по статусам.

Как подключить

Что сделать до подключения

1

uv, установленный глобально

2

Токен Яндекс Трекера с нужными правами

3
TRACKER_TOKEN

OAuth-токен Яндекс Трекера; вместо него подходит IAM-токен в TRACKER_IAM_TOKEN или ключи сервисного аккаунта

4
TRACKER_CLOUD_ORG_ID

ID организации Yandex Cloud; для организации Яндекс 360 задайте TRACKER_ORG_ID. ID виден в адресе Трекера или в настройках организации

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'TRACKER_TOKEN=<OAuth-токен Трекера>' --env 'TRACKER_CLOUD_ORG_ID=<ID организации>' --transport stdio yandex-tracker \
  -- uvx yandex-tracker-mcp@latest

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Инструменты сервера

issues_findищет задачи языком запросов
issues_countсчитает задачи по запросу
issue_getчитает задачу целиком
issue_createсоздаёт задачу
issue_updateменяет поля задачи
issue_get_transitionsпоказывает доступные переходы
issue_execute_transitionпереводит задачу в статус
issue_closeзакрывает задачу с резолюцией
issue_moveпереносит задачу в другую очередь
issue_get_commentsчитает комментарии
issue_add_commentдобавляет комментарий
issue_add_worklogзаписывает затраченное время
issue_get_worklogsпоказывает учёт времени
issue_get_changelogпоказывает историю изменений
issue_add_linkсвязывает две задачи
issue_add_checklist_itemsдобавляет пункты в список дел
queues_get_allперечисляет очереди
queue_get_fieldsпоказывает поля очереди
board_get_sprintsпоказывает спринты доски
users_searchищет пользователя

Показано 20 из 101.

Что попросить агента

«Сколько открытых багов в очереди <ключ очереди>, назначенных на меня?»Агент вызовет issues_count с запросом на языке Трекера, без выгрузки самих задач
«Заведи в очереди <ключ очереди> задачу «<название>» с компонентом <компонент>»Агент посмотрит поля очереди через queue_get_fields и вызовет issue_create
«Переведи <ключ задачи> в «В работе», а когда закончу — закрой с резолюцией «Решён»»Агент вызовет issue_get_transitions и issue_execute_transition, затем issue_close
«Спиши 2 часа на <ключ задачи> и напиши в комментарии, что нужна проверка от <коллега>»Агент найдёт коллегу через users_search, вызовет issue_add_worklog и issue_add_comment
«Кто и когда менял статус и поля <ключ задачи>?»Агент вызовет issue_get_changelog: правки полей, переходы, комментарии и сработавшие триггеры

Для каких задач

Найти задачи по сложному фильтру и посчитать их без выгрузки
Завести задачу с нужными полями, компонентами и спринтом
Перевести задачу по статусам и закрыть с резолюцией
Списать время и оставить комментарий с призывом коллеги
Разобрать историю изменений задачи и связанные задачи

Ограничения

!

Ограничение по очередям работает внутри сервера; если у клиента сам токен Трекера, права нужно резать на токене

!

Инструменты проектов, портфелей и целей включаются отдельно и не подчиняются ограничениям по очередям

!

Вход через OAuth требует публичного адреса сервера для обратного вызова, и поддерживают его не все клиенты

!

Создать задачу или комментарий из шаблона нельзя: шаблоны только читаются

Если не работает

Все вызовы падают с ошибкой Only one of org_id or cloud_org_id should be provided
Заданы обе переменные организации. Оставьте одну: TRACKER_CLOUD_ORG_ID для организации Yandex Cloud или TRACKER_ORG_ID для Яндекс 360.
issue_update падает с конфликтом редактирования
Триггеры очереди меняют version сразу после создания задачи. Перечитайте задачу через issue_get прямо перед правкой или не передавайте version.

Частые вопросы

Как запретить агенту менять задачи?
Задайте TRACKER_READ_ONLY=true, и все пишущие инструменты отключатся. Чтобы оставить только нужные очереди, перечислите их в TRACKER_LIMIT_QUEUES, а очереди только для чтения — в TRACKER_READ_ONLY_QUEUES.
Что указывать: TRACKER_ORG_ID или TRACKER_CLOUD_ORG_ID?
Для организации Yandex Cloud — TRACKER_CLOUD_ORG_ID, для Яндекс 360 — TRACKER_ORG_ID. Задавайте только одну переменную: с обеими любой вызов Трекера падает с ошибкой.
Можно поставить в Claude Desktop без настройки файлов?
Да. Скачайте файл .mcpb со страницы GitHub Releases, откройте его двойным щелчком и введите OAuth-токен Трекера.
Как включить проекты, портфели и цели?
Добавьте TRACKER_ENTITIES_ENABLED=true. По умолчанию эти инструменты выключены: они раздувают список инструментов и дают доступ ко всем проектам организации.
Работает ли сервер из России?
Сервер запускается на вашем компьютере и обращается к API Трекера напрямую; зарубежные аккаунты не нужны.

Похожие серверы