ytracker-mcp

MCP-сервер для Yandex Tracker. Позволяет AI-ассистентам (Claude, GPT и др.) управлять задачами, спринтами, очередями и workflow трекера через Model Context Protocol.

38 инструментов — задачи, комментарии, связи, вложения, чеклисты, доски, спринты, массовые операции, администрирование очередей.

Быстрый старт

Для работы нужны две вещи: OAuth-токен и ID организации. Как их получить — ниже.

Claude Code

claude mcp add ytracker \
  -e TRACKER_OAUTH_TOKEN=y0_AgAAAA... \
  -e TRACKER_ORG_ID=123456 \
  -- npx -y @1gnatov/ytracker-mcp

Проверить:

claude mcp list

Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "ytracker": {
      "command": "npx",
      "args": ["-y", "@1gnatov/ytracker-mcp"],
      "env": {
        "TRACKER_OAUTH_TOKEN": "y0_AgAAAA...",
        "TRACKER_ORG_ID": "123456"
      }
    }
  }
}

Другие MCP-клиенты

Любой MCP-клиент, поддерживающий stdio-транспорт:

npx -y @1gnatov/ytracker-mcp

Конфигурация через переменные окружения (см. ниже).

Получение токена и ID организации

1. OAuth-токен

1. Откройте oauth.yandex.ru и создайте приложение
2. Платформа: Веб-сервисы
3. Доступы: tracker:read и tracker:write
4. Сохраните и перейдите по ссылке:

   https://oauth.yandex.ru/authorize?response_type=token&client_id=<ваш_client_id>

5. Скопируйте access_token из URL после авторизации

2. ID организации

1. Откройте Yandex Tracker
2. Перейдите в Администрирование (шестеренка) → Организации
3. Скопируйте числовой ID

Если ваша организация подключена через Yandex Cloud, вместо OAuth используйте IAM-токен:

yc iam create-token

А вместо TRACKER_ORG_ID используйте TRACKER_CLOUD_ORG_ID:

yc organization-manager organization list

IAM-токен действует 12 часов и требует обновления.

Конфигурация

| Переменная | Описание | |---|---| | TRACKER_OAUTH_TOKEN | OAuth-токен для Yandex 360 (или TRACKER_IAM_TOKEN для Cloud) | | TRACKER_ORG_ID | ID организации Yandex 360 (или TRACKER_CLOUD_ORG_ID для Cloud) | | TRACKER_BASE_URL | API URL, по умолчанию https://api.tracker.yandex.net |

Укажите один тип токена и один тип Org ID.

Инструменты

Задачи

| Инструмент | Описание | |---|---| | search_issues | Поиск задач (язык запросов Tracker или фильтры) | | get_issue | Детали задачи по ключу | | create_issue | Создать задачу | | update_issue | Обновить поля задачи |

Workflow

| Инструмент | Описание | |---|---| | list_transitions | Доступные переходы (смены статуса) | | execute_transition | Сменить статус задачи |

Комментарии

| Инструмент | Описание | |---|---| | list_comments | Показать комментарии | | add_comment | Добавить комментарий | | update_comment | Обновить комментарий | | delete_comment | Удалить комментарий |

Очереди

| Инструмент | Описание | |---|---| | list_queues | Список очередей | | get_queue | Детали очереди | | get_queue_fields | Типы задач в очереди | | create_queue | Создать очередь | | update_queue | Обновить настройки очереди | | delete_queue | Удалить очередь (необратимо) |

Связи

| Инструмент | Описание | |---|---| | list_links | Связи задачи | | create_link | Создать связь | | delete_link | Удалить связь |

Вложения

| Инструмент | Описание | |---|---| | list_attachments | Список вложений | | upload_attachment | Загрузить файл (base64) | | download_attachment | Скачать вложение | | delete_attachment | Удалить вложение |

Чеклисты

| Инструмент | Описание | |---|---| | get_checklist | Показать чеклист | | add_checklist_item | Добавить пункт | | update_checklist_item | Обновить/отметить пункт | | delete_checklist_item | Удалить пункт |

Доски и спринты

| Инструмент | Описание | |---|---| | list_boards | Agile-доски | | list_sprints | Спринты доски | | create_board | Создать доску | | create_sprint | Создать спринт | | update_sprint | Обновить спринт |

Пользователи

| Инструмент | Описание | |---|---| | get_myself | Информация о текущем пользователе | | list_users | Список пользователей организации |

Массовые операции

| Инструмент | Описание | |---|---| | bulk_update | Массовое обновление задач | | bulk_transition | Массовая смена статуса | | bulk_move | Массовое перемещение между очередями | | get_bulk_operation | Статус массовой операции |

Разработка

git clone https://gitlab.com/1gnatov/ytracker-mcp.git
cd ytracker-mcp
npm install
npm run build
npm test

Лицензия

Apache 2.0