Integración con IA
Conecta agentes de IA y asistentes de codificación a Meshy, con la Meshy CLI o el MCP server de Meshy para generar modelos, o con llms.txt y llms-full.txt para leer la documentación.
Si tu agente puede ejecutar comandos de shell, como Claude Code, Cursor y Codex, usa la CLI o el MCP server. Si solo se conecta a herramientas mediante MCP, instala el MCP server. Si tu agente de chat no admite ninguna de las dos opciones, dirígelo a https://docs.meshy.ai/llms.txt.
CLI o MCP
Ambos llaman a la misma API REST de Meshy, a los mismos precios. Se diferencian en quién los ejecuta y cómo inician sesión.
| Meshy CLI | MCP server | |
|---|---|---|
| Quién lo ejecuta | Tú en una terminal, scripts, CI y agentes que pueden ejecutar comandos de shell | Apps de IA que se conectan a herramientas mediante MCP |
| Inicio de sesión | Una vez, en tu navegador. Una clave de API es opcional, para CI. | Una clave de API en la configuración del cliente |
| Instalación | npm install -g meshy-cli | Un comando o entrada de configuración por cliente (ver abajo) |
| Ideal para | Scripts, trabajos por lotes, CI, descargas y preparación para impresión 3D | Uso tipo chat en una app de chat que no puede ejecutar comandos de shell, como Claude Desktop |
Para comenzar con la CLI, consulta Meshy CLI. El resto de esta página trata sobre el MCP server.
Qué es MCP
El Model Context Protocol (MCP) es un estándar abierto que permite a los asistentes de IA llamar a herramientas externas y obtener contexto estructurado. El MCP server de Meshy envuelve la API REST de Meshy como herramientas que tu agente puede llamar. Con ellas, el agente puede generar un modelo, verificar una tarea y descargar el resultado sin código HTTP escrito a mano.
El MCP server es de código abierto. Está publicado en npm como @meshy-ai/meshy-mcp-server, y su código fuente está en el repositorio meshy-mcp-server en GitHub.
Necesitas una clave de API de Meshy. Crea una en la página de claves de API de la Plataforma para desarrolladores. El MCP server la lee desde la variable de entorno MESHY_API_KEY.
Instalar el MCP server
Para instalar el servidor, usa la pestaña correspondiente a tu cliente de IA. Reemplaza msy_YOUR_API_KEY con tu clave de API. Cada configuración guarda la clave en tu configuración a nivel de usuario, fuera de cualquier proyecto, para que no termine en un repositorio.
# macOS / Linux / WSL
claude mcp add -s user meshy --env MESHY_API_KEY=msy_YOUR_API_KEY -- npx -y @meshy-ai/meshy-mcp-server
# Windows (PowerShell or Command Prompt)
claude mcp add -s user meshy --env MESHY_API_KEY=msy_YOUR_API_KEY "--" cmd /c npx -y @meshy-ai/meshy-mcp-server
En Windows, inicia el servidor mediante cmd /c en las configuraciones JSON anteriores: establece "command" como "cmd" y "args" como ["/c", "npx", "-y", "@meshy-ai/meshy-mcp-server"]. No pases JSON como argumento de comando en PowerShell, porque PowerShell elimina sus comillas.
¿Prefieres un skill? El paquete de skills de código abierto meshy-3d-agent tiene flujos de trabajo de Meshy ya preparados, como generar un modelo, hacer seguimiento de la tarea y descargar el resultado. Funciona en Claude Code, Cursor, Codex, OpenClaw y Hermes Agent. Los skills se ejecutan con la Meshy CLI en lugar del MCP server. Inicias sesión una vez en tu navegador, por lo que no necesitas una clave de API. Requieren Node.js 22.12 o posterior. Para configurar la CLI, consulta Meshy CLI.
npx skills add meshy-dev/meshy-3d-agent
Herramientas disponibles
El MCP server ofrece la API REST de Meshy como las siguientes herramientas, agrupadas por capacidad.
Generación 3D
meshy_text_to_3d: crea una malla de vista previa sin textura a partir de un prompt de textomeshy_image_to_3d: crea un modelo 3D a partir de una imagenmeshy_multi_image_to_3d: crea un modelo 3D a partir de varias imágenes del mismo objetomeshy_text_to_3d_refine: agrega textura a una malla de vista previa
Posprocesamiento
meshy_remesh: cambia la topology o el recuento de polígonos de un modelo existente, o ambosmeshy_retexture: aplica una nueva textura a un modelo existentemeshy_rig: agrega un esqueleto a un personaje humanoide 3Dmeshy_animate: aplica una animación a un personaje con rigmeshy_convert: convierte un modelo a otro formato de archivomeshy_resize: redimensiona un modelo a dimensiones del mundo realmeshy_uv_unwrap: genera una nueva distribución UV para un modelomeshy_text_to_motion: genera una animación a partir de un prompt de textomeshy_list_animations: consulta los ID de las acciones de animación predefinidas, de forma gratuita
Creative Lab
meshy_creative_lab: convierte una foto en un producto terminado de Creative Lab (ejecuta las tareas de prototipo y construcción)
Generación de imágenes
meshy_text_to_image: crea una imagen 2D a partir de textomeshy_image_to_image: crea una imagen 2D a partir de una imagen de referencia
Gestión de tareas
meshy_get_task_status: verifica el estado de la tarea y las URL de descargameshy_list_tasks: lista las tareas recientes, filtradas opcionalmente por tipo o estadomeshy_cancel_task: elimina una tarea. Meshy elimina y reembolsa una tareaPENDING, y elimina una tarea finalizada. Una tareaIN_PROGRESSno se puede cancelar, y la API devuelve409.meshy_download_model: descarga un archivo de modelo terminado y lo guarda localmente
Espacio de trabajo
meshy_list_models: lista tus modelos recientes de Texto a 3D. Para otros tipos de tareas, usameshy_list_tasks.
Impresión 3D
meshy_send_to_slicer: encuentra los slicers instalados en tu computadora y devuelve un comando que abre el modelo en uno de ellos. Se ejecuta localmente y no llama a la API de Meshy.meshy_analyze_printability: verifica la imprimibilidad FDM de un modelo de forma gratuita, incluyendo estanqueidad, volumen, agujeros, aristas non-manifold y caras degeneradasmeshy_process_multicolor: convierte un modelo con textura en un archivo 3MF multicolor para imprimirmeshy_repair_printability: repara un modelo para impresión FDMmeshy_auto_split: divide un modelo en partes que se pueden imprimir por separado
Cuenta
meshy_check_balance: verifica tus créditos restantesmeshy_list_usage: lista las tareas de API finalizadas de tu equipo y los créditos que usó cada una, para equipos Studio y Enterprise
Los nombres y el comportamiento de las herramientas pueden cambiar. Para ver la lista completa, consulta las herramientas en el código fuente del MCP server.
Ejemplos de prompts
Para comenzar, prueba estos prompts en tu chat habilitado para MCP:
Generate a 3D fox from the prompt "a cartoon fox sitting", preview it, then
texture it with PBR maps. Download the final GLB to ./outputs.
Take the image at https://example.com/sculpture.jpg and convert it into a
riggable 3D character. Use `should_remesh: true` and 50k target polycount.
What's my current Meshy credit balance?
List my last 10 successful text-to-3d tasks and download the top 3 as GLB
into ./downloads/.
llms.txt y llms-full.txt
Si tu agente no admite MCP, o si quieres incluir la documentación de Meshy directamente en un prompt, dirígelo a las versiones en texto plano de la documentación:
llms.txt: un índice compacto con instrucciones de integración, como la forma de sondear tareas asíncronas, autenticación, límites de tasa, elección de modelo y errores comunes.llms-full.txt: todas las páginas de la API en un solo archivo, para que un agente pueda leer la documentación en una sola solicitud.- Markdown por página: agrega
.mda cualquier URL de endpoint, por ejemplohttps://docs.meshy.ai/api/text-to-3d.md.
Meshy regenera los tres cada vez que se compila el sitio de documentación, para que coincidan con la documentación en HTML.
Preguntas frecuentes
- ¿El MCP server es stateless?
- No almacena tus credenciales. El servidor mantiene tu MESHY_API_KEY en memoria y nunca la escribe en disco. De forma predeterminada, guarda los modelos que descarga, junto con sus metadatos, en una carpeta meshy_output dentro de su directorio de trabajo. Para guardar una descarga en otro lugar, proporciona a la herramienta de descarga una ruta save_to.
- ¿MCP cuesta lo mismo que la API REST?
- Sí. Las llamadas a herramientas de MCP realizan las mismas llamadas REST y usan créditos a la misma tasa. Consulta la página de Precios para ver cada precio.
- ¿Cuáles son los límites de tasa?
- Las llamadas del MCP server cuentan dentro de los mismos límites de tasa que tus llamadas a la API REST. Consulta la página de límites de tasa para conocer los límites de cada plan.
- ¿A qué datos de Meshy puede acceder el MCP server?
- Solo a lo que tu MESHY_API_KEY puede acceder a través de la API REST, con los mismos permisos.
- ¿Cómo reporto problemas?
- Abre un issue en el repositorio meshy-mcp-server en GitHub: https://github.com/meshy-dev/meshy-mcp-server/issues