MCP-серверы и навыки
Как подключить к Оттеру MCP-сервер и навык — заявка в реестр, ревью, классы инструментов, запечатанный ключ и проверка описаний перед каждым запуском.
Оттер получает только то, что прошло ревью. MCP-серверы проверяют в AI Каталог → MCP Hub, навыки — в AI Каталог → Скиллы и плагины. Одобряет ревьюер с правом «Ревью MCP-серверов и навыков». По умолчанию это право есть только у администратора, остальным его выдают в ролях.
MCP-сервер
Добавьте сервер в реестр
В MCP Hub попадают серверы, которые Аркепелаг нашёл в конфигурациях MCP в репозиториях, и серверы, добавленные вручную. Предложить сервер может любой, кто создаёт Оттеров:
- Нажмите Добавить сервер.
- Укажите название, адрес Streamable HTTP и назначение. Адрес можно оставить пустым, тогда сервер будет только в каталоге. Раздел и метки можно не заполнять. Раздел задаёт место сервера на витрине, а по меткам его находит поиск.
- Нажмите Добавить. Откроется карточка сервера со статусом «На проверке».
Оттер вызывает только серверы с транспортом Streamable HTTP. Сервер без адреса остаётся в каталоге, Оттеры его не вызывают.
Витрина MCP Hub устроена так же, как «Скиллы и плагины». Слева разделы: «Задачи и трекеры», «Код и репозитории», «Базы данных» и другие. Поиск ищет по названию, описанию, меткам и адресу. Найденные в репозиториях серверы приходят без раздела, его задаёт ревьюер в окне правки.
Подключите к своему агенту
На карточке сервера, в блоке Подключение → Claude Code · Cursor, лежат команда claude mcp add и фрагмент для .mcp.json, у каждого своя кнопка копирования. Они появляются, только когда у сервера указан адрес. Ключа платформы в них нет, вместо него стоит <ваш ключ>. Запечатанное значение остаётся в Аркепелаге, свой ключ выдаёт владелец системы.
Ревью
Ревьюер открывает карточку сервера. У неё три вкладки: Обзор, Инструменты и Оттеры. Дальше по шагам:
- Нажимает карандаш рядом с названием. В окне проверяет адрес и описывает, к каким системам ходит сервер и какие права ему нужны.
- В том же окне задаёт заголовок авторизации и его значение, например
AuthorizationиBearer …. Значение хранится запечатанным. В интерфейсе вместо него точки, а в «Общих сведениях» видно только «Задана». В API и трассе значения нет. - На вкладке Инструменты нажимает Получить список. Аркепелаг запрашивает у сервера
tools/list. - Каждому инструменту ставит класс Чтение или Запись и включает допуск. Без класса допуск не включить.
- На вкладке Обзор в блоке Решение пишет комментарий и нажимает Одобрить.
Новые инструменты приходят выключенными. Инструменты записи Оттер вызывает только на уровне самостоятельности 3. Если у одобренного сервера сменить адрес, он вернётся на проверку. Запретить убирает сервер у всех Оттеров.
Подключите к Оттеру
В конструкторе откройте Настройки → Ресурсы агента → MCP и добавьте сервер. В списке только одобренные серверы с адресом и хотя бы одним допущенным инструментом. В подсказке видно число инструментов и есть ли среди них запись.
Сохраните Оттера: сервер попадёт в новую версию. Если сервер потом перестанут одобрять, при следующем сохранении он отключится сам.
Что происходит при вызове
Оттер не ходит к серверу напрямую. Все вызовы идут через core-service.
- Перед каждым запуском Аркепелаг ещё раз запрашивает у сервера список инструментов и сверяет описание и схему каждого с одобренными. Если что-то поменялось, инструмент теряет допуск, в запуск не попадает, а на карточке сервера появляется метка «Описание изменилось». Ревьюер проверяет его заново.
- Модель видит описание и схему, которые проверил ревьюер, а не те, что сервер отдаёт сейчас.
- Ключ подставляет core-service. Если сервер вернёт ключ в ответе, Аркепелаг заменит его на «[скрыто]».
- Ответ сервера помечен для модели как внешние данные и обрезается до 12 000 символов. Правила платформы запрещают Оттеру выполнять инструкции из таких данных.
- На сверку списка отводится 8 секунд, на вызов — 20. Редиректы запрещены, ответ — до 1 МБ.
- Недоступный сервер или инструмент без допуска записывается в трассу шагом «Отказ шлюза». Остальные инструменты работают.
Каждый вызов — шаг трассы запуска. За один запуск Оттер делает не больше 20 вызовов инструментов. Токены модели идут в месячный лимит Оттера и в лимиты подключения.
Навык
Навык — инструкция, которую Аркепелаг добавляет к промпту Оттера как есть. Например, порядок разбора бага.
- В Скиллы и плагины нажмите Предложить навык.
- Заполните название, короткое описание и инструкцию. Инструкцию пишите в Markdown. Раздел и метки можно не заполнять. Раздел задаёт место навыка на витрине, а по меткам его находит поиск.
- Нажмите Отправить на проверку. Откроется карточка навыка, а до одобрения Оттеры его не получают.
- Ревьюер открывает карточку навыка. Текст лежит на вкладке Инструкция. Затем на вкладке Обзор в блоке Решение ревьюер нажимает Одобрить или Запретить.
- В конструкторе добавьте навык в Ресурсы агента → Навыки и сохраните Оттера.
Если инструкцию одобренного навыка изменить, навык снова уйдёт на проверку. Правила платформы Аркепелаг ставит после навыков, и навык их не отменяет.
Витрина Скиллы и плагины разбита на разделы: «Тестирование», «Ревью кода», «Безопасность» и другие. Раздел выберите слева. Поиск над карточками смотрит в название, описание и метки.
Навык можно взять и в свой репозиторий. На карточке навыка откройте Установка → Claude Code · Codex. Там указан путь .claude/skills/<имя>/SKILL.md и есть кнопки Скопировать SKILL.md и Скачать. В начале файла стоят имя и описание навыка, дальше идёт инструкция. Вкладка Инструкция показывает текст как документ, а кнопка Исходник — файл целиком.