Интеграция через MCP

Что такое MCP

Model Context Protocol (MCP) — открытый стандарт, позволяющий внешним системам и алгоритмам обращаться к данным. QRetro предоставляет MCP-сервер для доступа к данным ваших ретроспектив из Claude Desktop, Cursor, VS Code и других совместимых клиентов.

Быстрый старт

1. Создайте API-токен

Перейдите в Настройки → API-ключи и создайте новый токен. Скопируйте его — токен показывается только один раз.

2. Настройте клиент

Добавьте MCP-сервер QRetro в конфигурацию вашего клиента.

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "qretro": {
      "url": "https://mcp.qretro.com",
      "headers": {
        "Authorization": "Bearer ВАШ_ТОКЕН"
      }
    }
  }
}

3. Начните работу

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

• «Покажи ретроспективы команды Backend»
• «Какие действия были согласованы в последнем спринте?»
• «Как менялся пульс команды за последние 3 месяца?»
• «Найди все упоминания проблем с деплоем в ретро»

Использование этой документации в MCP‑клиентах

На всех страницах документации есть блок действий в правом верхнем углу:

• Copy page — копирует всю страницу в формате Markdown. Удобно, когда вы хотите «прикрепить» эту документацию к сессии в Claude, Cursor или ChatGPT.
• Copy Markdown link — копирует прямую ссылку на Markdown‑версию страницы (например, https://qretro.com/raw/ru/docs/6.mcp.md), которую можно передать ассистенту в виде запроса «Прочитай эту документацию по MCP и используй её дальше как справочник».
• Open in ChatGPT / Open in Claude — открывают выбранного ассистента с уже подготовленным запросом вида Read https://qretro.com/raw/ru/docs/6.mcp.md so I can ask questions about it..

Рекомендуемый текст для использования документации внутри MCP‑клиента (Claude Desktop, Cursor и т.п.):

Прочитай документацию по MCP‑серверу QRetro здесь:
https://qretro.com/raw/ru/docs/6.mcp.md
Используй её как источник правды о доступных инструментах и их параметрах, когда будешь работать с сервером QRetro.

Доступные инструменты

Все инструменты следуют схеме domain.scope.action. Для QRetro домен — retro.

Инструменты MCP используют имена вида retro.*, например retro.teams.list и retro.boards.list. В MCP‑клиентах используйте только эти имена.

Инструменты записи (требуют scope mcp:write)

Инструменты удаления (требуют scope mcp:delete)

Промпты

QRetro также предоставляет встроенные промпты для структурированного анализа:

• Analyze Retro — глубокий анализ одной ретроспективы: ключевые темы, качество действий, динамика команды
• Team Health — анализ трендов здоровья по нескольким ретроспективам, обнаружение системных рисков и сигналов выгорания

Безопасность

• Токены имеют область mcp:read по умолчанию. Для операций записи используйте токены со scope mcp:write.
• Каждый токен привязан к создавшему его пользователю.
• Вы можете отозвать токен в любой момент в Настройки → API-ключи.

Права на удаление (mcp:delete)

Scope mcp:delete даёт MCP‑клиенту ограниченное право на удаление:

• С mcp:delete клиент может вызывать инструмент retro.board.messages.delete_own и удалять только свои собственные сообщения на досках, к которым у него уже есть доступ.

Дополнительные правила для ассистентов

• Источник прав: при работе с пунктами действий единственным источником прав являются поля can_edit и can_complete в объектах ActionItem (и ответах API). Не выдумывайте свою собственную логику доступов поверх этого.
• Контекст команды: большинство инструментов подразумевают работу в рамках одной команды (Team). Для стабильной работы MCP‑клиентов рекомендуется использовать API‑токен с привязкой к одной команде (Team‑scoped token).
• Цепочки вызовов: перед обновлением или удалением сущностей всегда сначала запрашивайте списки (retro.boards.list, retro.board.actions.list, retro.board.messages.list), чтобы получить актуальные ID.

Сценарии использования (Recipes)

Сценарий A: Анализ здоровья команды (Team Health)

Если пользователь просит «проанализировать состояние команды», следуйте этой цепочке:

1. Вызовите retro.boards.list (убедитесь, что токен привязан к одной команде; при ошибке «Multiple teams available» предложите пользователю создать Team‑scoped токен).
2. Для последних 3–5 досок вызовите retro.board.health.get и retro.board.roti.get.
3. Если health_check возвращает null, не сообщайте об ошибке. Отвечайте: «Опросы здоровья на этой доске ещё не проводились» и продолжайте анализ по доступным данным (карточки, summary, action items).

Примечания к данным и инструментам

Описание некоторых инструментов