# Каталог и реестр

Каталог и официальный реестр MCP — два способа подготовить исходное определение Hosted MCP. Каталог содержит определения, курируемые для текущей инсталляции Just Run. Результаты из реестра поступают из внешнего индекса сообщества, и перед запуском их необходимо проверить.

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

## Ментальная модель[​](#mental-model "Прямая ссылка на Ментальная модель")

```
Catalog entry ───────────────┐
                             ├──► copied definition ──► Hosted MCP instance
Official Registry result ────┘       ├── source
                                     ├── package и version
                                     ├── arguments
                                     └── environment requirements
```

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

## Сравнение источников[​](#compare-the-sources "Прямая ссылка на Сравнение источников")

| Свойство                        | Каталог                                                   | Официальный реестр MCP                                                                                        |
| ------------------------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| Кто поддерживает                | Инсталляция Just Run                                      | Внешние издатели реестра                                                                                      |
| Проверка продуктом              | Курируется для инсталляции                                | Непроверенное содержимое сообщества                                                                           |
| Типы источников                 | Любой источник, поддерживаемый записью каталога           | npm- и PyPI-пакеты со stdio, пригодные для размещения                                                         |
| Результат выбора                | Сервер заполняет источник, пакет и аргументы по умолчанию | Интерфейс заполняет редактируемое определение собственного сервера                                            |
| Метаданные переменных окружения | Обязательные и необязательные поля из записи              | Подсказки об обязательных, необязательных и чувствительных полях и значения по умолчанию из исходного реестра |
| Доступность                     | Доступен вместе с MCP-хостингом                           | Может быть отдельно отключен или временно недоступен                                                          |
| Будущие обновления              | Не применяются к существующим инстансам                   | Не применяются к существующим инстансам                                                                       |

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

## Как работает каталог[​](#how-the-catalog-behaves "Прямая ссылка на Как работает каталог")

Веб-интерфейс открывает вкладку *Каталог* после выбора *Новый MCP-сервер* на странице *MCP-хостинг*. На каждой карточке могут отображаться:

* источник и пакет записи;
* краткое описание и ссылка на документацию;
* количество обязательных переменных окружения.

Выбор карточки сохраняет ее `catalog_key`. При создании сервер читает текущую видимую запись и заполняет `source`, `package` и непустые аргументы по умолчанию. Клиент API может явно переопределить эти поля, но веб-интерфейс фиксирует курируемые поля запуска во время создания.

Обязательные поля переменных окружения нужно передать напрямую, если не подключена хотя бы одна ссылка на секрет. Ссылка на секрет обходит эту проверку ключей при создании. Во время развертывания Just Run проверяет, что каждый указанный секрет существует, имеет тип `env` и может быть объединен, но не сравнивает итоговые ключи с метаданными каталога. Убедитесь, что подключенные секреты действительно содержат все обязательные переменные; иначе сервер может завершиться ошибкой при запуске или MCP handshake.

Записи каталога — данные конкретной инсталляции. Их имена и содержимое могут меняться при обновлении инсталляции, а скрытые записи не возвращаются. Вместо зависимости от жестко заданного списка проверяйте текущие карточки или `GET /v1/hosted-mcp/catalog`.

## Как работает реестр[​](#how-registry-browsing-behaves "Прямая ссылка на Как работает реестр")

Вкладка *Реестр* в форме *Новый MCP-сервер* просматривает официальный реестр MCP и выполняет по нему поиск через аутентифицированный эндпоинт Just Run. Результаты разбиты на страницы с курсором. Предлагаются только записи, которые текущая среда выполнения Hosted MCP может преобразовать в локальный сервер:

* npm-пакеты с транспортом stdio становятся источниками `npx`;
* PyPI-пакеты с транспортом stdio становятся источниками `uvx`;
* если запись предлагает оба варианта, приоритет получает npm-пакет;
* исключаются определения, которые доступны только как удаленный сервер, только как образ OCI или Docker либо используют неподдерживаемый транспорт, а также пакеты с недопустимыми именами.

У просмотра реестра есть собственный переключатель в конфигурации инсталляции, независимый от MCP-хостинга. Если он отключен, вкладка объясняет недоступность возможности, а API возвращает HTTP `503`.

Результаты кешируются по поисковому запросу и курсору. При сбое исходного реестра может быть возвращена недавняя устаревшая копия; если подходящей кешированной копии нет, запрос возвращает HTTP `503`. Поэтому поиск по реестру — средство обнаружения, а не подтверждение в реальном времени состояния публикации пакета.

## Что копирует импорт[​](#what-an-import-copies "Прямая ссылка на Что копирует импорт")

После выбора результата из реестра открывается обычная форма собственного сервера, которая предварительно заполняет:

* `npx` или `uvx` как источник;
* имя пакета и опубликованную версию;
* описания полей переменных окружения, пометки об обязательности, подсказки о чувствительности и непустые значения по умолчанию;
* документированные аргументы пакета как видимые подсказки;
* предложенное имя инстанса;
* `registry_ref` в формате `<registry-name>@<version>`.

Проверяйте каждое поле до создания инстанса. Аргументы пакета не добавляются автоматически. Значения переменных окружения по умолчанию могут быть заполнены заранее, но метаданные исходного реестра не доказывают, что значение безопасно или все еще правильно. Все поля запуска остаются редактируемыми; `registry_ref` — только справочные сведения о происхождении.

Официальный реестр не означает доверенный код

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

## Когда выбрать другой путь[​](#choose-another-path-when "Прямая ссылка на Когда выбрать другой путь")

* Выберите [собственный сервер](/hosted-mcp/custom-servers.md), если пакет уже известен или нужны явная команда либо HTTP-сервер, который сам предоставляет MCP.
* Выберите [обычную песочницу](/sandboxes.md), если рабочей нагрузке нужны сборка, загруженные исходные файлы, интерактивная среда или несколько сервисов помимо одного управляемого MCP-эндпоинта.

## Связанные материалы[​](#related "Прямая ссылка на Связанные материалы")

* [Обзор MCP-хостинга](/hosted-mcp.md)
* [Конфигурация и секреты](/hosted-mcp/configuration-and-secrets)
* [Жизненный цикл и засыпание при простое](/hosted-mcp/lifecycle-and-scale-to-zero)
* [Использование секретов с MCP-хостингом](/secrets/use-with-mcp-hosting.md)
* [Справочник REST API](/api-reference/rest.md)
