Ist der MCP-Server zustandslos?

Er speichert deine Zugangsdaten nicht. Der Server hält deinen MESHY_API_KEY im Arbeitsspeicher 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“.

Was sind die Rate-Limits?

Die Aufrufe des MCP-Servers zählen zu denselben Rate-Limits wie deine REST-API-Aufrufe. Die Limits der einzelnen Pläne findest du auf der Seite „Rate limits“.

Auf welche Meshy-Daten kann der MCP-Server zugreifen?

Nur auf das, worauf dein MESHY_API_KEY über die REST API Zugriff hat, 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

KI-Integration

Verbinde KI-Agenten und Coding-Assistenten mit Meshy, entweder über den Meshy MCP-Server für Tool-Aufrufe oder über llms.txt und llms-full.txt zum Lesen der Dokumentation.

Wenn du Claude Code, Cursor, Windsurf, Codex oder einen anderen MCP-Client verwendest, installiere den MCP-Server. Wenn dein Chat-Agent MCP nicht unterstützt, verweise ihn stattdessen auf https://docs.meshy.ai/llms.txt.

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 kapselt die Meshy REST API als Tools, 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 ist 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 Seite „API-Schlüssel“ der Developer Platform. Der MCP-Server liest ihn aus der Umgebungsvariable MESHY_API_KEY.

MCP-Server installieren

Verwende zur Installation des Servers den Tab für deinen KI-Client. Ersetze msy_YOUR_API_KEY durch deinen API-Schlüssel.

# 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

Bevorzugst du einen Skill? Das Open-Source-Skill-Paket meshy-3d-agent enthält fertige Meshy-Workflows für Claude Code, Cursor und OpenClaw, etwa das Generieren eines Modells, das Abfragen des Tasks und das Herunterladen des Ergebnisses. Es ruft die Meshy REST API direkt auf, sodass du den MCP-Server nicht benötigst.

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

Verfügbare Tools

Der MCP-Server bietet die Meshy REST API als folgende Tools an, gruppiert nach Funktion.

3D-Generierung

meshy_text_to_3d: erstellt ein unbestrukturiertes Preview-Netz aus einem Text-Prompt
meshy_image_to_3d: erstellt ein 3D-Modell aus einem Bild
meshy_multi_image_to_3d: erstellt ein 3D-Modell aus mehreren Bildern desselben Objekts
meshy_text_to_3d_refine: fügt einem Preview-Netz eine Textur hinzu

Nachbearbeitung

meshy_remesh: ändert die topology oder die Polygonanzahl eines bestehenden Modells, oder beides
meshy_retexture: wendet eine neue Textur auf ein bestehendes Modell an
meshy_rig: fügt einem 3D-Humanoid-Charakter ein Skelett hinzu
meshy_animate: wendet eine Animation auf einen gerigten Charakter an
meshy_convert: konvertiert ein Modell in ein anderes Dateiformat
meshy_resize: ändert die Größe eines Modells auf reale Abmessungen
meshy_uv_unwrap: generiert ein neues UV-Layout für ein Modell
meshy_text_to_motion: generiert eine Animation aus einem Text-Prompt
meshy_list_animations: ruft kostenlos die IDs der voreingestellten Animationsaktionen 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 Text
meshy_image_to_image: erstellt ein 2D-Bild aus einem Referenzbild

Task-Verwaltung

meshy_get_task_status: prüft den Task-Status und die Download-URLs
meshy_list_tasks: listet aktuelle Tasks auf, optional gefiltert nach Typ oder Status
meshy_cancel_task: löscht einen Task. Meshy entfernt und erstattet einen PENDING-Task und löscht einen abgeschlossenen Task. Ein IN_PROGRESS-Task kann nicht abgebrochen werden, und die API gibt 409 zurück.
meshy_download_model: lädt eine fertige Modelldatei herunter und speichert sie lokal

Arbeitsbereich

meshy_list_models: listet deine letzten Text zu 3D-Modelle auf. Für andere Task-Typen verwende meshy_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 kostenlos die FDM-Druckbarkeit eines Modells, einschließlich Wasserdichtigkeit, Volumen, Löchern, nicht-mannigfaltiger Kanten und entarteter Flächen
meshy_process_multicolor: konvertiert ein texturiertes Modell in eine mehrfarbige 3MF-Datei zum Drucken
meshy_repair_printability: repariert ein Modell für den FDM-Druck
meshy_auto_split: teilt ein Modell in separat druckbare Teile auf

Konto

meshy_check_balance: prüft deine verbleibenden Credits
meshy_list_usage: listet die abgeschlossenen API-Tasks deines Teams und die dafür 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, Rate-Limits, Modellwahl 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 .md an eine beliebige Endpunkt-URL an, zum Beispiel https://docs.meshy.ai/api/text-to-3d.md.

Meshy regeneriert alle drei bei jedem Build der Dokumentations-Website, damit sie mit der HTML-Dokumentation übereinstimmen.

FAQ

Ist der MCP-Server zustandslos?: Er speichert deine Zugangsdaten nicht. Der Server hält deinen MESHY_API_KEY im Arbeitsspeicher 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“.
Was sind die Rate-Limits?: Die Aufrufe des MCP-Servers zählen zu denselben Rate-Limits wie deine REST-API-Aufrufe. Die Limits der einzelnen Pläne findest du auf der Seite „Rate limits“.
Auf welche Meshy-Daten kann der MCP-Server zugreifen?: Nur auf das, worauf dein MESHY_API_KEY über die REST API Zugriff hat, 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