Intégration IA

Meshy expose deux canaux pour les agents IA et les assistants de codage : le MCP server de Meshy pour l'appel d'outils, et llms.txt / llms-full.txt pour l'ingestion de la 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 intégrez depuis un agent de chat classique sans prise en charge MCP, pointez-le plutôt vers https://docs.meshy.ai/llms.txt.

Qu'est-ce que le MCP

Le Model Context Protocol (MCP) est une norme ouverte qui permet aux assistants IA d'appeler des outils externes et de récupérer du contexte structuré. Le MCP server de Meshy encapsule l'API REST de Meshy 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 avoir à écrire de code HTTP à la main.

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 sur la page des clés API dans la plateforme développeurs. 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 une skill prête à l'emploi ? Le pack de skills open source meshy-3d-agent fournit des workflows Meshy prêts à l'emploi (générer → interroger → télécharger) pour Claude Code, Cursor et OpenClaw. Il appelle directement l'API REST de Meshy — aucun MCP server requis.

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

Outils disponibles

Le MCP server expose l'API REST de Meshy sous forme d'outils, regroupés par fonctionnalité.

Génération 3D

  • meshy_text_to_3d — crée un modèle 3D à partir d'un prompt textuel
  • meshy_image_to_3d — crée un modèle 3D à partir d'une image
  • meshy_multi_image_to_3d — crée un modèle 3D à partir de plusieurs images du même objet
  • meshy_text_to_3d_refine — ajoute une texture à un maillage preview

Post-traitement

  • meshy_remesh — modifie la topology et/ou le nombre de polygones d'un modèle existant
  • meshy_retexture — applique une nouvelle texture à un modèle existant
  • meshy_rig — ajoute un squelette à un personnage 3D humanoïde
  • meshy_animate — applique une animation à un personnage riggé

Génération d'images

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

Gestion des tâches

  • meshy_get_task_status — vérifie le statut d'une tâche et les URL de téléchargement
  • meshy_list_tasks — liste les tâches récentes, éventuellement filtrées par type/statut
  • meshy_cancel_task — annule une tâche en attente ou en cours
  • meshy_download_model — récupère un fichier de modèle terminé et l'enregistre localement

Espace de travail

  • meshy_list_models — liste tous les modèles de l'espace de travail de l'utilisateur authentifié

Impression 3D

  • meshy_send_to_slicer — détecte les slicers installés et lance le modèle dans l'un d'eux (s'exécute localement sur votre machine ; aucun appel à l'API Meshy)
  • 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é de Meshy sera disponible.
  • meshy_process_multicolor — convertit un modèle texturé en un fichier 3MF multicolore prêt à l'impression

Compte

  • meshy_check_balance — interroge 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

Utilisez-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 directement la documentation Meshy dans un prompt, pointez-le vers nos surfaces en texte brut :

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

Ces trois éléments sont régénérés à chaque build du site de documentation, ils ne divergent donc jamais de la documentation HTML.

FAQ

Le MCP server est-il sans état ?
Oui. Votre MESHY_API_KEY est utilisée par requête et n'est jamais conservée côté serveur.
Le MCP coûte-t-il la même chose que l'API REST ?
Oui — chaque appel d'outil MCP correspond à un unique appel REST et consomme des crédits exactement au même tarif. Consultez la page Tarification pour la grille complète.
Quelles sont les limites de débit ?
Le MCP server partage le même plan de limitation de débit que l'API REST. Consultez la page des limites de débit pour les limites par palier.
À quelles données Meshy le MCP peut-il accéder ?
Uniquement à ce que la MESHY_API_KEY peut atteindre via REST. Les scopes et permissions sont identiques.
Comment signaler des problèmes ?
Ouvrez un ticket sur le dépôt meshy-mcp-server : https://github.com/meshy-dev/meshy-mcp-server/issues