TO3D
ガイド / MCP連携

MCPクライアントをTO3Dへ接続

ライブv2 HTTPエンドポイントを使って、MCP対応クライアントからTO3Dツールを確認します。ここではエンドポイントと読み取り専用の証拠を記録し、全クライアントの検証やMCPによる自動リギングを約束しません。

APIとMCPのドキュメントを開くAPIワークフローを読む

2026年9月27日確認済み

ライブエンドポイントへ接続

クライアントに https://mcp.to3d.app/v2/mcp を設定します。OAuth対応クライアントはTO3D WorkOS AuthKitへサインインできます。no-authツールは準備や確認に使えますが、生成にはアカウントが必要です。

  • 現在の 14 ツールの構成には /v2/mcp パスを使用します。
  • クライアントが OAuth スコープを求めたら openid と email を要求します。
  • サインインは接続を認可しますが、それだけで生成タスクを送信することはありません。
{
  "mcpServers": {
    "to3d": {
      "url": "https://mcp.to3d.app/v2/mcp"
    }
  }
}

MCPディスカバリーを実行

クライアントはinitializeから始め、tools/listとresources/listを呼びます。これがライブゲートで使った安全な確認であり、このページでは生成ツールを呼びません。

  • initialize はプロトコルとサーバー情報を確立します。
  • tools/list は名前、スキーマ、セキュリティスキームを返します。
  • resources/list はサーバーが案内するウィジェットリソースを返します。
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"your-client","version":"1.0"}}}
{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}
{"jsonrpc":"2.0","id":3,"method":"resources/list","params":{}}

ライブの14ツール

現在のv2応答は、OAuthで保護されたアカウント・タスク操作と、no-authの準備・診断操作を分けています。実装の真実は実際に取得した名前とスキーマです。

  • OAuth では、クライアントが接続済みアカウントのセッションを提示する必要があります。
  • 認証なしの場合、アカウントトークンなしでツールを呼び出せますが、生成が無料になるわけではありません。
  • 読み取り専用のヒントはツールのアノテーションを示すもので、サーバーの認可チェックに代わるものではありません。
curl -fsS https://mcp.to3d.app/v2/mcp -H 'content-type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'
ライブゲートで tools/list が返したツール
ツールアクセス用途
get_3d_creditsOAuth利用可能なクレジットを確認
estimate_3d_generationOAuth生成クレジットを見積もる
generate_3dOAuth画像から生成
image-to-3d認証なし画像ピッカーを開く
process_image_url_to_3d認証なし画像 URL をプレビュー
prepare_3d_generation認証なし選択した画像を準備
cancel_3d_generation認証なし未送信のリクエストをキャンセル
generate_3d_authenticatedOAuth準備済みの生成を開始
get_authenticated_generationOAuth生成を確認
create_3d_job_from_urlOAuthURL から 3D ジョブを再開
get_3d_job_statusOAuthジョブの状態を確認
get_3d_resultOAuthジョブ結果を取得
get_3d_statusOAuthタスクを確認
report_widget_diagnostic認証なしウィジェット診断を記録

タスクの流れ

画像を準備し、生成時に認証し、ジョブを開始または再開して状態と結果を読み取ります。各段階が返すresumeKey、intentId、jobId、taskIdをそのまま保持します。

  • 有料生成を依頼する前に、クレジットと見積もりを確認します。
  • タスクの確認には get_3d_job_status または get_3d_status を使い、サーバーが完了を報告したら get_3d_result を使います。
  • 現在のエンドポイントには MCP の humanoid リギングツールはありません。別のリグタスクには REST の Skin Tokens ワークフローを使います。
prepare -> authenticate -> generate_3d_authenticated -> get_3d_job_status -> get_3d_result

クライアントと能力の境界

WebスタジオとREST APIには別の契約があります。MCPクライアントは実際に発見したツールとスキーマだけを表示し、他のルートのOAuth、自動リギング、互換性の主張をコピーしないでください。

  • 古い /mcp パスは existing-v1 の互換ルートであり、この v2 ツール一覧の根拠にはなりません。
  • このライブエンドポイントの OAuth 対応は記録されていますが、各クライアントのサインインフローは個別に検証する必要があります。
  • このガイドでは生成リクエストを実行していません。
endpoint=https://mcp.to3d.app/v2/mcp
legacy=https://mcp.to3d.app/mcp
APIワークフローcurlで画像をGLBに変換ガイドを読む →GLB検査TO3D GLBの中身ガイドを読む →リギングの境界humanoidリギングを理解するガイドを読む →