# Быстрый старт для AI-агента

Подключите Claude Code или Codex к Just Run через плагин Just Run, затем попросите агента создать песочницу, выполнить команду, показать результат и удалить ресурс. С плагином токен не нужен: вы входите в Just Run через браузер. Если ваш MCP-клиент так входить не умеет или агенту нужны права только на чтение, подключите его [по персональному токену](#connect-with-a-token).

## Перед началом[​](#before-you-begin "Прямая ссылка на Перед началом")

Нужны доступ к Just Run — личный аккаунт или участие в организации — и один из ассистентов:

* Claude Code 2.1.292 или новее;
* Codex CLI 0.159 или новее и `git`.

Агент работает в аккаунте, который активен в Just Run в момент входа. Чтобы агент работал в организации, сначала [переключитесь на нее](/accounts.md#active-account-context) в веб-интерфейсе.

Команды ниже — для публичного сервиса `platform.just-run.app`. Для другой инсталляции Just Run возьмите команды на ее странице *Кодинг-ассистенты* в группе *Помощь* основной навигации.

## 1. Подключение ассистента[​](#1-connect-the-assistant "Прямая ссылка на 1. Подключение ассистента")

### Claude Code[​](#connect-claude-code "Прямая ссылка на Claude Code")

Если вы раньше подключали Just Run к Claude Code по токену, удалите тот сервер командой `claude mcp remove just-run --scope <область>`, где `<область>` — область, в которую его добавляли, например `project`. Иначе Claude Code подключит прежний сервер вместо сервера плагина: у них один адрес.

Установите плагин — выполните в терминале по очереди:

```
claude plugin marketplace add https://platform.just-run.app/plugins/marketplace.json
claude plugin install just-run@just-run
```

Затем войдите в Just Run:

1. Запустите `claude`, выполните `/mcp`, выберите сервер `plugin:just-run:just-run` и пункт *Authenticate*.
2. В браузере откроется Just Run. Войдите, если еще не вошли, и нажмите *Разрешить полный доступ*.

### Codex[​](#connect-codex "Прямая ссылка на Codex")

Установите плагин — выполните в терминале по очереди:

```
codex plugin marketplace add https://platform.just-run.app/plugins/codex.git
codex plugin add just-run@just-run
```

Затем войдите в Just Run:

1. Выполните в терминале `codex mcp login just-run` — вход откроется в браузере.
2. Войдите в Just Run, если еще не вошли, и нажмите *Разрешить полный доступ*.
3. Начните новый сеанс Codex.

### По персональному токену[​](#connect-with-a-token "Прямая ссылка на По персональному токену")

Клиент должен поддерживать Streamable HTTP и пользовательские заголовки. Сценарий изменяет ресурсы, поэтому токену нужны права *Полные*. Если у токена права *Только чтение*, MCP не показывает инструменты создания, выполнения и удаления и отклоняет их вызов.

Создайте токен:

1. Откройте *Токены* в основной навигации.
2. Нажмите *Новый токен* и в поле *Название* задайте понятное имя. В поле *Права* выберите *Полные* для задачи из этого быстрого старта или *Только чтение* для агента, которому нужно только читать.
3. Нажмите *Создать токен*.
4. Сразу скопируйте токен: после закрытия диалога его значение не покажут ни интерфейс, ни API.

После создания диалог показывает блок *Подключить к Claude Code (MCP)*. Раскройте его, если он свернут: там готовая команда для Claude Code и файл `.mcp.json` с адресом текущей инсталляции и новым токеном.

Затем добавьте MCP-сервер в клиент. Для Claude Code замените условные значения на свои и выполните:

```
claude mcp add -s project --transport http just-run \
  https://your-just-run-host/mcp \
  --header "Authorization: Bearer your-personal-access-token"
```

Тот же сервер можно описать в файле `.mcp.json` — так конфигурацию показывает диалог создания токена:

```
{
  "mcpServers": {
    "just-run": {
      "type": "http",
      "url": "https://your-just-run-host/mcp",
      "headers": {
        "Authorization": "Bearer your-personal-access-token"
      }
    }
  }
}
```

Для другого клиента перенесите адрес и заголовок в формат его конфигурации.

предупреждение

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

## 2. Задача для агента[​](#2-ask-the-agent-to-complete-the-task "Прямая ссылка на 2. Задача для агента")

Когда ассистент подключен, проверьте его на простой задаче: агент создаст песочницу из шаблона `base`, выполнит в ней команду, покажет результат и удалит песочницу. Отправьте агенту промпт:

```
Using the just-run MCP tools, list the available templates, create a sandbox
from the base template, run `echo "hello from just-run"`, show me the exit code
and output, and then delete the sandbox. Do not leave any created resources.
```

## 3. Проверка результата[​](#3-verify-the-result "Прямая ссылка на 3. Проверка результата")

Агент должен сообщить:

* ID созданной песочницы;
* код выхода `0`;
* `hello from just-run` в stdout;
* успешное удаление.

Затем откройте *Песочницы* и убедитесь, что песочницы агента нет в списке. Если список длинный, введите в поле поиска ID из ответа агента: песочница не должна найтись.

Если агент вошел через браузер, его подключение видно в разделе *Токены* на вкладке *MCP-подключения*.

## Права и срок доступа агента[​](#agent-access-and-expiry "Прямая ссылка на Права и срок доступа агента")

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

Подключение через браузер истекает после 30 дней без использования и не позже чем через 90 дней после согласия, после этого войдите снова. Отозвать его раньше можно в разделе *Токены* на вкладке *MCP-подключения*: клиент сразу теряет доступ, а песочницы и другие ресурсы, которые он создал, продолжают работать.

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

* [Плагин Just Run](/skills.md#the-just-run-plugin-for-claude-code-and-codex)
* [Персональные токены](/accounts/personal-access-tokens.md)
* [Инструменты MCP управления платформой](/api-reference/mcp.md)
* [Основы работы с API](/developers/api-fundamentals.md)
* [Быстрый старт в веб-интерфейсе](/getting-started/web-ui.md)
