lowpoly wird am 30.10.2026 abgeschaltet. meshy-7 wird als 3D-Generierungsmodell am 31.12.2026 abgeschaltet; als Texturmodell bleibt es verfügbar. Wechseln Sie vor diesen Terminen das Modell, um Fehler bei Anfragen zu vermeiden. Alle Abkündigungen ansehen

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 CLIMCP-Server
Wer führt es ausDu in einem Terminal, Skripte, CI und Agenten, die Shell-Befehle ausführen könnenKI-Apps, die sich über MCP mit Tools verbinden
AnmeldungEinmalig im Browser. Ein API-Schlüssel ist optional, für CI.Ein API-Schlüssel in der Konfiguration des Clients
Installationnpm install -g meshy-cliEin Befehl oder Konfigurationseintrag pro Client (siehe unten)
Am besten geeignet fürSkripte, Batch-Jobs, CI, Downloads und Vorbereitung für den 3D-DruckChat-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

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-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 Vorschau-Netz eine Textur hinzu

Nachbearbeitung

  • meshy_remesh: ändert die topology oder Polygonanzahl eines bestehenden Modells, oder beides
  • meshy_retexture: wendet eine neue Textur auf ein bestehendes Modell an
  • meshy_rig: fügt einem 3D-Humanoiden-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 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 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 zuletzt erstellten 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 die FDM-Druckbarkeit eines Modells kostenlos, 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 jeweils verwendeten Credits auf, für Studio- und Enterprise-Teams

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 .md an eine beliebige Endpunkt-URL an, zum Beispiel https://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