MCP-сервер платформы
Подключение Claude Code, Cursor и своих агентов к данным Аркепелага по личному токену с правами владельца токена.
У Аркепелага есть свой MCP-сервер. Через него внешний агент задаёт платформе те же вопросы, что и Otti: про команды, продукты, репозитории, стенды, уязвимости, архитектуру, развёртывания, пул-реквесты, требования и людей. Агент может быть любым: Claude Code, Cursor или ваш собственный на любом фреймворке, если он умеет MCP.
Все инструменты только читают и отвечают по правам владельца токена. Продукт, которого человек не видит в каталоге, его агент тоже не увидит.
Включить сервер
Сервер включает администратор.
- Откройте Центр агентов → Управление.
- В карточке Инструменты включите MCP-сервер для внешних агентов.
В той же карточке можно выключить отдельный инструмент: он пропадёт и у Оттеров, и у внешних агентов. Стоп-кран Оттеров останавливает и MCP-сервер.
Подключить агента
- Выпустите личный токен в Настройки → API-токены. Достаточно доступа «только чтение».
- Подключите сервер в агенте:
| Параметр | Значение |
|---|---|
| Адрес | https://<портал>/api/v1/mcp |
| Транспорт | Streamable HTTP |
| Заголовок | Authorization: Bearer pat_… |
Для Claude Code одной командой:
claude mcp add --transport http archepelag https://<портал>/api/v1/mcp --header "Authorization: Bearer pat_…"Готовую команду с адресом вашего портала копирует кнопка Команда Claude Code в карточке Инструменты.
Для автоматизаций, которые работают без человека, выпустите токен сервисного аккаунта (sat_…). Агент получит права сервисного аккаунта, а не ваши.
Инструменты
| Раздел | Инструменты |
|---|---|
| Каталог | search_catalog, get_team, get_product, get_repository |
| Стенды | list_stands, get_stand |
| Уязвимости | get_vulnerability_summary, list_vulnerabilities |
| Архитектура | get_product_architecture, get_architecture_overview |
| Развёртывания | get_product_deployments |
| Разработка | get_product_activity, list_pull_requests |
| Требования | get_product_requirements |
| Люди | get_product_people |
Сначала агент находит сущность через search_catalog, потом передаёт её id в остальные инструменты. Поле link в ответе ведёт на карточку в портале.
Ограничения
- Не больше 60 вызовов инструментов в минуту на пользователя.
- Пул-реквесты читаются из Bitbucket, GitLab и Gitea. GitHub пока не поддерживается.
- Каждый вызов попадает в журнал: кто вызывал, каким токеном и какой инструмент. Сколько раз вызывали каждый инструмент через MCP, администратор видит в колонке Вызовы карточки Инструменты.