lowpoly se retira el 30 oct 2026. meshy-7 se retira como modelo de generación 3D el 31 dic 2026; como modelo de texturas sigue disponible. Cambia de modelo antes de estas fechas para evitar errores en las solicitudes. Ver todas las obsolescencias

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 CLIMCP server
Quién lo ejecutaTú en una terminal, scripts, CI y agentes que pueden ejecutar comandos de shellApps de IA que se conectan a herramientas mediante MCP
Inicio de sesiónUna vez, en tu navegador. Una clave de API es opcional, para CI.Una clave de API en la configuración del cliente
Instalaciónnpm install -g meshy-cliUn comando o entrada de configuración por cliente (ver abajo)
Ideal paraScripts, trabajos por lotes, CI, descargas y preparación para impresión 3DUso 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

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 texto
  • meshy_image_to_3d: crea un modelo 3D a partir de una imagen
  • meshy_multi_image_to_3d: crea un modelo 3D a partir de varias imágenes del mismo objeto
  • meshy_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 ambos
  • meshy_retexture: aplica una nueva textura a un modelo existente
  • meshy_rig: agrega un esqueleto a un personaje humanoide 3D
  • meshy_animate: aplica una animación a un personaje con rig
  • meshy_convert: convierte un modelo a otro formato de archivo
  • meshy_resize: redimensiona un modelo a dimensiones del mundo real
  • meshy_uv_unwrap: genera una nueva distribución UV para un modelo
  • meshy_text_to_motion: genera una animación a partir de un prompt de texto
  • meshy_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 texto
  • meshy_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 descarga
  • meshy_list_tasks: lista las tareas recientes, filtradas opcionalmente por tipo o estado
  • meshy_cancel_task: elimina una tarea. Meshy elimina y reembolsa una tarea PENDING, y elimina una tarea finalizada. Una tarea IN_PROGRESS no se puede cancelar, y la API devuelve 409.
  • 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, usa meshy_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 degeneradas
  • meshy_process_multicolor: convierte un modelo con textura en un archivo 3MF multicolor para imprimir
  • meshy_repair_printability: repara un modelo para impresión FDM
  • meshy_auto_split: divide un modelo en partes que se pueden imprimir por separado

Cuenta

  • meshy_check_balance: verifica tus créditos restantes
  • meshy_list_usage: lista las tareas de API finalizadas de tu equipo y los créditos que usó cada una, para equipos Studio y Enterprise

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 .md a cualquier URL de endpoint, por ejemplo https://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