YouTrack MCP Server

Кастомный MCP (Model Context Protocol) сервер для интеграции с YouTrack - системой управления задачами от JetBrains.

🌟 Возможности

🛠️ Инструменты (Tools)

• search_issues - поиск задач в YouTrack по запросу
• create_issue - создание новых задач
• update_issue - обновление существующих задач

📊 Ресурсы (Resources)

• youtrack://projects - список всех доступных проектов

🚀 Установка

1. Установка зависимостей

cd mcp-servers/youtrack
npm install

2. Получение YouTrack токена

1. Перейди в YouTrack → User Profile → Authentication
2. Создай новый Permanent Token
3. Сохрани токен в безопасном месте

3. Настройка переменных окружения

export YOUTRACK_TOKEN="your_youtrack_token_here"
export YOUTRACK_BASE_URL="https://your-company.youtrack.cloud"

4. Настройка в Cursor

1. Скопируй конфигурацию:

   cp .cursor/mcp.json.example .cursor/mcp.json

2. Обнови файл .cursor/mcp.json с реальными значениями:

   {
     "mcpServers": {
       "youtrack": {
         "command": "node",
         "args": ["./mcp-servers/youtrack/index.js"],
         "env": {
           "YOUTRACK_TOKEN": "your_youtrack_token_here",
           "YOUTRACK_BASE_URL": "https://your-company.youtrack.cloud"
         }
       }
     }
   }

3. Обнови настройки MCP в Cursor

📖 Использование

Поиск задач

Найди все открытые задачи в проекте ADV, назначенные на меня

Покажи все баги с высоким приоритетом

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

Создай задачу в проекте ADV с заголовком "Добавить поддержку YouTrack MCP" и описанием "Интегрировать YouTrack с AI ассистентом"

Обновление задач

Обнови задачу ADV-123, поменяй статус на "In Progress" и назначь на sergey.komarov

🔍 Примеры запросов YouTrack

YouTrack использует мощный язык запросов. Примеры:

• project: ADV state: Open - открытые задачи в проекте ADV
• assignee: me - задачи, назначенные на текущего пользователя
• type: Bug priority: Critical - критические баги
• created: today - задачи, созданные сегодня
• updated: {-1w .. today} - задачи, обновленные за последнюю неделю

🔧 API YouTrack

Сервер использует YouTrack REST API:

• GET /api/issues - поиск задач
• POST /api/issues - создание задач
• POST /api/issues/{issueId} - обновление задач
• GET /api/admin/projects - получение проектов

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

• Токен YouTrack должен храниться в переменных окружения
• Не коммить токены в репозиторий
• Использовать минимально необходимые права доступа
• Регулярно ротировать токены

🚨 Устранение неполадок

Ошибки аутентификации

• Проверь правильность токена
• Убедись, что токен не истек
• Проверь URL YouTrack instance

MCP сервер не работает

• Проверь установку зависимостей: npm install
• Убедись, что переменные окружения установлены
• Проверь логи: node index.js

🔗 Полезные ссылки

• YouTrack REST API Documentation
• YouTrack Query Language
• Model Context Protocol

📝 Заметки разработчика

Этот MCP сервер предоставляет базовую функциональность для работы с YouTrack через AI ассистента и может быть адаптирован под различные проекты.

Для расширения функциональности можно добавить:

• Работу с комментариями
• Управление временем (time tracking)
• Работу с вложениями
• Агильные доски
• Отчеты и аналитику