Intégration IA

Meshy expose deux canaux pour les agents IA et les assistants de codage : le MCP server Meshy pour l’appel d’outils, et llms.txt / llms-full.txt pour l’ingestion de documentation.

Si vous intégrez Meshy depuis Claude Code, Cursor, Windsurf, Codex ou tout autre outil compatible MCP, installez le MCP server ci-dessous. Si vous l’intégrez depuis un agent de chat simple sans prise en charge MCP, pointez-le plutôt vers https://docs.meshy.ai/llms.txt.

Qu’est-ce que MCP

Le Model Context Protocol (MCP) est un standard ouvert qui permet aux assistants IA d’appeler des outils externes et de récupérer un contexte structuré. Le MCP server Meshy encapsule la Meshy API REST sous forme d’un ensemble d’outils que votre agent peut invoquer — générer un modèle, vérifier une tâche, télécharger le résultat — sans écrire manuellement de code HTTP.

Le MCP server est open source et publié sur npm sous le nom @meshy-ai/meshy-mcp-server. Source : github.com/meshy-dev/meshy-mcp-server.

Vous avez besoin d’une clé API Meshy. Créez-en une à l’adresse https://www.meshy.ai/settings/api. Le MCP server la lit depuis la variable d’environnement MESHY_API_KEY.

Installation rapide

# 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

Vous préférez plutôt une compétence prête à l’emploi ? Le pack de compétences open source meshy-3d-agent inclut des flux de travail Meshy préécrits (générer → interroger → télécharger) pour Claude Code, Cursor et OpenClaw. Il appelle directement la Meshy API REST — aucun MCP server requis.

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

Outils disponibles

Le MCP server expose la Meshy API REST sous forme d’outils, regroupés par capacité.

Génération 3D

  • meshy_text_to_3d — créer un modèle 3D à partir d’un prompt textuel
  • meshy_image_to_3d — créer un modèle 3D à partir d’une image
  • meshy_multi_image_to_3d — créer un modèle 3D à partir de plusieurs images du même objet
  • meshy_text_to_3d_refine — ajouter une texture à un maillage de prévisualisation

Post-traitement

  • meshy_remesh — modifier la topology et/ou le nombre de polygones d’un modèle existant
  • meshy_retexture — appliquer une nouvelle texture à un modèle existant
  • meshy_rig — ajouter un squelette à un personnage humanoïde 3D
  • meshy_animate — appliquer une Animation à un personnage riggé

Génération d’images

  • meshy_text_to_image — image 2D à partir de texte
  • meshy_image_to_image — image 2D à partir d’une image de référence

Gestion des tâches

  • meshy_get_task_status — vérifier le statut de la tâche et les URL de téléchargement
  • meshy_list_tasks — lister les tâches récentes, éventuellement filtrées par type/statut
  • meshy_cancel_task — annuler une tâche en attente ou en cours
  • meshy_download_model — récupérer un fichier de modèle terminé et l’enregistrer localement

Espace de travail

  • meshy_list_models — lister tous les modèles dans l’espace de travail de l’utilisateur authentifié

Impression 3D

  • meshy_send_to_slicer — détecter les trancheurs (slicer) installés et lancer le modèle dans l’un d’eux (s’exécute localement sur votre machine ; aucun appel à la Meshy API)
  • meshy_analyze_printability — renvoie actuellement une checklist manuelle de préparation à l’impression (épaisseur de paroi, surplombs, maillage manifold, etc.). Sera mis à niveau vers une analyse automatisée dès que l’API d’imprimabilité Meshy sera disponible.
  • meshy_process_multicolor — convertir un modèle texturé en fichier 3MF multicolore pour l’impression

Compte

  • meshy_check_balance — interroger les crédits restants

Les noms et comportements des outils peuvent évoluer. La liste faisant autorité se trouve dans le code source du MCP server.

Exemples de prompts

Déposez-les dans votre chat compatible MCP comme point de départ.

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 et llms-full.txt

Si votre agent ne prend pas en charge MCP, ou si vous souhaitez ingérer la documentation Meshy directement dans un prompt, pointez-le vers nos surfaces en texte brut :

  • llms.txt — index compact + instructions d’intégration (le bon schéma d’interrogation asynchrone, les règles d’authentification, les limites de débit, le choix du modèle, les erreurs courantes).
  • llms-full.txt — chaque page d’API concaténée dans un seul fichier pour une ingestion en une seule récupération.
  • Markdown par page : ajoutez .md à n’importe quelle URL de point de terminaison. Exemple : https://docs.meshy.ai/api/text-to-3d.md.

Les trois sont régénérés à chaque build du site de documentation, afin qu’ils ne divergent jamais de la documentation HTML.

FAQ

Le MCP server est-il sans état ?

Oui. Votre MESHY_API_KEY est utilisée pour chaque requête et n’est jamais conservée côté serveur.

MCP coûte-t-il le même prix que l’API REST ?

Oui — chaque appel d’outil MCP correspond à un seul appel REST et consomme des crédits exactement au même taux. Consultez la Tarification pour la matrice complète.

Quelles sont les limites de débit ?

Le MCP server partage le même plan de limites de débit que l’API REST. Consultez les Rate Limits pour les limites par niveau.

À quelles données Meshy le MCP peut-il accéder ?

Uniquement à ce à quoi la MESHY_API_KEY peut accéder via REST. Les portées et les autorisations sont identiques.

Comment signaler des problèmes ?

Ouvrez une issue sur github.com/meshy-dev/meshy-mcp-server.