YouTrack MCP: три сервера для задач и учёта времени в Claude и Cursor

tonyzorin/youtrack-mcp· Проверено 12.11.2026· 100на GitHub

Даёт агенту задачи YouTrack: искать по языку запросов, заводить и двигать задачи по статусам, писать комментарии, списывать время и вести статьи базы знаний.

3 реализации:

Работает через REST API, в том числе со старыми YouTrack Server до 2025.3; поля задаются простыми строками, набор инструментов режется списками ENABLED_TOOLS и DISABLED_TOOLS.

Как подключить

Что сделать до подключения

Node.js 18 или новее и Python 3.14 или новее; вместо них можно Docker-образ tonyzorin/youtrack-mcp:latest

Адрес вашего YouTrack Cloud или Server и постоянный токен

YOUTRACK_API_TOKEN

YouTrack → профиль → постоянные токены (permanent token) → создать токен

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'YOUTRACK_URL=https://<ваш-инстанс>.youtrack.cloud' --env 'YOUTRACK_API_TOKEN=<постоянный токен perm-…>' --transport stdio youtrack \
  -- npx -y youtrack-mcp-tonyzorin

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.youtrack]
command = "npx"
args = ["-y", "youtrack-mcp-tonyzorin"]

[mcp_servers.youtrack.env]
YOUTRACK_URL = "https://<ваш-инстанс>.youtrack.cloud"
YOUTRACK_API_TOKEN = "<постоянный токен perm-…>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "youtrack": {
      "command": "npx",
      "args": ["-y", "youtrack-mcp-tonyzorin"],
      "env": {
        "YOUTRACK_URL": "https://<ваш-инстанс>.youtrack.cloud",
        "YOUTRACK_API_TOKEN": "<постоянный токен perm-…>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "youtrack": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "youtrack-mcp-tonyzorin"],
      "env": {
        "YOUTRACK_URL": "https://<ваш-инстанс>.youtrack.cloud",
        "YOUTRACK_API_TOKEN": "<постоянный токен perm-…>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "youtrack": {
      "command": "npx",
      "args": ["-y", "youtrack-mcp-tonyzorin"],
      "env": {
        "YOUTRACK_URL": "https://<ваш-инстанс>.youtrack.cloud",
        "YOUTRACK_API_TOKEN": "<постоянный токен perm-…>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "youtrack": {
      "command": "npx",
      "args": ["-y", "youtrack-mcp-tonyzorin"],
      "env": {
        "YOUTRACK_URL": "https://<ваш-инстанс>.youtrack.cloud",
        "YOUTRACK_API_TOKEN": "<постоянный токен perm-…>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "youtrack": {
        "type": "local",
        "command": ["npx", "-y", "youtrack-mcp-tonyzorin"],
        "environment": {
          "YOUTRACK_URL": "https://<ваш-инстанс>.youtrack.cloud",
          "YOUTRACK_API_TOKEN": "<постоянный токен perm-…>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "youtrack": {
      "command": "npx",
      "args": ["-y", "youtrack-mcp-tonyzorin"],
      "env": {
        "YOUTRACK_URL": "https://<ваш-инстанс>.youtrack.cloud",
        "YOUTRACK_API_TOKEN": "<постоянный токен perm-…>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "youtrack": {
      "command": "npx",
      "args": ["-y", "youtrack-mcp-tonyzorin"],
      "env": {
        "YOUTRACK_URL": "https://<ваш-инстанс>.youtrack.cloud",
        "YOUTRACK_API_TOKEN": "<постоянный токен perm-…>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

search_issuesищет задачи по запросу YouTrack

get_issueоткрывает задачу

create_issueсоздаёт задачу или подзадачу

update_issue_stateменяет статус

update_issue_priorityменяет приоритет

update_issue_assigneeназначает исполнителя

update_issue_typeменяет тип задачи

update_issue_estimationставит оценку

update_custom_fieldsменяет произвольные поля

add_commentпишет комментарий

add_dependencyсвязывает задачи зависимостью

link_issuesсвязывает задачи

get_attachment_contentскачивает вложение

get_projectsперечисляет проекты

diagnose_workflow_restrictionsразбирает запреты воркфлоу

get_helpвыводит справку

70 инструментов на весь REST API: учёт времени, теги, сохранённые запросы, доски Agile и спринты, команды YouTrack, создание проектов.

Как подключить

Что сделать до подключения

Node.js с командой npx

Постоянный токен YouTrack со scope YouTrack; для пользователей, типов связей и новых проектов ещё YouTrack Administration

YOUTRACK_TOKEN

профиль → Account Security → Tokens → New token, отметить scope; токен начинается с perm:

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'YOUTRACK_URL=https://<ваш-инстанс>.youtrack.cloud' --env 'YOUTRACK_TOKEN=<постоянный токен perm:…>' --transport stdio youtrack-mcp-extended \
  -- npx @promtior/youtrack-mcp-extended

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.youtrack-mcp-extended]
command = "npx"
args = ["@promtior/youtrack-mcp-extended"]

[mcp_servers.youtrack-mcp-extended.env]
YOUTRACK_URL = "https://<ваш-инстанс>.youtrack.cloud"
YOUTRACK_TOKEN = "<постоянный токен perm:…>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "youtrack-mcp-extended": {
      "command": "npx",
      "args": ["@promtior/youtrack-mcp-extended"],
      "env": {
        "YOUTRACK_URL": "https://<ваш-инстанс>.youtrack.cloud",
        "YOUTRACK_TOKEN": "<постоянный токен perm:…>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "youtrack-mcp-extended": {
      "type": "stdio",
      "command": "npx",
      "args": ["@promtior/youtrack-mcp-extended"],
      "env": {
        "YOUTRACK_URL": "https://<ваш-инстанс>.youtrack.cloud",
        "YOUTRACK_TOKEN": "<постоянный токен perm:…>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "youtrack-mcp-extended": {
      "command": "npx",
      "args": ["@promtior/youtrack-mcp-extended"],
      "env": {
        "YOUTRACK_URL": "https://<ваш-инстанс>.youtrack.cloud",
        "YOUTRACK_TOKEN": "<постоянный токен perm:…>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "youtrack-mcp-extended": {
      "command": "npx",
      "args": ["@promtior/youtrack-mcp-extended"],
      "env": {
        "YOUTRACK_URL": "https://<ваш-инстанс>.youtrack.cloud",
        "YOUTRACK_TOKEN": "<постоянный токен perm:…>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "youtrack-mcp-extended": {
        "type": "local",
        "command": ["npx", "@promtior/youtrack-mcp-extended"],
        "environment": {
          "YOUTRACK_URL": "https://<ваш-инстанс>.youtrack.cloud",
          "YOUTRACK_TOKEN": "<постоянный токен perm:…>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "youtrack-mcp-extended": {
      "command": "npx",
      "args": ["@promtior/youtrack-mcp-extended"],
      "env": {
        "YOUTRACK_URL": "https://<ваш-инстанс>.youtrack.cloud",
        "YOUTRACK_TOKEN": "<постоянный токен perm:…>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "youtrack-mcp-extended": {
      "command": "npx",
      "args": ["@promtior/youtrack-mcp-extended"],
      "env": {
        "YOUTRACK_URL": "https://<ваш-инстанс>.youtrack.cloud",
        "YOUTRACK_TOKEN": "<постоянный токен perm:…>"
      }
    }
  }
}

Инструменты сервера

search_issuesищет задачи по запросу YouTrack

create_issueсоздаёт задачу

update_issueменяет заголовок и описание

delete_issueудаляет задачу

move_issue_to_projectпереносит задачу в другой проект

apply_commandприменяет команду YouTrack к задачам

add_issue_commentпишет комментарий

log_workсписывает время

get_all_work_itemsвыгружает списания времени

link_issuesсвязывает задачи

upload_issue_attachmentзагружает вложение

get_issue_activitiesчитает историю задачи

get_issue_vcs_changesпоказывает связанные коммиты

manage_issue_tagsставит и снимает теги

create_saved_queryсохраняет поисковый запрос

create_agile_boardсоздаёт доску Agile

create_sprintсоздаёт спринт

create_projectсоздаёт проект

get_agile_boardsперечисляет доски Agile

Показано 19 из 70.

Упор на учёт времени: списание за период без выходных и праздников, отчёты об отклонениях от нормы часов, пакетные операции до 50 задач; есть README на русском.

Как подключить

Что сделать до подключения

Node.js 22 или новее

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

YOUTRACK_TOKEN

постоянный токен YouTrack с правом чтения задач и work items

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'YOUTRACK_URL=https://<адрес вашего YouTrack>' --env 'YOUTRACK_TOKEN=<постоянный токен perm:…>' --transport stdio youtrack-mcp \
  -- npx -y @vitalyostanin/youtrack-mcp@latest

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.youtrack-mcp]
command = "npx"
args = ["-y", "@vitalyostanin/youtrack-mcp@latest"]

[mcp_servers.youtrack-mcp.env]
YOUTRACK_URL = "https://<адрес вашего YouTrack>"
YOUTRACK_TOKEN = "<постоянный токен perm:…>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "youtrack-mcp": {
      "command": "npx",
      "args": ["-y", "@vitalyostanin/youtrack-mcp@latest"],
      "env": {
        "YOUTRACK_URL": "https://<адрес вашего YouTrack>",
        "YOUTRACK_TOKEN": "<постоянный токен perm:…>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "youtrack-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@vitalyostanin/youtrack-mcp@latest"],
      "env": {
        "YOUTRACK_URL": "https://<адрес вашего YouTrack>",
        "YOUTRACK_TOKEN": "<постоянный токен perm:…>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "youtrack-mcp": {
      "command": "npx",
      "args": ["-y", "@vitalyostanin/youtrack-mcp@latest"],
      "env": {
        "YOUTRACK_URL": "https://<адрес вашего YouTrack>",
        "YOUTRACK_TOKEN": "<постоянный токен perm:…>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "youtrack-mcp": {
      "command": "npx",
      "args": ["-y", "@vitalyostanin/youtrack-mcp@latest"],
      "env": {
        "YOUTRACK_URL": "https://<адрес вашего YouTrack>",
        "YOUTRACK_TOKEN": "<постоянный токен perm:…>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "youtrack-mcp": {
        "type": "local",
        "command": ["npx", "-y", "@vitalyostanin/youtrack-mcp@latest"],
        "environment": {
          "YOUTRACK_URL": "https://<адрес вашего YouTrack>",
          "YOUTRACK_TOKEN": "<постоянный токен perm:…>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "youtrack-mcp": {
      "command": "npx",
      "args": ["-y", "@vitalyostanin/youtrack-mcp@latest"],
      "env": {
        "YOUTRACK_URL": "https://<адрес вашего YouTrack>",
        "YOUTRACK_TOKEN": "<постоянный токен perm:…>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "youtrack-mcp": {
      "command": "npx",
      "args": ["-y", "@vitalyostanin/youtrack-mcp@latest"],
      "env": {
        "YOUTRACK_URL": "https://<адрес вашего YouTrack>",
        "YOUTRACK_TOKEN": "<постоянный токен perm:…>"
      }
    }
  }
}

Инструменты сервера

issues_searchищет задачи по тексту

issue_detailsчитает задачу целиком

issue_createсоздаёт задачу

issue_change_stateдвигает задачу по воркфлоу

issue_assignназначает исполнителя

issue_comment_createпишет комментарий

issue_attachment_uploadзагружает до 10 файлов

issue_starпомечает задачу звёздочкой

workitem_createсписывает время

workitems_create_periodсписывает время за период

workitems_report_summaryстроит сводку по времени

workitems_report_invalidнаходит дни с недоработкой

users_activityпоказывает активность сотрудника

article_createсоздаёт статью базы знаний

articles_searchищет по базе знаний

Показано 15 из 59.

Что попросить агента

«Покажи незакрытые задачи проекта <код проекта>»YouTrack MCP вызовет search_issues с запросом project: <код> #Unresolved

«Заведи баг в <проект> «<заголовок>» на <логин>»Агент вызовет create_issue с типом Bug и исполнителем

«Переведи <ID задачи> в In Progress и поставь оценку 4 часа»YouTrack MCP вызовет update_issue_state и update_issue_estimation

«Спиши по 8 часов на <ID задачи> за прошлую неделю без выходных»Сервер VitalyOstanin вызовет workitems_create_period с excludeWeekends

«Создай спринт «<название>» на доске <доска> с датами»YouTrack MCP Extended вызовет get_agile_boards и create_sprint

Для каких задач

Найти незакрытые задачи проекта запросом YouTrack и открыть нужную

Завести баг с исполнителем и типом или подзадачу к родительской задаче

Перевести задачу в другой статус, сменить приоритет и оценку

Списать время по задаче за неделю без выходных и праздников и построить отчёт

Создать спринт на доске Agile и сохранить поисковый запрос

Написать и найти статью в базе знаний YouTrack

Ограничения

Все три сервера сторонние; встроенный MCP от JetBrains есть только в YouTrack 2025.3 и новее

У YouTrack MCP Extended 11 звёзд на GitHub, у сервера VitalyOstanin — 6

YouTrack MCP Extended не удаляет доски Agile и спринты: REST API YouTrack этого не умеет, удалять приходится в интерфейсе

Встроенные воркфлоу JetBrains могут ронять создание и перенос задач с ошибкой 500 Workflow runtime error

Если не работает

Контейнер Docker сразу завершается

Для stdio нужен флаг -i в docker run. Переменные YOUTRACK_URL и YOUTRACK_API_TOKEN передавайте через -e в args: блок env клиента Docker не видит.

В Docker Compose сервер запускается и тут же останавливается

Compose не подключает клиента к stdin: включите TRANSPORT: streamable-http, откройте порт 8000 и укажите клиенту http://localhost:8000/mcp.

create_issue или move_issue_to_project отвечают 500 Workflow runtime error

Мешает встроенный воркфлоу JetBrains, например flatten-duplicates-structure: отключите его в Project settings → Workflow и повторите.

get_command_suggestions всегда возвращает пустой ответ

На части инстансов YouTrack Cloud это ограничение прав или тарифа: проверьте права токена или смотрите синтаксис команд в окне команд YouTrack.

Связи задач падают с HTTP 403 у сервера VitalyOstanin

При YOUTRACK_SILENT_COMMANDS=true нужно право Apply Commands Silently: дайте его или верните false.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
YouTrack MCP	tonyzorin	100	локально	токен	16	11 ноября 2026
YouTrack MCP Extended	Promtior	11	локально	токен	70	21 июля 2026
YouTrack MCP Server (VitalyOstanin)	VitalyOstanin	6	локально	токен	59	19 октября 2026

Частые вопросы

Чем эти серверы отличаются от встроенного MCP в YouTrack?

Встроенный сервер JetBrains живёт внутри YouTrack 2025.3 и новее по адресу https://<ваш-инстанс>/mcp. Серверы на этой странице запускаются у вас и ходят в REST API, поэтому работают и со старым YouTrack Server. YouTrack MCP Extended закрывает то, чего во встроенном сервере пока нет: удаление задач, вложения, доски Agile, создание проектов.

Как оставить агенту только чтение?

У YouTrack MCP (tonyzorin) задайте ENABLED_TOOLS=get_issue,search_issues,get_projects: остальные инструменты скроются. Можно и наоборот: DISABLED_TOOLS со списком пишущих инструментов.

Почему не меняется статус задачи?

В YouTrack MCP поля передаются простыми строками: update_issue_state("DEMO-123", "In Progress"). Вложенный объект вида { "name": "In Progress" } не сработает. Если мешает правило воркфлоу, его разберёт diagnose_workflow_restrictions.

Можно ли удалить что-то случайно?

У сервера VitalyOstanin удаление вложений, связей и списаний времени требует в запросе confirmation: true. В YouTrack MCP Extended delete_issue удаляет задачу без возврата.

Работает ли с самоподписанным сертификатом YouTrack Server?

Да, у YouTrack MCP (tonyzorin) задайте YOUTRACK_VERIFY_SSL=false.

Как подключить YouTrack MCP к Claude Code?

Для YouTrack MCP Extended: claude mcp add youtrack-mcp-extended -e YOUTRACK_URL=<адрес> -e YOUTRACK_TOKEN=<токен> -- npx @promtior/youtrack-mcp-extended. Для остальных вариантов откройте вкладку Claude Code в блоке «Как подключить».

Есть ли у YouTrack свой MCP-сервер?

Есть: JetBrains встроила его в YouTrack 2025.3 и новее, Cloud и Server, по адресу https://<ваш-инстанс>/mcp. Сторонние серверы нужны для старых версий и для функций, которых во встроенном пока нет.

Работает ли сервер из России?

Серверы работают на вашем компьютере и обращаются к вашему YouTrack по токену; со своим YouTrack Server внешние сервисы не нужны.

YouTrack MCP: три сервера для задач и учёта времени в Claude и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы