KI-Integration

Meshy bietet zwei Kanäle für KI-Agenten und Coding-Assistenten: den Meshy MCP-Server für Tool-Calling sowie llms.txt / llms-full.txt für die Einbindung der Dokumentation.

Wenn Sie Meshy über Claude Code, Cursor, Windsurf, Codex oder ein anderes MCP-kompatibles Tool integrieren, installieren Sie unten den MCP-Server. Wenn Sie von einem einfachen Chat-Agenten ohne MCP-Unterstützung aus integrieren, verweisen Sie 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 abzurufen. Der Meshy MCP-Server kapselt die Meshy REST API als eine Reihe von Tools, die Ihr Agent aufrufen kann – ein Modell generieren, einen Task prüfen, das Ergebnis herunterladen – ohne HTTP-Code von Hand zu schreiben.

Der MCP-Server ist Open Source und auf npm als @meshy-ai/meshy-mcp-server veröffentlicht. Quellcode: github.com/meshy-dev/meshy-mcp-server.

Sie benötigen einen Meshy API-Schlüssel. Erstellen Sie einen auf der Seite „API Keys“ in der Developer Platform. Der MCP-Server liest ihn aus der Umgebungsvariable MESHY_API_KEY.

Schnellinstallation

# 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

Bevorzugen Sie stattdessen ein fertiges Skill-Paket? Das Open-Source-Skill-Paket meshy-3d-agent liefert vorgefertigte Meshy-Workflows (generieren → abfragen → herunterladen) für Claude Code, Cursor und OpenClaw. Es ruft die Meshy REST API direkt auf – kein MCP-Server erforderlich.

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

Verfügbare Tools

Der MCP-Server stellt die Meshy REST API als Tools bereit, gruppiert nach Funktionsbereich.

3D-Generierung

  • meshy_text_to_3d — erstellt ein 3D-Modell 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 topology und/oder Polygonanzahl eines bestehenden Modells
  • meshy_retexture — wendet eine neue Textur auf ein bestehendes Modell an
  • meshy_rig — fügt einem humanoiden 3D-Charakter ein Skelett hinzu
  • meshy_animate — wendet eine Animation auf einen gerigten Charakter an

Bildgenerierung

  • meshy_text_to_image — 2D-Bild aus Text
  • meshy_image_to_image — 2D-Bild aus einem Referenzbild

Task-Verwaltung

  • meshy_get_task_status — prüft Task-Status und Download-URLs
  • meshy_list_tasks — listet aktuelle Tasks auf, optional gefiltert nach Typ/Status
  • meshy_cancel_task — bricht einen ausstehenden oder laufenden Task ab
  • meshy_download_model — lädt eine abgeschlossene Modelldatei herunter und speichert sie lokal

Arbeitsbereich

  • meshy_list_models — listet alle Modelle im Arbeitsbereich des authentifizierten Benutzers auf

3D-Druck

  • meshy_send_to_slicer — erkennt installierte Slicer und startet das Modell in einem davon (läuft lokal auf Ihrem Rechner; kein Meshy-API-Aufruf)
  • meshy_analyze_printability — liefert derzeit eine manuelle Checkliste zur Druckbereitschaft (Wandstärke, Überhänge, mannigfaltiges Netz usw.). Wird auf automatisierte Analyse umgestellt, sobald die Meshy-API für Druckbarkeit verfügbar ist.
  • meshy_process_multicolor — konvertiert ein texturiertes Modell in eine mehrfarbige 3MF-Datei zum Drucken

Konto

  • meshy_check_balance — fragt verbleibende Credits ab

Toolnamen und -verhalten können sich weiterentwickeln. Die maßgebliche Liste finden Sie im Quellcode des MCP-Servers.

Beispiel-Prompts

Verwenden Sie diese als Ausgangspunkt in Ihrem MCP-fähigen Chat.

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 Ihr Agent MCP nicht unterstützt oder Sie die Meshy-Dokumentation direkt in einen prompt einbinden möchten, verweisen Sie auf unsere reinen Textquellen:

  • llms.txt — kompakter Index + Integrationsanleitung (das korrekte asynchrone Polling-Muster, Auth-Regeln, Ratenlimits, Modellwahl, häufige Fehler).
  • llms-full.txt — alle API-Seiten in einer einzigen Datei zusammengefasst, für die Einbindung mit einem einzigen Abruf.
  • Markdown pro Seite: Hängen Sie .md an eine beliebige Endpunkt-URL an. Beispiel: https://docs.meshy.ai/api/text-to-3d.md.

Alle drei Dateien werden bei jedem Build der Dokumentationsseite neu generiert und weichen daher nie von der HTML-Dokumentation ab.

FAQ

Ist der MCP-Server zustandslos?
Ja. Ihr MESHY_API_KEY wird pro Anfrage verwendet und niemals serverseitig gespeichert.
Kostet MCP genauso viel wie die REST API?
Ja — jeder MCP-Tool-Aufruf entspricht genau einem REST-Aufruf und verbraucht Credits zum exakt gleichen Satz. Die vollständige Übersicht finden Sie auf der Seite „Preise“.
Wie hoch sind die Ratenlimits?
Der MCP-Server nutzt dieselbe Ratenlimit-Ebene wie die REST API. Die Limits je Tarifstufe finden Sie auf der Seite „Rate Limits“.
Auf welche Meshy-Daten kann der MCP-Server zugreifen?
Nur auf das, worauf der MESHY_API_KEY per REST zugreifen kann. Scopes und Berechtigungen sind identisch.
Wie melde ich Probleme?
Erstellen Sie ein Issue im meshy-mcp-server-Repository: https://github.com/meshy-dev/meshy-mcp-server/issues