yougile-mcp от Ивана Терешина
yougile-mcp
Продакшен-уровня MCP-сервер для YouGile: 44 инструмента полного CRUD, ресурсы, готовые промпты и два транспорта
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Полный CRUD по всем ресурсам компании: проекты, доски, задачи, пользователи, отделы и вебхуки
- Ключ API дает доступ ко всей компании целиком, сервер не ограничивает права по ролям или проектам
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/ivantereshin-yougile-mcpОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport stdio --env 'YOUGILE_API_KEY=<ваш YOUGILE_API_KEY>' yougile -- npx -y yougile-mcpИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"yougile": {
"command": "npx",
"args": [
"-y",
"yougile-mcp"
],
"env": {
"YOUGILE_API_KEY": "<ваш YOUGILE_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
YOUGILE_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"yougile": {
"command": "npx",
"args": [
"-y",
"yougile-mcp"
],
"env": {
"YOUGILE_API_KEY": "<ваш YOUGILE_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
YOUGILE_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
code --add-mcp '{"name":"yougile","type":"stdio","command":"npx","args":["-y","yougile-mcp"],"env":{"YOUGILE_API_KEY":"<ваш YOUGILE_API_KEY>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"yougile": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"yougile-mcp"
],
"env": {
"YOUGILE_API_KEY": "<ваш YOUGILE_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
YOUGILE_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add yougile --env 'YOUGILE_API_KEY=<ваш YOUGILE_API_KEY>' -- npx -y yougile-mcpИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.yougile]
command = "npx"
args = ["-y", "yougile-mcp"]
env = { YOUGILE_API_KEY = "<ваш YOUGILE_API_KEY>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
YOUGILE_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"yougile": {
"command": "npx",
"args": [
"-y",
"yougile-mcp"
],
"env": {
"YOUGILE_API_KEY": "<ваш YOUGILE_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
YOUGILE_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"yougile": {
"command": "npx",
"args": [
"-y",
"yougile-mcp"
],
"env": {
"YOUGILE_API_KEY": "<ваш YOUGILE_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
YOUGILE_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"yougile": {
"command": "npx",
"args": [
"-y",
"yougile-mcp"
],
"env": {
"YOUGILE_API_KEY": "<ваш YOUGILE_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
YOUGILE_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"yougile": {
"command": "npx",
"args": [
"-y",
"yougile-mcp"
],
"env": {
"YOUGILE_API_KEY": "<ваш YOUGILE_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
YOUGILE_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"yougile": {
"type": "local",
"command": [
"npx",
"-y",
"yougile-mcp"
],
"environment": {
"YOUGILE_API_KEY": "<ваш YOUGILE_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
YOUGILE_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"yougile": {
"command": "npx",
"args": [
"-y",
"yougile-mcp"
],
"env": {
"YOUGILE_API_KEY": "<ваш YOUGILE_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
YOUGILE_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"yougile": {
"command": "npx",
"args": [
"-y",
"yougile-mcp"
],
"env": {
"YOUGILE_API_KEY": "<ваш YOUGILE_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
YOUGILE_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Получи API-ключ в YouGile → Настройки → API, добавь сервер в claude_desktop_config.json с командой npx -y yougile-mcp и переменной YOUGILE_API_KEY.
Другие способы из описания автора
{
"mcpServers": {
"yougile": {
"command": "npx",
"args": ["-y", "yougile-mcp"],
"env": { "YOUGILE_API_KEY": "your-key" }
}
}
}Конфигурация из README для Claude Desktop, для Cursor аналогичная запись в .cursor/mcp.json.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает полный список, получение, создание и обновление (с мягким удалением через update) по всем основным сущностям YouGile: проекты, доски, колонки, задачи, пользователи, отделы, групповые чаты, строковые и спринт-стикеры, вебхуки, плюс чат задачи и данные компании. Поверх инструментов есть MCP-ресурсы yougile://projects, yougile://users и шаблон yougile://board/{boardId}, а также готовые промпты triage_board, create_task_from_note, standup_report и find_stale_tasks. Работает и по stdio, и по Streamable HTTP, с ретраями и учетом 429/Retry-After.
Для кого. Для команд на YouGile, которым нужно полное покрытие API с валидацией, тестами и CI вместо тонкого враппера.
Подходит, если
- Нужен доступ ко всем сущностям YouGile, включая отделы, стикеры и вебхуки
- Важны готовые сценарии вроде триажа доски или отчета к летучке
- Нужен HTTP-транспорт для удаленного развертывания, а не только stdio
Не подходит, если
- Нужен только узкий набор из пары инструментов: 44 инструмента могут быть избыточны
- Не готовы давать агенту доступ на запись во все ресурсы компании: сервер не разделяет права по уровням
Пример запроса к агенту
Проведи триаж доски «Разработка» и покажи задачи без исполнителя или срокаОграничения
Нужен API-ключ YouGile (Настройки → API или POST /auth/keys). Удаление сущностей реализовано мягко, через update, отдельного метода жесткого удаления нет, но это не отменяет того, что update может архивировать или скрыть объект. Ключ дает доступ ко всей компании, разграничения по проектам или ролям сервер не делает.
Как отключить. Удалите запись yougile из claude_desktop_config.json или .cursor/mcp.json, либо отзовите API-ключ в настройках YouGile.
MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| YOUGILE_API_KEY обязательная, секрет | Bearer-токен API YouGile. |
| YOUGILE_BASE_URL | Базовый адрес API, по умолчанию https://yougile.com/api-v2. |
Проверка безопасности
- Полный CRUD по всем ресурсам компании: проекты, доски, задачи, пользователи, отделы и вебхуки
- Ключ API дает доступ ко всей компании целиком, сервер не ограничивает права по ролям или проектам
Коротко о README
Двуязычный README дает сравнительную таблицу с типичной оберткой, таблицу из 44 инструментов по ресурсам, описание ресурсов и промптов, быстрый старт через npx для Claude Desktop и Cursor, таблицу переменных окружения и схему архитектуры исходников.
Частые вопросы
Чем это лучше типичной обертки над YouGile API?
README сравнивает: здесь полное покрытие всех ресурсов, инструменты плюс ресурсы плюс промпты, Zod-валидация каждого инструмента, ретраи и тесты с CI, а не только stdio.
Можно развернуть как удаленный сервер?
Да, есть режим Streamable HTTP: YOUGILE_MCP_TRANSPORT=http, эндпоинт POST /mcp.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма