KI-Integration

Meshy bietet zwei Kanäle für KI-Agenten und Codierungsassistenten: den Meshy MCP-Server für Tool-Aufrufe und llms.txt / llms-full.txt für die Dokumenteneinbindung.

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

Was ist MCP

Das Model Context Protocol (MCP) ist ein offener Standard, der es KI-Assistenten ermöglicht, externe Werkzeuge aufzurufen und strukturierte Kontexte abzurufen. Der Meshy MCP-Server umschließt die Meshy REST API als eine Reihe von Werkzeugen, die Ihr Agent aufrufen kann — ein Modell generieren, eine Aufgabe überprüfen, das Ergebnis herunterladen — ohne HTTP-Code manuell zu schreiben.

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 einen Meshy API-Schlüssel. Erstellen Sie einen unter https://www.meshy.ai/settings/api. Der MCP-Server liest ihn aus der Umgebungsvariable MESHY_API_KEY.

Schnelle Installation

# 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 eine sofort einsatzbereite Fähigkeit? Das Open-Source-Skill-Pack meshy-3d-agent enthält 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 Werkzeuge

Der MCP-Server stellt die Meshy REST API als Werkzeuge zur Verfügung, gruppiert nach Fähigkeiten.

3D-Generierung

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

Nachbearbeitung

  • meshy_remesh — die topology und/oder Polygonanzahl eines vorhandenen Modells ändern
  • meshy_retexture — eine neue Textur auf ein vorhandenes Modell anwenden
  • meshy_rig — ein Skelett zu einem 3D-humanoiden Charakter 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 überprüfen
  • meshy_list_tasks — kürzliche Aufgaben auflisten, optional nach Typ/Status gefiltert
  • meshy_cancel_task — eine ausstehende oder in Bearbeitung befindliche 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 starten (läuft lokal auf Ihrem Rechner; kein Meshy API-Aufruf)
  • meshy_analyze_printability — derzeit wird eine manuelle Druckbereitschafts-Checkliste zurückgegeben (Wandstärke, Überhänge, mannigfaltiges Netz, etc.). Wird auf eine automatisierte Analyse aufgerüstet, sobald die Meshy Druckbarkeits-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

Werkzeugnamen und -verhalten können sich ändern. Die autoritative Liste befindet sich im MCP-Server-Quellcode.

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-Dokumente direkt in einen Prompt einbinden möchten, richten Sie ihn auf unsere Klartext-Oberflächen aus:

  • llms.txt — kompakter Index + Integrationsanweisungen (das korrekte asynchrone Abfrage-Muster, Authentifizierungsregeln, Ratenlimits, Modellwahl, häufige Fehler).
  • llms-full.txt — jede API-Seite in einer einzigen Datei für die einmalige Einbindung zusammengefasst.
  • Pro-Seite-Markdown: Fügen Sie .md zu jeder Endpunkt-URL hinzu. Beispiel: https://docs.meshy.ai/api/text-to-3d.md.

Alle drei werden jedes Mal neu generiert, wenn die Dokumentationsseite erstellt wird, sodass sie nie von den HTML-Dokumenten 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 mit der exakt gleichen Rate. Siehe die Seite Preise für die vollständige Matrix.
Was sind die Ratenlimits?
Der MCP-Server teilt die gleiche Ratenlimit-Ebene wie die REST API. Siehe die Seite Ratenlimits für die Limits pro Stufe.
Auf welche Meshy-Daten kann MCP zugreifen?
Nur auf das, worauf der MESHY_API_KEY über REST zugreifen kann. Bereiche und Berechtigungen sind identisch.
Wie melde ich Probleme?
Erstellen Sie ein Problem im meshy-mcp-server-Repository: https://github.com/meshy-dev/meshy-mcp-server/issues