Yandex Tracker

io.github.sdamarketingv1.0.8更新於 Oct 7, 2026

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

已驗證STDIO僅桌面Developer ToolsProductivity & Workflow

概覽

AI 產生的概覽

讓 AI 助理透過 Yandex Tracker API v3 處理工作項目：搜尋、建立、編輯、留言與關閉議題。

功能
提供涵蓋 Yandex Tracker API v3 的 187 個工具，助理可用篩選器或查詢語言搜尋議題、建立與編輯議題、變更狀態、建立關聯並查看歷史。也支援留言、檢查清單、工時記錄、附件（含下載）、佇列、看板與衝刺、儀表板、專案與目標、參考資料以及批次修改。唯讀模式只暴露 80 個讀取工具，刪除與批次操作需要明確的確認旗標。
適用情境
當團隊使用 Yandex Tracker 追蹤工作，並希望助理查詢自己的議題、草擬或更新任務、執行批次變更而不必手動複製連結時適用。依設定可用於唯讀瀏覽或完整寫入。
執行需求
透過 npm 套件 tracker-mcp 或 Docker 映像 ghcr.io/sdamarketing/tracker-mcp 以 stdio 在本機執行；npm 方式需要 Node.js 20+。需要 Yandex 360 OAuth 權杖或 Yandex Cloud IAM 權杖（TRACKER_TOKEN）以及組織 ID（TRACKER_ORG_ID），並用 TRACKER_AUTH 選擇 oauth 或 iam。需要連線至 Tracker API 的網路。選用的 HTTP 模式使用 MCP_AUTH_TOKEN。
安裝前請注意
權杖擁有你在 Tracker 中的同等權限，唯讀用途應授予最小權限，例如 tracker:read。寫入工具可以建立、編輯、移動、關閉與刪除議題、留言、檢查清單、佇列與看板；刪除與批次工具需要 confirm: true。IAM 權杖約 12 小時內過期。不要把 TRACKER_TOKEN 寫進程式碼或共用檔案，在將 HTTP 模式暴露到 localhost 之外前先設定 MCP_AUTH_TOKEN。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Yandex Tracker，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

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 Трекера меняется — следите за официальной документацией.

來源：README.md，提交 787486b

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v1.0.8最新Oct 7, 2026