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

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

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

Перед началом​

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

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

Агент работает в аккаунте, который активен в Just Run в момент входа. Чтобы агент работал в организации, сначала переключитесь на нее в веб-интерфейсе.

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

1. Подключение ассистента​

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​

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

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.

По персональному токену​

Клиент должен поддерживать 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. Задача для агента​

Когда ассистент подключен, проверьте его на простой задаче: агент создаст песочницу из шаблона 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. Проверка результата​

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

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

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

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

Права и срок доступа агента​

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

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