Scruma можно подключить к вашему AI-агенту: сервис отдаёт MCP-сервер, и агент — Claude Code, Cursor, любой другой клиент — получает доступ к вашим командам, доскам и задачам. От вашего имени и с вашими правами. Никакого отдельного пароля, никакого «сервисного пользователя»: агент делает ровно то, что можете сделать вы сами, и упирается ровно в те же ограничения.
Дают это подключение две вещи. Первая — разбор результатов: агент читает итоги ретроспектив и помогает сделать из них выводы. Вторая — помощь в ведении встречи: занести карточки, оформить задачи, переключить стадию. Агент здесь помощник, а не автопилот — ретро по-прежнему ведёт команда.
Ниже — как это подключить за пять минут, что агент умеет на самом деле и на чём обычно спотыкаются в первый раз.
Что такое MCP и зачем это на ретро
MCP (Model Context Protocol) — открытый протокол, по которому AI-клиент подключается к внешнему сервису и получает список инструментов: «прочитать доску», «добавить карточку», «завести задачу». Клиент показывает эти инструменты модели, а модель вызывает их, когда они нужны для вашей задачи.
Разбор результатов
Самое ценное начинается после встречи. Итоги ретроспективы — карточки, голоса, отчёт, список action items — лежат в Scruma в структурированном виде, и агент может их прочитать: не одно ретро, а несколько подряд. Дальше работает уже модель, а не сервис: она видит данные и отвечает на вопросы, которые обычно так и остаются незаданными.
- что повторяется от спринта к спринту — одна и та же боль в колонке Stop третий раз подряд;
- что осталось невыполненным — незакрытые задачи прошлых ретро с ответственными и сроками;
- что стоит вынести в план — какие темы набрали голоса, но так и не превратились в задачу.
В диалоге это выглядит буднично: «посмотри последние три ретро команды Platform и скажи, какие темы повторяются», «покажи незакрытые задачи и кто за них отвечает», «собери из отчёта по прошлому ретро список того, что мы обещали».
Важная оговорка: никакой аналитики Scruma за агента не считает. Сервис отдаёт данные через инструменты чтения — выводы делает языковая модель на стороне вашего клиента. Поэтому качество разбора зависит от модели, а не от тарифа.
Помощь в ведении
Вторая половина — рутина вокруг самой встречи, которую иначе делают руками, переключаясь между вкладками:
- перенести в карточки то, что уже лежит в тикетах, инцидентах или в вашем рабочем журнале спринта;
- вытащить незакрытые action items прошлого ретро перед встречей — чтобы начать не с чистого листа, а с проверки обещаний;
- оформить договорённости в задачи с ответственным и сроком, пока команда ещё обсуждает.
И здесь: «добавь в колонку Stop карточки по трём инцидентам этого спринта», «заведи задачу на Лену со сроком до конца следующего спринта», «предложи пять вопросов для разогрева по нашей теме спринта». Фасилитатора агент не заменяет — он снимает с него механическую работу.
Всё, что агент делает, идёт через тот же API, что и браузер. Если вы не организатор ретроспективы — агент не переключит стадию. Если голоса кончились — не проголосует. Если ретро на стадии обсуждения — не добавит карточку. Обойти правило через агента нельзя, потому что исполняется тот же код, что и для вкладки в браузере.
Шаг 1. Выпустить API-токен
Токен (personal access token) — это то, чем агент представляется Scruma. Он принадлежит лично вам и действует с вашими правами.
- Откройте приложение и нажмите на кнопку со своим аватаром и именем — она в левом нижнем углу, в самом низу бокового меню. Сразу откроется окно Профиль.
- Перейдите в нём на вкладку API-токены.
- Нажмите Создать токен, дайте ему понятное имя (например,
claude-code-ноутбук) и при желании укажите срок жизни. - Скопируйте показанный токен целиком. Он выглядит так:
scr_pat_и дальше длинная строка символов.
Как это в Scruma
Полный токен показывается ровно один раз — сразу после создания. Восстановить его нельзя: на сервере хранится только необратимый отпечаток, а не сам токен. Если вы закрыли окно, не скопировав, — просто отзовите токен и выпустите новый, это нормальная рутина, а не авария.
Заводите отдельный токен на каждое устройство или на каждого клиента. Тогда потерянный ноутбук лечится отзывом одного токена, а не сменой всего сразу: остальные подключения продолжают работать.
Шаг 2. Подключить агента
Адрес сервера один для всех клиентов:
https://app.scruma.ru/mcp
Транспорт — Streamable HTTP, авторизация — заголовок
Authorization: Bearer scr_pat_.... Дальше выберите свой клиент.
Claude Code (CLI)
Одна команда в терминале:
claude mcp add --transport http scruma https://app.scruma.ru/mcp \
--header "Authorization: Bearer scr_pat_..."
Проверить, что подключилось, — claude mcp list, а в самом Claude Code
попросите агента «покажи мои команды в Scruma»: он вызовет инструмент со
списком команд.
Codex CLI
У Codex конфиг не JSON, а TOML — файл ~/.codex/config.toml (глобально) или
.codex/config.toml в проекте:
[mcp_servers.scruma]
url = "https://app.scruma.ru/mcp"
bearer_token_env_var = "SCRUMA_TOKEN"
Главное отличие от остальных клиентов: токен в конфиге не пишется. Codex читает
его из переменной окружения, имя которой вы указали в bearer_token_env_var, и
сам подставляет в заголовок Authorization: Bearer …. То есть перед запуском
нужно экспортировать саму переменную:
export SCRUMA_TOKEN=scr_pat_...
Это, пожалуй, самый аккуратный из вариантов: секрета в файле нет вообще, и конфиг можно спокойно держать в репозитории.
То же самое одной командой, без ручной правки файла:
codex mcp add scruma --url https://app.scruma.ru/mcp \
--bearer-token-env-var SCRUMA_TOKEN
Как это в Scruma
Если ваша сборка Codex игнорирует HTTP-сервер и видит только stdio — обновите CLI. Прямой Streamable HTTP появился в Codex не сразу: в старых версиях он был спрятан за флагом experimental_use_rmcp_client в конфиге. В актуальных сборках это первоклассный транспорт, никаких флагов не требуется.
Cursor
Файл ~/.cursor/mcp.json (глобально) или .cursor/mcp.json внутри проекта:
{
"mcpServers": {
"scruma": {
"url": "https://app.scruma.ru/mcp",
"headers": { "Authorization": "Bearer scr_pat_..." }
}
}
}
VS Code (GitHub Copilot)
Файл .vscode/mcp.json в проекте. Обратите внимание: у VS Code свой ключ
верхнего уровня — servers, а не mcpServers, и обязательный type:
{
"servers": {
"scruma": {
"type": "http",
"url": "https://app.scruma.ru/mcp",
"headers": { "Authorization": "Bearer ${input:scruma-token}" }
}
},
"inputs": [
{
"type": "promptString",
"id": "scruma-token",
"description": "Scruma API token",
"password": true
}
]
}
Здесь токен вынесен в inputs: VS Code спросит его при первом подключении и
не положит в файл, который поедет в репозиторий. Можно подставить и строкой
напрямую — но тогда файл в git отправлять нельзя.
Windsurf
Файл ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"scruma": {
"serverUrl": "https://app.scruma.ru/mcp",
"headers": { "Authorization": "Bearer scr_pat_..." }
}
}
}
Claude Desktop
Десктопное приложение подключает удалённые серверы через Настройки →
Connectors, а не через файл конфигурации. Если в вашей версии в диалоге
добавления коннектора есть поле для заголовков запроса — укажите там
Authorization со значением Bearer scr_pat_.... Если поля нет, рабочий
обходной путь — мостик mcp-remote в claude_desktop_config.json (нужен
установленный Node.js):
{
"mcpServers": {
"scruma": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://app.scruma.ru/mcp",
"--header", "Authorization: Bearer scr_pat_..."
]
}
}
}
Любой другой клиент
Если ваш клиент читает конфиг в формате mcp.json, ему подойдёт тот же
блок, что и Cursor'у: URL плюс заголовок Authorization. Названия ключей у
клиентов расходятся (url против serverUrl, mcpServers против
servers), поэтому сверяйтесь с документацией своего клиента — сам сервер
ничего специфического не требует, только HTTP-транспорт и заголовок.
Корпоративная установка Scruma работает так же: подставьте вместо
app.scruma.ru адрес своего контура.
Что агент умеет
Инструментов у сервера двадцать два, и делятся они на четыре понятные группы. На первой держится разбор результатов, остальные три — это помощь в ведении.
Чтение. Профиль и тариф, список команд с вашей ролью в каждой, шаблоны команды с колонками, список ретроспектив с фильтром по статусу, полное состояние доски (колонки, карточки, группы, голоса, текущая стадия, ваши голоса и их остаток), итоговый отчёт по завершённой ретроспективе и список action items с фильтрами по исполнителю и выполненности. Этого набора хватает, чтобы агент собрал картину по нескольким ретро сразу — и уже сам, как языковая модель, сделал из неё выводы.
Ретроспектива и доска. Создать ретроспективу по шаблону — в том числе запланированную на будущую дату. Переключить стадию вперёд. Завершить встречу. Добавить, изменить, удалить и переместить карточку. Объединить карточки в группу, переименовать группу, расформировать её.
Голосование. Отдать голос за карточку или за группу и снять его.
Задачи. Завести action item с ответственным и сроком, изменить его, отметить выполненным.
Отдельно — чего в наборе нет намеренно: управления командами и участниками, биллинга, уведомлений и настроек профиля. И выпуска новых токенов: агент не может выдать себе доступ, это делается только руками в браузере.
Готовых «аналитических» инструментов в наборе тоже нет — ни сводок, ни трендов, ни рекомендаций. Это не пробел: сервис отдаёт данные, а думает над ними модель вашего клиента. Так разбор не упирается в то, какие отчёты мы успели придумать заранее.
По той же причине среди инструментов нет и серверной AI-группировки. Кнопка «Группировать с помощью AI» на доске — для людей, работающих в браузере (тариф Professional, разбор — в статье про AI-группировку карточек). Агент и сам языковая модель: он читает доску и объединяет карточки обычными инструментами группировки.
Как это выглядит в работе
Порядок действий агент узнаёт от самого сервера: начать с профиля и списка команд, взять ID нужной команды, дальше — ретроспективы и доска. Вам не нужно диктовать ему идентификаторы, достаточно назвать команду словами.
Стадии идут строго вперёд: размышление → группировка → голосование → обсуждение. Вернуться назад нельзя ни агенту, ни человеку. Отчёт становится доступен только после завершения ретроспективы.
Ещё одна деталь, которую полезно знать заранее: всё, что агент делает, видят участники в реальном времени. Карточка, добавленная из терминала, появляется на открытых досках коллег так же, как если бы вы набрали её мышкой. Ваша собственная вкладка тоже её увидит — она ведь ничего не отправляла.
Как это в Scruma
Если ретроспектива идёт прямо сейчас и на доске сидит команда — предупредите её, прежде чем натравливать агента на доску. Пять карточек, появившихся сами по себе, посреди этапа размышления смущают не меньше, чем чужой курсор в чужой колонке.
Ограничения и частые ошибки
Агент отвечает «нет прав» или «доступ запрещён». Скорее всего, так и есть: правила у агента те же, что у вас. Стадию переключает организатор ретроспективы или владелец команды; чужую карточку не отредактировать; карточки добавляются только на стадии размышления. Проверьте, что вы сами могли бы сделать то же самое в браузере.
Ошибка авторизации (401). Отозванный, истёкший и просто неверный
токен дают одинаковый ответ — различить их нельзя, и это сделано намеренно.
Не тратьте время на диагностику: выпустите новый токен и пропишите его в
клиент.
Проверка «жив ли сервер» из терминала. Полезная команда:
curl -i -X GET https://app.scruma.ru/mcp
Ожидаемый ответ — 405 Method Not Allowed. Это нормально: сервер
принимает только POST, а 405 означает, что запрос дошёл куда надо. А вот
404 — уже сигнал: путь не доехал до приложения (прокси, VPN,
корпоративный фильтр). Токен здесь ни при чём: эту проверку можно делать
вообще без него.
Агент не может выпустить себе токен. Управление токенами доступно только из браузера. Попытка сделать это через MCP вернёт отказ — чтобы утёкший токен не умел продлевать сам себя.
Слишком много запросов подряд (429). На один токен действует лимит
120 запросов в минуту. В обычной работе упереться в него сложно; если
уперлись — попросите агента делать паузы или разбейте задачу на части.
Браузерная сессия при этом не страдает: лимит считается по токену.
Токен в репозитории. Конфиг клиента с токеном в открытом виде легко
уезжает в git вместе с проектом. Держите такие файлы в .gitignore либо
используйте подстановку из переменных окружения — в VS Code для этого есть
inputs, в Windsurf и Cursor поддерживается ссылка на переменную среды.
Корпоративный контур. В корпоративной редакции срок жизни токена обязателен и ограничен 90 днями — токен придётся периодически перевыпускать. Это плата за то, что за токеном нет живой сессии каталога: уволенный сотрудник с бессрочным токеном сохранял бы доступ.