KI-Integration

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

Wenn Sie Meshy aus Claude Code, Cursor, Windsurf, Codex oder einem anderen MCP-kompatiblen Tool integrieren, installieren Sie den untenstehenden MCP-Server. Wenn Sie die Integration über einen einfachen Chat-Agenten ohne MCP-Unterstützung vornehmen, verweisen Sie ihn stattdessen auf https://docs.meshy.ai/llms.txt.

Was ist MCP

Das Model Context Protocol (MCP) ist ein offener Standard, mit dem KI-Assistenten externe Tools aufrufen und strukturierten Kontext abrufen können. Der Meshy MCP-Server kapselt die Meshy REST API als eine Reihe von Tools, die Ihr Agent aufrufen kann — ein Modell generieren, eine Aufgabe prüfen, das Ergebnis herunterladen — ohne HTTP-Code von Hand schreiben zu müssen.

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

Sie benötigen eine Meshy API key. Erstellen Sie eine unter https://www.meshy.ai/settings/api. Der MCP-Server liest sie 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 einen direkt einsetzbaren Skill? Das Open-Source-Skill-Pack meshy-3d-agent wird mit vorgefertigten Meshy-Workflows (generieren → abfragen → herunterladen) für Claude Code, Cursor und OpenClaw geliefert. 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 Fähigkeit.

3D-Generierung

  • meshy_text_to_3d — ein 3D-Modell aus einem Text-Prompt erstellen
  • meshy_image_to_3d — ein 3D-Modell aus einem einzelnen Bild erstellen
  • meshy_multi_image_to_3d — ein 3D-Modell aus mehreren Bildern desselben Objekts erstellen
  • meshy_text_to_3d_refine — einem Vorschau-Mesh eine Textur hinzufügen

Nachbearbeitung

  • meshy_remesh — Topologie und/oder Polygonanzahl eines bestehenden Modells ändern
  • meshy_retexture — eine neue Textur auf ein bestehendes Modell anwenden
  • meshy_rig — einem humanoiden 3D-Charakter ein Skelett hinzufügen
  • meshy_animate — eine Animation auf einen geriggten Charakter anwenden

Bildgenerierung

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

Aufgabenverwaltung

  • meshy_get_task_status — Aufgabenstatus und Download-URLs prüfen
  • meshy_list_tasks — aktuelle Aufgaben auflisten, optional nach Typ/Status gefiltert
  • meshy_cancel_task — eine ausstehende oder laufende Aufgabe abbrechen
  • meshy_download_model — eine abgeschlossene Modelldatei abrufen und lokal speichern

Arbeitsbereich

  • meshy_list_models — alle Modelle im Arbeitsbereich des authentifizierten Benutzers auflisten

3D-Druck

  • meshy_send_to_slicer — installierte Slicer erkennen und das Modell in einem davon öffnen (läuft lokal auf Ihrem Rechner; kein Meshy API-Aufruf)
  • meshy_analyze_printability — gibt derzeit eine manuelle Checkliste zur Druckbereitschaft zurück (Wandstärke, Überhänge, mannigfaltiges Mesh usw.). Wird auf automatisierte Analyse aktualisiert, sobald die Meshy-Printability-API verfügbar ist.
  • meshy_process_multicolor — ein texturiertes Modell in eine mehrfarbige 3MF-Datei für den Druck konvertieren

Konto

  • meshy_check_balance — verbleibende Credits abfragen

Tool-Namen und Verhaltensweisen können sich weiterentwickeln. Die maßgebliche Liste befindet sich im MCP-Server-Quellcode.

Beispiel-Prompts

Fügen Sie diese als Ausgangspunkt in Ihren MCP-fähigen Chat ein.

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 aufnehmen möchten, verweisen Sie ihn auf unsere Klartext-Oberflächen:

  • llms.txt — kompakter Index + Integrationsanweisungen (das korrekte Muster für asynchrones Polling, Authentifizierungsregeln, Rate Limits, Modellauswahl, häufige Fehler).
  • llms-full.txt — jede API-Seite in einer einzigen Datei zusammengeführt, für die Aufnahme mit einem einzigen Abruf.
  • Markdown pro Seite: .md an eine beliebige endpoint-URL anhängen. Beispiel: https://docs.meshy.ai/api/text-to-3d.md.

Alle drei werden jedes Mal neu generiert, wenn die Dokumentationsseite gebaut wird, sodass sie nie von der HTML-Dokumentation abweichen.

FAQ

Ist der MCP-Server zustandslos?

Ja. Ihr MESHY_API_KEY wird pro Anfrage verwendet und niemals serverseitig gespeichert.

Kostet MCP dasselbe wie die REST API?

Ja — jeder MCP-Tool-Aufruf entspricht einem einzelnen REST-Aufruf und verbraucht Credits genau zum selben Satz. Siehe Pricing für die vollständige Matrix.

Welche Rate Limits gelten?

Der MCP-Server nutzt dieselbe Rate-Limit-Ebene wie die REST API. Siehe Rate Limits für Limits pro Stufe.

Auf welche Meshy-Daten kann MCP zugreifen?

Nur auf das, worauf der MESHY_API_KEY über REST zugreifen kann. Scopes und Berechtigungen sind identisch.

Wie melde ich Probleme?

Erstellen Sie ein Issue unter github.com/meshy-dev/meshy-mcp-server.