Metapad über MCP verwenden (Claude Desktop / Claude Code)

Wie Sie externe KI-Tools wie Claude Desktop oder Claude Code über das MCP-Protokoll mit Ihren Metapad-Modellen verbinden.

Metapad implementiert das Model Context Protocol (MCP), das es externen KI-Tools wie Claude Desktop und Claude Code ermöglicht, Ihre Modelle zu lesen und zu ändern.

Was ist MCP?

MCP ist ein Standardprotokoll, das KI-Assistenten die Interaktion mit externen Datenquellen ermöglicht. Metapads MCP-API gibt externen Tools dieselbe Reichweite wie dem integrierten KI-Assistenten — die gesamte Modellierungsoberfläche, vom Lesen des Metamodells bis zum Ausführen einer Simulation.

Voraussetzungen

Pro-Plan oder höher
Claude Desktop oder Claude Code installiert
Entweder ein API-Token (siehe „API-Tokens und externer Zugriff”) oder eine OAuth-Anmeldung (siehe „MCP über OAuth verbinden”)

Authentifizierungsoptionen

Metapad unterstützt zwei Wege, MCP-Verbindungen zu authentifizieren:

OAuth (empfohlen für die interaktive Nutzung): Melden Sie sich einfach mit Ihren Metapad-Zugangsdaten an — kein Token nötig. Details siehe „MCP über OAuth verbinden”.
API-Tokens: Erstellen Sie ein mpt_...-Token für Skripte, CI/CD oder Automatisierung. Siehe „API-Tokens und externer Zugriff”.

Claude Desktop verbinden

Öffnen Sie die Claude Desktop-Einstellungen
Finden Sie die MCP-Server-Konfiguration
Fügen Sie einen neuen MCP-Server hinzu mit:
- Typ: HTTP
- URL: Ihr Metapad-MCP-Endpunkt
- Authentifizierung: OAuth (automatisch) oder Bearer-Token (mpt_...)
Speichern und Claude Desktop neu starten
Bei OAuth öffnet sich ein Anmeldefenster — melden Sie sich mit Ihren Metapad-Zugangsdaten an
Claude kann nun Ihr Modell abfragen und ändern

Claude Code verbinden

Fügen Sie den MCP-Server mit dem unten stehenden Befehl claude mcp add hinzu oder in einer Datei .mcp.json in Ihrem Projekt
Verwenden Sie die gleiche Endpunkt-URL und den API-Token
Claude Code kann nun während der Programmiersitzungen mit Ihrem Modell interagieren

CLI-Befehl:

claude mcp add --transport http <name> \
  https://app.metapad.ai/mcp/<model_uuid> \
  --header "Authorization: Bearer <mpt_token>"

Was Claude mit Ihrem Modell tun kann

Metapad stellt über MCP annähernd hundert Tools bereit. Statt sie hier aufzulisten — die Liste wächst stetig — die Kurzfassung: Alles, was Sie in der App tun können, können Sie Claude tun lassen:

Erkunden — das Metamodell lesen, Knoten suchen und filtern, Beziehungen verfolgen, die verwendeten Tags auflisten, mögliche Duplikate erkennen, Modellstatistiken abrufen, sehen, wer ein Element wann geändert hat
Modellieren — Knoten, Beziehungen und die dahinterliegenden Typen erstellen, ändern, zusammenführen und löschen; festlegen, welche Typen sich verbinden dürfen
Fließtext an Ort und Stelle ändern — einen einzelnen Absatz einer Beschreibung oder eines veröffentlichten Dokuments ändern, ohne den ganzen Text neu zu schreiben
Organisieren — Ordner, gespeicherte Filter, Tags, Navigationsbäume
Zeichnen — Diagramme erstellen und Elemente und Beziehungen darauf platzieren
Veröffentlichen — Renderings und Publikationen verfassen und eine Seite oder eine ganze Website als Text zurückgeben lassen
Simulieren — Twins, Szenarien und Agents aufbauen, Parameter und Zeitreihen setzen und eine Simulation ausführen, um die berechneten Ergebnisse zu erhalten, Live-Daten abrufen, Dashboards aufbauen
Übersetzen — alle übersetzbaren Texte des Modells auflisten und Übersetzungen zurückschreiben
Ressourcen — Dateien hochladen, auflisten und ihre Inhalte lesen
Versionen — vor einer größeren Änderung eine Version speichern

Die vollständige, aktuelle Tool-Liste mit Parametern und Beispielen finden Sie in der MCP-API-Referenz. Sie müssen nie ein Tool von Hand benennen — Claude liest die Liste direkt vom Server.

Gelöschte Elemente wiederherstellen

Versehentlich etwas gelöscht? Bitten Sie Claude, die zuletzt gelöschten Elemente aufzulisten und wiederherzustellen. Wiederhergestellte Elemente kommen mit ihren ursprünglichen IDs und Auto-IDs, ihren Beziehungen und ihren Plätzen in Diagrammen zurück. Claude kann Ihnen auch sagen, wer ein Element wann geändert hat.

Tipps

Bitten Sie Claude zuerst, sich das Metamodell anzusehen — das gibt allem Weiteren eine solide Grundlage
Änderungen greifen sofort, und alle, die das Modell geöffnet haben, sehen sie erscheinen
Wenn Claude etwas anlegt, nennt es Ihnen die vergebene ID — einschließlich der Auto-ID wie REQ-42, sodass Sie sich sofort darauf beziehen können
Vor dem Löschen, Zusammenführen oder Ändern des Typs wird automatisch eine Version gespeichert. Bitten Sie Claude vor einer größeren Änderung, eine benannte Version zu speichern, denn automatische Versionen werden nur eine Zeit lang aufbewahrt
Der MCP-Zugriff respektiert dieselben Modelldaten wie die Web-Oberfläche
OAuth-Verbindungen zeigen Mitwirkenden Ihren Namen. Änderungen über ein API-Token erscheinen unter dem Namen des Tokens; geben Sie jedem Token also einen Namen, der sagt, wer oder was es verwendet
Alles, was über den integrierten KI-Assistenten möglich ist, steht auch über MCP zur Verfügung