Разделы документации

MCP-сервер платформы

Подключение Claude Code, Cursor и своих агентов к данным Аркепелага по личному токену с правами владельца токена.

У Аркепелага есть свой MCP-сервер. Через него внешний агент задаёт платформе те же вопросы, что и Otti: про команды, продукты, репозитории, стенды, уязвимости, архитектуру, развёртывания, пул-реквесты, требования и людей. Агент может быть любым: Claude Code, Cursor или ваш собственный на любом фреймворке, если он умеет MCP.

Все инструменты только читают и отвечают по правам владельца токена. Продукт, которого человек не видит в каталоге, его агент тоже не увидит.

Включить сервер

Сервер включает администратор.

  1. Откройте Центр агентов → Управление.
  2. В карточке Инструменты включите MCP-сервер для внешних агентов.

В той же карточке можно выключить отдельный инструмент: он пропадёт и у Оттеров, и у внешних агентов. Стоп-кран Оттеров останавливает и MCP-сервер.

Подключить агента

  1. Выпустите личный токен в Настройки → API-токены. Достаточно доступа «только чтение».
  2. Подключите сервер в агенте:
ПараметрЗначение
Адресhttps://<портал>/api/v1/mcp
ТранспортStreamable HTTP
ЗаголовокAuthorization: Bearer pat_…

Для Claude Code одной командой:

Bash
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, администратор видит в колонке Вызовы карточки Инструменты.