Яндекс Трекер MCP: типизированные и сырые инструменты v3
yandex-tracker-mcp
MCP-сервер Трекера на fastmcp с гибридным интерфейсом: типизированные инструменты плюс универсальный вызов API v3
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Типизированные и сырые инструменты создают и меняют задачи, очереди и другие сущности Трекера
- tracker_raw_request открывает доступ к любому методу API v3 в пределах домена v3
Установка
Ручная установка
uv pip install yandex-tracker-mcpУстанавливает пакет и консольные команды tracker-mcp-stdio, tracker-mcp-http.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер построен на fastmcp и httpx поверх API Yandex Tracker v3. Типизированные инструменты называются по схеме tracker_<домен>_<действие>, например tracker_issue_get или tracker_queue_get_metadata, генерируются из реестра операций и берут параметры через path_params, query и body. Отдельный инструмент tracker_raw_request дает прямой вызов любого метода v3 с проверкой, что путь принадлежит домену v3, для случаев, которые типизированные инструменты не покрывают. Списочные и поисковые инструменты возвращают единый конверт пагинации с полями results, count, next, prev. Поддерживаются OAuth и Bearer токены, заголовки X-Org-ID и X-Cloud-Org-ID, транспорт stdio и потоковый HTTP.
Для кого. Для разработчиков, которым нужна и предсказуемая типизация частых операций Трекера, и лазейка для редких случаев через сырой запрос.
Подходит, если
- Нужна стабильная схема имен инструментов вроде tracker_issue_create для интеграции с другими системами
- Нужен доступ к редкому методу API v3, которого еще нет среди типизированных инструментов
- Нужна единая пагинация во всех списочных вызовах
Не подходит, если
- Нужны только API v2 Трекера: сервер работает исключительно с v3
- Не готовы использовать сырой запрос при нехватке типизированного инструмента
Пример запроса к агенту
Найди все открытые задачи с приоритетом критический в очереди SUPPORT и покажи их исполнителейОграничения
Работает только с API v3 Трекера. Нужен YANDEX_TRACKER_TOKEN и один из YANDEX_TRACKER_ORG_ID или YANDEX_TRACKER_CLOUD_ORG_ID. Реестр операций синхронизируется отдельным скриптом с документацией Яндекса и может отставать от последних изменений API.
Как отключить. Удалите блок yandex-tracker из конфигурации MCP-клиента или остановите процесс tracker-mcp-http.
MCP
- Транспорт
- stdio, http
- Авторизация
- OAuth
| Переменные окружения | |
|---|---|
| YANDEX_TRACKER_TOKEN обязательная, секрет | OAuth или Bearer токен Трекера |
| YANDEX_TRACKER_ORG_ID | ID организации, обязателен один из ORG_ID или CLOUD_ORG_ID |
| YANDEX_TRACKER_CLOUD_ORG_ID | ID облачной организации как альтернатива ORG_ID |
| YANDEX_TRACKER_TOKEN_TYPE | OAuth по умолчанию, поддерживает Bearer |
Проверка безопасности
- Типизированные и сырые инструменты создают и меняют задачи, очереди и другие сущности Трекера
- tracker_raw_request открывает доступ к любому методу API v3 в пределах домена v3
Коротко о README
README описывает проект как стабильную схему имен инструментов с CI-проверками, дает установку через uv pip, таблицу обязательных и опциональных переменных окружения, запуск stdio и HTTP версий, пример конфигурации MCP-клиента в TOML, описание типизированных и сырых инструментов и ссылку на скрипт синхронизации реестра операций с документацией Яндекса.
Частые вопросы
Что делать, если нужного метода нет среди типизированных инструментов?
Вызвать tracker_raw_request с методом, путем и телом запроса напрямую к API v3.
Работает ли с обычным Bearer-токеном без OAuth?
Да, YANDEX_TRACKER_TOKEN_TYPE можно задать как Bearer вместо OAuth по умолчанию.
Похожие
MCP-сервер со справкой по нодам и шаблонам n8n: агент подбирает ноды, проверяет конфигурацию и при наличии API создает воркфлоу в вашем n8n
Официальный плагин Zapier MCP: агент получает доступ к действиям в тысячах приложений через подключенный аккаунт Zapier
Awesome Claude Skills от Composio
Awesome Claude Skills
Каталог скиллов и плагинов для Claude и других агентов, плюс собственные скиллы автоматизации 78 SaaS-сервисов через Composio
Плагин и каталог CLI для агентов: генерирует командный интерфейс к GUI-программам вроде GIMP и Blender и ставит готовые через CLI-Hub