Integración con IA

Meshy ofrece dos canales para agentes de IA y asistentes de programación: el MCP server de Meshy para la invocación de herramientas, y llms.txt / llms-full.txt para la ingestión de documentación.

Si estás integrando Meshy desde Claude Code, Cursor, Windsurf, Codex o cualquier otra herramienta compatible con MCP, instala el MCP server que se indica a continuación. Si estás integrando desde un agente de chat simple sin soporte para 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 invocar herramientas externas y recuperar contexto estructurado. El MCP server de Meshy envuelve la API REST de Meshy como un conjunto de herramientas que tu agente puede invocar —generar un modelo, comprobar una tarea, descargar el resultado— sin necesidad de escribir código HTTP a mano.

El MCP server es de código abierto y está publicado en npm como @meshy-ai/meshy-mcp-server. Fuente: github.com/meshy-dev/meshy-mcp-server.

Necesitas una clave de API de Meshy. Crea una en la página de API Keys dentro de la Developer Platform. El MCP server la lee desde la variable de entorno MESHY_API_KEY.

Instalación rápida

# 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 una skill lista para usar? El paquete de skills de código abierto meshy-3d-agent incluye flujos de trabajo de Meshy ya escritos (generar → sondear → descargar) para Claude Code, Cursor y OpenClaw. Llama directamente a la API REST de Meshy, sin necesidad de un MCP server.

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

Herramientas disponibles

El MCP server expone la API REST de Meshy como herramientas, agrupadas por funcionalidad.

Generación 3D

  • meshy_text_to_3d — crea un modelo 3D 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

Post-procesamiento

  • meshy_remesh — cambia la topology y/o el recuento de polígonos de un modelo existente
  • 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

Generación de imágenes

  • meshy_text_to_image — imagen 2D a partir de texto
  • meshy_image_to_image — imagen 2D a partir de una imagen de referencia

Gestión de tareas

  • meshy_get_task_status — comprueba el estado de la tarea y las URL de descarga
  • meshy_list_tasks — lista las tareas recientes, con filtro opcional por tipo/estado
  • meshy_cancel_task — cancela una tarea pendiente o en curso
  • meshy_download_model — obtiene un archivo de modelo completado y lo guarda localmente

Espacio de trabajo

  • meshy_list_models — lista todos los modelos en el espacio de trabajo del usuario autenticado

Impresión 3D

  • meshy_send_to_slicer — detecta los slicers instalados y lanza el modelo en uno de ellos (se ejecuta localmente en tu máquina; no realiza ninguna llamada a la API de Meshy)
  • meshy_analyze_printability — actualmente devuelve una lista de verificación manual de preparación para la impresión (grosor de pared, voladizos, malla manifold, etc.). Se actualizará a un análisis automatizado en cuanto la API de imprimibilidad de Meshy esté disponible.
  • meshy_process_multicolor — convierte un modelo con textura en un archivo 3MF multicolor para impresión

Cuenta

  • meshy_check_balance — consulta los créditos restantes

Los nombres y comportamientos de las herramientas pueden evolucionar. La lista autorizada se encuentra en el código fuente del MCP server.

Ejemplos de prompts

Utiliza estos ejemplos en tu chat habilitado para MCP como punto de partida.

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 quieres ingerir la documentación de Meshy directamente en un prompt, apúntalo a nuestras superficies de texto plano:

  • llms.txt — índice compacto + instrucciones de integración (el patrón correcto de sondeo asíncrono, reglas de autenticación, límites de tasa, elección de modelo, errores comunes).
  • llms-full.txt — todas las páginas de la API concatenadas en un único archivo para su ingestión en una sola descarga.
  • Markdown por página: añade .md a cualquier URL de endpoint. Ejemplo: https://docs.meshy.ai/api/text-to-3d.md.

Los tres se regeneran cada vez que se genera el sitio de documentación, por lo que nunca se desincronizan de la documentación en HTML.

Preguntas frecuentes

¿El MCP server no guarda estado?
Sí. Tu MESHY_API_KEY se usa por cada solicitud y nunca se conserva en el lado del servidor.
¿MCP cuesta lo mismo que la API REST?
Sí — cada llamada a una herramienta MCP se corresponde con una única llamada REST y consume créditos exactamente a la misma tasa. Consulta la página de Precios para ver la tabla completa.
¿Cuáles son los límites de tasa?
El MCP server comparte el mismo nivel de límite de tasa que la API REST. Consulta la página de Límites de tasa para conocer los límites por nivel.
¿A qué datos de Meshy puede acceder MCP?
Solo a lo que MESHY_API_KEY puede acceder a través de REST. Los alcances y permisos son idénticos.
¿Cómo puedo informar de problemas?
Abre un issue en el repositorio meshy-mcp-server: https://github.com/meshy-dev/meshy-mcp-server/issues