GUIAS / INTEGRAÇÃO MCP

Conecte um cliente MCP à TO3D

Use o endpoint HTTP v2 ao vivo para descobrir ferramentas da TO3D em um cliente MCP. Este guia registra o endpoint e a evidência de descoberta somente leitura; não afirma que todos os clientes foram testados nem que MCP faz rigging automático.

Abrir documentação de API e MCP Ler o fluxo da API

Verificado em 27 de setembro de 2026

Conecte ao endpoint ao vivo

Configure https://mcp.to3d.app/v2/mcp no cliente. Clientes com OAuth podem fazer login no TO3D WorkOS AuthKit; ferramentas sem auth preparam ou inspecionam uma requisição, mas gerar exige uma conta.

Use o caminho /v2/mcp para a superfície atual de 14 ferramentas.
Solicite openid e email quando o cliente pedir escopos OAuth.
Entrar autoriza a conexão; isso não envia uma tarefa de geração por si só.

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

Faça a descoberta MCP

O cliente começa com initialize e depois pede tools/list e resources/list. Essas chamadas foram usadas no live gate; esta página não chama geração.

initialize estabelece o protocolo e as informações do servidor.
tools/list retorna nomes, esquemas e esquemas de segurança.
resources/list retorna os recursos do widget anunciados pelo 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":{}}

As 14 ferramentas ao vivo

A resposta v2 separa ações de conta e tarefas protegidas por OAuth de preparação e diagnóstico sem auth. Nomes e schemas descobertos são a fonte de verdade.

OAuth significa que o cliente deve apresentar a sessão da conta conectada.
Sem autenticação, a ferramenta pode ser chamada sem um token de conta; isso não significa geração gratuita.
As indicações somente leitura descrevem uma anotação da ferramenta e não substituem as verificações de autorização do 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":{}}'

Ferramentas retornadas por tools/list no live gate
Ferramenta	Acesso	Finalidade
`get_3d_credits`	OAuth	Ler créditos disponíveis
`estimate_3d_generation`	OAuth	Estimar créditos de geração
`generate_3d`	OAuth	Gerar a partir de uma imagem
`image-to-3d`	Sem autenticação	Abrir o seletor de imagens
`process_image_url_to_3d`	Sem autenticação	Visualizar uma URL de imagem
`prepare_3d_generation`	Sem autenticação	Preparar uma imagem selecionada
`cancel_3d_generation`	Sem autenticação	Cancelar uma solicitação não enviada
`generate_3d_authenticated`	OAuth	Iniciar uma geração preparada
`get_authenticated_generation`	OAuth	Verificar uma geração
`create_3d_job_from_url`	OAuth	Retomar um trabalho a partir de uma URL
`get_3d_job_status`	OAuth	Verificar o status do trabalho
`get_3d_result`	OAuth	Obter o resultado do trabalho
`get_3d_status`	OAuth	Verificar uma tarefa
`report_widget_diagnostic`	Sem autenticação	Registrar um diagnóstico do widget

Siga o fluxo da tarefa

Prepare a imagem, autentique quando o usuário escolher gerar, inicie ou retome o trabalho e leia status e resultado. Preserve resumeKey, intentId, jobId ou taskId sem inventar identificadores.

Leia os créditos e a estimativa antes de solicitar uma geração paga.
Use get_3d_job_status ou get_3d_status para observar uma tarefa e depois get_3d_result quando o servidor informar a conclusão.
O endpoint atual não expõe uma ferramenta MCP de rigging humanoide; use o fluxo REST do Skin Tokens para uma tarefa separada.

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

Limites do cliente e da capacidade

O estúdio Web e a API REST têm contratos próprios. O cliente MCP deve mostrar somente o que descobre e não copiar alegações de OAuth, rigging automático ou compatibilidade de outra rota.

O caminho antigo /mcp é uma rota de compatibilidade existing-v1 e não comprova esta lista de ferramentas v2.
O suporte a OAuth está registrado para este endpoint ativo; os fluxos de login de cada cliente ainda precisam de verificação específica.
Nenhuma solicitação de geração foi feita para este guia.

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