YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- По умолчанию роль admin дает полный доступ ко всему API, включая сотрудников, проекты и вебхуки
- Права сужают только то, что уже позволено ключу в YouGile, не заменяют встроенную защиту сервиса
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/indalo-tech-yougile-mcpОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport stdio --env 'YOUGILE_API_KEY=<ваш YOUGILE_API_KEY>' yougile -- uvx yougile-mcpИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"yougile": {
"command": "uvx",
"args": [
"yougile-mcp"
],
"env": {
"YOUGILE_API_KEY": "<ваш YOUGILE_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
YOUGILE_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"yougile": {
"command": "uvx",
"args": [
"yougile-mcp"
],
"env": {
"YOUGILE_API_KEY": "<ваш YOUGILE_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
YOUGILE_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
code --add-mcp '{"name":"yougile","type":"stdio","command":"uvx","args":["yougile-mcp"],"env":{"YOUGILE_API_KEY":"<ваш YOUGILE_API_KEY>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"yougile": {
"type": "stdio",
"command": "uvx",
"args": [
"yougile-mcp"
],
"env": {
"YOUGILE_API_KEY": "<ваш YOUGILE_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
YOUGILE_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add yougile --env 'YOUGILE_API_KEY=<ваш YOUGILE_API_KEY>' -- uvx yougile-mcpИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.yougile]
command = "uvx"
args = ["yougile-mcp"]
env = { YOUGILE_API_KEY = "<ваш YOUGILE_API_KEY>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
YOUGILE_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
gemini mcp add -s user -e 'YOUGILE_API_KEY=<ваш YOUGILE_API_KEY>' yougile uvx yougile-mcpИли добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"yougile": {
"command": "uvx",
"args": [
"yougile-mcp"
],
"env": {
"YOUGILE_API_KEY": "<ваш YOUGILE_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
YOUGILE_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"yougile": {
"command": "uvx",
"args": [
"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": "uvx",
"args": [
"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": "uvx",
"args": [
"yougile-mcp"
],
"env": {
"YOUGILE_API_KEY": "<ваш YOUGILE_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
YOUGILE_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"yougile": {
"type": "local",
"command": [
"uvx",
"yougile-mcp"
],
"environment": {
"YOUGILE_API_KEY": "<ваш YOUGILE_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
YOUGILE_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"yougile": {
"command": "uvx",
"args": [
"yougile-mcp"
],
"env": {
"YOUGILE_API_KEY": "<ваш YOUGILE_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
YOUGILE_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"yougile": {
"command": "uvx",
"args": [
"yougile-mcp"
],
"env": {
"YOUGILE_API_KEY": "<ваш YOUGILE_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
YOUGILE_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Получи ключ командой uvx yougile-mcp setup, добавь сервер командой claude mcp add yougile --scope user -e YOUGILE_API_KEY=ключ -- uvx yougile-mcp, при необходимости ограничь права файлом .yougile.json с role: reader или member.
Другие способы из описания автора
uvx yougile-mcp setupМастер из README: запрашивает логин и пароль YouGile только для выпуска ключа, ничего не сохраняет, кроме ключа.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Каталог операций сервера собран из официальной OpenAPI-спецификации YouGile, и тесты в CI не дают выпустить версию, где новая операция API осталась бы без инструмента. Задачные инструменты (yougile_overview, yougile_find_tasks, yougile_task, yougile_create_task, yougile_update_task, yougile_move_task, yougile_log_time, yougile_task_chat, yougile_use_board) принимают названия и номера задач вместо UUID. Доменные инструменты покрывают весь API десятью группами: задачи, чаты, доски, колонки, проекты, сотрудники, стикеры, компания, файлы, CRM. Три готовых MCP-промпта (standup, hours_report, triage) собирают отчеты одной командой. Права настраиваются файлом .yougile.json: роль reader/member/admin, список разрешенных проектов, запрет операций по маске, обязательное подтверждение записи в чувствительные проекты. Общий лимит 50 запросов в минуту на компанию Yandex сервер учитывает одним счетчиком на все сессии сразу.
Для кого. Для команд, которым нужен управляемый доступ к YouGile с ролями, подтверждениями и гарантией полного покрытия вместо простой обертки над API.
Подходит, если
- Нужно ограничить агента ролью «только чтение» или конкретными проектами через конфиг
- Важно, чтобы запись в чувствительные проекты требовала подтверждения человеком
- Нужны готовые сценарии: стендап, отчет по часам, разбор очереди задач
Не подходит, если
- Нужен простой сервер с парой инструментов, а не 65 операций с настройкой прав
- Клиент не поддерживает MCP elicitation: без него подтверждения и уточнение неоднозначных названий работают более грубо, через текст ошибки
Пример запроса к агенту
Собери отчет по часам за эту неделю по проекту «Разработка» и покажи перерасходОграничения
По умолчанию роль admin дает полный доступ, включая проекты, сотрудников и вебхуки, ограничить ее нужно явно в .yougile.json. Цепочки колонок Workflow YouGile не отдает через API, их приходится один раз прописать вручную в конфиге. Проверка check тратит 5 запросов из лимита. Настройки прав только сужают то, что уже разрешено ключу в самом YouGile, а не заменяют его права.
Как отключить. Выполните claude mcp remove yougile или удалите запись yougile из конфигурации клиента, при необходимости удалите файлы .yougile.json.
MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| YOUGILE_API_KEY обязательная, секрет | Ключ API YouGile. |
| YOUGILE_BASE_URL | Адрес YouGile, по умолчанию https://ru.yougile.com, для боксовой установки свой. |
| YOUGILE_RATE_LIMIT | Запросов в минуту на ключ, по умолчанию 45. |
Проверка безопасности
- По умолчанию роль admin дает полный доступ ко всему API, включая сотрудников, проекты и вебхуки
- Права сужают только то, что уже позволено ключу в YouGile, не заменяют встроенную защиту сервиса
Коротко о README
Двуязычный README подробно описывает задачные и доменные инструменты, три готовых сценария-промпта, полный формат файла настроек .yougile.json с примером, механизм подтверждения через MCP elicitation и без него, переменные окружения и раздел «как это устроено» про сверку каталога операций со спецификацией в CI.
Частые вопросы
Можно дать агенту только чтение?
Да, задайте role: reader в .yougile.json, тогда запись будет запрещена независимо от прав самого ключа.
Что если клиент не поддерживает подтверждения (elicitation)?
Инструмент вернет confirmation_required с текстом изменения, модель должна показать его пользователю и повторить вызов с confirm=true только после явного согласия.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма
Локальный набор скиллов и только читающий CLI для Codex: превращает свою переписку в WeChat в поиск, дайджесты, напоминания о недоеденном и учет договоренностей