GUIDES / INTÉGRATION MCP

Connecter un client MCP à TO3D

Utilisez l’endpoint HTTP v2 en direct pour découvrir les outils TO3D depuis un client MCP. Ce guide documente l’endpoint et la découverte en lecture seule ; il ne prétend pas avoir testé tous les clients ni offrir un rigging automatique MCP.

Ouvrir la documentation API et MCP Lire le workflow API

Vérifié le 27 septembre 2026

Se connecter à l’endpoint live

Configurez https://mcp.to3d.app/v2/mcp. Les clients OAuth peuvent ouvrir TO3D WorkOS AuthKit ; les outils sans auth préparent ou inspectent une requête, mais la génération exige un compte.

Utilisez le chemin /v2/mcp pour la surface actuelle de 14 outils.
Demandez openid et email lorsque le client demande des portées OAuth.
La connexion autorise le lien ; elle ne soumet pas à elle seule une tâche de génération.

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

Exécuter la découverte MCP

Le client commence par initialize puis demande tools/list et resources/list. Ce sont les appels sûrs du live gate ; cette page ne lance aucune génération.

initialize établit le protocole et les informations du serveur.
tools/list renvoie les noms, les schémas et les schémas de sécurité.
resources/list renvoie les ressources du widget annoncées par le serveur.

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

Les 14 outils live

La réponse v2 sépare les actions de compte et de tâche protégées par OAuth des actions de préparation et de diagnostic sans auth. Les noms et schémas reçus font foi.

OAuth signifie que le client doit présenter la session du compte connecté.
Sans authentification, l’outil peut être appelé sans jeton de compte ; cela ne signifie pas que la génération est gratuite.
Les indications en lecture seule décrivent une annotation de l’outil et ne remplacent pas les contrôles d’autorisation du serveur.

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

Outils renvoyés par tools/list lors du contrôle en direct
Outil	Accès	But
`get_3d_credits`	OAuth	Lire les crédits disponibles
`estimate_3d_generation`	OAuth	Estimer les crédits de génération
`generate_3d`	OAuth	Générer à partir d’une image
`image-to-3d`	Sans authentification	Ouvrir le sélecteur d’image
`process_image_url_to_3d`	Sans authentification	Prévisualiser une URL d’image
`prepare_3d_generation`	Sans authentification	Préparer une image sélectionnée
`cancel_3d_generation`	Sans authentification	Annuler une requête non envoyée
`generate_3d_authenticated`	OAuth	Démarrer une génération préparée
`get_authenticated_generation`	OAuth	Vérifier une génération
`create_3d_job_from_url`	OAuth	Reprendre un job depuis une URL
`get_3d_job_status`	OAuth	Vérifier l’état du job
`get_3d_result`	OAuth	Obtenir le résultat d’un job
`get_3d_status`	OAuth	Vérifier une tâche
`report_widget_diagnostic`	Sans authentification	Enregistrer un diagnostic du widget

Suivre le flux de tâche

Préparez l’image, authentifiez-vous lorsque l’utilisateur choisit de générer, démarrez ou reprenez le job puis lisez son statut et son résultat. Conservez resumeKey, intentId, jobId ou taskId tels quels.

Lisez les crédits et l’estimation avant de demander une génération payante.
Utilisez get_3d_job_status ou get_3d_status pour observer une tâche, puis get_3d_result lorsque le serveur signale sa fin.
L’endpoint actuel n’expose pas d’outil MCP de rigging humanoïde ; utilisez le workflow REST de Skin Tokens pour une tâche séparée.

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

Limites du client et des capacités

Le studio Web et l’API REST ont leurs propres contrats. Un client MCP doit afficher ce qu’il découvre et ne pas copier les affirmations OAuth, rigging automatique ou compatibilité d’une autre route.

L’ancien chemin /mcp est une route de compatibilité existing-v1 et ne prouve pas cette liste d’outils v2.
La prise en charge OAuth est enregistrée pour cet endpoint actif ; les parcours de connexion de chaque client doivent encore être vérifiés séparément.
Aucune requête de génération n’a été effectuée pour ce guide.

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