YouGile MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Проект готовится к публичному выпуску. Локальный stdio и приватный OAuth-сервер на Streamable HTTP реализованы. Публичное HTTPS-развёртывание и сквозные проверки с конкретными AI-клиентами ещё продолжаются. Готового общедоступного адреса подключения пока нет.
Возможности
Рабочее пространство
Проекты, доски и колонки: чтение и изменение структуры рабочего пространства через официальный REST API.
Задачи: поиск, просмотр, создание и изменение задач и связанных данных.
Команда и коммуникации
Пользователи, роли и отделы: доступ к поддерживаемым данным о сотрудниках и структуре компании.
Чаты и сообщения: операции с групповыми чатами и сообщениями YouGile.
Интеграции и администрирование
CRM, файлы и вебхуки: поддерживаемые операции CRM, загрузка вложений, управление вебхуками.
Управление доступом к MCP: подключения сотрудников, блокировки, отзыв доступа, отдельная панель оператора хостинга.
Сервер регистрирует 72 прямых MCP-инструмента, соответствующих официальным операциям YouGile REST API v2. Это не 72 готовых высокоуровневых AI-сценария: составные действия и специализированные агентские инструменты развиваются отдельно.
Наличие инструмента в каталоге не гарантирует его выполнение. Права пользователя, политики сервера и обязательные подтверждения проверяются при каждом вызове. Операции, которым необходим отсутствующий серверный механизм подтверждения или работы с секретами, блокируются.
Подробнее: архитектура · проверки REST API · происхождение контракта.
Related MCP server: yougile-mcp
Подключение
Выберите способ подключения в зависимости от того, где работает ваш AI-клиент.
Удалённый сервер · Streamable HTTP + OAuth
Для ChatGPT, Codex, Claude, Cursor и VS Code. Пользователь входит через свою учётную запись YouGile и выбирает компанию. Пример адреса после собственного проверенного развёртывания:
https://YOUR-HOST.example/mcp
Инструкции по клиентам
ChatGPT · Codex CLI / IDE · Claude Code · Claude Web / Desktop · Cursor · VS Code / GitHub Copilot
Адрес выше приведён только для примера. Текущие Dockerfile и Compose не публикуют MCP наружу.
Локальный сервер · stdio
Для агентов, запускающих MCP-процесс на своём компьютере. Использует API-ключ YouGile, ID компании и отдельный защищённый файл идентичности агента.
Пошаговая установка локального stdio →
Сравнение способов подключения, требования к OAuth и типовые ошибки: руководство по AI-клиентам.
Быстрый старт
Нужны Python 3.11+ и uv.
git clone https://github.com/amonrapmon/yougile-mcp.git
cd yougile-mcp
uv sync --locked --all-extras
uv run --locked yougile-mcp doctorКоманда doctor проверяет конфигурацию офлайн и не подключается к YouGile. Для запуска рабочего локального MCP настройте идентичность и учётные данные согласно инструкции stdio.
uv run --locked python scripts/check_catalog.py
uv run --locked python -m unittest discover -s tests -v
uv run --locked ruff check .Полный набор проверок, включая контракты агентов, описан в AGENTS.md.
Архитектура
flowchart LR
L["Локальные AI-агенты"] --> S["stdio"]
R["Удалённые AI-клиенты"] --> H["Streamable HTTP + OAuth"]
subgraph MCP["YouGile MCP"]
S --> T["Реестр инструментов"]
H --> T
T --> P["Права · политики · валидация"]
P --> C["Единый API-клиент"]
end
C --> Y["YouGile REST API v2"]Оба транспорта используют общий реестр инструментов и единый API-клиент. При обращении проверяются идентичность пользователя, компания, права и принадлежность ресурсов. Ошибки нормализуются, секреты не передаются в ответы инструментов.
В серверном режиме OAuth привязан к личной учётной записи YouGile. Доступ предоставляется в пределах полномочий пользователя; настройка OAuth-прав по отдельным проектам пока не реализована. PostgreSQL и Valkey используются для хранения состояния авторизации и подключений. Панель администратора компании отделена от панели оператора хостинга.
Подробнее об архитектуре и ограничениях →
Документация
Подключение и эксплуатация
AI-клиенты · Локальный stdio · Архитектура
Самостоятельное серверное развёртывание (pre-release)
Docker Compose · Traefik на DE · Cloudflare Tunnel
Публикация сервера требует проверки OAuth с AI-клиентом, ограничений запросов и резервного восстановления.
Возможности и проверки
Отчёт о live-проверках API · Проверка администрирования · План развития
Разработка и лицензирование
Contributing · Правила для агентов · Контракты · Provenance
Исходный код распространяется по лицензии GNU AGPL-3.0-only. Адаптированные компоненты Indalo сохраняют уведомления об авторстве. Лицензирование сторонних компонентов и статус распространения снимка OpenAPI описаны в PROVENANCE.md.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Minimal issue tracker: projects, objectives and trackable plans, written by agents over MCP.
Agent-native notes, tasks, dev-docs, vaults, sync & handoffs. MCP + OpenAPI dual surface.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Task & board management for AI agents + humans. Kanban, comments, digests via MCP.
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for YouGile project management. Provides 57 tools covering 100% of YouGile API v2, enabling natural language management of projects, boards, columns, tasks, chats, users, and more.5774 npm10MIT
- AlicenseBqualityCmaintenanceMCP server that exposes YouGile projects, boards, columns, tasks, and task chat as tools for agents to watch and manage tasks.1714 npmMIT
- AlicenseNot gradedqualityCmaintenanceAn unofficial, security-focused MCP server for YouGile REST API, providing policy-controlled tools with read-only defaults and optional direct-write profiles.4MIT
- AlicenseAqualityDmaintenanceMCP server for YouGile project management. Provides 57 tools covering 100% of the YouGile API v2, enabling AI agents to manage projects, boards, tasks, and chat directly through natural language.57MIT