tracker-mcp

traker-mcp

MCP-сервер Яндекс Трекера с 187 инструментами и скиллом: задачи, очереди, доски, спринты и автоматизация через API v3, режим только чтения

  • 1 ★ репозитория
  • Последний коммит
MCP-сервер

Широкий доступ

Почему такой уровень

  • Токен открывает рабочие задачи организации: агент создает, правит, переносит и удаляет их, а инструменты миграции пишут задним числом
  • Установка через `curl | bash` выполняет скачанный скрипт, который ставит Node.js и конфиги клиентов
Все причины и проверки
Российский стек

sdamarketing/tracker_mcp

Установка

Ручная установка

npm install -g tracker-mcp && tracker-mcp setup

Мастер спросит ключи и настроит выбранный клиент.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Токен открывает рабочие задачи организации: агент создает, правит, переносит и удаляет их, а инструменты миграции пишут задним числом
  • Установка через `curl | bash` выполняет скачанный скрипт, который ставит Node.js и конфиги клиентов

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер закрывает API Яндекс Трекера v3 почти целиком: 187 инструментов. Агент ищет задачи по фильтрам и языку запросов, создает, редактирует и переносит их, меняет статусы, ведет комментарии, чеклисты и учет времени, скачивает и загружает вложения. Дальше идут очереди с правами и версиями, доски со спринтами, проекты, цели и портфели, триггеры, автодействия и воркфлоу, справочники статусов и приоритетов. Кроме инструментов сервер отдает ресурсы `tracker://issue/{KEY}`, `tracker://queue/{KEY}` и `tracker://board/{ID}` для чтения контекста без вызова инструментов. Готовые промпты `standup`, `weekly-report`, `triage`, `sprint-review`, `close-issue` и `create-issue` в клиентах с поддержкой промптов вызываются как slash-команды. К серверу прилагается скилл `yandex-tracker`: язык запросов Трекера, допустимые значения полей, рецепты вроде «найди мои задачи» и «закрой с резолюцией», а также грабли API, например обязательная резолюция при закрытии. Все инструменты удаления и массовых правок требуют `confirm: true`, а переменная `TRACKER_READ_ONLY=1` оставляет только 80 инструментов чтения.

Для кого. Руководителям проектов и командам, которые ведут задачи в Яндекс Трекере и хотят искать, создавать и закрывать их из чата с агентом без копирования ссылок.

Подходит, если

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

Не подходит, если

  • Команда ведет задачи в Jira или другом трекере: сервер знает только API Яндекс Трекера
  • Нет токена Яндекс 360 или Yandex Cloud и идентификатора организации: без них сервер не стартует
  • Агент слишком усердно правит и удаляет: оставьте `TRACKER_READ_ONLY=1`, если запись не нужна
  • Требуется только пара запросов к задачам: тогда хватит меньшего сервера, 187 инструментов нагружают контекст

Пример запроса к агенту

Найди мои открытые задачи в очереди TREK и закрой TASK-123 с резолюцией «Решен».

MCP

Транспорт
stdio, http
Авторизация
API-ключ

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

TRACKER_TOKEN обязательная, секрет
OAuth-токен Яндекс 360 или IAM-токен Yandex Cloud.
TRACKER_ORG_ID обязательная
Идентификатор организации в Трекере.
TRACKER_READ_ONLY
Значение 1 оставляет только инструменты чтения.
TRACKER_AUTH
oauth по умолчанию или iam для токенов Yandex Cloud.

Ограничения

Нужны две переменные: `TRACKER_TOKEN` с OAuth-токеном Яндекс 360 или IAM-токеном Yandex Cloud и `TRACKER_ORG_ID` с идентификатором организации. IAM-токены живут не дольше 12 часов, для них задают `TRACKER_AUTH=iam`. Для Node.js нужна версия 20 или новее.

Установочный скрипт `install.sh` рассчитан на macOS, Linux и WSL, на чистом Windows ставят вручную. Скрипт запускается через `curl | bash`, поэтому его сначала лучше прочитать, а не выполнять вслепую.

Часть категорий включает администрирование и миграцию задним числом, их стоит держать выключенными, пока они не нужны. Сервер не ограничивает права токена сам: границу задает токен в Трекере.

Как отключить. Удалите сервер из конфигурации клиента. Установленный глобально пакет убирает `npm uninstall -g tracker-mcp`, скилл удаляется из каталога скиллов агента. Токен можно отозвать в настройках Яндекс 360.

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

Как подключить Яндекс Трекер к Claude Code?

Поставьте сервер командой `npm install -g tracker-mcp` и запустите `tracker-mcp setup`: мастер спросит токен и идентификатор организации, проверит их в API и настроит выбранный клиент. Затем скажите агенту, например, «найди мои задачи».

Какие токены принимает сервер?

OAuth-токен Яндекс 360, он начинается с `y0_`, или IAM-токен Yandex Cloud с `t1.`. Для IAM задайте `TRACKER_AUTH=iam`: так сервер подставит заголовок `X-Cloud-Org-ID` вместо `X-Org-ID`.

Как сделать доступ только на чтение?

Задайте `TRACKER_READ_ONLY=1`. Сервер отдаст только 80 инструментов чтения и полностью скроет запись. Дополнительно все `delete_*` и `bulk_*` требуют `confirm: true`.

Какие клиенты поддерживаются?

VS Code с Copilot, Cursor, Claude Desktop, Claude Code, opencode, Windsurf, Zed, JetBrains AI Assistant и Grok CLI. Мастер `tracker-mcp setup` дает выбрать клиента и прописывает конфигурацию с резервной копией.

Можно ли запустить сервер в Docker?

Да. Образ публикуется в GitHub Container Registry: `docker run -i --rm -e TRACKER_TOKEN -e TRACKER_ORG_ID ghcr.io/sdamarketing/tracker-mcp`. Для HTTP-режима добавьте `serve --host 0.0.0.0` и `MCP_AUTH_TOKEN`.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

MCP-сервер Яндекс Трекера: очереди, задачи, комментарии, переходы по статусам, спринты и поиск на языке запросов Трекера

MCP-серверШирокий доступ123Звезды репозитория
Российский стек

MCP-сервер Яндекс Трекера с .mcpb-расширением для Claude Desktop без терминала: задачи, комментарии, переходы статусов и режим только чтения

MCP-серверРасширенный доступ5Звезды репозитория
Российский стек

Полное покрытие API Яндекс Трекера через uvx: 146 инструментов для задач, проектов, портфелей, целей, досок, спринтов и учета времени

MCP-серверШирокий доступ3Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
tracker-mcp (эта карточка)нетAPI-ключ1
Yandex Tracker MCP Serverнетключ необязателен123другой MCP-сервер Трекера с меньшим набором инструментов
Скилл Яндекс Трекера на официальном Python-клиентенет3скилл без собственного сервера

Коротко о README

В README собраны таблицы разделов документации, описание ресурсов и промптов, перечень категорий инструментов, меры безопасности, четыре способа установки и таблица подключения клиентов. Сервер опубликован в реестре MCP как `io.github.sdamarketing/tracker-mcp`, лицензия MIT.

Бейдж для README

Сообщить о проблеме

Foxx AItracker-mcp
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.