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

Konfigurieren Sie den MCP-Server in der .claude/settings.json Ihres Projekts oder über die CLI
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
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
Übersetzen — alle übersetzbaren Texte des Modells auflisten und Übersetzungen zurückschreiben
Ressourcen — Dateien hochladen, auflisten und ihre Inhalte lesen

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.

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 destruktiven Änderungen wird eine Version gespeichert, sodass Sie über die Versionshistorie zurückrollen können
Der MCP-Zugriff respektiert dieselben Modelldaten wie die Web-Oberfläche
OAuth-Verbindungen zeigen Kollaborateuren Ihren Namen; API-Tokens erscheinen als „mcp-api”
Alles, was über den integrierten KI-Assistenten möglich ist, steht auch über MCP zur Verfügung