Symbioza

Symbioza

Claude Code からクラウド GPU でファインチューニング、評価、バッチ推論のジョブを、厳格な支出上限のもとで実行できます。 エージェントがジョブを準備し、無料の見積もりを提示します。実行するのは、あなたが指示したときだけです。Symbioza がマシンを選び、ジョブを実行して、生成されたファイルを返します。設定した支出上限を超えて請求されることはありません。

プラグインでできること

Symbioza は、厳格な金額上限のもとでレンタルしたクラウドマシン上のコンテナ化された GPU ジョブを実行し、利用可能な成果物を収集します。エージェントは 1 つの MCP コネクターを通じて、イメージ、コマンド、予算を送信します。Symbioza はコンピューティングリソースを選択してジョブを実行し、出力の配信状況と請求額を個別に報告します。復旧できるかどうかは、ジョブポリシー、利用可能なコンピューティングリソース、残りの予算、互換性のあるチェックポイントのサポート状況によって異なります。

• ホスト型 MCP サーバー（https://symbioza.dev/mcp、ストリーミング可能な HTTP、OAuth でサインイン、API キー不要）。9 つのツール：estimateExecution、submitJob、getStatus、inspectRun、getArtifact、listJobs、listSecrets、describeDataset、cancelJob。
• 1 つのスキル、/symbioza:run-on-symbioza。 ジョブが Symbioza に適しているか、何を確認すべきか、仕様の作成からファイル取得までの 4 つの呼び出し（見積もり、送信、ステータス、成果物）をエージェントに伝えます。

ジョブが適しているかどうかを判断するエージェント向けの情報：https://symbioza.dev/agent

VS Code、GitHub Copilot、その他の MCP クライアント

Symbioza の利用にプラグインは不要です。サーバーは同じリモート MCP エンドポイント https://symbioza.dev/mcp です。OAuth サインインに対応したリモート Streamable HTTP MCP クライアントであれば、どれでも接続できます。クライアントからヘッダーや API キーを求められた場合は、空欄のままにしてください。クライアントの初回接続時に、ブラウザーでサインインします。

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

2 つの方法のうち、どちらか一方だけを選んでください。両方選ぶと、エージェントにすべてのツールが重複して表示されます。

直接接続する。 サーバーを ~/.cursor/mcp.json（すべてのプロジェクト向け）または、1 つのプロジェクト内の .cursor/mcp.json に追加します。すでに mcpServers ブロックがある場合は、そこに統合してください。

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

サイドバーで Customize を開き、MCPs の下にある symbioza を有効にして、ブラウザーでサインインを完了します。これでエージェントは 9 つのツールを使えるようになります。run-on-symbioza スキルはインストールされず、マーケットプレイスへの掲載も必要ありません。

プラグインをインストールする。 このリポジトリを ~/.cursor/plugins/local/symbioza にコピーします（実際にコピーしてください。Cursor は、このディレクトリの外を指すシンボリックリンクをスキップします）。Cursor を再起動するか Developer: Reload Window を実行し、Customize に run-on-symbioza スキルと symbioza MCP サーバーが表示されていることを確認します。サーバーを有効にして、ブラウザーでサインインを完了してください。スキルを呼び出すには /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. 接続を確認する

次の 3 つすべてを満たしていれば、準備完了です。

• /mcp に plugin:symbioza:symbioza が 9 つのツールとともに接続済みとして表示されている。
• / を入力すると /symbioza:run-on-symbioza が表示される。
• claude plugin list に symbioza@symbioza が有効として表示されている。

すでに claude mcp add でコネクターを追加している場合は、エージェントにすべてのツールが重複して表示されないよう、そのコピーを削除してください（claude mcp remove symbioza）。

4. 無料の見積もりを取得する

次の内容を貼り付けるか、/symbioza:run-on-symbioza を実行します。

Symbioza で実行するこの GPU ジョブの準備を手伝ってください。コンテナーイメージ、コマンド、入力データ、予想される出力ファイルについて質問してください。ワークロードが現在のサービス制限に収まるか確認してください。無料の見積もりと不足している情報を示してから、合計支出上限を尋ねてください。まだジョブは送信しないでください。

見積もりの取得に支出上限は不要です。見積もりでは、想定コストとその幅、予想実行時間、信頼度を最初に提示します。これは可能な限りの見積もりであり、確約ではありません。ジョブから実行時間を予測できない場合は、合計額ではなく 1 時間あたりの実行料金を提示します。その後、見積もりに含まれる内容、不足している情報、アカウントのクレジットを示します。支出上限を選ぶと、それを反映して見積もりが再実行されます。上限は厳守される最大額で、カードには上限に達した時点で実行が停止する場所と、クレジットで費用を賄えるかどうかが示されます。ファインチューニング、評価、バッチ推論の実例仕様については、https://symbioza.dev/examples を参照してください。

5. クレジットを追加して送信する

2 つの条件があります。アカウントと、そのアカウントに入金されたクレジットです。新しいアカウントでも接続、見積もり、自分のジョブ一覧の確認はできますが、アカウントにクレジットがない場合、送信は拒否されます。「利用可能なプリペイド残高：$0.00 … チャージするか、予算を減らしてください。」と表示されます。https://symbioza.dev/app/topup でサインインし、カードでクレジットを追加してください。Symbioza の上限内であれば、1 ドル単位の任意の金額を追加できます。パックは手軽に購入するためのものです。見積もりでジョブの費用がクレジットでまかなえないと分かった場合、不足額が示され、エージェントからその金額があらかじめ入力されたチャージ用リンクが提示されます。チェックアウトを開いただけではクレジットは追加されません。支払いが済んだら、あらためて見積もりを依頼してください。クレジットパックと請求の詳細： https://symbioza.dev/pricing

見積もりに問題がなければ、エージェントに送信するよう伝えてください。送信するまでは、予約も請求も行われません。

6. ファイルを取得する

エージェントにジョブのステータス（getStatus）を尋ねてください。実行が完了したら、ファイル（getArtifact）を依頼してください。提供される各ファイルには、ダウンロードリンクと検証用のハッシュが付属します。リンクの有効期限は 24 時間です。新しいリンクが必要な場合は、再度依頼してください。

エージェントから確認される内容

• サポート対象のコンテナイメージ。 Symbioza は、自社のマシンで検証済みのイメージ（現在は PyTorch と TensorFlow のイメージ）を実行します。それ以外のイメージは、予約も請求も行われる前に、現在サポートされているイメージの一覧とともに拒否されます。標準のイメージにはコードが含まれていないため、コマンドでスクリプトや必要なものを URL などから取得する必要があります。
• ジョブを実行するコマンド。コンテナ内で入力するコマンドを指定してください。
• マシンからアクセスできる入力データ：マシンが自分でダウンロードする URL であり、ノートパソコン上のファイルではありません。ステージングに必要な期間だけ有効な署名付きリンクを使用してください。
• /workspace/artifacts/ に書き込む出力ファイル。このディレクトリ内のファイルが返されます。それ以外の場所に書き込まれたファイルは収集されません。
• ジョブの合計支出上限。米ドルで指定してください。

認証情報：チャットには書かず、保存済みの Secrets を使用

Hugging Face トークン、ストレージキーなどの認証情報が必要なジョブでは、チャットではなく、保存済みの Secret を使用します。エージェントは次のルールに従います。

API キー、アクセストークン、パスワード、クラウド認証情報をチャットに貼り付けるようユーザーに求めてはいけません。また、それらを env に入れてはいけません。env は機密情報ではない設定に使用します。

認証情報を一度 https://symbioza.dev/app/secrets に保存すると、エージェントは名前（secrets）でジョブに追加できます。エージェントは listSecrets を使って、保存済みのセットの名前と種類だけを一覧表示できます。保存後は、ページ、API、ツールのいずれからも値を確認できません。ジョブに必要なアクセス権がまだ保存されていない場合、エージェントから Symbioza の設定リンクが提示されます。リンクを開いて認証情報を保存し、完了したらエージェントに伝えてください。

保存済み Secret の取り扱い：Symbioza は Secret を暗号化して保存し、ページ、API、ツールのいずれからも値を返しません。そのセットを追加したジョブには、環境変数として平文の値が渡されます。また、そのジョブを実行するマシンは技術的に値を読み取ることができます。ジョブの出力に印字された 4 文字以上の値との完全一致、および 8 文字以上の値を 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 で行ってください。

ヘルプ

• プラグインのインストールや使用に関する問題： https://github.com/symbioza/claude-plugin/issues でイシューを作成してください。投稿前に、トークン、キー、アカウントの詳細、非公開のジョブデータを必ず削除してください。
• アカウント、お支払い、プライバシー、セキュリティに関するお問い合わせ： https://symbioza.dev/contact のお問い合わせフォームをご利用ください。
• その他のクライアント（ChatGPT、Claude、任意のリモート MCP クライアント）：https://symbioza.dev/plugins

変更履歴とライセンス

リリースノート：CHANGELOG.md。MIT — LICENSE を参照してください。ライセンスの対象は、このプラグインのファイルのみです。