Zum Inhalt

Einen MCP-Client verbinden

DATAMIMIC stellt pro Projekt einen Streamable-HTTP-MCP-Endpunkt bereit:

1
https://<platform-base>/api/v2/mcp/projects/<project-id>

Die URL identifiziert das Projekt. MCP-Client und FastMCP handeln die Protokollversion aus. Konfiguriere keinen festen MCP-Protocol-Version-Header.

First-Party-IDEs

Die DATAMIMIC Extension konfiguriert unterstützte VS-Code-, Kiro- und Google-Antigravity-Hosts. Füge keinen zweiten manuellen Eintrag hinzu. Der Host-Adapter besitzt nur die Installation; alle Hosts erhalten dieselben DATAMIMIC-Anweisungen und denselben Projekt-MCP-Vertrag.

Authentifizierung wählen

Anwendungsfall Authentifizierung
Interaktives Codex oder Claude Code Browser-OAuth, empfohlen
CI, Automation oder Client ohne OAuth Projekt-Zugriffstoken

OAuth-Freigaben und Projekt-Token sind unabhängig und können getrennt widerrufen werden.

OAuth

Codex

1
2
[mcp_servers.datamimic]
url = "https://<platform-base>/api/v2/mcp/projects/<project-id>"

Führe codex mcp login datamimic und codex mcp list aus. Schließe die Browser-Anmeldung und Projektfreigabe ab.

Claude Code

1
2
claude mcp add --transport http datamimic \
  https://<platform-base>/api/v2/mcp/projects/<project-id>

Verwende claude mcp get datamimic und /mcp, um den OAuth-Flow zu starten oder zu prüfen.

Projekt-Zugriffstoken

Erzeuge unter Projekteinstellungen > Access Token ein Token. DATAMIMIC zeigt es genau einmal und bietet kopierbare Konfigurationen für Codex, Claude Code und generisches HTTP an.

1
DATAMIMIC_PROJECT_ACCESS_TOKEN=<einmalig angezeigtes Projekt-Token>

Die generierte Konfiguration enthält nur diese Referenz und ein stabiles, nicht geheimes X-DATAMIMIC-Client-Binding. Verwende pro Runner, Anwendung oder Client-Profil ein eigenes Binding.

Codex mit Projekt-Token

1
2
3
4
[mcp_servers.datamimic_project]
url = "https://<platform-base>/api/v2/mcp/projects/<project-id>"
bearer_token_env_var = "DATAMIMIC_PROJECT_ACCESS_TOKEN"
http_headers = { "X-DATAMIMIC-Client-Binding" = "<stable-client-uuid>" }

Claude Code mit Projekt-Token

1
2
claude mcp add-json --scope local datamimic_project \
  '{"type":"http","url":"https://<platform-base>/api/v2/mcp/projects/<project-id>","headers":{"Authorization":"Bearer ${DATAMIMIC_PROJECT_ACCESS_TOKEN}","X-DATAMIMIC-Client-Binding":"<stable-client-uuid>"}}'

Speichere das Token niemals in Repository, URL, Log, Screenshot oder geteilter Konfiguration.

Projektdatenquellen untersuchen

Wenn die Data-Source-Capabilities aktiviert sind:

  1. Rufe datamimic_list_environments auf.
  2. Lies für DBMS zuerst die Metadatenkonfiguration und scanne nur bei fehlenden Metadaten.
  3. Rufe für MongoDB oder Object Storage zuerst Browse auf, scanne genau einen zurückgegebenen Locator, frage den Status ab und lies danach das gespeicherte strukturelle Ergebnis.

DATAMIMIC liefert Schemas, Tabellen, Spalten, Constraints und verschachtelte Feldpfade. Diese Tools liefern keine Zugangsdaten oder rohen Quellwerte.

Rotieren und prüfen

  1. Erzeuge ein Ersatz-Token, bevor Du das aktuelle löschst.
  2. Aktualisiere die Secret-Quelle und lade den Client neu.
  3. Liste die DATAMIMIC-Tools und führe einen nicht mutierenden Projekt-Call aus.
  4. Lösche das alte Token erst, nachdem der Ersatz funktioniert.

Das Löschen eines lokalen MCP-Eintrags widerruft nicht automatisch den serverseitigen OAuth-Grant oder das Projekt-Token.