Xata MCP server

Zum Hauptinhalt springen

Der Xata MCP-Server ermöglicht KI-Assistenten und -Agenten die Interaktion mit Ihren Xata-Organisationen, -Projekten und -Branches unter Verwendung des Model Context Protocol (MCP).

​Was ist der Xata MCP-Server?

• Ein gehosteter MCP-Server, der parallel zur Xata-API läuft – es muss nichts installiert oder lokal ausgeführt werden.
• Authentifizierung über OAuth in Ihrem Browser oder mit einem Xata-API-Schlüssel für monitorlose 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 Editor/Chat	Unterstützung für MCP OAuth (dynamische Client-Registrierung)
API-Schlüssel	Automatisierung, CI, monitorlose Agenten	Unterstützung für benutzerdefinierte HTTP-Header

​OAuth

Bei OAuth-fähigen Clients benötigen Sie nur die Server-URL. Wenn Ihr Client sich zum ersten Mal verbindet, registriert er sich bei Xata, öffnet ein Browserfenster und fordert Sie auf, sich bei Ihrem 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

Erstellen Sie einen dedizierten API-Schlüssel für den MCP-Zugriff, anstatt einen vorhandenen Schlüssel wiederzuverwenden. Speichern Sie ihn in einer Umgebungsvariable oder im geheimen Speicher Ihres Clients – committen Sie ihn niemals in die Versionskontrolle.

​Einrichtung Ihres MCP-Clients

​Cursor

Cursor bietet einen Deep-Link für die schnelle OAuth-Einrichtung:Zu Cursor hinzufügen

Alternativ können Sie ihn manuell hinzufügen:

1. Öffnen Sie die Befehlspalette und suchen Sie nach „Cursor-Einstellungen“.
2. Klicken Sie unter Tools & MCP auf Neuer MCP-Server.
3. Fügen Sie den Xata-Server zur sich öffnenden Konfigurationsdatei hinzu:

.cursor/mcp.json

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

4. Speichern Sie die Datei. Cursor fordert Sie zur Authentifizierung auf – folgen Sie dem Browser-Ablauf und genehmigen Sie den Zugriff auf Ihr Xata-Konto.

​Claude Code

Fügen Sie den Server von Ihrem Terminal aus hinzu:

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

Starten Sie dann Claude Code und führen Sie den Slash-Befehl /mcp aus. Wählen Sie den Server xata und folgen Sie den Browser-Anweisungen zur Authentifizierung. So verwenden Sie einen API-Schlüssel anstelle von OAuth (z. B. 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. Öffnen Sie die Befehlspalette (Cmd+Shift+P / Ctrl+Shift+P).
2. Führen Sie MCP: Server hinzufügen aus und wählen Sie HTTP.
3. Geben Sie https://api.xata.tech/mcp als URL und xata als Namen ein.

Alternativ fügen Sie ihn manuell zu Ihrer Konfiguration hinzu:

.vscode/mcp.json

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

Starten Sie den Server über MCP: Server auflisten und erlauben Sie die Authentifizierung, wenn Sie dazu aufgefordert werden.

​Claude (Web und Desktop)

Fügen Sie Xata als benutzerdefinierten Connector hinzu:

1. Gehen Sie zu Einstellungen → Connectors.
2. Klicken Sie auf Benutzerdefinierten Connector hinzufügen.
3. Geben Sie https://api.xata.tech/mcp als Server-URL ein und klicken Sie auf Hinzufügen.
4. Folgen Sie den Anweisungen, um sich mit Ihrem Xata-Konto anzumelden.

Benutzerdefinierte Connectors mit Remote-MCP sind nicht in allen Claude-Tarifen verfügbar und erfordern möglicherweise, dass ein Organisationsbesitzer sie in Team-Tarifen hinzufügt. Weitere Details finden Sie in der Claude-Dokumentation.

​ChatGPT

Verbinden Sie ChatGPT über einen benutzerdefinierten Connector mit Xata:

1. Gehen Sie in ChatGPT zu Einstellungen → Connectors → Erweiterte Einstellungen und aktivieren Sie den Entwicklermodus.
2. Erstellen Sie auf der Registerkarte „Connectors“ einen neuen Connector mit der Server-URL:

https://api.xata.tech/mcp

3. Wählen Sie OAuth zur Authentifizierung und schließen Sie den Autorisierungsablauf ab, wenn Sie dazu aufgefordert werden.
4. Klicken Sie in jedem Chat, in dem Sie Xata verwenden möchten, auf die Schaltfläche + und aktivieren Sie den Xata-Connector unter Quellen hinzufügen.

​Codex CLI

Fügen Sie den Xata-Server hinzu:

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

Der Befehl add öffnet möglicherweise einen Browser und meldet einen OAuth-Fehler. Fahren Sie in diesem Fall mit dem folgenden Anmeldebefehl fort; der Servereintrag xata wurde bereits gespeichert.

Authentifizieren Sie sich bei Xata mit expliziten OAuth-Bereichen:

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

Schließen Sie die Autorisierung im Browser ab. Der Bereich offline_access ermöglicht es Codex, seine Xata-Sitzung zu aktualisieren, ohne eine erneute Browser-Autorisierung zu erfordern. Starten Sie dann codex, führen Sie /mcp aus und überprüfen Sie, ob xata verbunden und authentifiziert ist.

​Antigravity CLI

Fügen Sie Xata zu Ihrer globalen MCP-Konfiguration hinzu:

~/.gemini/config/mcp_config.json

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

Um Xata nur für ein Projekt zu aktivieren, verwenden Sie stattdessen .agents/mcp_config.json im Stammverzeichnis dieses Projekts. Starten Sie agy und geben Sie /mcp ein. Verwenden Sie im MCP-Manager Authentifizieren für xata und folgen Sie den Anweisungen, um OAuth abzuschließen.

​OpenCode

Fügen Sie den Xata-Server zu Ihrer OpenCode-Konfigurationsdatei hinzu:

~/.config/opencode/opencode.json

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

Authentifizieren Sie sich dann von Ihrem Terminal aus:

opencode mcp auth xata

​Amp

Fügen Sie den Server von Ihrem Terminal aus hinzu:

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

Starten Sie dann amp – Sie sollten aufgefordert werden, sich im Browser zu authentifizieren. Führen Sie /mcp list tools aus, um zu bestätigen, dass der Server verbunden ist.

​Windsurf

1. Öffnen Sie in Windsurf das Cascade-Panel und klicken Sie auf das MCP-Symbol (Hammer), dann auf Konfigurieren, um die Rohkonfigurationsdatei (~/.codeium/windsurf/mcp_config.json) zu öffnen.
2. Fügen Sie den Xata-Servereintrag hinzu:

~/.codeium/windsurf/mcp_config.json

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

3. Speichern Sie die Datei und klicken Sie in der Cascade-Seitenleiste auf Aktualisieren. Schließen Sie den OAuth-Ablauf ab, wenn sich das Browserfenster öffnet.

​Zed

1. Öffnen Sie Einstellungen → KI → MCP-Server und klicken Sie auf Server hinzufügen → Remote-Server hinzufügen, oder bearbeiten Sie Ihre Einstellungsdatei direkt:

settings.json

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

2. Zed fordert Sie auf, sich mit dem standardmäßigen MCP-OAuth-Ablauf beim Server zu authentifizieren.

​Cline

1. Öffnen Sie Cline in VS Code und klicken Sie auf das Symbol MCP-Server.
2. Geben Sie auf der Registerkarte Remote-Server xata als Namen, https://api.xata.tech/mcp als URL ein und wählen Sie Streamable HTTP als Transport. Oder bearbeiten Sie die Konfigurations-JSON direkt:

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

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

​Andere MCP-Clients

Jeder MCP-Client kann eine Verbindung herstellen, 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 API-Schlüssel-Authentifizierung

Konsultieren Sie die Dokumentation Ihres Clients, um herauszufinden, wo Remote-MCP-Server konfiguriert werden, und verwenden Sie https://api.xata.tech/mcp als URL.

​Verbindung überprüfen

Fragen Sie nach der Verbindung Ihren Assistenten:

Verwende den Xata MCP-Server, um mir mitzuteilen, als wer ich authentifiziert bin.

Der Assistent sollte das Tool user_info aufrufen und Ihre Benutzeridentität (oder die API-Schlüssel-Identität, wenn Sie sich mit einem Schlüssel authentifiziert haben) zurückgeben. Wenn dies der Fall ist, funktioniert die Verbindung.

​Verfügbare Tools

Der Xata MCP-Server stellt die folgenden Tools bereit:

Tool	Beschreibung
user_info	Gibt die Identität des authentifizierten Aufrufers zurück – Ihre Benutzer-ID und E-Mail für OAuth oder die API-Schlüssel-ID.
search_operations	Findet eine Xata-REST-API-Operation anhand der Absicht (z. B. „Branches auflisten“ oder „Mitglied einladen“).
describe_operation	Gibt die Parameter und Anfrage-/Antwortschemata 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 für einen Branch aus. Standardmäßig schreibgeschützt; übergeben Sie write=true, um Anweisungen auszuführen, die Daten verändern.
describe_schema	Listet die Tabellen und Spalten eines Branches auf.
list_skills	Listet die verfügbaren Xata-Skills auf – geführte Workflows für häufige 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 nach Pfad.

​Sicherheit

• Bevorzugen Sie OAuth für interaktive Clients; Tokens sind kurzlebig und können durch Trennen des Servers in Ihrem Client widerrufen werden.
• Verwenden Sie für die Automatisierung einen dedizierten API-Schlüssel und rotieren Sie ihn regelmäßig.
• Einige Tools können Ihre 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 write=true aufgerufen wird. Überprüfen Sie die von Ihrem Assistenten vorgeschlagenen Aktionen, bevor Sie sie genehmigen, und behalten Sie bei jedem Schreib- oder Löschvorgang einen Menschen in der Schleife.

​Fehlerbehebung

Die Authentifizierung schlägt ständig fehl oder läuft in einer Schleife. Entfernen Sie den Xata-Server aus Ihrem Client, starten Sie den Client neu und fügen Sie den Server erneut hinzu, um einen neuen OAuth-Ablauf auszulösen. Der Server verbindet sich, aber es werden keine Tools angezeigt. Stellen Sie sicher, dass Sie den Authentifizierungsschritt abgeschlossen haben – die meisten Tools erfordern eine gültige Sitzung, bevor sie angezeigt werden. Führen Sie den Authentifizierungsablauf Ihres Clients erneut aus und aktualisieren Sie dann seine Toolliste. Siehe „Verfügbare Tools“ für den vollständigen Satz. Ihr Client kann überhaupt keine Verbindung herstellen. Bestätigen Sie, dass die URL genau https://api.xata.tech/mcp lautet und dass Ihr Client Streamable HTTP unterstützt. Reine SSE-Clients werden nicht unterstützt. Der Server wird in Ihrem Client nicht angezeigt. Überprüfen Sie die Syntax der MCP-Konfigurationsdatei des Clients – die JSON-Form unterscheidet sich zwischen Clients (mcpServers vs. servers vs. context_servers, url vs. serverUrl) – und überprüfen Sie die Protokolle des Clients. Die meisten Clients erfordern einen vollständigen Neustart nach Konfigurationsänderungen.

War diese Seite hilfreich?

Zurück

Organisationen

Weiter