3D-Agent (external agents, Ultra)

Transfiere tareas de Blender a 3D-Agent desde Claude Code, Claude Desktop, Cursor o Codex. Un servidor MCP local (una herramienta, 3d_agent(task)) en la aplicación de escritorio de pago 3D-Agent para macOS y Windows, plan Ultra. No es un servidor MCP de Blender.

Ver en 3d-agent.comPrueba este MCPPatrocinado

Documentación

Usa 3D-Agent desde Claude Code, Claude Desktop, Cursor o Codex

Para controlar Blender desde Claude Code, Claude Desktop, Cursor o Codex, conéctalo al servidor MCP local que 3D-Agent (3d-agent.com) ejecuta mientras su aplicación de escritorio está abierta. La aplicación le entrega a 3D-Agent una tarea en lenguaje natural, 3D-Agent realiza el trabajo en tu escena de Blender abierta, y la respuesta regresa a la aplicación.

Esto requiere el plan Ultra. Cada tarea usa un prompt, como un mensaje que escribes.

Requisitos

El plan Ultra. Un impulso del primer mes en otro plan no cuenta.
La aplicación de escritorio de 3D-Agent, abierta y con sesión iniciada, en macOS 12 o posterior o Windows 10 o posterior.
Blender 4.2 o posterior, abierto y conectado a 3D-Agent.
Una de estas aplicaciones: Claude Code, Claude Desktop, Cursor, Codex, la aplicación de escritorio de ChatGPT (macOS 14 o posterior) o ComfyUI.

Configura una aplicación

1. Abre External agents

En 3D-Agent, abre Settings → External agents.

2. Activa Allow connections

Esto crea el token de conexión que las aplicaciones usan para llegar a 3D-Agent.

3. Haz clic en Set up

Haz clic en Set up junto a la aplicación y luego sigue su mensaje de estado.

Set up escribe la configuración de cada aplicación por ti, así que nunca escribes un puerto o token. Las secciones siguientes muestran lo que escribe, por si quieres verificarlo o hacerlo manualmente.

Aplicación	Qué hace Set up	Cuándo está lista
Claude Code	Añade 3D-Agent con `claude mcp add`	Tu próxima sesión de Claude Code
Claude Desktop	Abre una extensión de 3D-Agent (`.mcpb`)	Una vez que la instales en Claude Desktop
Cursor	Abre un enlace de instalación de Cursor	Una vez que apruebes el servidor en Cursor
Codex y la aplicación ChatGPT	Añade 3D-Agent a tu `config.toml` de Codex	La próxima ejecución de Codex. Reinicia la aplicación ChatGPT si está abierta.
ComfyUI	Instala un nodo de 3D-Agent	Una vez que reinicies ComfyUI y añadas el nodo a un flujo de trabajo

Para deshacer la configuración de una aplicación, haz clic en Remove.

Encuentra tu puerto y token

Solo los necesitas para una configuración manual. En Settings → External agents, abre Advanced:

Connection token: haz clic en el ícono del ojo para mostrarlo, o en el ícono de copiar para copiarlo.
Set up any other client: la configuración del servidor, con tu puerto en la URL.

3D-Agent usa el puerto 1337 cuando está libre, y otro puerto cuando no lo está. Siempre copia el puerto del panel. En los ejemplos siguientes, reemplaza <port> y <token> con los tuyos.

Claude Code

Set up elimina cualquier entrada 3d-agent anterior y luego ejecuta:

claude mcp add --scope user --transport http 3d-agent http://127.0.0.1:<port>/mcp --header "Authorization: Bearer <token>"

--scope user hace que 3D-Agent esté disponible en todos tus proyectos. Claude Code se conecta a los servidores MCP cuando una sesión comienza, así que inicia una nueva sesión después de la configuración. Para verificar que 3d-agent está conectado, ejecuta /mcp en Claude Code o claude mcp list en una terminal.

Si la configuración falla, haz clic en Copy command y ejecútalo tú mismo. El comando copiado no tiene la bandera --scope, así que añade 3D-Agent solo al proyecto actual. Ejecútalo en tu carpeta de proyecto, o añade --scope user.

Luego pídele a Claude Code trabajo en 3D:

Usa 3D-Agent para modelar una caja de madera low-poly en Blender, y luego dime sus dimensiones.

Claude Desktop

Claude Desktop se conecta a través de una extensión de 3D-Agent. Set up escribe el archivo de la extensión y lo abre. Instálalo cuando Claude Desktop lo pida, y se conectará solo.

El archivo está en:

macOS: ~/Library/Application Support/com.3d-agent.app/claude-desktop/3d-agent.mcpb
Windows: %APPDATA%\com.3d-agent.app\claude-desktop\3d-agent.mcpb

Para instalarlo manualmente, en Claude Desktop abre Settings → Extensions → Advanced settings → Install Extension… y elige ese archivo.

La extensión lleva tu puerto y token y ejecuta un pequeño relé en el Node.js integrado de Claude Desktop. Ninguna de estas opciones funciona en su lugar:

claude_desktop_config.json solo inicia servidores locales de línea de comandos (stdio), no servidores HTTP como el de 3D-Agent.
Los conectores personalizados en Settings → Connectors se conectan desde la nube de Anthropic, así que no pueden llegar a 127.0.0.1 en tu computadora.

Cursor

Set up abre un enlace de instalación de Cursor. Aprueba el servidor cuando Cursor lo pida.

Para añadirlo manualmente, pon esto en ~/.cursor/mcp.json para todos los proyectos, o .cursor/mcp.json para un proyecto:

{
  "mcpServers": {
    "3d-agent": {
      "url": "http://127.0.0.1:<port>/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

Si Cursor no puede conectarse, abre su panel Output y elige MCP Logs.

Codex y la aplicación ChatGPT

Set up añade esto a tu archivo de configuración de Codex:

[mcp_servers."3d-agent"]
url = "http://127.0.0.1:<port>/mcp"
http_headers = { Authorization = "Bearer <token>" }
tool_timeout_sec = 960

Codex detiene una llamada de herramienta después de 60 segundos por defecto, y las tareas de 3D-Agent pueden tardar hasta 15 minutos. Si la línea tool_timeout_sec = 960 falta, añádela.

El archivo es ~/.codex/config.toml en macOS y %USERPROFILE%\.codex\config.toml en Windows, o config.toml en tu carpeta CODEX_HOME si configuraste una.

La CLI de Codex, la extensión IDE de Codex y la aplicación de escritorio de ChatGPT comparten este archivo, así que una configuración cubre las tres. La CLI lo detecta en su próxima ejecución. Si la aplicación ChatGPT está abierta, ciérrala y vuelve a abrirla. Para verificar, ejecuta codex mcp list, o /mcp en Codex.

Si la configuración falla, haz clic en Copy config y pega el bloque en el archivo tú mismo. No uses codex mcp add: solo lee un token de una variable de entorno (--bearer-token-env-var), no un encabezado.

ComfyUI

ComfyUI no tiene soporte MCP, así que Set up instala un nodo ComfyUI-3D-Agent en la carpeta custom_nodes de ComfyUI. Reinicia ComfyUI y luego añade el nodo 3D-Agent a un flujo de trabajo.

Si 3D-Agent no puede encontrar ComfyUI, haz clic en Choose folder y elige la carpeta de ComfyUI. Debe contener main.py y una carpeta custom_nodes.

La cola de ComfyUI espera mientras el nodo ejecuta su tarea. Cancelar en ComfyUI detiene la espera, pero la tarea sigue ejecutándose en 3D-Agent.

Cualquier otro cliente MCP

Cualquier cliente que admita Streamable HTTP con encabezados puede conectarse. Copia la configuración de Set up any other client en Advanced. Es el mismo JSON que el ejemplo de Cursor. Los clientes que solo admiten servidores stdio o SSE no pueden conectarse.

¿Qué sucede cuando una aplicación llama a 3D-Agent?

La aplicación ve una herramienta, 3d_agent, con un campo obligatorio, task: lo que quieres que se haga y cómo lo juzgarás, en lenguaje natural.
3D-Agent ejecuta la tarea como un prompt que escribes. Lee tu escena, usa sus herramientas de Blender y crea puntos de control antes de ediciones arriesgadas.
Cuando el turno termina, 3D-Agent envía su respuesta final de vuelta a la aplicación como texto, y el modelo de la aplicación continúa.

La llamada permanece abierta hasta que el turno termina, hasta 15 minutos. Mantén 3D-Agent abierto hasta que llegue la respuesta.

La otra aplicación nunca controla Blender directamente. Entrega la tarea, y 3D-Agent elige las herramientas de Blender.

¿Cuánto cuesta?

Cada tarea usa uno de los 800 prompts mensuales de tu plan Ultra. Las tareas rechazadas porque no estás en Ultra no usan un prompt. Consulta Plans and limits.

¿Es 3D-Agent un servidor MCP de Blender?

No. Un servidor MCP de Blender le da a un asistente comandos de bajo nivel de Blender, y el asistente hace el trabajo 3D. 3D-Agent es su propio agente para Blender, con sus propias herramientas, puntos de control y límites de pasos. Su servidor MCP expone una herramienta que entrega una tarea completa a ese agente.

No necesitas un add-on MCP de Blender. Si tienes uno para otra herramienta, desactívalo mientras usas 3D-Agent.

Para aprender cómo funciona el protocolo, consulta What is Blender MCP?. Para comparar las opciones de Blender MCP, consulta Blender MCP.

Lee el estado de una aplicación

Estado	Significado
Not set up	Aún no has configurado esta aplicación.
Ready	Configurada, pero la aplicación aún no ha enviado una tarea.
Working	La aplicación ha llegado a 3D-Agent al menos una vez. La fila muestra cuándo se ejecutó la última tarea y cuántos turnos usó hoy si fue más de uno.
Setup did not go through	Haz clic en Retry. Para Claude Code y Codex, también puedes hacer clic en Copy command o Copy config y añadirlo tú mismo.

Working significa que la configuración funcionó antes, no que la aplicación está conectada ahora mismo.

Límites

3D-Agent solo acepta tareas mientras está abierto.
Ejecuta una tarea a la vez.
Una aplicación aún no puede continuar un chat específico de 3D-Agent.
Por debajo de Ultra, el panel muestra "Paused. Your apps stay set up, and tasks resume on Ultra." Las tareas se rechazan y no usan un prompt.
Apagar Allow connections desconecta todas las aplicaciones y olvida su configuración.
Remove all en Advanced desconecta todas las aplicaciones y reemplaza el token. Configura cada aplicación de nuevo después.

Advertencia: Cualquiera con tu token de conexión puede gastar tus prompts. Mantenlo privado.

Solución de problemas

Lo que ves	Qué hacer
"3D-Agent: external agents need the Ultra plan."	Actualiza a Ultra. Un impulso del primer mes no cuenta.
"3D-Agent: not signed in, or the token is wrong."	Inicia sesión en 3D-Agent. Si hiciste clic en Remove all o apagaste y encendiste Allow connections, el token anterior ya no funciona. Haz clic en Set up para la aplicación de nuevo.
"3D-Agent: the app is not open."	Abre 3D-Agent y mantenlo abierto hasta que la tarea termine.
"3D-Agent: already working on a turn. Retry shortly."	3D-Agent ejecuta una tarea a la vez. Intenta de nuevo cuando la actual termine.
"3D-Agent: out of turns on this plan."	Has usado los prompts de este mes. Consulta Plans and limits.
"3D-Agent: continuing a specific thread is not supported yet."	La aplicación envió un `threadId`. Pídele que llame a `3d_agent` solo con un `task`.
Cada llamada falla, u otro programa responde	Otro programa, como Razer Chroma, usa el puerto `1337`. Copia el puerto del panel, o haz clic en Set up de nuevo para que la aplicación reciba el puerto actual.
La aplicación lista la herramienta `3d_agent` pero nunca la llama	Nombra la herramienta en tu solicitud, por ejemplo Usa la herramienta 3d_agent para….
El panel dice The local port is unavailable	Reinicia 3D-Agent y verifica si otro programa usa el puerto `1337`.

Verifica el servidor manualmente

Envía una solicitud MCP initialize con tu puerto y token:

curl -i -X POST "http://127.0.0.1:<port>/mcp" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"manual-curl","version":"1.0.0"}}}'

Un servidor que funciona responde HTTP 200 con un encabezado mcp-session-id. Esto no inicia una tarea ni usa un prompt.

Próximos pasos

Plans and limits: Compara planes por prompts, pasos y subagentes.
Connect to Blender: Mira cómo 3D-Agent encuentra Blender y se conecta a él.
Settings: Encuentra qué hay en cada página de configuración.