Integración con IA

Meshy expone dos canales para agentes de IA y asistentes de codificación: el servidor Meshy MCP para llamadas a herramientas, y llms.txt / llms-full.txt para la ingesta de documentos.

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

El servidor MCP 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 https://www.meshy.ai/settings/api. El servidor MCP la lee de 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 habilidad lista para usar? El paquete de habilidades de código abierto meshy-3d-agent ofrece flujos de trabajo preescritos de Meshy (generar → sondear → descargar) para Claude Code, Cursor y OpenClaw. Llama a la API REST de Meshy directamente, sin necesidad de un servidor MCP.

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

Herramientas Disponibles

El servidor MCP 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 múltiples 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 esqueleto

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 — verifica el estado de la tarea y las URLs de descarga
  • meshy_list_tasks — lista tareas recientes, opcionalmente filtradas por tipo/estado
  • meshy_cancel_task — cancela una tarea pendiente o en progreso
  • 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 cortadoras instaladas y lanza el modelo en una (se ejecuta localmente en tu máquina; no se realiza llamada a la API de Meshy)
  • meshy_analyze_printability — actualmente devuelve una lista de verificación manual de preparación para impresión (grosor de pared, voladizos, malla manifold, etc.). Se actualizará a análisis automatizado una vez que la API de imprimibilidad de Meshy esté disponible.
  • meshy_process_multicolor — convierte un modelo texturizado 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 la fuente del servidor MCP.

Ejemplos de Prompts

Introduce estos 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 soporta MCP, o deseas ingerir los documentos 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 — cada página de la API concatenada en un solo archivo para ingesta de una sola vez.
  • 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 construye el sitio de documentos, por lo que nunca se desvían de los documentos HTML.

Preguntas Frecuentes

¿El servidor MCP es sin estado?
Sí. Tu MESHY_API_KEY se usa por solicitud y nunca se persiste en el lado del servidor.
¿El MCP cuesta lo mismo que la API REST?
Sí — cada llamada a herramienta MCP se mapea a una sola llamada REST y consume créditos a la misma tasa exacta. Consulta la página de Precios para la matriz completa.
¿Cuáles son los límites de tasa?
El servidor MCP comparte el mismo plano de límite de tasa que la API REST. Consulta la página de Límites de Tasa para los límites por nivel.
¿A qué datos de Meshy puede acceder el MCP?
Solo a lo que la MESHY_API_KEY puede acceder a través de REST. Los alcances y permisos son idénticos.
¿Cómo informo problemas?
Presenta un problema en el repositorio meshy-mcp-server: https://github.com/meshy-dev/meshy-mcp-server/issues