Intégration IA
Connectez des agents IA et des assistants de codage à Meshy, avec le Meshy CLI ou le MCP server de Meshy pour générer des modèles, ou avec llms.txt et llms-full.txt pour lire la documentation.
Si votre agent peut exécuter des commandes shell, comme Claude Code, Cursor et Codex, utilisez le CLI ou le MCP server. S'il ne se connecte aux outils que via MCP, installez le MCP server. Si votre agent de chat ne prend en charge ni l'un ni l'autre, dirigez-le vers https://docs.meshy.ai/llms.txt.
CLI ou MCP
Les deux appellent la même API REST Meshy, aux mêmes prix. Ils diffèrent par qui les exécute et comment ils se connectent.
| Meshy CLI | MCP server | |
|---|---|---|
| Qui l'exécute | Vous dans un terminal, des scripts, le CI, et les agents capables d'exécuter des commandes shell | Les applications IA qui se connectent aux outils via MCP |
| Connexion | Une fois, dans votre navigateur. Une clé API est facultative, pour le CI. | Une clé API dans la configuration du client |
| Installation | npm install -g meshy-cli | Une commande ou une entrée de configuration par client (voir ci-dessous) |
| Idéal pour | Scripts, tâches par lots, CI, téléchargements et préparation pour l'impression 3D | Utilisation en mode chat dans une application de chat incapable d'exécuter des commandes shell, comme Claude Desktop |
Pour commencer avec le CLI, consultez Meshy CLI. Le reste de cette page couvre le MCP server.
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 d'obtenir un contexte structuré. Le MCP server de Meshy encapsule l'API REST Meshy sous forme d'outils que votre agent peut appeler. Grâce à eux, l'agent peut générer un modèle, vérifier une tâche et télécharger le résultat sans code HTTP écrit à la main.
Le MCP server est open source. Il est publié sur npm sous le nom @meshy-ai/meshy-mcp-server, et son code source se trouve dans le dépôt meshy-mcp-server sur GitHub.
Vous avez besoin d'une clé API Meshy. Créez-en une sur la page API Keys de la Developer Platform. Le MCP server la lit depuis la variable d'environnement MESHY_API_KEY.
Installer le MCP server
Pour installer le serveur, utilisez l'onglet correspondant à votre client IA. Remplacez msy_YOUR_API_KEY par votre clé API. Chaque configuration enregistre la clé dans votre configuration au niveau utilisateur, en dehors de tout projet, afin qu'elle ne se retrouve pas dans un dépôt.
# macOS / Linux / WSL
claude mcp add -s user meshy --env MESHY_API_KEY=msy_YOUR_API_KEY -- npx -y @meshy-ai/meshy-mcp-server
# Windows (PowerShell or Command Prompt)
claude mcp add -s user meshy --env MESHY_API_KEY=msy_YOUR_API_KEY "--" cmd /c npx -y @meshy-ai/meshy-mcp-server
Sous Windows, démarrez le serveur via cmd /c dans les configurations JSON ci-dessus : définissez "command" sur "cmd" et "args" sur ["/c", "npx", "-y", "@meshy-ai/meshy-mcp-server"]. Ne passez pas de JSON comme argument de commande dans PowerShell, car PowerShell supprime ses guillemets.
Vous préférez une skill ? Le pack de skills open source meshy-3d-agent propose des workflows Meshy prêts à l'emploi, comme générer un modèle, suivre la tâche et télécharger le résultat. Il fonctionne dans Claude Code, Cursor, Codex, OpenClaw et Hermes Agent. Les skills s'exécutent sur le Meshy CLI plutôt que sur le MCP server. Vous vous connectez une fois dans votre navigateur, vous n'avez donc pas besoin de clé API. Elles nécessitent Node.js 22.12 ou une version ultérieure. Pour configurer le CLI, consultez Meshy CLI.
npx skills add meshy-dev/meshy-3d-agent
Outils disponibles
Le MCP server propose l'API REST Meshy sous forme des outils suivants, regroupés par fonctionnalité.
Génération 3D
meshy_text_to_3d: crée un maillage de preview sans texture à partir d'un prompt textemeshy_image_to_3d: crée un modèle 3D à partir d'une imagemeshy_multi_image_to_3d: crée un modèle 3D à partir de plusieurs images du même objetmeshy_text_to_3d_refine: ajoute une texture à un maillage de preview
Post-traitement
meshy_remesh: modifie la topology ou le nombre de polygones d'un modèle existant, ou les deuxmeshy_retexture: applique une nouvelle texture à un modèle existantmeshy_rig: ajoute un squelette à un personnage 3D humanoïdemeshy_animate: applique une animation à un personnage riggémeshy_convert: convertit un modèle vers un autre format de fichiermeshy_resize: redimensionne un modèle à des dimensions réellesmeshy_uv_unwrap: génère une nouvelle disposition UV pour un modèlemeshy_text_to_motion: génère une animation à partir d'un prompt textemeshy_list_animations: recherche les ID d'action des animations prédéfinies, gratuitement
Creative Lab
meshy_creative_lab: transforme une photo en un produit Creative Lab terminé (exécute les tâches de prototype et de build)
Génération d'images
meshy_text_to_image: crée une image 2D à partir d'un textemeshy_image_to_image: crée une 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échargementmeshy_list_tasks: liste les tâches récentes, filtrables par type ou statutmeshy_cancel_task: supprime une tâche. Meshy retire et rembourse une tâchePENDING, et supprime une tâche terminée. Une tâcheIN_PROGRESSne peut pas être annulée, et l'API renvoie409.meshy_download_model: télécharge un fichier de modèle terminé et l'enregistre localement
Espace de travail
meshy_list_models: liste vos modèles Texte en 3D récents. Pour les autres types de tâches, utilisezmeshy_list_tasks.
Impression 3D
meshy_send_to_slicer: trouve les slicers installés sur votre ordinateur et renvoie une commande qui ouvre le modèle dans l'un d'eux. Elle s'exécute localement et n'appelle pas l'API Meshy.meshy_analyze_printability: vérifie gratuitement l'imprimabilité FDM d'un modèle, y compris l'étanchéité, le volume, les trous, les arêtes non-manifold et les faces dégénéréesmeshy_process_multicolor: convertit un modèle texturé en un fichier 3MF multicolore pour l'impressionmeshy_repair_printability: répare un modèle pour l'impression FDMmeshy_auto_split: divise un modèle en pièces imprimables séparément
Compte
meshy_check_balance: vérifie vos crédits restantsmeshy_list_usage: liste les tâches API terminées de votre équipe et les crédits utilisés par chacune, pour les équipes Studio et Enterprise
Les noms et le comportement des outils peuvent changer. Pour la liste complète, consultez les outils dans le code source du MCP server.
Exemples de prompts
Pour commencer, essayez ces prompts dans votre chat compatible MCP :
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 intégrer directement la documentation Meshy dans un prompt, dirigez-le vers les versions en texte brut de la documentation :
llms.txt: un index compact avec des instructions d'intégration, telles que comment interroger les tâches asynchrones, l'authentification, les limites de débit, le choix du modèle et les erreurs courantes.llms-full.txt: toutes les pages de l'API dans un seul fichier, afin qu'un agent puisse lire la documentation en une seule requête.- Markdown par page : ajoutez
.mdà n'importe quelle URL de point de terminaison, par exemplehttps://docs.meshy.ai/api/text-to-3d.md.
Meshy régénère les trois à chaque build du site de documentation, afin qu'ils correspondent à la documentation HTML.
FAQ
- Le MCP server est-il stateless ?
- Il ne stocke pas vos identifiants. Le serveur conserve votre MESHY_API_KEY en mémoire et ne l'écrit jamais sur le disque. Par défaut, il enregistre les modèles qu'il télécharge, avec leurs métadonnées, dans un dossier meshy_output de son répertoire de travail. Pour enregistrer un téléchargement ailleurs, indiquez à l'outil de téléchargement un chemin save_to.
- MCP coûte-t-il le même prix que l'API REST ?
- Oui. Les appels d'outils MCP effectuent les mêmes appels REST et consomment des crédits au même taux. Consultez la page Tarification pour chaque prix.
- Quelles sont les limites de débit ?
- Les appels du MCP server comptent dans les mêmes limites de débit que vos appels à l'API REST. Consultez la page Rate limits pour les limites de chaque forfait.
- À quelles données Meshy le MCP server peut-il accéder ?
- Uniquement à ce à quoi votre MESHY_API_KEY peut accéder via l'API REST, avec les mêmes autorisations.
- Comment signaler des problèmes ?
- Ouvrez un ticket dans le dépôt meshy-mcp-server sur GitHub : https://github.com/meshy-dev/meshy-mcp-server/issues