YouGile MCP Server

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

🚀 Что умеет

Управление проектами

✅ Создание и редактирование проектов
✅ Управление досками и колонками
✅ Работа с задачами (создание, обновление, комментарии)
✅ Управление командой (приглашения, роли)
✅ Отчеты и аналитика по проектам

Интеграция с AI помощниками

✅ Автоматическое создание задач из разговора
✅ Умные отчеты по проектам
✅ Планирование спринтов
✅ Анализ продуктивности команды

📦 Установка

1. Скачайте проект

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

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

python -m venv venv
source venv/bin/activate  # На Windows: venv\Scripts\activate

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

pip install -r requirements.txt

4. Получите данные YouGile

Найдите свой email и пароль YouGile - те же, что используете для входа на сайт.

Получите ID компании:

Войдите в YouGile
Нажмите Ctrl + ~ для открытия конфигуратора
Перейдите во вкладку "Навигатор по объектам" справа
Нажмите на иконку информации (ℹ️) справа от названия вашей компании
Скопируйте ID компании из открывшегося окна

5. Подключите к AI помощнику

Для Claude Desktop:

Добавьте в конфигурацию Claude Desktop:

{
  "mcpServers": {
    "yougile": {
      "command": "python",
      "args": ["/полный/путь/к/папке/yougile-mcp/run_server.py"],
      "cwd": "/полный/путь/к/папке/yougile-mcp",
      "env": {
        "PATH": "/полный/путь/к/папке/yougile-mcp/venv/bin:$PATH",
        "YOUGILE_BASE_URL": "https://yougile.com",
        "YOUGILE_EMAIL": "ваш-email@yougile.com",
        "YOUGILE_PASSWORD": "ваш-пароль",
        "YOUGILE_COMPANY_ID": "ваш-company-id"
      }
    }
  }
}

Для других MCP-совместимых AI:

Используйте аналогичную конфигурацию для Continue, Cline и других MCP-совместимых помощников.

🎯 Как использовать с AI помощником

После подключения можно просить AI помощника:

Управление задачами

"Создай задачу 'Исправить баг с авторизацией' в проекте Мобильное приложение"
"Покажи все мои задачи на сегодня"
"Обнови статус задачи на 'В работе'"

Работа с проектами

"Создай новый проект 'Редизайн сайта'"
"Покажи статистику по проекту за неделю"
"Добавь пользователя ivan@company.com в проект"

Отчеты и планирование

"Сделай отчет по продуктивности команды"
"Спланируй спринт на 2 недели"
"Покажи, какие задачи просрочены"

⚙️ Диагностика проблем

Проверка работы сервера

# Убедитесь что виртуальное окружение активировано
source venv/bin/activate  # На Windows: venv\Scripts\activate

python run_server.py

Сервер должен запуститься и подключиться к YouGile автоматически.

Частые ошибки

"No module named 'mcp'" - не активировано виртуальное окружение. Выполните source venv/bin/activate

"No module named 'src'" - запускайте через python run_server.py, не напрямую src/server.py

"HTTP 401" - неверные данные для входа в YouGile

"HTTP 403" - нет доступа к компании

Получение помощи

Если что-то не работает:

Проверьте, что можете войти в YouGile через браузер с теми же данными
Убедитесь, что Company ID правильный (см. инструкцию выше)
Попробуйте запустить python run_server.py напрямую и посмотрите на вывод

👨‍💻 Автор

Проект разработан HeadWise - Даниил Тарасенко

📄 Лицензия

Этот проект является открытым программным обеспечением.

yougile-mcp