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

MCP-серверы и навыки

Как подключить к Оттеру MCP-сервер и навык — заявка в реестр, ревью, классы инструментов, запечатанный ключ и проверка описаний перед каждым запуском.

Оттер получает только то, что прошло ревью. MCP-серверы проверяют в AI Каталог → MCP Hub, навыки — в AI Каталог → Скиллы и плагины. Одобряет ревьюер с правом «Ревью MCP-серверов и навыков». По умолчанию это право есть только у администратора, остальным его выдают в ролях.

MCP-сервер

Добавьте сервер в реестр

В MCP Hub попадают серверы, которые Аркепелаг нашёл в конфигурациях MCP в репозиториях, и серверы, добавленные вручную. Предложить сервер может любой, кто создаёт Оттеров:

  1. Нажмите Добавить сервер.
  2. Укажите название, адрес Streamable HTTP и назначение. Адрес можно оставить пустым, тогда сервер будет только в каталоге. Раздел и метки можно не заполнять. Раздел задаёт место сервера на витрине, а по меткам его находит поиск.
  3. Нажмите Добавить. Откроется карточка сервера со статусом «На проверке».

Оттер вызывает только серверы с транспортом Streamable HTTP. Сервер без адреса остаётся в каталоге, Оттеры его не вызывают.

Витрина MCP Hub устроена так же, как «Скиллы и плагины». Слева разделы: «Задачи и трекеры», «Код и репозитории», «Базы данных» и другие. Поиск ищет по названию, описанию, меткам и адресу. Найденные в репозиториях серверы приходят без раздела, его задаёт ревьюер в окне правки.

Подключите к своему агенту

На карточке сервера, в блоке Подключение → Claude Code · Cursor, лежат команда claude mcp add и фрагмент для .mcp.json, у каждого своя кнопка копирования. Они появляются, только когда у сервера указан адрес. Ключа платформы в них нет, вместо него стоит <ваш ключ>. Запечатанное значение остаётся в Аркепелаге, свой ключ выдаёт владелец системы.

Ревью

Ревьюер открывает карточку сервера. У неё три вкладки: Обзор, Инструменты и Оттеры. Дальше по шагам:

  1. Нажимает карандаш рядом с названием. В окне проверяет адрес и описывает, к каким системам ходит сервер и какие права ему нужны.
  2. В том же окне задаёт заголовок авторизации и его значение, например Authorization и Bearer …. Значение хранится запечатанным. В интерфейсе вместо него точки, а в «Общих сведениях» видно только «Задана». В API и трассе значения нет.
  3. На вкладке Инструменты нажимает Получить список. Аркепелаг запрашивает у сервера tools/list.
  4. Каждому инструменту ставит класс Чтение или Запись и включает допуск. Без класса допуск не включить.
  5. На вкладке Обзор в блоке Решение пишет комментарий и нажимает Одобрить.

Новые инструменты приходят выключенными. Инструменты записи Оттер вызывает только на уровне самостоятельности 3. Если у одобренного сервера сменить адрес, он вернётся на проверку. Запретить убирает сервер у всех Оттеров.

Подключите к Оттеру

В конструкторе откройте Настройки → Ресурсы агента → MCP и добавьте сервер. В списке только одобренные серверы с адресом и хотя бы одним допущенным инструментом. В подсказке видно число инструментов и есть ли среди них запись.

Сохраните Оттера: сервер попадёт в новую версию. Если сервер потом перестанут одобрять, при следующем сохранении он отключится сам.

Что происходит при вызове

Оттер не ходит к серверу напрямую. Все вызовы идут через core-service.

  • Перед каждым запуском Аркепелаг ещё раз запрашивает у сервера список инструментов и сверяет описание и схему каждого с одобренными. Если что-то поменялось, инструмент теряет допуск, в запуск не попадает, а на карточке сервера появляется метка «Описание изменилось». Ревьюер проверяет его заново.
  • Модель видит описание и схему, которые проверил ревьюер, а не те, что сервер отдаёт сейчас.
  • Ключ подставляет core-service. Если сервер вернёт ключ в ответе, Аркепелаг заменит его на «[скрыто]».
  • Ответ сервера помечен для модели как внешние данные и обрезается до 12 000 символов. Правила платформы запрещают Оттеру выполнять инструкции из таких данных.
  • На сверку списка отводится 8 секунд, на вызов — 20. Редиректы запрещены, ответ — до 1 МБ.
  • Недоступный сервер или инструмент без допуска записывается в трассу шагом «Отказ шлюза». Остальные инструменты работают.

Каждый вызов — шаг трассы запуска. За один запуск Оттер делает не больше 20 вызовов инструментов. Токены модели идут в месячный лимит Оттера и в лимиты подключения.

Навык

Навык — инструкция, которую Аркепелаг добавляет к промпту Оттера как есть. Например, порядок разбора бага.

  1. В Скиллы и плагины нажмите Предложить навык.
  2. Заполните название, короткое описание и инструкцию. Инструкцию пишите в Markdown. Раздел и метки можно не заполнять. Раздел задаёт место навыка на витрине, а по меткам его находит поиск.
  3. Нажмите Отправить на проверку. Откроется карточка навыка, а до одобрения Оттеры его не получают.
  4. Ревьюер открывает карточку навыка. Текст лежит на вкладке Инструкция. Затем на вкладке Обзор в блоке Решение ревьюер нажимает Одобрить или Запретить.
  5. В конструкторе добавьте навык в Ресурсы агента → Навыки и сохраните Оттера.

Если инструкцию одобренного навыка изменить, навык снова уйдёт на проверку. Правила платформы Аркепелаг ставит после навыков, и навык их не отменяет.

Витрина Скиллы и плагины разбита на разделы: «Тестирование», «Ревью кода», «Безопасность» и другие. Раздел выберите слева. Поиск над карточками смотрит в название, описание и метки.

Навык можно взять и в свой репозиторий. На карточке навыка откройте Установка → Claude Code · Codex. Там указан путь .claude/skills/<имя>/SKILL.md и есть кнопки Скопировать SKILL.md и Скачать. В начале файла стоят имя и описание навыка, дальше идёт инструкция. Вкладка Инструкция показывает текст как документ, а кнопка Исходник — файл целиком.