# Карта продукта и основные понятия

Центральная сущность Just Run — **песочница**. Остальные сущности задают, как она создается, предоставляют данные и учетные данные, запускают работу внутри нее либо публикуют долговременный сервис на ее основе.

## Основная модель[​](#the-core-model "Прямая ссылка на Основная модель")

| Сущность          | За что отвечает                                                                                                            | Связь с песочницей                                                                                                                                                                                                                                                                                                  |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Песочница**     | Запущенное или приостановленное вычислительное окружение, его файловая система, процессы, настройки и опубликованные порты | Место выполнения команд и сервисов                                                                                                                                                                                                                                                                                  |
| **Шаблон**        | Версионируемая начальная файловая система и значения ресурсов по умолчанию                                                 | Песочница создается из одной версии шаблона                                                                                                                                                                                                                                                                         |
| **Пресет**        | Ресурсы запуска и необязательные настройки подготовки для одного шаблона                                                   | Заполняет форму создания. В запросе создания через REST API пресет можно указать в `preset_id`: он дополнит запрос недостающими настройками подготовки и ресурсами. Без `preset_id`, как и при создании через MCP управления платформой, пресет шаблона по умолчанию дополняет запрос только настройками подготовки |
| **Автоматизация** | Cron- или вебхук-триггер и вызываемое действие                                                                             | Запускает команду или HTTP-действие в существующей песочнице                                                                                                                                                                                                                                                        |
| **MCP-хостинг**   | Управляемое определение MCP-сервера и постоянный эндпоинт для клиента                                                      | Работает в отдельной песочнице `mcp-<имя>`, которую Just Run создает сам; эта песочница видна в списке песочниц тем, кому виден Hosted MCP                                                                                                                                                                          |
| **Хранилище**     | Объектное хранилище уровня аккаунта                                                                                        | Отделено от файловой системы песочницы; доступ выдается явно                                                                                                                                                                                                                                                        |
| **Секрет**        | Переиспользуемые учетные данные или конфигурация                                                                           | Указывается по имени; сервер расшифровывает секрет и подставляет значения при создании песочницы или развертывании Hosted MCP                                                                                                                                                                                       |
| **Навык**         | Инструкции для ассистента или файлы, устанавливаемые в песочницу                                                           | Навыки плагина Just Run расширяют Claude Code или Codex на вашем компьютере; навыки песочницы входят в ее состав                                                                                                                                                                                                    |

## Файловая система песочницы и хранилище[​](#sandbox-filesystem-versus-storage "Прямая ссылка на Файловая система песочницы и хранилище")

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

**Хранилище** аккаунта — отдельное объектное хранилище. В файловую систему песочницы оно не монтируется. Доступ на чтение или на чтение и запись песочница получает, только если его выбрали при создании песочницы или позже в ее настройках.

## Шаблон и пресет[​](#template-versus-preset "Прямая ссылка на Шаблон и пресет")

**Шаблон** — переиспользуемая стартовая точка машины. **Пресет** — сохраненный набор значений для создания песочницы. После выбора пресета в блоке *Дополнительные настройки* формы создания можно изменить:

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

## Контекст аккаунта[​](#account-context "Прямая ссылка на Контекст аккаунта")

Ресурсы относятся к активному личному аккаунту или организации. Пользователь может переключать контекст, а API-операции используют контекст из токена или сессии. Список песочниц показывает только песочницы активного аккаунта — даже администратору платформы; песочницы всех аккаунтов он видит в *Админке*.

В организации [личными и общими](/sandboxes.md#organization-access) бывают:

* песочницы
* секреты
* автоматизации
* Hosted MCP

Новые ресурсы по умолчанию личные: их видят автор и пользователи с ролью *Владелец* или *Администратор*. Общие ресурсы видят все участники организации. Список песочниц в организации открывается с фильтром *Только мои*: чтобы увидеть общие песочницы коллег, выключите его.

## Выбор сущности[​](#pick-the-right-entry-point "Прямая ссылка на Выбор сущности")

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

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

* [Начало работы с Just Run](/getting-started.md)
* [Создание песочницы](/sandboxes/create-a-sandbox.md)
* [Основы работы с API](/developers/api-fundamentals.md)
* [Примеры](/examples.md)
