yougile-api-mcp от trueblackat

yougile-api-mcp

MCP-сервер YouGile без единой зависимости: пятнадцать инструментов, разметка read-only и destructive по MCP-аннотациям

  • 2 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Широкий доступ

Почему такой уровень

  • Может удалять задачи, проекты, доски и колонки через инструменты с меткой destructiveHint
  • Ключ API бессрочный и дает доступ ко всей компании, README прямо предупреждает о риске его утечки
Все причины и проверки
Российский стек

trueblackat/yougile-api-mcp

Установка

Сервисы

Ручная установка

npx github:trueblackat/yougile-api-mcp

Запуск прямо из GitHub без установки.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Может удалять задачи, проекты, доски и колонки через инструменты с меткой destructiveHint
  • Ключ API бессрочный и дает доступ ко всей компании, README прямо предупреждает о риске его утечки

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Весь сервер: один файл на Node.js со встроенным fetch, без единой npm-зависимости. Пятнадцать инструментов начинаются с yougile_map, который дает карту доски с идентификаторами для остальных вызовов, дальше идут стикеры, задачи (список, карточка, создание, изменение с переносом, закрытием или удалением через deleted:true), комментарии, сотрудники и структура (создание и правка проектов, досок, колонок). Каждый инструмент помечен MCP-аннотациями readOnlyHint или destructiveHint, чтобы клиент понимал, что можно вызывать без подтверждения, а что может стереть данные. Сознательно не реализованы приглашение и удаление сотрудников, роли, отделы, настройки компании, API-ключи и вебхуки.

Для кого. Для тех, кто хочет минимальный по коду, но честно размеченный по рискам MCP-сервер YouGile без сторонних зависимостей.

Подходит, если

  • Важно, чтобы сервер физически не мог управлять сотрудниками, ролями и API-ключами компании
  • Нужен сервер без единой npm-зависимости, который легко прочитать целиком
  • Нужна четкая разметка, какие вызовы безопасны, а какие могут стереть данные

Не подходит, если

  • Нужны приглашение сотрудников, роли, отделы, вебхуки или управление API-ключами: этого нет и не будет
  • Нужен полный набор из более чем 40 инструментов, пятнадцати сфокусированных мало

Пример запроса к агенту

Покажи карту доски «Продажи» и перенеси задачу с кодом SALE-12 в колонку «Закрыто»

MCP

Транспорт
stdio
Авторизация
API-ключ

Переменные окружения

YOUGILE_API_KEY обязательная, секрет
Бессрочный ключ API YouGile, наследует права выпустившего его сотрудника.
YOUGILE_BASE_URL
Адрес API, по умолчанию https://yougile.com/api-v2.

Ограничения

Нужен Node.js 18+ (используется встроенный fetch). Ключ API дает доступ ко всей компании, README прямо предупреждает не делиться им в общих чатах и не коммитить в git. Ключ можно получить только через режим --login (логином и паролем), в самом интерфейсе YouGile кнопки выпуска ключа нет.

Как отключить. Удалите запись yougile из конфигурации MCP клиента и, если ключ мог утечь, выпустите новый через --login и удалите старый через API.

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

Можно ли пригласить сотрудника через этот сервер?

Нет, приглашение и удаление сотрудников, роли и настройки компании сознательно не реализованы: ключ и так дает доступ ко всей компании, и такие действия README советует делать в самом интерфейсе YouGile.

Как получить API-ключ, если в интерфейсе YouGile нет такой кнопки?

Через режим node yougile-mcp.mjs --login, который один раз спрашивает email и пароль и выпускает ключ через API.

Чем yougile-api-mcp от trueblackat отличается от других серверов YouGile?

Весь сервер умещается в один файл на Node.js со встроенным fetch, без npm-зависимостей. Пятнадцать инструментов начинаются с yougile_map, который дает карту доски с идентификаторами для остальных вызовов. Инструменты размечены как read-only и destructive по MCP-аннотациям.

Можно ли пригласить сотрудника через сервер и как получить API-ключ?

Приглашение сотрудников в списке инструментов не заявлено, проверьте раздел инструментов в README. API-ключ YouGile создается через запрос авторизации API. Запуск: npx github:trueblackat/yougile-api-mcp. Работает в Claude Code, Claude Desktop и Cursor.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

Продакшен-уровня MCP-сервер для YouGile: 44 инструмента полного CRUD, ресурсы, готовые промпты и два транспорта

MCP-серверШирокий доступ2Звезды репозитория
Российский стек

YouGile MCP без единого инструмента жесткого удаления: самая сильная мутация: обратимое архивирование

MCP-серверРасширенный доступ
Выбор редакции

Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию

MCP-серверШирокий доступ
Российский стек

MCP-сервер на Go для YouGile с 24 инструментами, где изменяющие операции требуют подтверждения и пишутся в журнал аудита

MCP-серверРасширенный доступ
Российский стек

MCP-сервер YouGile на 18 инструментов с ключами сразу на все компании аккаунта и переключением активной компании на лету

MCP-серверРасширенный доступ

Коротко о README

Двуязычный README перечисляет все пятнадцать инструментов с аннотациями безопасности, отдельно объясняет режим --login для выпуска ключа и режим --check для его проверки, дает большой раздел об особенностях API YouGile (HTML вместо markdown, миллисекундные дедлайны, лимит 50 запросов в минуту, устаревший GET /tasks) и завершается инструкциями для Claude Code и других JSON-клиентов.

Бейдж для README

Сообщить о проблеме