Skip to main content
Glama

IMPORTANT

Проект готовится к публичному выпуску. Локальный 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…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      MCP 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.
      57
      74 npm
      10
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      An unofficial, security-focused MCP server for YouGile REST API, providing policy-controlled tools with read-only defaults and optional direct-write profiles.
      4
      MIT