lowpoly se retira el 30 oct 2026. 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 el MCP server de Meshy para llamadas a herramientas, o con llms.txt y llms-full.txt para leer la documentación.

Si usas Claude Code, Cursor, Windsurf, Codex u otro cliente MCP, instala el MCP server. Si tu agente de chat no es compatible con MCP, apúntalo en su lugar a https://docs.meshy.ai/llms.txt.

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 Meshy API REST 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 API Keys de la Developer Platform. 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.

# Detects installed AI clients and configures Meshy for each
npx add-mcp @meshy-ai/meshy-mcp-server --env MESHY_API_KEY=msy_YOUR_API_KEY

¿Prefieres un skill? El paquete de skills de código abierto meshy-3d-agent tiene flujos de trabajo de Meshy ya preparados para Claude Code, Cursor y OpenClaw, como generar un modelo, consultar la tarea y descargar el resultado. Llama directamente a la Meshy API REST, por lo que no necesitas el MCP server.

npx skills add meshy-dev/meshy-3d-agent

Herramientas disponibles

El MCP server ofrece la Meshy API REST 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: añade textura a una malla de vista previa

Postprocesamiento

  • 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: añade 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 IDs de las acciones de animación preestablecidas, de forma gratuita

Creative Lab

  • meshy_creative_lab: convierte una foto en un producto terminado de Creative Lab (ejecuta las tareas de prototipo y de build)

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 URLs de descarga
  • meshy_list_tasks: lista las tareas recientes, opcionalmente filtradas por tipo o estado
  • meshy_cancel_task: elimina una tarea. Meshy elimina y reembolsa una tarea en 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 finalizado y lo guarda localmente

Espacio de trabajo

  • meshy_list_models: lista tus modelos recientes de Texto a 3D. Para otros tipos de tarea, 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 Meshy API.
  • meshy_analyze_printability: verifica la imprimibilidad FDM de un modelo de forma gratuita, incluyendo estanqueidad al agua, volumen, agujeros, aristas non-manifold y caras degeneradas
  • meshy_process_multicolor: convierte un modelo con textura en un archivo 3MF multicolor para impresión
  • meshy_repair_printability: repara un modelo para impresión FDM
  • meshy_auto_split: divide un modelo en piezas 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

Los nombres y el comportamiento de las herramientas pueden cambiar. Para la lista completa, consulta las herramientas en el código fuente del MCP server.

Prompts de ejemplo

Para empezar, 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 es compatible con MCP, o quieres incluir la documentación de Meshy directamente en un prompt, apúntalo a las versiones en texto plano de la documentación:

  • llms.txt: un índice compacto con instrucciones de integración, como consultar 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: añade .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, de modo que coincidan con la documentación en HTML.

FAQ

¿El MCP server no guarda estado?
No almacena tus credenciales. El servidor mantiene tu MESHY_API_KEY en memoria y nunca la escribe en disco. Por defecto, 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 hacen las mismas llamadas REST y usan créditos a la misma tasa. Consulta la página de Precios para ver todos los precios.
¿Cuáles son los límites de tasa?
Las llamadas del MCP server cuentan para 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 pueda 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