Symbioza

Запускайте дообучение, оценку и пакетный инференс на облачном GPU из Claude Code, установив жесткий лимит расходов. Агент подготовит задачу, покажет бесплатную оценку стоимости и отправит её только после вашего подтверждения. Symbioza выберет машину, выполнит задачу и вернёт созданные файлы. С вас никогда не спишут больше установленного вами лимита расходов.

Что добавляет плагин

Symbioza запускает контейнеризированную задачу на GPU арендованной облачной машины в пределах установленного денежного лимита и собирает доступные артефакты. Агент передаёт образ, команду и бюджет через один MCP-коннектор. Symbioza выбирает вычислительные ресурсы, выполняет задачу и отдельно сообщает о передаче результатов и оплате. Возможность возобновления работы зависит от политики задачи, доступности вычислительных ресурсов, оставшегося бюджета и поддержки совместимых контрольных точек.

Размещённый MCP-сервер по адресу https://symbioza.dev/mcp (Streamable HTTP, вход через OAuth, API key не требуется). В его состав входят

девять инструментов: estimateExecution, submitJob, getStatus, inspectRun, getArtifact, listJobs, listSecrets,

describeDataset, cancelJob.
Один навык — /symbioza:run-on-symbioza. Он подсказывает агенту, подходит ли задача для Symbioza, что нужно у вас уточнить, и какие четыре вызова провести — от спецификации до файлов: оценка, отправка, проверка статуса, получение артефактов.

Информация для агентов, которые оценивают, подходит ли задача: https://symbioza.dev/agent

VS Code, GitHub Copilot и другие MCP-клиенты

Плагин для использования Symbioza не нужен: сервер доступен по тому же удалённому адресу MCP — https://symbioza.dev/mcp.

Подключиться к нему может любой клиент, который поддерживает удалённый MCP через Streamable HTTP с входом через OAuth. Если клиент запрашивает заголовки или API key, оставьте поля пустыми: при первом подключении клиента вы войдёте в систему через браузер.

В VS Code выполните команду MCP: Add Server из палитры команд или добавьте этот фрагмент в .vscode/mcp.json:

{
  "servers": {
    "symbioza": { "type": "http", "url": "https://symbioza.dev/mcp" }
  }
}

Затем запросите бесплатную оценку (шаг 4). Инструкции по настройке ChatGPT, Claude.ai и других клиентов:

https://symbioza.dev/plugins

Cursor

Выберите один из двух способов, но не оба сразу: иначе агент увидит каждый инструмент дважды.

Подключение напрямую. Добавьте сервер в ~/.cursor/mcp.json (для всех проектов) или в .cursor/mcp.json одного проекта, объединив конфигурацию с уже имеющимся блоком mcpServers, если он есть:

{
  "mcpServers": {
    "symbioza": { "url": "https://symbioza.dev/mcp" }
  }
}

Откройте Customize на боковой панели, включите symbioza в разделе MCPs и завершите вход через браузер. Агент получит доступ к девяти инструментам. Навык run-on-symbioza при этом не устанавливается, а публикация в каталоге не требуется.

Установка плагина. Скопируйте этот репозиторий в ~/.cursor/plugins/local/symbioza (именно скопируйте: Cursor пропускает символическую ссылку, ведущую за пределы этой директории), перезапустите Cursor или выполните Developer: Reload Window, затем убедитесь в разделе Customize, что в списке есть навык run-on-symbioza и MCP-сервер symbioza. Включите сервер и завершите вход через браузер; вызовите навык командой /run-on-symbioza. Политика команды может запрещать импорт локальных плагинов.

Информация о входе, использовании и стоимости, а также список проверок: docs/cursor.md.

1. Установка

Шаги 1–3 и команды обновления предназначены для Claude Code. Инструкции для Cursor приведены в разделе выше.

claude plugin marketplace add symbioza/claude-plugin
claude plugin install symbioza@symbioza

Или выполните обе команды сразу из сеанса Claude Code (Claude Code v2.1.275 или более поздней версии):

/plugin install symbioza --marketplace symbioza/claude-plugin. Проверено на Claude Code 2.1.283.

После установки из командной строки появится сообщение Successfully installed plugin: symbioza@symbioza: чтобы начать работу, запустите новый сеанс

Claude Code. Если плагин установлен из сеанса, Claude Code сообщит либо Plugin is now active., либо

Run /reload-plugins to activate. — в последнем случае выполните /reload-plugins.

2. Вход в систему

Прежде чем инструменты коннектора появятся, нужно один раз войти в систему. Выполните /mcp, выберите plugin:symbioza:symbioza

и нажмите Authenticate: в браузере откроется страница входа через Google, GitHub или адрес электронной почты. Создавать или передавать ключ не нужно.

3. Проверка подключения

Подключение настроено, если выполняются все три условия:

В списке /mcp указано, что plugin:symbioza:symbioza подключён и предоставляет девять инструментов.
При вводе / отображается /symbioza:run-on-symbioza.
Команда claude plugin list показывает, что symbioza@symbioza включён.

Уже добавляли коннектор командой claude mcp add? Удалите его (claude mcp remove symbioza), чтобы

агент не видел каждый инструмент дважды.

4. Получение бесплатной оценки

Вставьте этот текст или запустите /symbioza:run-on-symbioza:

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

Для получения оценки лимит расходов не нужен. Сначала указываются предполагаемая стоимость, её диапазон, ожидаемое время выполнения и степень уверенности. Это приблизительная оценка, а не коммерческое предложение. Если по имеющимся данным невозможно предсказать время выполнения задачи, вместо общей стоимости указывается цена каждого часа работы. Затем приводятся сведения о том, что включено в оценку, чего ещё не хватает, и о доступном остатке на вашем счёте. Когда вы выберете лимит расходов, оценка будет рассчитана повторно с его учётом: лимит задаёт максимальную сумму, а в карточке будет показано, на каком этапе выполнение остановится и хватит ли для этого средств. Примеры спецификаций для дообучения, оценки и пакетного инференса:

https://symbioza.dev/examples

5. Пополнение счёта и отправка задачи

Необходимы два условия: наличие аккаунта и средств на его балансе. Новый пользователь может подключиться, получить оценку и просмотреть список собственных задач, но при отправке задачи появится отказ: «предоплаченный баланс: доступно $0.00 … Пополните счёт или уменьшите бюджет». Пополните счёт по адресу https://symbioza.dev/app/topup: войдите в систему и внесите средства с карты. Счёт можно пополнить на любую целую сумму в долларах в пределах ограничений Symbioza — пакеты пополнения лишь упрощают этот процесс. Если средств не хватает, оценка покажет недостающую сумму, а агент предоставит ссылку для пополнения с уже указанной суммой. Открытие страницы оплаты не означает пополнение счёта: после оплаты запросите новую оценку. Пакеты пополнения и информация об оплате:

https://symbioza.dev/pricing

Когда вас устроит оценка, попросите агента отправить задачу. До этого момента ничего не будет зарезервировано или списано.

6. Получение файлов

Попросите агента проверить статус задачи (getStatus). Когда выполнение завершится, запросите файлы (getArtifact): для каждого переданного файла вы получите ссылку для скачивания и хеш, с помощью которого можно проверить его целостность. Срок действия ссылок — 24 часа. Чтобы получить новые, отправьте запрос ещё раз.

Что потребуется от вас

Поддерживаемый образ контейнера. Symbioza запускает образы, проверенные на её машинах (на данный момент — образы PyTorch и

TensorFlow). Любой другой образ будет отклонён с указанием актуального списка поддерживаемых образов — до того,

как что-либо будет зарезервировано или оплачено. В стандартном образе нет вашего кода, поэтому команда должна загружать

скрипт и все необходимые файлы, например, по URL.
Команда для запуска задачи — в том виде, в каком вы ввели бы её в контейнере.
Данные, доступные машине: она может загрузить их по URL, но не получить файлы с вашего компьютера. Используйте подписанную ссылку

с минимальным сроком действия, достаточным для передачи данных.
Выходные файлы, сохранённые в /workspace/artifacts/. Symbioza вернёт содержимое этой директории; файлы, сохранённые

в других местах, не собираются.
Общий лимит расходов на задачу в долларах США.

Учётные данные: сохранённые Secrets, а не чат

Если для задачи нужен токен Hugging Face, ключи хранилища или другие учётные данные, агент получает их из сохранённого Secret, а не из чата. Агент соблюдает следующее правило:

Никогда не просите пользователя отправлять в чат ключи API, токены доступа, пароли или облачные учётные данные и никогда не помещайте их в env — переменные env предназначены для нечувствительных параметров конфигурации.

Сохраните учётные данные один раз на странице https://symbioza.dev/app/secrets, а агент прикрепит их к задаче по имени (secrets). Агент может получить список сохранённых наборов с помощью listSecrets: команда возвращает только имена и типы. После сохранения ни одна страница, API или инструмент не показывают значение. Если задаче нужен доступ, учётные данные для которого ещё не сохранены, агент предоставит ссылку для настройки Symbioza. Перейдите по ней, сохраните учётные данные и сообщите агенту, когда закончите.

Как обрабатываются сохранённые Secrets: Symbioza хранит их в зашифрованном виде, и ни одна страница, API или инструмент не возвращают их значения; задача, к которой прикреплён набор, получает открытые значения в своём окружении, и машина, на которой выполняется задача, технически может их прочитать; точная копия значения длиной от четырёх символов в выводе задачи или его форма в кодировке base64 либо URL-кодировке для значения длиной от восьми символов заменяется на [redacted] перед сохранением вывода — проверяется точное совпадение, но это не гарантирует защиту, если значение выведено в другой форме; созданные задачей файлы передаются без изменений и не проверяются на наличие учётных данных; учётные данные, помещённые в env в более ранней задаче, остаются в сохранённой спецификации этой задачи — сохранение Secret не удаляет их.

Как выполняются задачи, передаются файлы и работает отмена

Ограничение по времени. Для каждого запуска устанавливается лимит времени: он определяется тем, сколько позволяет ваш лимит расходов на забронированной машине, и любым заданным вами ограничением, но не может превышать максимальные 48 часов, установленные платформой. Оценка показывает лимит до списания средств; сама машина, на которой выполняется задача, может завершить запуск раньше. Ограничение свыше 48 часов будет отклонено и при оценке, и при отправке задачи.
Файлы. Проверяйте статус передачи файлов отдельно от статуса запуска. Для доступных выходных файлов предоставляются ссылки на скачивание и хеши, по которым можно проверить их целостность. Успешное завершение запуска само по себе не подтверждает передачу файлов или окончательный расчёт. Ссылки на скачивание действуют 24 часа; сами файлы не удаляются.
Возобновление. Возможность повторного запуска или переноса на другую машину зависит от политики задачи, доступных вычислительных ресурсов и остатка лимита расходов. Для восстановления по контрольной точке код должен поддерживать совместимую логику сохранения и возобновления. Запуск может остановиться, не завершившись.
Отмена. При отмене задача останавливается, а выделенная ей машина освобождается. Если остановка подтверждена, оплата начисляется за измеренное время до момента остановки. Если связаться с машиной не удаётся, оплата начисляется только до момента отправки запроса на отмену — и в любом случае не превышает установленный вами лимит расходов.

Сколько вы платите

Оценки, проверки статуса и просмотр списка собственных задач бесплатны.
Отправленные задачи оплачиваются предоплаченными средствами.
Если задача завершается с ошибкой или вы её отменяете, оплата начисляется за время работы машины — не больше установленного вами лимита расходов.
Лимит расходов — это жёсткий верхний предел: сумма списания никогда его не превысит. Лимит проверяется перед бронированием машины и перед каждой повторной попыткой. Сумма, показанная после завершения задачи, может измениться при сверке расчётов.

Конфиденциальность

Задачи выполняются на вычислительных ресурсах сторонних поставщиков. Образ задачи, команда, ссылки на наборы данных, переменные окружения и последние фрагменты журналов обрабатываются на серверах Symbioza и могут храниться. Поэтому не помещайте в них секреты: никогда не добавляйте учётные данные в спецификацию задачи или её переменные окружения и не отправляйте закрытые SSH-ключи. Учётные данные следует хранить в сохранённых Secrets: они хранятся в зашифрованном виде и передаются задаче только во время её выполнения. Отправляйте только тот код и данные, на использование которых у вас есть разрешение.

Конфиденциальность: https://symbioza.dev/privacy · Условия использования: https://symbioza.dev/terms

Обновление и удаление

Эти команды обновляют уже установленный плагин. Если вы устанавливаете его впервые, см. шаг 1. Автоматическое обновление для этой площадки по умолчанию отключено. Чтобы обновить плагин:

claude plugin marketplace update symbioza
claude plugin update symbioza@symbioza

После обновления появится сообщение Restart to apply changes.: перезапустите Claude Code, чтобы загрузить новую версию.

Чтобы удалить плагин:

claude plugin uninstall symbioza@symbioza
claude plugin marketplace remove symbioza

Удаление плагина не отменяет уже отправленные задачи и не закрывает вашу учётную запись Symbioza.

Сначала отмените выполняющиеся задачи (попросите агента вызвать cancelJob), а учётной записью управляйте на странице https://symbioza.dev/app.

Помощь

Проблемы с установкой или использованием плагина: создайте issue по адресу

https://github.com/symbioza/claude-plugin/issues. Перед публикацией удалите конфиденциальные данные: никогда не размещайте токены, ключи, сведения об учётной записи или закрытые данные задач.

Учётная запись, платёж, конфиденциальность или безопасность: воспользуйтесь контактной формой по адресу https://symbioza.dev/contact.
Другие клиенты (ChatGPT, Claude, любой удалённый MCP-клиент): https://symbioza.dev/plugins

Изменения и лицензия

Примечания к выпуску: CHANGELOG.md. Лицензия MIT — см. LICENSE. Лицензия распространяется только на файлы этого плагина.