lowpoly sera retiré le 30 oct. 2026. Changez de modèle avant ces dates pour éviter les erreurs de requête. Voir toutes les dépréciations

Intégration IA

Connectez des agents IA et des assistants de codage à Meshy, avec le MCP server de Meshy pour les appels d'outils, ou avec llms.txt et llms-full.txt pour lire la documentation.

Si vous utilisez Claude Code, Cursor, Windsurf, Codex, ou un autre client MCP, installez le MCP server. Si votre agent conversationnel ne prend pas en charge MCP, dirigez-le plutôt vers https://docs.meshy.ai/llms.txt.

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 la Meshy API 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 des clés API 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.

# 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 ? Le pack de skills open source meshy-3d-agent propose des workflows Meshy prêts à l'emploi pour Claude Code, Cursor et OpenClaw, comme générer un modèle, interroger périodiquement la tâche, et télécharger le résultat. Il appelle directement la Meshy API, vous n'avez donc pas besoin du MCP server.

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

Outils disponibles

Le MCP server propose la Meshy API sous forme des outils suivants, regroupés par fonctionnalité.

Génération 3D

  • meshy_text_to_3d : crée un maillage de prévisualisation sans texture à partir d'un prompt textuel
  • meshy_image_to_3d : crée un modèle 3D à partir d'une seule 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 de prévisualisation

Post-traitement

  • meshy_remesh : modifie la topology ou le nombre de polygones d'un modèle existant, ou les deux
  • 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é
  • meshy_convert : convertit un modèle dans un autre format de fichier
  • meshy_resize : redimensionne un modèle à des dimensions réelles
  • meshy_uv_unwrap : génère une nouvelle disposition UV pour un modèle
  • meshy_text_to_motion : génère une animation à partir d'un prompt textuel
  • meshy_list_animations : consulte les ID des actions d'animation 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 texte
  • meshy_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 URLs de téléchargement
  • meshy_list_tasks : liste les tâches récentes, filtrables par type ou statut
  • meshy_cancel_task : supprime une tâche. Meshy retire et rembourse une tâche PENDING, et supprime une tâche terminée. Une tâche IN_PROGRESS ne peut pas être annulée, et l'API renvoie 409.
  • 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, utilisez meshy_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 la Meshy API.
  • 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ées
  • meshy_process_multicolor : convertit un modèle texturé en un fichier 3MF multicolore pour l'impression
  • meshy_repair_printability : répare un modèle pour l'impression FDM
  • meshy_auto_split : divise un modèle en pièces imprimables séparément

Compte

  • meshy_check_balance : vérifie vos crédits restants
  • meshy_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 des outils et leur comportement 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 insérer 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, comme la manière d'interroger les tâches asynchrones, l'authentification, les limites de débit, le choix du modèle, et les erreurs courantes.
  • llms-full.txt : chaque page 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 à l'URL de n'importe quel point de terminaison, par exemple https://docs.meshy.ai/api/text-to-3d.md.

Meshy régénère les trois fichiers à 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 la REST API ?
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 connaître tous les 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 à la REST API. Consultez la page des limites de débit pour connaître 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 la REST API, avec les mêmes permissions.
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