YouGile MCP: три сервера и подключение к Claude, Cursor и ChatGPT

nebelov/yougile-mcp· Проверено 12.11.2026· 10на GitHub

Даёт агенту доступ к YouGile по API-ключу компании: проекты, доски, колонки, задачи и чат задачи. Можно разобрать свои задачи, завести новые и перенести карточки между колонками.

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

Пакет в npm с 57 инструментами на весь API v2, включая стикеры, отделы, роли и вебхуки; ключ и конфиг клиента прописывает команда --setup.

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

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

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

API-ключ YouGile: можно получить командой npx @nebelov/yougile-mcp --setup

YOUGILE_API_KEY

YouGile → Настройки → API или запуск npx @nebelov/yougile-mcp --setup: он войдёт в YouGile и выпустит ключ

YOUGILE_API_HOST_URL

необязательно: свой адрес API вместо https://yougile.com/api-v2

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

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

claude mcp add --env 'YOUGILE_API_KEY=<API-ключ YouGile>' --transport stdio yougile \
  -- npx -y @nebelov/yougile-mcp

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

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

[mcp_servers.yougile]
command = "npx"
args = ["-y", "@nebelov/yougile-mcp"]

[mcp_servers.yougile.env]
YOUGILE_API_KEY = "<API-ключ YouGile>"

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

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

{
  "mcpServers": {
    "yougile": {
      "command": "npx",
      "args": ["-y", "@nebelov/yougile-mcp"],
      "env": {
        "YOUGILE_API_KEY": "<API-ключ YouGile>"
      }
    }
  }
}

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

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

{
  "mcpServers": {
    "yougile": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@nebelov/yougile-mcp"],
      "env": {
        "YOUGILE_API_KEY": "<API-ключ YouGile>"
      }
    }
  }
}

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

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

{
  "mcpServers": {
    "yougile": {
      "command": "npx",
      "args": ["-y", "@nebelov/yougile-mcp"],
      "env": {
        "YOUGILE_API_KEY": "<API-ключ YouGile>"
      }
    }
  }
}

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

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

{
  "mcpServers": {
    "yougile": {
      "command": "npx",
      "args": ["-y", "@nebelov/yougile-mcp"],
      "env": {
        "YOUGILE_API_KEY": "<API-ключ YouGile>"
      }
    }
  }
}

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

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

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "yougile": {
        "type": "local",
        "command": ["npx", "-y", "@nebelov/yougile-mcp"],
        "environment": {
          "YOUGILE_API_KEY": "<API-ключ YouGile>"
        }
      }
    }
  }
}

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

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

{
  "mcpServers": {
    "yougile": {
      "command": "npx",
      "args": ["-y", "@nebelov/yougile-mcp"],
      "env": {
        "YOUGILE_API_KEY": "<API-ключ YouGile>"
      }
    }
  }
}

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

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

{
  "mcpServers": {
    "yougile": {
      "command": "npx",
      "args": ["-y", "@nebelov/yougile-mcp"],
      "env": {
        "YOUGILE_API_KEY": "<API-ключ YouGile>"
      }
    }
  }
}

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

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

yougile_list_projectsвыводит список проектов

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

yougile_list_boardsвыводит доски

yougile_create_boardсоздаёт доску

yougile_list_columnsвыводит колонки доски

yougile_create_columnсоздаёт колонку

yougile_list_tasksищет задачи по фильтрам

yougile_get_taskчитает задачу

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

yougile_update_taskменяет задачу

yougile_set_chat_subscribersзадаёт подписчиков чата задачи

yougile_list_messagesчитает сообщения чата

yougile_send_messageпишет сообщение в чат

yougile_list_group_chatsвыводит групповые чаты

yougile_list_usersвыводит сотрудников

yougile_invite_userприглашает сотрудника

yougile_list_string_stickersвыводит строковые стикеры

yougile_create_string_sticker_stateдобавляет состояние стикера

Показано 18 из 57.

30 инструментов на основные сущности: задачи, доски, колонки, пользователи и чат задачи; ищет задачу по коду вроде SAI-515 и собирает все задачи сотрудника по проектам.

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

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

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

Склонировать репозиторий, выполнить npm install и npm run build

API-ключ компании YouGile

YOUGILE_API_KEY

в YouGile нажмите Ctrl + ~ или шестерёнку у названия компании → «Настроить», в настройках API создайте или скопируйте ключ

YOUGILE_USER_ID

необязательно: сотрудник по умолчанию для списка «мои задачи»

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

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

claude mcp add --env 'YOUGILE_API_KEY=<API-ключ YouGile>' --transport stdio yougile-mcp \
  -- node /path/to/yougile-mcp/yougile.cjs

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

[mcp_servers.yougile-mcp]
command = "node"
args = ["/path/to/yougile-mcp/yougile.cjs"]

[mcp_servers.yougile-mcp.env]
YOUGILE_API_KEY = "<API-ключ YouGile>"

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

{
  "mcpServers": {
    "yougile-mcp": {
      "command": "node",
      "args": ["/path/to/yougile-mcp/yougile.cjs"],
      "env": {
        "YOUGILE_API_KEY": "<API-ключ YouGile>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "yougile-mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/yougile-mcp/yougile.cjs"],
      "env": {
        "YOUGILE_API_KEY": "<API-ключ YouGile>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "yougile-mcp": {
      "command": "node",
      "args": ["/path/to/yougile-mcp/yougile.cjs"],
      "env": {
        "YOUGILE_API_KEY": "<API-ключ YouGile>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "yougile-mcp": {
      "command": "node",
      "args": ["/path/to/yougile-mcp/yougile.cjs"],
      "env": {
        "YOUGILE_API_KEY": "<API-ключ YouGile>"
      }
    }
  }
}

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

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "yougile-mcp": {
        "type": "local",
        "command": ["node", "/path/to/yougile-mcp/yougile.cjs"],
        "environment": {
          "YOUGILE_API_KEY": "<API-ключ YouGile>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "yougile-mcp": {
      "command": "node",
      "args": ["/path/to/yougile-mcp/yougile.cjs"],
      "env": {
        "YOUGILE_API_KEY": "<API-ключ YouGile>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "yougile-mcp": {
      "command": "node",
      "args": ["/path/to/yougile-mcp/yougile.cjs"],
      "env": {
        "YOUGILE_API_KEY": "<API-ключ YouGile>"
      }
    }
  }
}

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

get_meпоказывает владельца ключа

get_usersвыводит сотрудников компании

create_userприглашает сотрудника

get_projectsвыводит проекты

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

get_tasksищет задачи по колонке или исполнителю

get_user_tasksсобирает все задачи сотрудника

get_taskчитает задачу по ID или коду

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

update_taskменяет задачу, закрывает или архивирует

get_boardsвыводит доски

create_boardсоздаёт доску

get_columnsвыводит колонки доски

create_columnсоздаёт колонку

get_task_chatчитает чат задачи

send_task_messageпишет комментарий в чат задачи

Показано 16 из 30.

Сервер с упором на безопасность: по умолчанию только чтение, запись идёт через отдельный профиль и пробный прогон, ключ хранится вне конфига клиента; есть мастер настройки в браузере.

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

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

Node.js 20 или новее и pnpm 11, либо скрипт scripts/bootstrap.sh (на Windows scripts/bootstrap.ps1), который скачает их в папку проекта

Собрать проект: pnpm install --frozen-lockfile и pnpm run build

Создать config.local.yaml: скопировать config.example.yaml или запустить мастер node dist/cli.js setup

YOUGILE_ACME_API_KEY

ключ передаётся только через переменную окружения, защищённый файл или HashiCorp Vault; имя переменной задаётся в config.local.yaml, мастер setup выпускает ключ сам

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

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

claude mcp add --transport stdio yougile-mcp \
  -- node /absolute/path/to/yougile-mcp/dist/cli.js --config /absolute/path/to/config.local.yaml --transport stdio

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

[mcp_servers.yougile-mcp]
command = "node"
args = ["/absolute/path/to/yougile-mcp/dist/cli.js", "--config", "/absolute/path/to/config.local.yaml", "--transport", "stdio"]

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

{
  "mcpServers": {
    "yougile-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/yougile-mcp/dist/cli.js",
        "--config",
        "/absolute/path/to/config.local.yaml",
        "--transport",
        "stdio"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "yougile-mcp": {
      "type": "stdio",
      "command": "node",
      "args": [
        "/absolute/path/to/yougile-mcp/dist/cli.js",
        "--config",
        "/absolute/path/to/config.local.yaml",
        "--transport",
        "stdio"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "yougile-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/yougile-mcp/dist/cli.js",
        "--config",
        "/absolute/path/to/config.local.yaml",
        "--transport",
        "stdio"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "yougile-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/yougile-mcp/dist/cli.js",
        "--config",
        "/absolute/path/to/config.local.yaml",
        "--transport",
        "stdio"
      ]
    }
  }
}

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

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "yougile-mcp": {
        "type": "local",
        "command": [
          "node",
          "/absolute/path/to/yougile-mcp/dist/cli.js",
          "--config",
          "/absolute/path/to/config.local.yaml",
          "--transport",
          "stdio"
        ]
      }
    }
  }
}

{
  "mcpServers": {
    "yougile-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/yougile-mcp/dist/cli.js",
        "--config",
        "/absolute/path/to/config.local.yaml",
        "--transport",
        "stdio"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "yougile-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/yougile-mcp/dist/cli.js",
        "--config",
        "/absolute/path/to/config.local.yaml",
        "--transport",
        "stdio"
      ]
    }
  }
}

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

yougile_users_meпоказывает владельца ключа

yougile_users_listвыводит сотрудников

yougile_tasks_listвыводит задачи по фильтрам

yougile_tasks_getчитает задачу

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

yougile_tasks_updateменяет задачу

yougile_tasks_moveпереносит задачу в колонку

yougile_tasks_bulk_updateменяет до 50 задач разом

yougile_chat_messages_listчитает сообщения чата

yougile_chat_messages_sendпишет сообщение в чат

yougile_analytics_task_countsсчитает задачи

yougile_analytics_overdue_tasksнаходит просроченные задачи

yougile_files_uploadзагружает файл после проверки

yougile_health_checkпроверяет связь с API

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

«Создай проект «<название>» с доской, колонками «Бэклог», «В работе», «Готово» и задачами из этого списка: <список>»nebelov вызовет yougile_create_project, yougile_create_board, yougile_create_column и yougile_create_task

«Покажи все мои открытые задачи по всем проектам»ichinya определит владельца ключа через get_me и соберёт задачи через get_user_tasks

«Перенеси задачу <код> в колонку «Готово» и напиши в её чат, что сделано»Агент найдёт колонку через get_columns, обновит задачу update_task и оставит комментарий send_task_message

«Сколько задач просрочено в компании?»cvtmysxul посчитает через yougile_analytics_overdue_tasks и yougile_analytics_task_counts

«Добавь стикеру «<стикер>» состояние «<значение>»»nebelov найдёт стикер через yougile_list_string_stickers и добавит состояние yougile_create_string_sticker_state

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

Собрать все задачи сотрудника по всем проектам

Развернуть новый проект с досками, колонками и задачами

Перенести задачу в другую колонку или закрыть её

Прочитать обсуждение в чате задачи и оставить комментарий

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

Настроить стикеры, отделы и вебхуки компании

Ограничения

Все три сервера сторонние и с малым числом звёзд на GitHub: 10, 19 и 4

Сервер ichinya покрывает около 40% API: нет стикеров, вебхуков, файлов и удаления задач, досок и колонок

У nebelov сообщения в чате нельзя отредактировать, только удалить; удаление большинства сущностей мягкое, через отметку deleted

Сервер cvtmysxul требует сборки и YAML-конфига; запись выключена по умолчанию и идёт пробным прогоном, пока профиль её не разрешит

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

Ошибка «MCP error -32000: Connection closed» при работе в разных проектах

Укажите в конфиге клиента файл yougile.cjs вместо yougile.js и перезапустите клиент после правки.

get_tasks не фильтрует по projectId

API YouGile не поддерживает этот фильтр: ищите по columnId или assignedTo, а все задачи сотрудника собирайте через get_user_tasks.

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

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
@nebelov/yougile-mcp	nebelov	10	локально	токен	57	31 октября 2026
Yougile MCP Server	ichinya	19	локально	токен	30	3 ноября 2026
YouGile MCP	cvtmysxul	4	локально	токен	14	21 июля 2026

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

Какой сервер выбрать?

Быстрее всего подключить @nebelov/yougile-mcp: он ставится через npx и закрывает весь API, включая стикеры и вебхуки. Сервер ichinya проще и ищет задачи по коду. cvtmysxul подойдёт, если агенту нужен только просмотр и важен контроль записи.

Где взять API-ключ YouGile?

Откройте в YouGile настройки компании клавишами Ctrl + ~ или через шестерёнку у названия компании и создайте ключ в разделе API. У nebelov ключ выпускает команда npx @nebelov/yougile-mcp --setup.

Агент сможет удалять задачи?

У nebelov задача удаляется через отметку deleted в yougile_update_task. У ichinya удаления задач, досок и колонок нет. У cvtmysxul запись по умолчанию выключена.

Как найти задачу по номеру?

У сервера ichinya get_task принимает и UUID, и код задачи вида SAI-515.

Как подключить YouGile MCP к ChatGPT?

У nebelov в ChatGPT включите Developer Mode в Settings → Apps & Connectors → Advanced, нажмите Create и вставьте https://you-mcp.com/mcp, затем войдите по email и паролю YouGile. Можно поднять свой сервер с флагом --http --port 3000 и открыть его наружу через ngrok.

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

Добавьте в ~/.claude.json сервер с командой npx -y @nebelov/yougile-mcp и переменной YOUGILE_API_KEY или выполните npx @nebelov/yougile-mcp --setup. Готовые команды есть во вкладке Claude Code в блоке «Как подключить».

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

Серверы работают на вашем компьютере и обращаются к API yougile.com по ключу вашей компании; для своего сервера YouGile адрес API меняется переменной YOUGILE_API_HOST_URL.

YouGile MCP: три сервера и подключение к Claude, Cursor и ChatGPT

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ограничения

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

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

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

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