yougile

YouGile MCP Server позволяет интегрировать YouGile с MCP-совместимыми AI помощниками (например Claude Desktop, Continue, Cline и др.). Сервер принимает команды через MCP протокол и выполняет управление задачами, проектами и командой в YouGile, а также формирует отчеты и помогает в планировании спринтов. Подключение осуществляется через конфигурацию на стороне помощника, где задаются путь к серверу, рабочий каталог и переменные окружения, включая данные доступа к YouGile. После подключения AI сможет создавать задачи, обновлять статусы, инициировать планирование спринтов и получать отчеты по проектам.

Как использовать: после запуска сервера вы можете просить AI: создавать задачи и проекты, управлять досками и колонками, добавлять пользователей в проекты, формировать отчеты и планы. Помощник будет использовать команды MCP для взаимодействия с YouGile через запрашиваемый вами контекст (проект, задача, статус и т. д.).

prerequisites:

• Python 3.8+ установлен на вашей системе
• Git установлен
• Виртуальное окружение (venv) поддержано вашей ОС

шаги:

1. Склонируйте репозиторий и перейдите в папку проекта:

git clone https://github.com/justrussian/yougile-mcp.git
cd yougile-mcp

2. Создайте и активируйте виртуальное окружение:

python -m venv venv

# macOS/Linux
source venv/bin/activate

# Windows
venv\Scripts\activate

3. Установите зависимости:

pip install -r requirements.txt

4. Подготовьте данные YouGile (email, пароль и Company ID) как описано в инструкции README (поместите в переменные окружения для конфигурации MCP).
5. Запустите сервер локально:

python run_server.py

6. Подключите MCP клиент (AI помощника) с настройками в секции mcpServers вышего конфига, указав путь к run_server.py, активированное виртуальное окружение и необходимые переменные окружения.

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

Советы и распространенные проблемы:

• Убедитесь, что активировано виртуальное окружение перед запуском: source venv/bin/activate (или активируйте через соответствующий способ на Windows).
• Используйте python run_server.py напрямую, а не запуск src/server.py, чтобы избежать ошибок импорта.
• HTTP 401 означает неверные учетные данные YouGile; перепроверьте email/пароль и Company ID.
• HTTP 403 может означать недостаточные разрешения доступа к компании — проверьте права пользователя в YouGile.
• При изменении конфигурации перезапустите MCP сервер, чтобы новые параметры вступили в силу.