onplate
РусEng
Вся документация

MCP-серверы

MCP-сервер — это расширение, которое даёт AI дополнительные инструменты: доступ к базе данных, поиску, файлам, внешним сервисам. Раздел MCP-серверы работает так же, как хранилище скиллов: сервер сначала добавляется в onplate, затем устанавливается в нужные AI-инструменты.

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

Три способа:

Вручную

Кнопка Добавить MCP-сервер. Заполните:

  • Транспорт — как AI будет общаться с сервером:
    • stdio — сервер запускается как локальная программа на вашем компьютере;
    • http или sse — сервер работает удалённо, по адресу в интернете;
  • Команда и аргументы (для stdio) — что именно запускать;
  • Переменные окружения и заголовки — настройки и ключи доступа.

Импорт из JSON

Почти каждый MCP-сервер в своём README приводит блок конфигурации mcpServers. Просто скопируйте его и вставьте в окно импорта — onplate распознает и одиночную запись, и целый список серверов.

Из реестра

Вкладка MCP в Маркетплейсе: поиск по официальному реестру MCP-серверов и установка в пару кликов. Можно подключить и свой реестр.

Секреты под защитой

Ключи API, токены и пароли — самое ценное в конфигурации MCP. onplate обращается с ними особо:

  • секретные значения шифруются и не показываются после сохранения;
  • в конфиги AI они подставляются только в момент установки;
  • при экспорте и командной публикации секреты в артефакты не попадают.

Отметьте значение флажком секрет — и оно будет зашифровано. Мастер-ключ шифрования можно сменить в разделе Безопасность.

Проверить соединение

Прежде чем устанавливать сервер в AI, нажмите Проверить соединение — onplate подключится к серверу и покажет список инструментов, которые тот предоставляет. Так вы заранее видите, что сервер живой и что он умеет.

Для stdio-серверов проверка означает запуск локальной команды на вашем компьютере, поэтому onplate сначала покажет команду и попросит подтверждение: запускайте только то, чему доверяете. Если сервер помечен как опасный (запуск кода, доступ к сети), установка тоже потребует явного согласия.

Панель угроз в карточке

Бейдж вердикта в карточке сервера — кнопка. Раскройте его, и onplate разберёт спецификацию текущей версии и покажет находки так же, как у скиллов и субагентов: заголовок правила, «почему это важно», «что делать» и сама улика — фрагмент спецификации, на котором сработало правило. Разбор считается лениво, при первом раскрытии; секреты в него не подставляются — анализатор смотрит на форму конфигурации, а не на значения.

С находкой можно не только согласиться:

  • Ложное — правило сработало зря;
  • Принять риск — вы понимаете, что делает сервер, и осознанно оставляете это; onplate попросит объяснить, почему риск допустим;
  • Отозвать — снять свою прежнюю отметку.

После отметки вердикт пересчитывается по оставшимся находкам: сервер с двумя опасными находками, из которых одну вы признали ложной, не станет сразу «безопасным». Сама находка из списка не исчезает — иначе её нельзя было бы отозвать.

Отметка привязана к паре «правило + улика». Если вы поменяете команду или адрес сервера, улика станет другой, и старое исключение к новой находке не применится. Если обновится набор правил, отметка помечается «исключение устарело» и находка снова учитывается.

Установка в AI

Как со скиллами: выберите AI-инструмент и область. Для каждого AI onplate знает свой формат конфига и перед записью показывает, какой файл будет изменён. Установки видны в Привязках на вкладке MCP.

Как проверить результат

После установки или снятия установки Орби показывает последнее подтверждённое действие. Подтверждение означает, что onplate перечитал привязки и увидел ожидаемую запись в конфигурации AI.

Это подтверждает только конфигурацию — не запуск самого MCP-сервера. Чтобы убедиться, что команда запускается, соединение устанавливается и инструменты доступны, отдельно нажмите Проверить соединение.

Если Орби пишет «Не удалось подтвердить…», не повторяйте операцию сразу. Запись сервера, конфигурация AI или зашифрованные секреты могли измениться частично. Обновите раздел MCP-серверы и вкладку MCP в Привязках, проверьте фактическое состояние и только затем решайте, нужна ли повторная установка.

Версии и откат

У MCP-серверов, как и у скиллов, есть история версий: блок Версии в карточке показывает список с пометкой текущая, любая прошлая версия возвращается кнопкой Откатить.

Удаление

  • Снять установку — убрать сервер из конфига конкретного AI;
  • Удалить из хранилища — убрать запись из onplate (установки, если они есть, останутся — onplate предупредит);
  • Удалить отовсюду — снять сервер из всех конфигов AI и удалить из хранилища.

Удаление MCP-сервера из хранилища не отправляет его в корзину: сохранённую запись и управляемые onplate секреты восстановить нельзя. Перед подтверждением проверьте список оставшихся установок.