YouTrack MCP
YouTrack MCP открывает агенту задачи YouTrack Cloud и Server через REST API: поиск, создание, правки и комментарии.
- 100 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Токен YouTrack дает агенту права его владельца, в том числе на запись, если не сузить набор инструментов.
Установка
- Работает в
Ручная установка
docker run --rm -i -e YOUTRACK_URL=https://your-instance.youtrack.cloud -e YOUTRACK_API_TOKEN=perm-xxx.your-token tonyzorin/youtrack-mcp:latestDocker-вариант из README, флаг `-i` обязателен для stdio. Вариант без Docker: `npx -y youtrack-mcp-tonyzorin`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Токен YouTrack дает агенту права его владельца, в том числе на запись, если не сузить набор инструментов.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MCP-сервер запускается локально через Docker, npx или Python и обращается к YouTrack по REST API. Агент в Cursor или Claude Desktop ищет задачи, создает их, меняет поля и добавляет комментарии. Поля обновляются простыми строками, например `update_issue_state("DEMO-123", "In Progress")`. Набор инструментов сужают переменными `ENABLED_TOOLS` (белый список) и `DISABLED_TOOLS` (черный список), поэтому запись можно выключить и оставить только чтение. Проект вышел в апреле 2025 и работает на самостоятельно размещаемом Server, который еще не обновлен до 2025.3 со встроенным MCP от JetBrains.
Для кого. Команды на YouTrack, где агент должен вести задачи, особенно на Server старше 2025.3.
Подходит, если
- Агент ищет задачи по запросу и пересказывает их в чате.
- Из ошибки в коде нужно завести задачу в нужном проекте.
- Состояние и поля задачи меняют фразой, а не заполнением формы.
- Агенту дают только чтение через `ENABLED_TOOLS`.
Не подходит, если
- Экземпляр YouTrack 2025.3 и новее, где нужны OAuth и встроенный `/mcp`.
- Нельзя выдавать агенту постоянный токен с правами записи.
- Нужен сервер без Docker, Node.js и Python.
Пример запроса к агенту
Найди открытые задачи проекта DEMO с высоким приоритетом и добавь комментарий к DEMO-123.MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
YOUTRACK_URLобязательная- Адрес экземпляра YouTrack, Cloud или Server.
YOUTRACK_API_TOKENобязательная, секрет- Постоянный токен YouTrack.
Ограничения
Нужен постоянный токен YouTrack и адрес экземпляра. Вариант через npx требует Node.js 18 и Python 3.14. Docker не видит переменные `env` клиента, их передают флагами `-e` в аргументах. Инструменты работы со статьями требуют базы знаний YouTrack. Минимальная версия YouTrack не опубликована, проверяйте на своем экземпляре. Токен выдает агенту права его владельца, поэтому для первого запуска безопаснее оставить только чтение через `ENABLED_TOOLS`.
Как отключить. Удалите запись `youtrack` из конфигурации MCP-клиента и отзовите постоянный токен в профиле YouTrack. Контейнер останавливает `docker stop`.
Частые вопросы
Чем он отличается от MCP самого YouTrack?
Он запускается у вас и ходит по REST API, поэтому работает и на Server до 2025.3. Встроенный MCP JetBrains живет внутри YouTrack по адресу `/mcp`.
Как оставить только чтение?
Задайте `ENABLED_TOOLS=get_issue,search_issues,get_projects`. Либо скройте записывающие инструменты через `DISABLED_TOOLS`.
Что делать с самоподписанным сертификатом?
Установите `YOUTRACK_VERIFY_SSL=false` для такого Server.
Где взять токен?
В профиле YouTrack создается постоянный токен, его значение передают в `YOUTRACK_API_TOKEN`.
Какие способы запуска есть?
Docker, `npx -y youtrack-mcp-tonyzorin` и запуск из Python. Для stdio в Docker нужен флаг `-i`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыtracker-mcp
traker-mcp
MCP-сервер Яндекс Трекера с 187 инструментами и скиллом: задачи, очереди, доски, спринты и автоматизация через API v3, режим только чтения
Официальный MCP-сервер Todoist: агент ищет, создает и меняет задачи и проекты в вашем аккаунте
MCP-сервер Яндекс Трекера: очереди, задачи, комментарии, переходы по статусам, спринты и поиск на языке запросов Трекера
Jira MCP на Go: агент ищет задачи по JQL, читает спринты и комментарии, списывает время, видит ветки и пул-реквесты задачи, работает с Cloud и Data Center
Официальный MCP и плагин Taskade: агент ведет проекты, задачи, автоматизации и ИИ-агентов рабочего пространства.
Задачи, тикеты Desk, страницы Spaces и чаты Teamwork.com для агента: размещенный сервер с профилями по ролям и режимом чтения
Коротко о README
README объясняет, зачем проект живет рядом с официальным MCP, и сравнивает их в таблице. Затем идут быстрый старт для Cursor и Claude Desktop через Docker и npx, запуск из Python и таблица переменных окружения.