Быстрый старт для 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:
- Запустите
claude, выполните/mcp, выберите серверplugin:just-run:just-runи пункт Authenticate. - В браузере откроется Just Run. Войдите, если еще не вошли, и нажмите Разрешить полный доступ.
Codex
Установите плагин — выполните в терминале по очереди:
codex plugin marketplace add https://platform.just-run.app/plugins/codex.git
codex plugin add just-run@just-run
Затем войдите в Just Run:
- Выполните в терминале
codex mcp login just-run— вход откроется в браузере. - Войдите в Just Run, если еще не вошли, и нажмите Разрешить полный доступ.
- Начните новый сеанс Codex.
По персональному токену
Клиент должен поддерживать Streamable HTTP и пользовательские заголовки. Сценарий изменяет ресурсы, поэтому токену нужны права Полные. Если у токена права Только чтение, MCP не показывает инструменты создания, выполнения и удаления и отклоняет их вызов.
Создайте токен:
- Откройте Токены в основной навигации.
- Нажмите Новый токен и в поле Название задайте понятное имя. В поле Права выберите Полные для задачи из этого быстрого старта или Только чтение для агента, которому нужно только читать.
- Нажмите Создать токен.
- Сразу скопируйте токен: после закрытия диалога его значение не покажут ни интерфейс, ни 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-подключения: клиент сразу теряет доступ, а песочницы и другие ресурсы, которые он создал, продолжают работать.