GUIDES / MCP-INTEGRATION

Einen MCP-Client mit TO3D verbinden

Nutze den Live-HTTP-Endpunkt v2, um TO3D-Tools aus einem MCP-Client zu entdecken. Dieser Guide dokumentiert Endpunkt und schreibgeschützte Discovery; er behauptet weder Tests jedes Clients noch automatisches Rigging durch MCP.

API- und MCP-Doku öffnen API-Ablauf lesen

Geprüft am 27. September 2026

Mit dem Live-Endpunkt verbinden

Konfiguriere https://mcp.to3d.app/v2/mcp. OAuth-fähige Clients können TO3D WorkOS AuthKit öffnen; No-Auth-Tools bereiten eine Anfrage vor oder prüfen sie, aber Erzeugung braucht ein Konto.

Verwende für die aktuelle Oberfläche mit 14 Tools den Pfad /v2/mcp.
Fordere openid und email an, wenn der Client OAuth-Scopes abfragt.
Die Anmeldung autorisiert die Verbindung; sie sendet selbst keine Generierungsaufgabe.

{
  "mcpServers": {
    "to3d": {
      "url": "https://mcp.to3d.app/v2/mcp"
    }
  }
}

MCP-Discovery ausführen

Der Client beginnt mit initialize und fragt danach tools/list und resources/list ab. Das sind die sicheren Discovery-Aufrufe des Live-Gates; dieser Guide startet keine Erzeugung.

initialize legt Protokoll und Serverinformationen fest.
tools/list gibt Namen, Schemas und Sicherheitsschemata zurück.
resources/list gibt die vom Server angebotenen Widget-Ressourcen zurück.

{"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":{}}

Die 14 Live-Tools

Die v2-Antwort trennt per OAuth geschützte Konto- und Task-Aktionen von No-Auth-Vorbereitung und Diagnose. Namen und Schemas der Antwort sind die Quelle der Wahrheit.

OAuth bedeutet, dass der Client die Sitzung des verbundenen Kontos vorlegen muss.
Ohne Authentifizierung kann das Tool ohne Kontotoken aufgerufen werden; das bedeutet keine kostenlose Generierung.
Nur-Lese-Hinweise beschreiben eine Tool-Annotation und ersetzen nicht die Autorisierungsprüfungen des Servers.

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":{}}'

Von tools/list beim Live-Gate zurückgegebene Tools
Tool	Zugriff	Zweck
`get_3d_credits`	OAuth	Verfügbare Credits lesen
`estimate_3d_generation`	OAuth	Generierungsguthaben schätzen
`generate_3d`	OAuth	Aus einem Bild generieren
`image-to-3d`	Keine Authentifizierung	Bildauswahl öffnen
`process_image_url_to_3d`	Keine Authentifizierung	Bild-URL in der Vorschau anzeigen
`prepare_3d_generation`	Keine Authentifizierung	Ausgewähltes Bild vorbereiten
`cancel_3d_generation`	Keine Authentifizierung	Nicht gesendete Anfrage abbrechen
`generate_3d_authenticated`	OAuth	Vorbereitete Generierung starten
`get_authenticated_generation`	OAuth	Generierung prüfen
`create_3d_job_from_url`	OAuth	3D-Job aus URL fortsetzen
`get_3d_job_status`	OAuth	Jobstatus prüfen
`get_3d_result`	OAuth	Jobergebnis abrufen
`get_3d_status`	OAuth	Aufgabe prüfen
`report_widget_diagnostic`	Keine Authentifizierung	Widget-Diagnose aufzeichnen

Dem Task-Ablauf folgen

Bild vorbereiten, bei der Erzeugung authentifizieren, Job starten oder fortsetzen und Status und Ergebnis lesen. resumeKey, intentId, jobId und taskId unverändert behalten.

Lies Guthaben und Schätzung, bevor du eine kostenpflichtige Generierung anforderst.
Verwende get_3d_job_status oder get_3d_status, um eine Aufgabe zu beobachten, und danach get_3d_result, wenn der Server den Abschluss meldet.
Der aktuelle Endpunkt bietet kein MCP-Tool für Humanoid-Rigging; verwende für eine separate Rig-Aufgabe den REST-Workflow von Skin Tokens.

prepare -> authenticate -> generate_3d_authenticated -> get_3d_job_status -> get_3d_result

Grenzen von Client und Fähigkeit

Web-Studio und REST-API haben eigene Verträge. Ein MCP-Client soll nur Entdecktes anzeigen und OAuth-, Auto-Rigging- oder Kompatibilitätsaussagen anderer Routen nicht übertragen.

Der ältere /mcp-Pfad ist eine existing-v1-Kompatibilitätsroute und kein Beleg für diese v2-Tool-Liste.
Die OAuth-Unterstützung ist für diesen Live-Endpunkt dokumentiert; die Anmeldung einzelner Clients muss weiterhin client-spezifisch geprüft werden.
Für diesen Leitfaden wurde keine Generierungsanfrage gestellt.

endpoint=https://mcp.to3d.app/v2/mcp
legacy=https://mcp.to3d.app/mcp