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 documents.

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 simple sans support MCP, pointez-le vers https://docs.meshy.ai/llms.txt à la place.

Qu'est-ce que 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 un contexte structuré. Le MCP server de Meshy enveloppe l'API REST de Meshy en 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 de code HTTP à la main.

Le MCP server est open source et publié sur npm sous @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 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

Préférez-vous une compétence prête à l'emploi ? Le pack de compétences open-source meshy-3d-agent propose des workflows Meshy pré-écrits (générer → interroger → télécharger) pour Claude Code, Cursor, et OpenClaw. Il appelle directement l'API REST de Meshy — pas besoin de MCP server.

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

Outils disponibles

Le MCP server expose l'API REST de Meshy en tant qu'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 — changer 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 avec squelette

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 des tâches 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 modèle complété 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 installés et lancer le modèle dans l'un d'eux (s'exécute localement sur votre machine ; aucun appel à l'API Meshy)
  • meshy_analyze_printability — retourne actuellement une liste de vérification manuelle de l'état de préparation à l'impression (épaisseur de paroi, surplombs, maillage manifold, etc.). Sera mis à niveau vers une analyse automatisée une fois l'API d'imprimabilité de Meshy disponible.
  • meshy_process_multicolor — convertir un modèle texturé en un fichier 3MF multicolore pour l'impression

Compte

  • meshy_check_balance — interroger le solde de crédits restant

Les noms et comportements des outils peuvent évoluer. La liste officielle se trouve dans la source du MCP server.

Exemples de prompts

Insérez-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 supporte pas MCP, ou si vous souhaitez ingérer directement les documents Meshy dans un prompt, pointez-le vers nos surfaces en texte brut :

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

Les trois sont régénérés chaque fois que le site de documentation est construit, donc ils ne divergent jamais des documents 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 le même prix que l'API REST ?
Oui — chaque appel d'outil MCP correspond à un seul appel REST et consomme des crédits au même taux. Voir la page Tarification pour la matrice complète.
Quelles sont les limites de taux ?
Le MCP server partage le même plan de limite de taux que l'API REST. Voir la page Limites de taux pour les limites par niveau.
À quelles données Meshy le MCP peut-il accéder ?
Seulement à ce que la MESHY_API_KEY peut accéder via REST. Les portées et permissions sont identiques.
Comment signaler des problèmes ?
Déposez un problème dans le dépôt meshy-mcp-server : https://github.com/meshy-dev/meshy-mcp-server/issues