KI-Integration
Verbinde KI-Agenten und Coding-Assistenten mit Meshy – über die Meshy CLI oder den Meshy MCP-Server zum Generieren von Modellen, oder über llms.txt und llms-full.txt zum Lesen der Dokumentation.
Wenn dein Agent Shell-Befehle ausführen kann, wie Claude Code, Cursor und Codex, nutze die CLI oder den MCP-Server. Wenn er sich nur über MCP mit Tools verbindet, installiere den MCP-Server. Wenn dein Chat-Agent keines von beidem unterstützt, verweise ihn auf https://docs.meshy.ai/llms.txt.
CLI oder MCP
Beide rufen dieselbe Meshy REST API auf, zu denselben Preisen. Sie unterscheiden sich darin, wer sie ausführt und wie man sich anmeldet.
| Meshy CLI | MCP-Server | |
|---|---|---|
| Wer führt es aus | Du in einem Terminal, Skripte, CI und Agenten, die Shell-Befehle ausführen können | KI-Apps, die sich über MCP mit Tools verbinden |
| Anmeldung | Einmalig im Browser. Ein API-Schlüssel ist optional, für CI. | Ein API-Schlüssel in der Konfiguration des Clients |
| Installation | npm install -g meshy-cli | Ein Befehl oder Konfigurationseintrag pro Client (siehe unten) |
| Am besten geeignet für | Skripte, Batch-Jobs, CI, Downloads und Vorbereitung für den 3D-Druck | Chat-artige Nutzung in einer Chat-App, die keine Shell-Befehle ausführen kann, wie Claude Desktop |
Um mit der CLI zu starten, siehe Meshy CLI. Der Rest dieser Seite behandelt den MCP-Server.
Was ist MCP
Das Model Context Protocol (MCP) ist ein offener Standard, der es KI-Assistenten ermöglicht, externe Tools aufzurufen und strukturierten Kontext zu erhalten. Der Meshy MCP-Server bildet die Meshy REST API als Tools ab, die dein Agent aufrufen kann. Damit kann der Agent ein Modell generieren, einen Task prüfen und das Ergebnis herunterladen – ohne handgeschriebenen HTTP-Code.
Der MCP-Server ist Open Source. Er wird auf npm als @meshy-ai/meshy-mcp-server veröffentlicht, und sein Quellcode befindet sich im meshy-mcp-server-Repository auf GitHub.
Du benötigst einen Meshy API-Schlüssel. Erstelle einen auf der API-Schlüssel-Seite der Developer Platform. Der MCP-Server liest ihn aus der Umgebungsvariable MESHY_API_KEY.
MCP-Server installieren
Um den Server zu installieren, verwende den Tab für deinen KI-Client. Ersetze msy_YOUR_API_KEY durch deinen API-Schlüssel. Jedes Setup speichert den Schlüssel in deiner benutzerspezifischen Konfiguration, außerhalb jedes Projekts, damit er nicht in einem Repository landet.
# 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
Starte den Server unter Windows über cmd /c in den obigen JSON-Konfigurationen: Setze "command" auf "cmd" und "args" auf ["/c", "npx", "-y", "@meshy-ai/meshy-mcp-server"]. Übergib in PowerShell kein JSON als Befehlsargument, da PowerShell dessen Anführungszeichen entfernt.
Bevorzugst du einen Skill? Das Open-Source-Skill-Paket meshy-3d-agent enthält fertige Meshy-Workflows, wie das Generieren eines Modells, das Verfolgen des Tasks und das Herunterladen des Ergebnisses. Es funktioniert in Claude Code, Cursor, Codex, OpenClaw und Hermes Agent. Die Skills laufen auf der Meshy CLI statt auf dem MCP-Server. Du meldest dich einmalig in deinem Browser an, daher benötigst du keinen API-Schlüssel. Sie erfordern Node.js 22.12 oder höher. Um die CLI einzurichten, siehe Meshy CLI.
npx skills add meshy-dev/meshy-3d-agent
Verfügbare Tools
Der MCP-Server stellt die Meshy REST API als die folgenden Tools bereit, gruppiert nach Funktion.
3D-Generierung
meshy_text_to_3d: erstellt ein unteiliertes Vorschau-Netz aus einem Text-Promptmeshy_image_to_3d: erstellt ein 3D-Modell aus einem Bildmeshy_multi_image_to_3d: erstellt ein 3D-Modell aus mehreren Bildern desselben Objektsmeshy_text_to_3d_refine: fügt einem Vorschau-Netz eine Textur hinzu
Nachbearbeitung
meshy_remesh: ändert die topology oder Polygonanzahl eines bestehenden Modells, oder beidesmeshy_retexture: wendet eine neue Textur auf ein bestehendes Modell anmeshy_rig: fügt einem 3D-Humanoiden-Charakter ein Skelett hinzumeshy_animate: wendet eine Animation auf einen gerigten Charakter anmeshy_convert: konvertiert ein Modell in ein anderes Dateiformatmeshy_resize: ändert die Größe eines Modells auf reale Abmessungenmeshy_uv_unwrap: generiert ein neues UV-Layout für ein Modellmeshy_text_to_motion: generiert eine Animation aus einem Text-Promptmeshy_list_animations: ruft die voreingestellten Animations-Aktions-IDs kostenlos ab
Creative Lab
meshy_creative_lab: verwandelt ein Foto in ein fertiges Creative-Lab-Produkt (führt die Prototyp- und Build-Tasks aus)
Bildgenerierung
meshy_text_to_image: erstellt ein 2D-Bild aus Textmeshy_image_to_image: erstellt ein 2D-Bild aus einem Referenzbild
Task-Verwaltung
meshy_get_task_status: prüft den Task-Status und die Download-URLsmeshy_list_tasks: listet aktuelle Tasks auf, optional gefiltert nach Typ oder Statusmeshy_cancel_task: löscht einen Task. Meshy entfernt und erstattet einenPENDING-Task und löscht einen abgeschlossenen Task. EinIN_PROGRESS-Task kann nicht abgebrochen werden, und die API gibt409zurück.meshy_download_model: lädt eine fertige Modelldatei herunter und speichert sie lokal
Arbeitsbereich
meshy_list_models: listet deine zuletzt erstellten Text-zu-3D-Modelle auf. Für andere Task-Typen verwendemeshy_list_tasks.
3D-Druck
meshy_send_to_slicer: findet die auf deinem Computer installierten Slicer und gibt einen Befehl zurück, der das Modell in einem davon öffnet. Läuft lokal und ruft die Meshy API nicht auf.meshy_analyze_printability: prüft die FDM-Druckbarkeit eines Modells kostenlos, einschließlich Wasserdichtigkeit, Volumen, Löchern, nicht-mannigfaltiger Kanten und entarteter Flächenmeshy_process_multicolor: konvertiert ein texturiertes Modell in eine mehrfarbige 3MF-Datei zum Druckenmeshy_repair_printability: repariert ein Modell für den FDM-Druckmeshy_auto_split: teilt ein Modell in separat druckbare Teile auf
Konto
meshy_check_balance: prüft deine verbleibenden Creditsmeshy_list_usage: listet die abgeschlossenen API-Tasks deines Teams und die dafür jeweils verwendeten Credits auf, für Studio- und Enterprise-Teams
Tool-Namen und -Verhalten können sich ändern. Die vollständige Liste findest du in den Tools im MCP-Server-Quellcode.
Beispiel-Prompts
Probiere zum Einstieg diese Prompts in deinem MCP-fähigen Chat aus:
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 und llms-full.txt
Wenn dein Agent MCP nicht unterstützt oder du die Meshy-Dokumentation direkt in einen Prompt einfügen möchtest, verweise ihn auf die Klartext-Versionen der Dokumentation:
llms.txt: ein kompakter Index mit Integrationsanweisungen, etwa wie man asynchrone Tasks abfragt, Authentifizierung, Ratenbegrenzungen, Modellauswahl und häufige Fehler.llms-full.txt: jede API-Seite in einer Datei, sodass ein Agent die Dokumentation in einer einzigen Anfrage lesen kann.- Markdown pro Seite: füge
.mdan eine beliebige Endpunkt-URL an, zum Beispielhttps://docs.meshy.ai/api/text-to-3d.md.
Meshy generiert alle drei Dateien bei jedem Build der Dokumentations-Website neu, damit sie mit der HTML-Dokumentation übereinstimmen.
FAQ
- Ist der MCP-Server zustandslos?
- Er speichert deine Anmeldedaten nicht. Der Server hält deinen MESHY_API_KEY im Speicher und schreibt ihn nie auf die Festplatte. Standardmäßig speichert er die heruntergeladenen Modelle samt Metadaten in einem Ordner meshy_output in seinem Arbeitsverzeichnis. Um einen Download an einem anderen Ort zu speichern, gib dem Download-Tool einen save_to-Pfad an.
- Kostet MCP genauso viel wie die REST API?
- Ja. MCP-Tool-Aufrufe führen dieselben REST-Aufrufe aus und verbrauchen Credits zum gleichen Satz. Alle Preise findest du auf der Seite Preise.
- Welche Ratenbegrenzungen gelten?
- Die Aufrufe des MCP-Servers zählen zu denselben Ratenbegrenzungen wie deine REST-API-Aufrufe. Die Limits der einzelnen Pläne findest du auf der Seite Ratenbegrenzungen.
- Auf welche Meshy-Daten kann der MCP-Server zugreifen?
- Nur auf das, worauf dein MESHY_API_KEY über die REST API zugreifen kann, mit denselben Berechtigungen.
- Wie melde ich Probleme?
- Erstelle ein Issue im meshy-mcp-server-Repository auf GitHub: https://github.com/meshy-dev/meshy-mcp-server/issues