Размещение MCP-сервера на платформе Caila

Model Context Protocol (MCP) — это стандарт, который позволяет большим языковым моделям (LLM) безопасно подключаться к внешним инструментам (tools): базам данных, файловым системам или сторонним API.

Платформа Caila позволяет настроить и запустить ваш собственный MCP-сервер. Вы сможете предоставить внешний доступ к вашим инструментам и интегрировать их в различные приложения, используя инфраструктуру Caila.

Для взаимодействия с MCP-серверами платформа поддерживает как STDIO, так и HTTP — Streamable HTTP и HTTP/SSE.

примечание

Помимо возможности развернуть собственный MCP-сервер из вашего образа, платформа Caila предоставляет готовые к использованию MCP-серверы и прототипы для запуска на вашем или арендованном сервере. Они представлены в каталоге в разделе MCP-серверы.

Предварительные условия

Для развертывания вам понадобится Docker-образ или NPM-пакет, который реализует ваш MCP-сервер.

Настройка MCP-сервера

Пошаговый мастер настройки MCP-сервера проведет вас через все необходимые этапы.

1. Перейдите в Моё пространство → Сервисы и нажмите Создать сервис.

2. Выберите тип сервиса MCP Сервер.

3. Заполните базовую информацию о сервисе:

   • Компания-автор и Название сервиса.

     Ссылка на сервис будет сформирована автоматически, но вы можете отредактировать ее.

   • Описание — будет отображаться в карточке сервиса и в каталоге.

   • Прототип — включите опцию, если сервис предназначен для клонирования.

   • Тип задачи — выберите значение «MCP server».

   • Поддерживаемые языки — будет отображаться в карточке сервиса и в каталоге, например: ru, en. После ввода каждого кода языка нажмите Enter.

   • Управление доступом:

     • Всем пользователям — MCP-сервер будет доступен по публичной ссылке вида ID_аккаунта-название_сервиса.app.caila.io.
     • По ссылке — для доступа к MCP-серверу генерируется уникальная сложная ссылка, которую практически невозможно подобрать. Доступ будет только у тех, с кем вы ею поделитесь.
     примечание

     Платформа не ограничивает доступ к вашему MCP-серверу и не требует авторизации для входящих запросов.

4. Укажите, откуда платформа должна взять код MCP-сервера:

   • Если ваш сервер упакован в Docker-образ:

     1. Выберите тип образа Docker.

     2. Укажите полный путь к образу, например:

        my-registry.com/my-org/my-mcp-server:latest

   • Если ваш сервер представляет собой NPM-пакет:

     1. Выберите тип образа NPM.

     2. Укажите имя пакета, например:

        @my-scope/my-npm-mcp-package

5. Выберите сетевой интерфейс (транспортный протокол) вашего MCP-сервера:

   • STDIO — стандартный ввод/вывод. Платформа будет взаимодействовать с MCP-сервером как с консольным приложением, через stdin и stdout.

     Укажите Аргументы команды запуска, передаваемые дочернему процессу (например, аргументы команды npx в случае развертывания из NPM-пакета).

   • HTTP — ваш сервер запускает веб-сервер и предоставляет HTTP/REST API.

     Укажите Порт, на который платформа будет направлять запросы, и Healthcheck endpoint — путь для проверки работоспособности.

6. Настройте остальные параметры запуска:

   • Переменные среды — параметры, передаваемые внутрь контейнера при запуске. Подробнее в разделе Конфигурация запуска.
   • Таймаут — время ожидания запуска инстанса MCP-сервера.

7. Выберите вычислительные ресурсы:

   • Если у вас уже есть подходящая ресурс-группа, выберите ее.
   • Если нет, выберите виртуальный сервер с нужными характеристиками: CPU, RAM и др. В этом случае будет создана новая ресурс-группа.

   Подробнее о ресурс-группах читайте в разделе Аренда серверных мощностей.

   Если требуется, укажите лимиты ресурсов для одного инстанса. Подробнее о лимитах читайте в разделе Ресурсы и лимиты сервиса.

Сразу после завершения настройки MCP-сервер начнет запускаться (если не была выбрана опция Прототип).

Тестирование MCP-сервера

Когда статус сервиса сменится на Работает, в карточке сервиса перейдите в раздел Тестирование. Платформа автоматически запросит у вашего сервера список доступных инструментов и отобразит их.

Заполните параметры и нажмите Выполнить, чтобы убедиться, что сервер корректно обрабатывает запросы и возвращает данные.

Использование инструментов MCP-сервера

После создания сервиса платформа автоматически сгенерирует документацию для подключения к MCP-серверу с правильными URL-адресами и готовыми примерами конфигурации для популярных инструментов, таких как Claude Code, Desktop, n8n, IntelliJ IDEA. Документация отображается в карточке созданного сервиса в разделе Обзор.

Особенности подключения к MCP-серверу на платформе Caila:

• Для внешнего доступа к инструментам MCP-сервера платформа предоставляет HTTP-интерфейс. Даже если сам MCP-сервер работает по STDIO, платформа автоматически обернет его в прокси для работы по сети.
• Поскольку MCP-серверы часто используются внешними инструментами (IDE, чат-боты), платформа отключает собственную проверку авторизации для входящих запросов. Однако вы можете реализовать авторизацию на уровне самого MCP-сервера, если требуется.
• В запросах к MCP-серверу можно указывать любые HTTP-заголовки — платформа передаст их без изменений.