GUÍAS / INTEGRACIÓN MCP

Conecta un cliente MCP con TO3D

Usa el endpoint HTTP v2 en vivo para descubrir herramientas de TO3D desde un cliente MCP. Esta guía registra el endpoint y la evidencia de descubrimiento de solo lectura; no afirma que todos los clientes estén probados ni que MCP haga rigging automático.

Abrir documentación API y MCP Leer el flujo de API

Verificado el 27 de septiembre de 2026

Conecta al endpoint vivo

Configura https://mcp.to3d.app/v2/mcp en tu cliente. Los clientes con OAuth pueden iniciar sesión con TO3D WorkOS AuthKit; las herramientas sin auth preparan o inspeccionan una petición, pero generar requiere una cuenta.

Usa la ruta /v2/mcp para la superficie actual de 14 herramientas.
Solicita openid y email cuando el cliente pida ámbitos OAuth.
Iniciar sesión autoriza la conexión; por sí solo no envía una tarea de generación.

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

Ejecuta el descubrimiento MCP

El cliente empieza con initialize y después solicita tools/list y resources/list. Son las llamadas de descubrimiento usadas en la puerta en vivo; esta página no invoca generación.

initialize establece el protocolo y la información del servidor.
tools/list devuelve nombres, esquemas y esquemas de seguridad.
resources/list devuelve los recursos del widget anunciados por el servidor.

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

Las 14 herramientas en vivo

La respuesta v2 separa acciones de cuenta y tareas protegidas por OAuth de acciones de preparación y diagnóstico sin auth. Los nombres y esquemas descubiertos son la fuente de verdad.

OAuth significa que el cliente debe presentar la sesión de la cuenta conectada.
Sin autenticación, la herramienta puede llamarse sin un token de cuenta; eso no implica generación gratuita.
Las indicaciones de solo lectura describen una anotación de la herramienta y no sustituyen las comprobaciones de autorización del servidor.

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

Herramientas devueltas por tools/list en la comprobación activa
Herramienta	Acceso	Uso
`get_3d_credits`	OAuth	Consultar los créditos disponibles
`estimate_3d_generation`	OAuth	Estimar los créditos de generación
`generate_3d`	OAuth	Generar a partir de una imagen
`image-to-3d`	Sin autenticación	Abrir el selector de imágenes
`process_image_url_to_3d`	Sin autenticación	Previsualizar una URL de imagen
`prepare_3d_generation`	Sin autenticación	Preparar una imagen seleccionada
`cancel_3d_generation`	Sin autenticación	Cancelar una solicitud no enviada
`generate_3d_authenticated`	OAuth	Iniciar una generación preparada
`get_authenticated_generation`	OAuth	Comprobar una generación
`create_3d_job_from_url`	OAuth	Reanudar un trabajo desde una URL
`get_3d_job_status`	OAuth	Comprobar el estado del trabajo
`get_3d_result`	OAuth	Obtener el resultado del trabajo
`get_3d_status`	OAuth	Comprobar una tarea
`report_widget_diagnostic`	Sin autenticación	Registrar un diagnóstico del widget

Sigue el flujo de tarea

Prepara una imagen, autentica cuando el usuario decide generar, inicia o reanuda el trabajo y lee estado y resultado. Conserva resumeKey, intentId, jobId o taskId sin inventarlos.

Lee los créditos y calcula el coste antes de solicitar una generación de pago.
Usa get_3d_job_status o get_3d_status para observar una tarea y luego get_3d_result cuando el servidor indique que terminó.
El endpoint actual no expone una herramienta MCP de rigging humanoide; usa el flujo REST de Skin Tokens para una tarea de rigging independiente.

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

Límites del cliente y la capacidad

El estudio web y la API REST tienen contratos propios. Un cliente MCP debe mostrar solo lo que descubre y no copiar afirmaciones de OAuth, rigging automático o compatibilidad de otra ruta.

La ruta antigua /mcp es una ruta de compatibilidad existing-v1 y no demuestra esta lista de herramientas v2.
La compatibilidad con OAuth está registrada para este endpoint activo; los flujos de inicio de sesión de cada cliente aún requieren verificación específica.
Esta guía no realizó ninguna solicitud de generación.

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