Xata MCP server

MCP-Server

Verbinde Cursor, Claude, VS Code und andere MCP-Clients mit Xata

Der Xata MCP server ermöglicht KI-Assistenten und Agenten die Interaktion mit deinen Xata-Organisationen, -Projekten und -Branches über das Model Context Protocol (MCP).

Was ist der Xata MCP server?

• Ein gehosteter MCP-Server, der neben der Xata API läuft — es muss nichts lokal installiert oder ausgeführt werden.
• Authentifizierung per OAuth im Browser oder mit einem Xata API-Schlüssel für Headless-Umgebungen.
• Zugänglich von jedem MCP-Client, der Remote-Server über Streamable HTTP unterstützt.

Server-URL:

https://api.xata.tech/mcp

Der Server verwendet den Streamable HTTP-Transport. Es gibt keinen SSE-Endpunkt und keine lokale (npm-)Version des Servers.

Authentifizierung

Der MCP-Server unterstützt zwei Authentifizierungsmethoden:

Methode	Verwendung	Client-Anforderung
OAuth	Interaktive Nutzung in einem Editor/Chat	Unterstützung für MCP OAuth (dynamische Client-Registrierung)
API-Schlüssel	Automatisierung, CI, Headless-Agenten	Unterstützung für benutzerdefinierte HTTP-Header

OAuth

Bei OAuth-fähigen Clients benötigst du nur die Server-URL. Wenn dein Client sich zum ersten Mal verbindet, registriert er sich bei Xata, öffnet ein Browserfenster und fordert dich auf, dich bei deinem Xata-Konto anzumelden und den Zugriff zu genehmigen. Tokens sind kurzlebig und auf den MCP-Server beschränkt.

API-Schlüssel

Clients, die benutzerdefinierte Header unterstützen, können sich stattdessen mit einem Xata API-Schlüssel authentifizieren:

Authorization: Bearer YOUR_XATA_API_KEY

[!WARNING]

Erstelle einen dedizierten API-Schlüssel für den MCP-Zugriff, anstatt einen vorhandenen Schlüssel wiederzuverwenden. Speichere ihn in einer Umgebungsvariable oder im Secret-Speicher deines Clients — committe ihn niemals in die Versionskontrolle.

Richte deinen MCP-Client ein

Cursor

[!TIP]

Cursor bietet einen Deep-Link für eine schnelle OAuth-Einrichtung:

Zu Cursor hinzufügen

Alternativ kannst du ihn manuell hinzufügen:

1. Öffne die Befehlspalette und suche nach „Cursor Settings".
2. Klicke unter Tools & MCP auf New MCP Server.
3. Füge den Xata-Server zur Konfigurationsdatei hinzu, die sich öffnet:

{
  "mcpServers": {
    "xata": {
      "url": "https://api.xata.tech/mcp"
    }
  }
}

4. Speichere die Datei. Cursor fordert dich zur Authentifizierung auf — folge dem Browser-Ablauf und genehmige den Zugriff auf dein Xata-Konto.

Claude Code

Füge den Server über dein Terminal hinzu:

claude mcp add --transport http xata https://api.xata.tech/mcp

Starte dann Claude Code und führe den Slash-Befehl /mcp aus. Wähle den Server xata und folge den Browser-Anweisungen zur Authentifizierung.

Um einen API-Schlüssel anstelle von OAuth zu verwenden (zum Beispiel in CI):

claude mcp add --transport http xata https://api.xata.tech/mcp \
  --header "Authorization: Bearer YOUR_XATA_API_KEY"

VS Code

MCP-Server in VS Code erfordern die Erweiterungen GitHub Copilot und GitHub Copilot Chat.

1. Öffne die Befehlspalette (Cmd+Shift+P / Ctrl+Shift+P).
2. Führe MCP: Add Server aus und wähle HTTP.
3. Gib https://api.xata.tech/mcp als URL und xata als Namen ein.

Alternativ kannst du ihn manuell zu deiner Konfiguration hinzufügen:

{
  "servers": {
    "xata": {
      "type": "http",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

Starte den Server über MCP: List Servers und erlaube die Authentifizierung, wenn du dazu aufgefordert wirst.

Claude (Web und Desktop)

[!TIP]

Öffne den Dialog für benutzerdefinierte Connectoren von Claude mit vorausgefüllten Xata-Details:

Xata mit Claude verbinden

Überprüfe und bestätige den Connector in Claude und authentifiziere dich dann bei Xata.

Alternativ kannst du Xata manuell als benutzerdefinierten Connector hinzufügen:

1. Gehe zu Settings → Connectors.
2. Klicke auf Add custom connector.
3. Gib https://api.xata.tech/mcp als Server-URL ein und klicke auf Add.
4. Folge den Aufforderungen, um dich mit deinem Xata-Konto anzumelden.

[!NOTE]

Benutzerdefinierte Connectoren, die Remote-MCP verwenden, sind nicht in allen Claude-Tarifen verfügbar und erfordern bei Team-Tarifen möglicherweise einen Organisationsinhaber, um sie hinzuzufügen. Weitere Details findest du in der Claude-Dokumentation.

ChatGPT

Verbinde ChatGPT über einen benutzerdefinierten Connector mit Xata:

1. Gehe in ChatGPT zu Settings → Connectors → Advanced settings und aktiviere den Developer mode.
2. Erstelle im Tab Connectors einen neuen Connector mit der Server-URL:

https://api.xata.tech/mcp

3. Wähle OAuth für die Authentifizierung und schließe den Autorisierungsablauf ab, wenn du dazu aufgefordert wirst.
4. Klicke in jedem Chat, in dem du Xata verwenden möchtest, auf die Schaltfläche + und aktiviere den Xata-Connector unter Add sources.

Codex CLI

Füge den Xata-Server hinzu:

codex mcp add xata --url https://api.xata.tech/mcp

[!NOTE]

Der Befehl add öffnet möglicherweise einen Browser und meldet einen OAuth-Fehler. Fahre in diesem Fall mit dem unten stehenden Login-Befehl fort; der Servereintrag xata wurde bereits gespeichert.

Authentifiziere dich bei Xata mit expliziten OAuth-Scopes:

codex mcp login xata --scopes mcp-client,offline_access

Schließe die Autorisierung im Browser ab. Der Scope offline_access ermöglicht es Codex, seine Xata-Sitzung zu erneuern, ohne eine weitere Browser-Autorisierung zu benötigen.

Starte dann codex, führe /mcp aus und überprüfe, ob xata verbunden und authentifiziert ist.

Antigravity CLI

Füge Xata zu deiner globalen MCP-Konfiguration hinzu:

{
  "mcpServers": {
    "xata": {
      "serverUrl": "https://api.xata.tech/mcp"
    }
  }
}

Um Xata nur für ein Projekt zu aktivieren, verwende stattdessen .agents/mcp_config.json im Stammverzeichnis dieses Projekts.

Starte agy und gib /mcp ein. Verwende im MCP Manager Authenticate für xata und folge den Aufforderungen, um OAuth abzuschließen.

OpenCode

Füge den Xata-Server zu deiner OpenCode-Konfigurationsdatei hinzu:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "xata": {
      "type": "remote",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

Authentifiziere dich dann über dein Terminal:

opencode mcp auth xata

Amp

Füge den Server über dein Terminal hinzu:

amp mcp add xata https://api.xata.tech/mcp

Starte dann amp — du solltest aufgefordert werden, dich im Browser zu authentifizieren. Führe /mcp list tools aus, um zu bestätigen, dass der Server verbunden ist.

Windsurf

1. Öffne in Windsurf das Cascade-Panel und klicke auf das MCP-Symbol (Hammer), dann auf Configure, um die rohe Konfigurationsdatei (~/.codeium/windsurf/mcp_config.json) zu öffnen.
2. Füge den Xata-Servereintrag hinzu:

{
  "mcpServers": {
    "xata": {
      "serverUrl": "https://api.xata.tech/mcp"
    }
  }
}

3. Speichere die Datei und klicke in der Cascade-Seitenleiste auf Refresh. Schließe den OAuth-Ablauf ab, wenn sich das Browserfenster öffnet.

Zed

1. Öffne Settings → AI → MCP Servers und klicke auf Add Server → Add Remote Server, oder bearbeite deine Einstellungsdatei direkt:

{
  "context_servers": {
    "xata": {
      "url": "https://api.xata.tech/mcp"
    }
  }
}

2. Zed fordert dich auf, dich beim Server über den standardmäßigen MCP-OAuth-Ablauf zu authentifizieren.

Cline

1. Öffne Cline in VS Code und klicke auf das Symbol MCP Servers.
2. Gib im Tab Remote Servers xata als Namen und https://api.xata.tech/mcp als URL ein und wähle Streamable HTTP als Transport. Oder bearbeite die Konfigurations-JSON direkt:

{
  "mcpServers": {
    "xata": {
      "type": "streamableHttp",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

[!NOTE]

Der Transporttyp muss streamableHttp sein (camelCase). Wenn er weggelassen wird, fällt Cline auf den veralteten SSE-Transport zurück, den der Xata MCP server nicht unterstützt.

Andere MCP-Clients

Jeder MCP-Client kann sich verbinden, wenn er Folgendes unterstützt:

• Remote-MCP-Server über Streamable HTTP (nicht SSE)
• OAuth mit dynamischer Client-Registrierung oder benutzerdefinierte HTTP-Header für die Authentifizierung per API-Schlüssel

Konsultiere die Dokumentation deines Clients, um zu erfahren, wo Remote-MCP-Server konfiguriert werden, und verwende https://api.xata.tech/mcp als URL.

Überprüfe die Verbindung

Bitte deinen Assistenten nach dem Verbinden:

Verwende den Xata MCP server, um die REST-API-Operation zum Auflisten von Branches zu finden.

Der Assistent sollte search_operations mit {"query":"list branches"} aufrufen und die Operation listBranches zurückgeben, die über call_read_operation aufgerufen werden kann. Wenn dies der Fall ist, funktioniert die Verbindung.

Verfügbare Tools

Der Xata MCP server stellt die folgenden Tools bereit:

Tool	Beschreibung
search_operations	Findet eine Xata REST-API-Operation anhand der Absicht (zum Beispiel „list branches" oder „invite member").
describe_operation	Gibt die Parameter und Request/Response-Schemas für eine bestimmte Operation zurück.
call_read_operation	Ruft eine schreibgeschützte Xata REST-API-Operation auf.
call_write_operation	Ruft eine Xata REST-API-Operation auf, die Daten erstellt oder aktualisiert.
call_destructive_operation	Ruft eine Xata REST-API-Operation auf, die Daten zerstört oder den Zugriff widerruft. Erfordert confirm=true.
run_sql	Führt SQL gegen einen Branch aus. Standardmäßig schreibgeschützt; Anweisungen, die Daten verändern, erfordern sowohl write=true als auch confirm=true.
describe_schema	Listet die Tabellen und Spalten eines Branches auf.
list_skills	Listet die verfügbaren Xata-Skills auf — geführte Workflows für gängige mehrstufige Aufgaben.
get_skill	Liest die Anweisungen für einen bestimmten Skill.
search_xata	Durchsucht die Xata-Dokumentation.
query_docs_filesystem_xata	Liest Xata-Dokumentationsseiten anhand des Pfads.

Sicherheit

• Bevorzuge OAuth für interaktive Clients; Tokens sind kurzlebig und können durch Trennen der Serververbindung in deinem Client widerrufen werden.
• Verwende für die Automatisierung einen dedizierten API-Schlüssel und rotiere ihn regelmäßig.
• Einige Tools können deine Daten verändern: call_write_operation und call_destructive_operation können Ressourcen ändern oder löschen (letzteres erfordert confirm=true), und run_sql kann Daten verändern, wenn es mit sowohl write=true als auch confirm=true aufgerufen wird. Überprüfe die Aktionen, die dein Assistent vorschlägt, bevor du sie genehmigst, und behalte bei jedem Schreiben oder Löschen einen Menschen im Prozess.

Fehlerbehebung

Die Authentifizierung schlägt wiederholt fehl oder gerät in eine Schleife. Entferne den Xata-Server aus deinem Client, starte den Client neu und füge den Server erneut hinzu, um einen frischen OAuth-Ablauf auszulösen.

Die Authentifizierung zeigt „Client not found" im Browser. Dein MCP-Client hat möglicherweise eine gespeicherte OAuth-Registrierung, die auf dem Authentifizierungsserver von Xata nicht mehr verfügbar ist. Je nach Client kann das Entfernen und erneute Hinzufügen des MCP-Servers diese Registrierung intakt lassen. Lösche die gespeicherte OAuth-Registrierung für Xata in deinem Client, starte dann den Xata MCP server neu und authentifiziere dich erneut, um eine frische Registrierung zu ermöglichen.

Zum Beispiel in VS Code:

1. Öffne die Befehlspalette (Cmd+Shift+P / Ctrl+Shift+P).
2. Führe Authentication: Remove Dynamic Authentication Providers aus.
3. Wähle den mit Xata verbundenen Anbieter aus und lasse nicht zugehörige Anbieter unverändert.
4. Starte den Xata MCP server neu und schließe die Authentifizierung erneut ab.

Der Server verbindet sich, aber es werden keine Tools angezeigt. Stelle sicher, dass du den Authentifizierungsschritt abgeschlossen hast — die meisten Tools erfordern eine gültige Sitzung, bevor sie erscheinen. Führe den Authentifizierungsablauf deines Clients erneut aus und aktualisiere dann seine Tool-Liste. Die vollständige Liste findest du unter Verfügbare Tools.

Dein Client kann sich überhaupt nicht verbinden. Stelle sicher, dass die URL genau https://api.xata.tech/mcp lautet und dass dein Client Streamable HTTP unterstützt. Nur-SSE-Clients werden nicht unterstützt.

Der Server erscheint nicht in deinem Client. Überprüfe die Syntax der MCP-Konfigurationsdatei des Clients — die JSON-Struktur unterscheidet sich zwischen Clients (mcpServers vs. servers vs. context_servers, url vs. serverUrl) — und prüfe die Logs des Clients. Die meisten Clients erfordern einen vollständigen Neustart nach Konfigurationsänderungen.

Diese Dokumentation wird auf Mintlify erstellt und gehostet, einer Entwickler-Dokumentationsplattform.