Skip to main content
Glama

Yandex Tracker MCP Server

Техническое задание: MCP сервер для Яндекс.Трекер

Общие сведения

Проект: MCP (Model Context Protocol) сервер для интеграции с Яндекс.Трекер Платформа: Node.js Режим работы: stdio API версия: Яндекс.Трекер REST API v 2

Цель проекта

Создание MCP сервера, обеспечивающего взаимодействие AI-ассистентов с системой управления задачами Яндекс.Трекер через стандартизированный протокол MCP.

Архитектура и технические требования

Основные компоненты

  1. MCP Server Core Реализация протокола MCP версии 2024 - 11 - 05 Обработка stdio коммуникации Управление жизненным циклом соединения
  2. Yandex Tracker API Client HTTP клиент для взаимодействия с API Яндекс.Трекер Аутентификация через OAuth токен Обработка rate limiting и ошибок
  3. Data Models Типизированные модели для объектов Трекера (задачи, проекты, пользователи) Валидация входящих и исходящих данных

Технологический стек

Runtime: Node.js 18+
Язык: TypeScript
HTTP клиент: axios
MCP SDK: @modelcontextprotocol/sdk
Валидация: zod
Логирование: pino

Функциональные требования

Обязательные инструменты (tools)

  1. Управление задачами

create_issue

Создание новой задачи Параметры: summary, description, queue, type, priority, assignee, components, labels Возврат: объект созданной задачи с ключом

get_issue

Получение информации о задаче по ключу Параметры: issueKey Возврат: полная информация о задаче

update_issue

Обновление существующей задачи Параметры: issueKey, поля для обновления Возврат: обновленный объект задачи

search_issues

Поиск задач по критериям Параметры: query (язык запросов Трекера), sort, limit, offset Возврат: список найденных задач

transition_issue

Изменение статуса задачи Параметры: issueKey, transition, comment Возврат: обновленная задача
  1. Комментарии

add_comment

Добавление комментария к задаче Параметры: issueKey, text, summonees Возврат: объект созданного комментария

get_comments

Получение комментариев задачи
Параметры: issueKey, limit, offset Возврат: список комментариев
  1. Управление проектами

get_queues

Получение списка очередей Параметры: expand, filter Возврат: список доступных очередей

get_queue

Получение информации об очереди Параметры: queueKey, expand Возврат: детальная информация об очереди
  1. Пользователи и права

get_myself

Получение информации о текущем пользователе Возврат: профиль пользователя

search_users

Поиск пользователей Параметры: query, limit Возврат: список найденных пользователей

Ресурсы (resources)

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

config://yandex-tracker/settings

Текущие настройки подключения Информация об авторизации (без токена) Базовый URL API
  1. Схемы и метаданные

schema://yandex-tracker/issue-types

Доступные типы задач в организации

schema://yandex-tracker/priorities

Список приоритетов задач

schema://yandex-tracker/statuses

Доступные статусы задач

Промпты (prompts)

  1. Анализ задач

analyze_sprint

Анализ спринта или группы задач Аргументы: sprintId или query для поиска задач Контекст: статистика, проблемы, рекомендации

task_summary

Краткое изложение задачи Аргументы: issueKey Контекст: суть задачи, статус, исполнители
  1. Создание контента

daily_report

Генерация отчета о ежедневной работе Аргументы: assignee, date Контекст: выполненные задачи, планы

Конфигурация и аутентификация

Переменные окружения

Аутентификация

YANDEX_TRACKER_TOKEN=<OAuth токен> YANDEX_TRACKER_CLOUD_ORG_ID=<ID огранизации> YANDEX_TRACKER_BASE_URL=https://api.tracker.yandex.net/v2 LOG_LEVEL=info REQUEST_TIMEOUT=30000 RATE_LIMIT_REQUESTS=100 RATE_LIMIT_WINDOW=60000
OAuth 2. 0 токен через заголовок Authorization Передача ID организации в заголовке X-Cloud-Org-Id Обработка истечения токена с информативными сообщениями

Обработка ошибок

Типы ошибок

  1. Аутентификация 401 Unauthorized - невалидный токен 403 Forbidden - недостаточно прав
  2. Клиентские ошибки 400 Bad Request - некорректные параметры 404 Not Found - задача не найдена 409 Conflict - конфликт при обновлении
  3. Серверные ошибки 500 Internal Server Error 503 Service Unavailable
  4. Сетевые ошибки Таймауты Потеря соединения

Стратегии обработки

Автоматические повторы для 5 xx ошибок (exponential backoff) Rate limiting с ожиданием Детальные сообщения об ошибках для пользователя Логирование всех ошибок для отладки

Производительность и ограничения

Rate Limiting

Соблюдение лимитов API Яндекс.Трекер Очередь запросов с приоритизацией Кэширование часто запрашиваемых данных

Оптимизация

  1. Пакетные операции где возможно
  2. Ленивая загрузка данных
  3. Сжатие ответов

Тестирование

Unit тесты

Покрытие всех публичных методов Мокирование HTTP запросов Валидация входных и выходных данных

Интеграционные тесты

Тестирование с реальным API (dev окружение) Проверка всех инструментов MCP Тестирование обработки ошибок

E 2 E тесты

Полный цикл взаимодействия через MCP Тестирование в Claude Desktop или другом MCP клиенте

Документация

README.md

Инструкции по установке и настройке Примеры использования Конфигурация для популярных MCP клиентов

API Documentation

Описание всех инструментов, ресурсов и промптов Примеры запросов и ответов Схемы данных

Troubleshooting Guide

Частые проблемы и их решения Отладка соединения Проблемы с аутентификацией

Развертывание и распространение

NPM пакет

Публикация в npm registry Семантическое версионирование Автоматические релизы через GitHub Actions

Docker контейнер (опционально)

Dockerfile для контейнеризации Docker Compose для локальной разработки

Установка

Конфигурация в MCP клиентах

Мониторинг и логирование

Метрики

Количество запросов к API Время ответа Количество ошибок по типам Использование rate limit

Логирование

Структурированные логи в JSON формате

npm install -g yandex-tracker-mcp-server
{ "mcpServers": { "yandex-tracker": { "command": "yandex-tracker-mcp-server", "env": { "YANDEX_TRACKER_TOKEN": "your_token_here", "YANDEX_TRACKER_CLOUD_ORG_ID": "your_org_id" } } } }
Различные уровни логирования Ротация логов Безопасность - исключение токенов из логов

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

Защита токенов

  1. Токены только через переменные окружения
  2. Маскирование токенов в логах
  3. Безопасное хранение конфигурации

Валидация данных

  1. Проверка всех входящих параметров
  2. Санитизация пользовательского ввода
  3. Защита от injection атак

Совместимость

MCP версии

  1. Поддержка MCP Protocol 2024 - 11 - 05
  2. Обратная совместимость с предыдущими версиями

Node.js версии

Минимальная версия: Node.js 18 Тестирование на LTS версиях Поддержка ES modules

Планы развития

Фаза 1 (MVP)

Базовые операции с задачами Поиск и фильтрация Управление комментариями

Фаза 2

Работа с проектами и досками Продвинутая аналитика Интеграция с календарем

Фаза 3

Автоматизация процессов Интеграция с другими системами Расширенные отчеты

Критерии приемки

  1. Все обязательные инструменты реализованы и протестированы
  2. Успешная интеграция с популярными MCP клиентами
  3. Покрытие тестами не менее 80 %
  4. Документация полная и актуальная
  5. Производительность соответствует требованиям API
  6. Безопасная обработка аутентификационных данных
-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Node.js MCP server that enables AI assistants to interact with Yandex Tracker task management system through a standardized protocol, supporting operations like creating, updating, and searching issues.

  1. Общие сведения
    1. Цель проекта
      1. Архитектура и технические требования
        1. Основные компоненты
        2. Технологический стек
      2. Функциональные требования
        1. Обязательные инструменты (tools)
        2. Ресурсы (resources)
        3. Промпты (prompts)
      3. Конфигурация и аутентификация
        1. Переменные окружения
        2. Аутентификация
      4. Обработка ошибок
        1. Типы ошибок
        2. Стратегии обработки
      5. Производительность и ограничения
        1. Rate Limiting
        2. Оптимизация
      6. Тестирование
        1. Unit тесты
        2. Интеграционные тесты
        3. E 2 E тесты
      7. Документация
        1. README.md
        2. API Documentation
        3. Troubleshooting Guide
      8. Развертывание и распространение
        1. NPM пакет
        2. Docker контейнер (опционально)
        3. Установка
        4. Конфигурация в MCP клиентах
      9. Мониторинг и логирование
        1. Метрики
        2. Логирование
      10. Безопасность
        1. Защита токенов
        2. Валидация данных
      11. Совместимость
        1. MCP версии
        2. Node.js версии
      12. Планы развития
        1. Фаза 1 (MVP)
        2. Фаза 2
        3. Фаза 3
      13. Критерии приемки
        1. Getting started
          1. Add your files
            1. Integrate with your tools
              1. Collaborate with your team
                1. Test and Deploy
                  1. Editing this README
                    1. Suggestions for a good README
                    2. Name
                    3. Description
                    4. Badges
                    5. Visuals
                    6. Installation
                    7. Usage
                    8. Support
                    9. Roadmap
                    10. Contributing
                    11. Authors and acknowledgment
                    12. License
                    13. Project status

                  Related MCP Servers

                  • -
                    security
                    A
                    license
                    -
                    quality
                    An MCP server that provides AI assistants access to the Beeminder API, allowing them to help users track goals, manage datapoints, and interact with Beeminder's self-commitment tools through natural language.
                    Last updated -
                    2
                    Python
                    MIT License
                    • Apple
                  • A
                    security
                    A
                    license
                    A
                    quality
                    A Model Context Protocol server that enables AI assistants to interact with Linear project management systems, allowing users to retrieve, create, and update issues, projects, and teams through natural language.
                    Last updated -
                    32
                    80
                    5
                    TypeScript
                    MIT License
                    • Apple
                  • -
                    security
                    A
                    license
                    -
                    quality
                    An MCP server that enables AI platforms to interact with YepCode's infrastructure, allowing LLM-generated scripts to run on YepCode and turning YepCode processes into powerful tools that AI assistants can use directly.
                    Last updated -
                    120
                    24
                    TypeScript
                    MIT License
                    • Linux
                    • Apple
                  • A
                    security
                    A
                    license
                    A
                    quality
                    A Node.js/TypeScript MCP server that facilitates interactive communication between LLMs and users, allowing AI assistants to request user input, display notifications, and manage command-line chat sessions.
                    Last updated -
                    5
                    820
                    TypeScript
                    MIT License
                    • Apple
                    • Linux

                  View all related MCP servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/Igordeveloperr/Yandex-tracker-MCP'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server