Yandex Tracker

Integrates with Yandex Tracker, allowing an AI assistant to interact with its task management system via the MCP protocol.

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

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

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

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

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

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

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

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

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

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

Параметры: issueKey, limit, offset Возврат: список комментариев

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

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

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

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

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

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

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

Генерация отчета о ежедневной работе Аргументы: 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 Обработка истечения токена с информативными сообщениями

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

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

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

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

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

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

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

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

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

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

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

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

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" } } } }

Различные уровни логирования Ротация логов Безопасность - исключение токенов из логов

- Токены только через переменные окружения
- Маскирование токенов в логах
- Безопасное хранение конфигурации
- Проверка всех входящих параметров
- Санитизация пользовательского ввода
- Защита от injection атак
- Поддержка MCP Protocol 2024 - 11 - 05
- Обратная совместимость с предыдущими версиями

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

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

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

Автоматизация процессов Интеграция с другими системами Расширенные отчеты
- Все обязательные инструменты реализованы и протестированы
- Успешная интеграция с популярными MCP клиентами
- Покрытие тестами не менее 80 %
- Документация полная и актуальная
- Производительность соответствует требованиям API
- Безопасная обработка аутентификационных данных

Interact with task, doc, and project data in Dart, an AI-native project management tool

Remote MCP server for MeisterTask. Create and manage projects, tasks, and notes from your AI assistant. Hosted (streamable-HTTP) — connect at https://mcp.meistertask.com/mcp

The official Plane MCP server provides integration with Plane APIs, enabling full AI automation of Plane projects, work items, cycles and more.

Keep teams & agents coordinated automatically

From the creators of Wunderlist — the all-in-one task management app for to-do lists, notes, and projects. AI-powered productivity that replaces 5 apps.

Connect to the Taskade platform via MCP. Access tasks, projects, workflows, and AI agents in real-time through a unified workspace and API.

Official Taskeract MCP Server for integrating your Taskeract project tasks and load the context of your tasks into your MCP enabled app.

Manage your Todoist tasks and projects directly from your LLM.

Interact with Asana tasks, projects, workspaces, and comments using the Asana API.

Comprehensive Trello integration: 46 tools covering boards, cards, lists, labels, checklists, attachments, members, custom fields, and search. Read-only mode, image attachment auto-download. Active fork of kocakli/Trello-Desktop-MCP integrating contributions from across the Trello MCP fork ecosystem