Integración con IA

Meshy expone dos canales para agentes de IA y asistentes de programación: el MCP server de Meshy para llamadas a herramientas, y llms.txt / llms-full.txt para la ingesta 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 a continuación. Si estás integrando desde un agente de chat simple sin compatibilidad con MCP, apúntalo a https://docs.meshy.ai/llms.txt en su lugar.

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 recuperar contexto estructurado. El MCP server de Meshy encapsula 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 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. Código fuente: github.com/meshy-dev/meshy-mcp-server.

Necesitas una clave de API de Meshy. Crea una en https://www.meshy.ai/settings/api. 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 → consultar → descargar) para Claude Code, Cursor y OpenClaw. Llama directamente a la API REST de Meshy — no se requiere 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 capacidad.

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

Posprocesamiento

  • 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 tareas recientes, opcionalmente filtradas por tipo/estado
  • meshy_cancel_task — cancela una tarea pendiente o en progress
  • 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 laminadores (slicer) instalados e inicia el modelo en uno (se ejecuta localmente en tu máquina; no hay llamada a la Meshy API)
  • meshy_analyze_printability — actualmente devuelve una lista de comprobación manual de preparación para impresión (grosor de pared, voladizos, malla manifold, etc.). Se actualizará a análisis automatizado cuando 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.

Prompts de ejemplo

Pégalos 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 si 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 solo archivo para ingesta con una única obtención.
  • 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 compila el sitio de documentación, por lo que nunca se desvían de la documentación HTML.

Preguntas frecuentes

¿El MCP server no tiene estado?

Sí. Tu MESHY_API_KEY se usa por solicitud y nunca se conserva en el lado del servidor.

¿MCP cuesta lo mismo que la API REST?

Sí — cada llamada a herramienta MCP se asigna a una única llamada REST y consume créditos exactamente a la misma tasa. Consulta Precios para ver la matriz completa.

¿Cuáles son los límites de tasa?

El MCP server comparte el mismo plano de límite de tasa que la API REST. Consulta Límites de tasa para ver los límites por nivel.

¿A qué datos de Meshy puede acceder MCP?

Solo a aquello a lo que MESHY_API_KEY puede acceder mediante REST. Los ámbitos y permisos son idénticos.

¿Cómo informo de problemas?

Abre un issue en github.com/meshy-dev/meshy-mcp-server.