Перейти к основному содержимому
Открыть Markdown

MCP-хостинг

MCP-хостинг запускает MCP-сервер в выделенной песочнице Just Run и публикует его через стабильный эндпоинт Streamable HTTP, защищенный bearer-токеном. Вы управляете инстансом Hosted MCP — его источником, конфигурацией, данными для подключения и жизненным циклом, — а Just Run создает и заменяет песочницу, в которой работает сервер.

Используйте MCP-хостинг, когда результатом должен быть MCP-эндпоинт для агентов и инструментов, а не универсальная песочница, которой вы управляете напрямую.

Чем управляет MCP-хостинг​

  • Именованное определение MCP-сервера уровня аккаунта.
  • Стабильный HTTPS URL, оканчивающийся на /mcp.
  • Клиентский bearer-токен, который можно ротировать без изменения URL.
  • Песочница, в которой работает сервер, процесс сервиса, открытие порта и проверки готовности.
  • Необязательное засыпание при простое с пробуждением при следующем запросе к эндпоинту.
  • Статус развертывания, ошибки, снимок обнаруженных инструментов, логи, проверка соединения, число запросов и метаданные последнего использования.

Hosted MCP может быть отключен в инсталляции. Когда возможность выключена, API возвращает HTTP 503. Также нужна конфигурация инсталляции для шифрования секретов, поскольку значения переменных окружения, заданные напрямую, и клиентские bearer-токены хранятся в зашифрованном виде.

Ментальная модель​

Hosted MCP instance
├── definition
│ ├── catalog, Registry import или custom source
│ ├── package, version, arguments или command
│ ├── environment и Secret references
│ └── resources и idle policy
├── стабильная client identity
│ ├── https://…/mcp
│ └── bearer token
└── deployed generation
└── disposable backing sandbox
└── MCP service

Запись инстанса — пользовательский ресурс. Развертывание компилирует его текущее определение в песочницу и публикует сервис под стабильными данными для подключения. Повторное развертывание заменяет эту песочницу, но сохраняет URL и bearer-токен.

Считайте песочницу, в которой работает сервер, управляемым вычислительным ресурсом. Управляйте сервисом через элементы управления MCP-хостинга, чтобы определение, статус, внешний доступ и развернутое поколение оставались согласованными.

Выбор источника сервера​

ИсточникЧто вы указываетеЧто запускается
Курируемый каталогПоддерживаемую запись каталога и необходимую конфигурациюЗапись заполняет определение, готовое к развертыванию
Официальный реестр MCPРезультат из реестра для импорта и проверкиИмпортированные поля становятся редактируемым определением
npxnpm-пакет, необязательную версию и аргументыstdio-сервер через мост в Streamable HTTP
uvxPython-пакет, необязательную версию и аргументыstdio-сервер через мост в Streamable HTTP
commandЯвную команду и аргументыstdio-сервер через мост в Streamable HTTP
httpКоманду и порт, на котором он предоставляет MCPHTTP-сервер, который сам предоставляет MCP, публикуется напрямую

Каталог и реестр — это исходные точки поиска и настройки, а не отдельные способы запуска. У просмотра реестра есть собственный переключатель в конфигурации инсталляции, поэтому он может быть недоступен даже при включенном MCP-хостинге.

Краткий жизненный цикл​

Создание обычно запускает асинхронное развертывание:

create
└── deploying
├── ready
└── failed ──► исправить или redeploy

изменить deployed definition ──► needs_redeploy ──► redeploy ──► ready

disable ──► disabled ──► enable
СтатусЗначение
not_deployedОпределение существует, но развертывание еще не запускалось
deployingСоздается и проверяется новое поколение песочницы
readyРазвернутое поколение прошло аутентифицированный handshake MCP через публичный URL
needs_redeployРазвернутого поколения нет или оно старше текущего определения
failedРазвертывание остановилось с ошибкой, доступной на инстансе
disabledВнешний доступ удален, сервис недоступен

ready описывает пригодные к использованию данные для подключения Hosted MCP с возможностью пробуждения. Этот статус не требует, чтобы песочница, в которой работает сервер, постоянно оставалась активной: инстанс с остановленной из-за простоя песочницей может сохранять ready и выполнить холодный старт при следующем запросе.

Готовность и поколения​

Развертывание считается завершенным, только когда Just Run:

  1. разрешил переменные окружения, заданные напрямую, и ссылки на секреты типа env;
  2. создал и подготовил песочницу, в которой работает сервер;
  3. запустил сервис и опубликовал его порт с аутентификацией по bearer-токену;
  4. вызвал initialize и tools/list через публичный URL.

Если обязательный этап завершается ошибкой, инстанс получает failed и предоставляет deploy_error. Изменение развернутого определения не меняет работающее поколение: инстанс переходит в needs_redeploy, пока вы явно его не замените.

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

Данные для подключения и доступ​

Создание возвращает клиентский bearer-токен открытым текстом один раз. Последующие ответы на запросы чтения показывают только последние символы; если токен не сохранен, ротируйте его и обновите каждого клиента.

Клиенты подключаются к стабильному URL с заголовком:

Authorization: Bearer <hosted-mcp-token>

Веб-интерфейс предоставляет готовые фрагменты для Claude Code, конфигурации MCP в формате JSON и другой песочницы Just Run. Один инстанс Hosted MCP может обслуживать несколько клиентов, у которых есть его токен.

Bearer-токен защищает публичный эндпоинт, но не операции управления. Для создания, изменения, развертывания, ротации или удаления инстанса нужны аутентифицированная сессия Just Run или API-токен в аккаунте, которому принадлежит инстанс.

Засыпание при простое​

Если в разделе Сон и ресурсы формы инстанса режим Всегда включен не выбран, песочница, в которой работает сервер, останавливается после настроенного окна простоя. Запрос к публичному эндпоинту может разбудить ее и поэтому столкнуться с задержкой холодного старта. Остановка песочницы не меняет стабильные URL, токен или статус ready.

Режим Всегда включен отключает автоматическую остановку инстанса при простое. Это не становится гарантией доступности: развертывания, сбои, обслуживание, нехватка ресурсов и внешние зависимости все еще могут прервать сервис.

Аккаунт и границы безопасности​

Инстансы принадлежат активному личному аккаунту или аккаунту организации. Участник организации может создать инстанс с видимостью private (по умолчанию) или явно выбрать org. Личный инстанс видят только автор и пользователи с ролью Владелец или Администратор. Общий инстанс видят все участники, но менять его могут только автор и пользователи с ролью Владелец или Администратор. Ответ API содержит permissions.mutate и permissions.change_visibility для текущего пользователя. Песочница, в которой работает сервер, наследует автора и видимость инстанса. Лимит инстансов на аккаунт и ресурсы по умолчанию задаются конфигурацией сервиса.

В организации видимость инстанса можно отдельно менять между private и org. Вместе с ним меняется видимость песочницы, в которой работает сервер, и сохранившихся управляемых сред выполнения. Публикация отклоняется, если подключенный или уже скопированный секрет личный либо происхождение секретов среды выполнения неизвестно. Для скрытия нужен назначенный владелец. Перед сменой видимости дождитесь завершения развертывания. Ранее выданные URL, защищенные bearer-токеном, останутся активными.

Перед включением и каждым развертыванием или повторным развертыванием проверяются текущее членство автора и доступ к указанным секретам. Личный секрет можно подключить только к личному инстансу того же автора. Если автор вышел из организации или потерял доступ к секрету, новое развертывание отклоняется. Фоновая попытка записывает причину в статус инстанса. Сама потеря доступа не останавливает работающий инстанс и не отзывает его URL, защищенный bearer-токеном. Для остановки нужно вручную отключить или удалить инстанс; ротация токена прекращает доступ со старым токеном. Значения, уже скопированные из секрета в среду выполнения, автоматически не отзываются.

Значения переменных окружения, заданные напрямую, и bearer-токен — зашифрованные данные только для записи. Ответы API показывают имена переменных окружения, имена ссылок на секреты и последние символы токена, но не сохраненные значения.

MCP-сервер получает конфигурацию открытым текстом

Процесс MCP должен получить пригодные для использования значения переменных окружения во время работы. Пользователь, контролирующий пакет сервера, команду или песочницу, в которой работает сервер, может их прочитать. Проверяйте сторонние пакеты и импорт из реестра до передачи учетных данных.

Подробнее об MCP-хостинге​