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 компании:

1. Войдите в YouGile
2. Нажмите Ctrl + ~ для открытия конфигуратора
3. Перейдите во вкладку "Навигатор по объектам" справа
4. Нажмите на иконку информации (ℹ️) справа от названия вашей компании
5. Скопируйте 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" - нет доступа к компании

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

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

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

👨‍💻 Автор

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

📄 Лицензия

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