Yandex Tracker

io.github.sdamarketingv1.0.8Updated Oct 7, 2026

MCP server for Yandex Tracker: full API v3 coverage (187 tools)

VerifiedSTDIODesktop onlyDeveloper ToolsProductivity & Workflow

Overview

AI-generated overview

Lets an AI assistant work with Yandex Tracker: find, create, edit, comment on, and close issues through the Tracker API v3.

What it does
Exposes 187 tools covering the Yandex Tracker API v3, so an assistant can search issues with filters or query language, create and edit them, change status, link them, and read history. It also handles comments, checklists, time tracking, attachments (including downloads), queues, boards and sprints, dashboards, projects and goals, reference data, and bulk edits. A read-only mode exposes only the 80 read tools, and delete or bulk operations require an explicit confirmation flag.
When to use it
Use it when your team tracks work in Yandex Tracker and you want an assistant to look up your issues, draft or update tasks, or run bulk changes without copying links by hand. It suits both read-only browsing and full write access, depending on how you configure it.
Requirements
Runs locally over stdio via the npm package tracker-mcp or the Docker image ghcr.io/sdamarketing/tracker-mcp; Node.js 20+ for the npm route. Requires a Yandex 360 OAuth token or Yandex Cloud IAM token in TRACKER_TOKEN and an organization ID in TRACKER_ORG_ID, with TRACKER_AUTH selecting oauth or iam. Network access to the Tracker API is needed. An optional HTTP mode uses MCP_AUTH_TOKEN.
Before you install
The token carries the same permissions you have in Tracker, so grant minimal scopes such as tracker:read for read-only use. Write tools can create, edit, move, close, and delete issues, comments, checklists, queues, and boards; delete and bulk tools require confirm: true. IAM tokens expire within about 12 hours. Keep TRACKER_TOKEN out of code and shared files, and set MCP_AUTH_TOKEN before exposing the HTTP mode beyond localhost.

Installation

In SourceWeft

  1. Open Yandex Tracker in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

traker-mcp — MCP-сервер для Яндекс Трекера

[CI] [npm] [skills.sh] [install]

Проще говоря: этот сервер учит вашего AI-ассистента работать с Яндекс Трекером. Вы говорите ассистенту «найди мои задачи», «создай задачу в очереди TREK», «закрой TASK-123 с резолюцией “Решён”» — а он делает это через API Трекера сам, без копирования ссылок руками.

Работает с любым MCP-клиентом: VS Code (Copilot), Cursor, Claude Desktop, Claude Code, opencode, Windsurf, Zed, JetBrains AI Assistant.

📘 Подробное руководство для новичков (получение токена, пошаговая настройка каждого клиента, решение проблем) — в docs/SETUP.md.

Что умеет

187 инструментов — полное покрытие API Трекера v3:

КатегорияЧто можно делать
Задачиискать (фильтр, язык запросов, query 2.0, scroll >10k, подсказки), создавать, читать, редактировать, переносить, менять статус, связывать, история
Комментариидобавлять, читать (список и по одному), редактировать, удалять, реакции
Чеклистызадачи + проекты/портфели: добавлять, отмечать, двигать, удалять
Учёт временизаписи по задаче и поиск по авторам/датам
Вложениясписок, метаданные, скачивание (картинки/текст/база), миниатюры, загрузка, временные файлы
Массоворедактирование, перенос и закрытие задач; bulk-обновление проектов/целей
Отчёты и фильтрысохранённые отчёты для виджетов, CRUD сохранённых фильтров
ОчередиCRUD (вкл. удаление/восстановление), права доступа, версии, компоненты, локальные поля, макросы, теги
Автоматизациятриггеры и автодействия (CRUD + логи), воркфлоу (статусы и переходы)
ДоскиCRUD, пагинация, колонки CRUD, спринты (создать/запустить/архив)
Дашбордысоздание дашбордов и виджетов («Время цикла»)
Проекты, цели, портфелиCRUD, комментарии, чеклисты, вложения, связи, события, права, ключевые результаты и метрики (через fields)
Справочникичтение И запись: типы, статусы, приоритеты, резолюции; глобальные поля и категории
Внешние приложениясвязи задач с внешними системами (Jira и др.)
Отсутствияотпуска/болезни/командировки (admin)
Миграцияимпорт задач/комментариев/связей/трудозатрат/вложений «задним числом» (admin)

Безопасность для агентов

  • Каждый инструмент несёт MCP-аннотации: чтения помечены readOnlyHint, все delete_* — destructiveHint — клиенты показывают их как подтверждаемые/Безопасные операции.
  • Все delete_* и bulk_* требуют confirm: true (агент сначала показывает, что удалит).
  • TRACKER_READ_ONLY=1 — сервер отдаёт только 80 инструментов чтения, запись скрыта полностью. Для «просто посмотреть» интеграций.

Скилл для AI-агентов (skills.sh)

К серверу прилагается скилл yandex-tracker — процедурные знания для агента: язык запросов Трекера, корректные значения полей (приоритеты, статусы, резолюции), рецепты («найди мои задачи», «закрой с резолюцией», bulk-правки) и грабли API (dueDate vs releaseDate, обязательная резолюция при закрытии, IAM-токены ≤12ч).

bash
npx skills add sdamarketing/tracker_mcp

Устанавливает скилл во все обнаруженные агенты (Claude Code, Cursor, opencode, Codex и ещё 75+). Мастер npm run setup тоже предлагает установить скилл вместе с настройкой MCP-клиента. Репозиторий скилла: skills.sh/sdamarketing/tracker_mcp.

Установка в одну команду (macOS / Linux / WSL)

bash
curl -fsSL https://raw.githubusercontent.com/sdamarketing/tracker_mcp/main/install.sh | bash

Скрипт сам: проверит систему → поставит Node.js через nvm, если его нет (спросит согласия, sudo не нужен) → скачает сервер в ~/.traker-mcp → соберёт и проверит его → запустит мастер настройки: ключи Трекера (ввод скрыт), проверка ключей в API, выбор AI-клиента (VS Code, Cursor, Claude Desktop, Claude Code, opencode, Windsurf, Zed, JetBrains) и итоговый отчёт.

Повторный запуск той же командой = обновление сервера (конфиги клиентов не трогаются).

🔎 Хотите сначала прочитать скрипт? Уберите | bash и посмотрите вывод: curl -fsSL https://raw.githubusercontent.com/sdamarketing/tracker_mcp/main/install.sh

🪟 Windows: установите через WSL командой выше или вручную — см. ниже.

Установка из npm (без клонирования)

bash
npm install -g tracker-mcptracker-mcp setup     # интерактивный мастер: ключи Трекера + настройка AI-клиента

После этого сервер доступен командой tracker-mcp (в конфиг AI-клиента её и прописывайте). Другие команды: tracker-mcp update, tracker-mcp links, tracker-mcp --help.

Official MCP Registry

Сервер опубликован в официальном реестре MCP как io.github.sdamarketing/tracker-mcp (npm + Docker-пакеты, env-переменные описаны в server.json). Клиенты с поддержкой реестра найдут его по имени.

Docker (без установки чего-либо, кроме Docker)

Образ публикуется в GitHub Container Registry при каждом релизе (v*-тег):

bash
# stdio (MCP-клиент запускает контейнер сам)docker run -i --rm -e TRACKER_TOKEN -e TRACKER_ORG_ID ghcr.io/sdamarketing/tracker-mcp
# HTTP-режимdocker run --rm -p 3407:3407 -e TRACKER_TOKEN -e TRACKER_ORG_ID \  -e MCP_AUTH_TOKEN=вашключ ghcr.io/sdamarketing/tracker-mcp serve --host 0.0.0.0

В конфиге агента вместо command: node используется command: docker, args: ["run","-i","--rm","-e","TRACKER_TOKEN","-e","TRACKER_ORG_ID","ghcr.io/sdamarketing/tracker-mcp"].

Ручная установка (Windows или без curl)

Шаг 1. Убедитесь, что есть Node.js 20+ (проверка: node -v).

Шаг 2. Соберите сервер:

bash
git clone <адрес-этого-репозитория>cd traker_mcpnpm installnpm run buildnpm run smoke   # проверка: должно быть "OK: ... 187 tools listed"

Шаг 3. Подготовьте две вещи из Трекера:

Шаг 4. Запустите мастер установки:

bash
npm run setup

Мастер спросит ключи (токен — скрытым вводом), проверит их в API Трекера, покажет интерактивное меню клиентов (↑↓ + Enter) и настроит выбранные (можно несколько подряд) — через их CLI или дописав конфиг с бэкапом, — а в конце выведет отчёт.

Альтернатива: npm run links — откроет страницу в браузере с кнопками установки в один клик (VS Code, Cursor, Claude Desktop) и конфигами всех клиентов для ручного копирования.

Подключение к вашему агенту

Ваш агентБыстрый способКонфиг-файл
VS Code (Copilot)npm run setup (CLI code).vscode/mcp.json
Cursornpm run setup~/.cursor/mcp.json
Claude Desktopnpm run setupclaude_desktop_config.json
Claude Code (терминал)npm run setup (CLI claude)~/.claude.json
opencodenpm run setup~/.config/opencode/opencode.json
Windsurfnpm run setup~/.codeium/windsurf/mcp_config.json
Zednpm run setupsettings.json (context_servers)
JetBrains IDEnpm run setup.mcp.json в корне проекта

Пошаговые инструкции с точными путями для macOS/Windows/Linux: docs/SETUP.md.

Проверка

После установки перезапустите агента и спросите:

«Вызови инструмент get_current_user» — вернётся ваш профиль из Трекера. «Найди мои задачи в Трекере» — сработает find_issues.

Частые проблемы

СимптомПричина и решение
Missing required environment variable TRACKER_TOKENтокен не передан — перегенерируйте ссылки (npm run links) или проверьте env в конфиге
Yandex Tracker API error 401неверный токен или токен истёк (IAM живёт ≤12 часов)
Yandex Tracker API error 403: Organization is not availableневерный TRACKER_ORG_ID или организация не подключена к Трекеру
Сервер не запускается в Claude Desktop (macOS)используйте абсолютный путь к node — уже так в сгенерированном конфиге
У агента нет инструментовсервер отключён — включите в списке MCP-серверов клиента и перезапустите

Больше решений — docs/SETUP.md, раздел 8.

Настройка сервера

ПеременнаяОбязательнаОписание
TRACKER_TOKENдаOAuth-токен (y0_..., Яндекс 360) или IAM-токен (t1...., Yandex Cloud)
TRACKER_ORG_IDдаИдентификатор организации
TRACKER_AUTHнетoauth (по умолчанию) или iam — определяет заголовки X-Org-ID / X-Cloud-Org-ID
TRACKER_API_URLнетПо умолчанию https://api.tracker.yandex.net/v3
TRACKER_LANGнетru или en — язык локализованных полей
TRACKER_READ_ONLYнет1 — агенту видны только read-only инструменты (80 шт)
TRACKER_CACHE_TTL_MSнетTTL кэша справочников (по умолчанию 10 минут)

HTTP-режим (serve)

По умолчанию сервер работает по stdio (для локальных агентов). Для сетевого доступа (команда, удалённый клиент, проксирование):

bash
tracker-mcp serve --port 3407 --host 127.0.0.1   # значения по умолчаниюMCP_AUTH_TOKEN=s3cret tracker-mcp serve            # ключ к эндпоинту (Bearer)curl localhost:3407/health                         # {"ok":true,"tools":187}
  • Эндпоинт MCP: POST/GET/DELETE /mcp (Streamable HTTP, stateless)
  • Без MCP_AUTH_TOKEN привязка к не-loopback-адресу отклоняется — токен Трекера живёт в env, голый порт в сети недопустим
  • Конфиг клиента для HTTP: "url": "http://127.0.0.1:3407/mcp" + "headers": {"Authorization": "Bearer s3cret"}

Безопасность

  • Токен даёт агенту те же права, что у вас в Трекере. Выдавайте минимальные права (для чтения хватит tracker:read).
  • Храните токен в .env (уже в .gitignore) или в конфиге клиента, не в коде.
  • install-links.html содержит токен — скрипт добавляет его в .gitignore сам.

Разработка

bash
npm run typecheck   # проверка типовnpm run build       # сборка в dist/npm run smoke       # запуск и список инструментов без обращения к APInpm run setup       # интерактивный мастер установки для AI-клиентовnpm run links       # страница с кнопками установки (deeplinks)

Архитектура и полный список инструментов — в docs/SETUP.md и в коде src/tools/.

Лицензия и поддержка

Проблемы и идеи — в issues репозитория. API Трекера меняется — следите за официальной документацией.

Source: README.md at commit 787486b

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.0.8LatestOct 7, 2026