# Собственные серверы

Собственный сервер Hosted MCP создается из указанного вами определения пакета или процесса. Just Run запускает его как управляемый сервис в среде выполнения Hosted MCP текущей инсталляции, публикует `/mcp` за bearer-токеном инстанса и проверяет MCP handshake перед переводом поколения в `ready`.

Если курируемый каталог не содержит нужного сервера, откройте в форме *Новый MCP-сервер* вкладку *Свой сервер*.

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

```
npx package ───┐
uvx package ───┼──► stdio MCP process ──► Streamable HTTP bridge ──► /mcp
command argv ──┘

http command + port ──► native Streamable HTTP server ─────────────► /mcp
```

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

## Требования к источникам[​](#source-requirements "Прямая ссылка на Требования к источникам")

| Источник  | Обязательное определение                         | Что запускает Just Run                     |
| --------- | ------------------------------------------------ | ------------------------------------------ |
| `npx`     | npm-пакет                                        | `npx -y <package>` с аргументами           |
| `uvx`     | Python-пакет                                     | `uvx <package>` с аргументами              |
| `command` | Непустая команда с аргументами                   | Эта команда как stdio-процесс MCP          |
| `http`    | Непустая команда с аргументами и порт `1..65535` | Эта команда напрямую, без моста протоколов |

`npx`, `uvx` и `command` должны реализовывать MCP через stdio. Just Run оборачивает их мостом без сохранения состояния, публикующим Streamable HTTP. Источник `http` должен самостоятельно предоставлять Streamable HTTP по `/mcp` на указанном порту.

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

Для `npx` и `uvx` укажите имя пакета и необязательную версию:

```
npx: @scope/package + 1.2.3  →  npx -y '@scope/package@1.2.3'
uvx: package-name + 1.2.3    →  uvx 'package-name==1.2.3'
```

Без версии каждое новое развертывание разрешает последнюю версию, доступную менеджеру пакетов в этот момент. Фиксируйте версию, когда важна повторяемость поколений; для изменения зафиксированной версии требуется повторное развертывание.

Текущий образ среды выполнения рассчитан на Node.js, `npx`, Python, `uvx`, `supergateway`, Git и распространенные инструменты командной строки. Конкретный образ и его содержимое — конфигурация инсталляции, а не переносимый публичный контракт среды выполнения.

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

### Аргументы[​](#arguments "Прямая ссылка на Аргументы")

Аргументы передаются после спецификации пакета. В веб-интерфейсе поле *Аргументы* в разделе *Запуск* формы разбивается по пробельным символам:

```
--flag value --verbose
```

Получаются три аргумента: `--flag`, `value` и `--verbose`. REST API принимает явный массив `args` и может сохранить один аргумент с пробелами. Just Run заключает каждый аргумент в кавычки перед передачей через мост stdio.

## Источник `command`[​](#command-source "Прямая ссылка на command-source")

Используйте `command` для исполняемого файла, уже доступного в настроенной среде выполнения Hosted MCP. В веб-интерфейсе вводите по одному элементу команды на строку:

```
python3
-m
my_mcp_server
```

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

`command` не загружает исходный код и не собирает приложение. Если процесс зависит от файлов или исполняемых файлов, которых нет в образе среды выполнения, используйте пакетный источник или подготовьте рабочую нагрузку в [обычной песочнице](/sandboxes.md).

## Источник `http`[​](#native-http-source "Прямая ссылка на native-http-source")

Используйте `http` только для процесса, который уже реализует MCP Streamable HTTP. Укажите:

* по одному элементу команды на строку;
* порт, который слушает процесс;
* необходимые значения переменных окружения процесса.

Just Run напрямую запускает команду, ждет объявленный порт и публикует стабильный URL, защищенный bearer-токеном и оканчивающийся на `/mcp`. Он не преобразует другой HTTP-путь или протокол в MCP. Процесс должен привязаться к адресу, доступному для прокси сервисов песочницы, и отвечать на MCP-запросы `initialize` и `tools/list` по `/mcp`.

## Границы валидации[​](#validation-boundaries "Прямая ссылка на Границы валидации")

* Пакетные источники требуют непустое имя пакета только из букв ASCII, цифр и символов `@`, `/`, `.`, `_`, `-`, `=`, `^`, `~`.
* Фиксация версии доступна только для `npx` и `uvx`: не более 64 букв ASCII, цифр и символов `.`, `_`, `+`, `-`.
* `command` и `http` отклоняют пустые элементы команды.
* `http` требует целочисленный порт от `1` до `65535`.
* Имена переменных окружения могут содержать буквы ASCII, цифры и `_` и иметь длину до 128 символов.

Успешная валидация определения означает только то, что Just Run может скомпилировать сервис. Развертывание все еще может завершиться ошибкой во время установки пакета, запуска процесса, ожидания порта, открытия внешнего доступа или MCP handshake.

За код сервера отвечаете вы

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

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

* [Обзор MCP-хостинга](/hosted-mcp.md)
* [Каталог и реестр](/hosted-mcp/catalog-and-registry.md)
* [Конфигурация и секреты](/hosted-mcp/configuration-and-secrets)
* [Жизненный цикл и засыпание при простое](/hosted-mcp/lifecycle-and-scale-to-zero)
* [Логи, тестирование и диагностика](/hosted-mcp/logs-testing-and-troubleshooting)
* [Справочник REST API](/api-reference/rest.md)
