DOKUMENTATION

KI-Tools mit Espobase verbinden

Mit dem Espobase-Connector können Claude, ChatGPT, Cursor, VS Code und andere Tools, die das Model Context Protocol (MCP) unterstützen, mit deinen Projekten arbeiten: Schema und API-Referenz lesen, Typen generieren, Lesezugriffe ausführen, Logs und Nutzung prüfen und Datenbankänderungen vorschlagen, die du freigibst.

← Gesamte Dokumentation

Verbinden

Claude (claude.ai, Claude Desktop) und ChatGPT: Füge einen benutzerdefinierten Connector mit der Server-URL unten hinzu und klicke auf Connect. Du meldest dich bei Espobase an (E-Mail, GitHub, Google, Apple oder SSO), prüfst, was das Tool darf, und erlaubst den Zugriff. Keine Schlüssel zum Kopieren.

https://app.espobase.com/api/mcp

In Claude: Settings › Connectors › Add custom connector. In ChatGPT: Settings › Connectors (oder Apps).

Claude Code, Cursor, VS Code und andere MCP-Clients: Erstelle im Dashboard ein persönliches Zugriffstoken (Kontoeinstellungen › Entwickler); dort findest du auch die fertige Konfiguration zum Einfügen für jedes Tool. Zum Beispiel in Claude Code:

claude mcp add --transport http espobase https://app.espobase.com/api/mcp \
  --header "Authorization: Bearer <your token>"

Du brauchst ein Espobase-Konto; der Connector funktioniert mit jedem Tarif.

Was ein verbundenes Tool kann und was nicht

  • Es handelt als du: nur in den Organisationen und Projekten, auf die du Zugriff hast, mit deiner Rolle.
  • Es sieht nur, was du auf dem Zustimmungsbildschirm erlaubt hast (zum Beispiel Schema, Logs, SQL nur lesend).
  • SQL ist immer nur lesend: Anweisungen, die Daten oder Struktur ändern würden, werden abgelehnt, selbst wenn du Inhaber des Projekts bist.
  • Es kann Datenbankänderungen vorschlagen, aber nie anwenden. Du prüfst das SQL und wendest es im KI-Tab deines Projekts an.
  • Es erhält nie Datenbankpasswörter, geheime API-Schlüssel oder andere Zugangsdaten.
  • Du kannst es jederzeit unter Kontoeinstellungen › Entwickler › Verbundene Apps trennen; der Zugriff endet sofort.

Tools

whoamiDein Espobase-Konto und deine Organisationen.
list_projectsProjekte, auf die du Zugriff hast, mit Status, Umgebung, Region und deiner Rolle.
get_projectDie Details eines Projekts.
get_schemaTabellen, Spalten, Beziehungen, Row Level Security und Richtlinien (nur die Struktur).
get_api_referenceREST-Endpunkte, Filter, Authentifizierung und SDK-Nutzung zum Schreiben von Client-Code.
generate_typescript_typesespobase.types.ts für typisierte Abfragen mit @espobase/client.
run_read_only_sqlSELECT-Abfragen, ausgeführt mit dem Nur-Lese-Datenbanklogin des Projekts.
get_logsNeueste Anfrage-Logs (Pfade, Status, Dauer; nie Inhalte oder Geheimnisse).
get_usageAPI-Anfragen, Bandbreite, Datenbank- und Dateispeicher, KI-Nutzung.
list_storageBuckets, Ordner und Dateinamen (keine Dateiinhalte).
propose_schema_changeEin Plan (Tabellen, Beziehungen, Richtlinien…) und sein SQL, den du prüfst und anwendest.
create_projectEin neues Projekt, wenn du das Anlegen von Projekten erlaubt hast.

Beispielfragen

  • “Liste meine Espobase-Projekte auf und fasse das Datenbankschema meines Hauptprojekts zusammen.”
  • “Welche Tabellen in meinem Projekt haben Row Level Security, aber noch keine Richtlinien?”
  • “Schreib eine Next.js-Seite, die die letzten 20 Bestellungen aus meinem Espobase-Projekt mit @espobase/client auflistet.”
  • “Wie viele API-Anfragen hat mein Projekt diese Woche verarbeitet, und gab es Fehler in den Logs?”
  • “Schlag eine Tabelle todos vor, in der jeder angemeldete Nutzer nur seine eigenen Aufgaben sieht.”

Deine Daten

Wenn du dein KI-Tool etwas fragst, gibt der Connector die Antwort an dieses Tool zurück: zum Beispiel Tabellen- und Spaltennamen, Abfrageergebnisse, Log-Einträge oder Dateinamen. Der KI-Anbieter verarbeitet diese Inhalte dann nach seinen eigenen Bedingungen und seiner Datenschutzerklärung. Espobase erhält nie deine Unterhaltung mit dem KI-Tool. Es erhält nur, was jeder Tool-Aufruf sendet: zum Beispiel die auszuführende SQL-Abfrage oder, bei propose_schema_change, deine Änderungsanfrage, die wie im Dashboard eingegebene Anfragen im KI-Verlauf des Projekts gespeichert wird. Tool-Aufrufe werden zur Sicherheit und Prüfung protokolliert (welcher Endpunkt, wann, der Ergebnisstatus).

In der Datenschutzerklärung von Espobase erfährst du, wie wir mit deinen Informationen umgehen.

Fehlerbehebung

  • Ein Tool meldet eine fehlende Berechtigung (Scope): Trenne es und verbinde es erneut (oder erstelle ein Token mit dieser Berechtigung).
  • Deine Organisation verlangt Single Sign-on (SSO): Melde dich vor dem Verbinden mit SSO bei Espobase an.
  • Ein Projekt wird nicht angezeigt: Vielleicht hast du nur Zugriff auf ausgewählte Projekte; frag einen Administrator der Organisation.

Brauchst du Hilfe? Kontaktiere den Support.