Yandex Tracker MCP

Независимый MCP-сервер на Python для работы AI-ассистентов с REST API v3 Яндекс Трекера.

Возможности

• получение и поиск задач;

• создание и обновление задач;

• чтение и добавление комментариев;

• получение очередей;

• просмотр и выполнение переходов статуса;

• полное управление пунктами чек-листа;

• управление трудозатратами и отчёты по задаче, сотрудникам, очередям и периодам;

• пользователи, поля очередей, статусы, типы задач, приоритеты и резолюции;

• OAuth- и IAM-аутентификация;

• поддержка организаций Яндекс 360 и Yandex Cloud.

Инструменты, изменяющие данные, явно требуют от MCP-клиента сначала показать планируемое изменение и получить подтверждение пользователя.

Related MCP server: Yandex Tracker MCP Server

Быстрый запуск

Требуются Python 3.11+ и uv.

cp .env.example .env
# Заполните .env, затем:
uv sync
uv run yandex-tracker-mcp

Используйте ровно один способ аутентификации:

• TRACKER_TOKEN — OAuth-токен;

• TRACKER_IAM_TOKEN — IAM-токен.

И ровно один идентификатор организации:

• TRACKER_ORG_ID — организация Яндекс 360;

• TRACKER_CLOUD_ORG_ID — организация Yandex Cloud.

Подключение к Cursor

Добавьте сервер в .cursor/mcp.json нужного проекта:

{
  "mcpServers": {
    "yandex-tracker": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/Yandex-Tracker-MCP",
        "run",
        "yandex-tracker-mcp"
      ],
      "env": {
        "TRACKER_TOKEN": "${env:TRACKER_TOKEN}",
        "TRACKER_ORG_ID": "${env:TRACKER_ORG_ID}"
      }
    }
  }
}

Для Yandex Cloud замените TRACKER_ORG_ID на TRACKER_CLOUD_ORG_ID. Не сохраняйте токены непосредственно в git.

Инструменты

Read-only:

• get_issue

• search_issues

• list_comments

• list_queues

• list_transitions

• get_checklist

• get_checklist_report

• list_worklogs

• get_issue_time_report

• get_time_report

• get_current_user

• get_user

• list_users

• search_users

• get_global_fields

• get_queue_fields

• get_statuses

• get_issue_types

• get_priorities

• get_resolutions

Изменяющие данные:

• create_issue

• update_issue

• add_comment

• execute_transition

• add_checklist_item

• update_checklist_item

• delete_checklist_item

• add_worklog

• update_worklog

• delete_worklog

Чек-листы

get_checklist возвращает идентификаторы пунктов, необходимые для изменения и удаления. Пункты поддерживают текст, отметку выполнения, исполнителя и deadline. Для снятия исполнителя или срока используйте clear_assignee или clear_deadline в update_checklist_item.

get_checklist_report рассчитывает процент выполнения, показывает открытые и просроченные пункты и группирует их по исполнителям.

Анализ времени

get_issue_time_report строит отчёт по одной задаче: первоначальная и текущая оценка, сумма worklog-записей, отклонение и разбивка по сотрудникам и дням.

get_time_report принимает запрос на языке Трекера и может ограничить отчёт датами date_from / date_to в формате YYYY-MM-DD. Например:

Покажи затраты команды по Queue: "BACKEND" с 2026-09-01 по 2026-09-30,
с разбивкой по сотрудникам и задачам.

Трекер хранит worklog в ISO 8601 (PT1H30M). Сервер приводит все длительности к минутам, считая рабочий день равным 8 часам, а рабочую неделю — 40 часам. Один отчёт обрабатывает не более 200 задач и 500 worklog-записей на задачу; при достижении лимита ответ содержит truncated: true.

Для записи времени используйте длительность ISO 8601, например PT1H30M. add_worklog, update_worklog и delete_worklog изменяют данные и требуют предварительного подтверждения пользователя.

Справочники

Перед созданием или изменением задачи MCP может получить допустимые значения через get_issue_types, get_priorities, get_statuses, get_resolutions и get_queue_fields. search_users ищет по логину, email или имени и просматривает не более 1000 пользователей.

Разработка

uv sync --group dev
uv run ruff check .
uv run mypy
uv run pytest

Официальная документация

• Общий формат REST API v3

• Доступ и аутентификация

• Создание задачи

• Поиск задач

• Поля задач

• Комментарии

• Переходы между статусами

• Получить чек-лист

• Добавить пункт чек-листа

• Трудозатраты задачи

• Поиск трудозатрат

API base URL: https://api.tracker.yandex.net/v3.

Происхождение

Проект реализован с собственной историей и структурой на основе официальной документации Яндекс Трекера и Model Context Protocol. В качестве архитектурного референса изучался Apache-2.0 проект aikts/yandex-tracker-mcp; его git-история и исходный код в этот репозиторий не переносились.

Лицензия

MIT