Überblick
Der Meshy MCP-Server (Model Context Protocol) ermöglicht es lokalen KI-Agenten – wie Claude Code, Cursor, Codex und jedem anderen Client, der stdio-MCP-Server unterstützt –, die 3D-Tools von Meshy direkt aus einer Konversation aufzurufen.
Eine Verbindung gibt deinem Agenten Zugriff auf 24 Meshy-Tools: Text to 3D, Image to 3D, Texturing, Remeshing, Rigging, Druckbarkeitsprüfungen, Downloads und mehr. Die vollständige Einrichtungsseite findest du unter meshy.ai/mcp.
Meshy 3D Agent vs. Meshy MCP
Meshy 3D Agent läuft in deinem Browser auf meshy.ai — keine Einrichtung erforderlich.
Meshy MCP bringt dieselben Generierungstools in den KI-Client, in dem du bereits arbeitest, sodass du 3D-Assets erstellen und herunterladen kannst, ohne deinen Editor oder dein Terminal zu verlassen.
Was du brauchst
Node.js 18 oder höher
Einen Meshy-API-Schlüssel — erstelle einen in der Meshy Developer Platform
Einrichtung
Option A: Deinen Agenten installieren lassen (empfohlen)
Füge in einer Claude Code-, Cursor- oder Codex-Sitzung Folgendes ein:
Installiere den Meshy MCP-Server für mich. Doku: https://github.com/meshy-dev/meshy-mcp-server Hilf mir, MESHY_API_KEY lokal in den Client-Einstellungen zu konfigurieren. Bitte verlange nicht, dass ich einen API-Schlüssel in diesen Chat einfüge.
Option B: Manuelle Einrichtung
Folge den manuellen Schritten für deinen Client auf meshy.ai/mcp oder in der GitHub-README.
Verbindung überprüfen
Der Server wird bei deiner nächsten Nachricht geladen. Frage deinen Agenten: „Wie hoch ist mein Meshy-Credit-Guthaben?“
Wenn er antwortet, bist du verbunden – beschreibe einfach das Modell, das du möchtest.
Du nutzt ChatGPT?
Füge Meshy 3D aus den ChatGPT-Plugins hinzu und melde dich mit deinem Meshy-Konto an. Es ist kein API-Schlüssel und keine lokale Einrichtung erforderlich, und es funktioniert sowohl im Web als auch auf dem Desktop.
Credits und Sicherheit
Generierungen über MCP verbrauchen API-Credits des Kontos, das mit deinem API-Schlüssel verknüpft ist – genau wie direkte API-Aufrufe.
Behandle deinen API-Schlüssel wie ein Passwort: Füge ihn niemals in einen Chat ein und committe ihn nicht in die Versionskontrolle oder in gemeinsam genutzte Konfigurationsdateien.
Mehr erfahren
Tutorial: Die Meshy API und MCP verwenden
Alle Integrationen: meshy.ai/integrations
Doku für KI-Agenten: docs.meshy.ai/api/ai.md
FAQ
1. Ist der MCP-Server dasselbe wie der Meshy Agent im Browser?
Nein. Der Meshy 3D Agent ist die Chat-Oberfläche auf meshy.ai. Der MCP-Server stellt die Tools von Meshy externen KI-Clients wie Claude Code, Cursor oder Codex zur Verfügung.
2. Mein Client listet die Meshy-Tools nicht auf. Was soll ich tun?
Prüfe, ob Node.js 18+ installiert ist und ob MESHY_API_KEY in den MCP-Einstellungen des Clients gesetzt ist, und starte den Client anschließend neu. Siehe den Abschnitt zur Fehlerbehebung im GitHub-README.
3. Verbrauchen MCP-Generierungen dieselben Credits wie die Web-App?
Sie verbrauchen die API-Credits des Kontos, dem dein API-Schlüssel gehört.
4. Wohin werden die generierten Modelle gespeichert?
Bitte den Agenten, das benötigte Format herunterzuladen, zum Beispiel GLB oder FBX. Lokale Downloads werden unter meshy_output/ gespeichert und stehen für deine DCC-App oder deinen Slicer bereit.
5. Kann ich einen API-Schlüssel für mehrere Tools wiederverwenden?
Ja, in Clients, denen du vertraust – aber halte ihn aus gemeinsam genutzten oder öffentlichen Konfigurationsdateien heraus.