PlanetScale MCP Server

Der PlanetScale MCP Server ist der offizielle Model-Context-Protocol-Server von PlanetScale für KI-gestützten Datenbankzugriff. Er verbindet MCP-fähige KI-Clients – darunter Claude Code, Cursor, VS Code, OpenCode, Codex, Gemini CLI und Notion – mit PlanetScale-Organisationen, -Datenbanken, -Branches, -Schemata und Query-Performance-Daten (Insights). Der offizielle Produktlink lautet https://planetscale.com/docs/mcp-server; das TypeScript-Tooling-Repository, das die direkt gepflegten MCP-Werkzeuge enthält, liegt unter https://github.com/planetscale/mcp-server (Apache-2.0, 4 GitHub-Sterne exakt per API am 08.09.2026). Der gehostete Server läuft unter https://mcp.pscale.dev/mcp/planetscale; kein lokaler Build-Schritt, kein npm-Paket und keine eigene Serverinfrastruktur sind für die Nutzung erforderlich.

Was ist der PlanetScale MCP Server?

Laut Anbieter ist der PlanetScale MCP Server ein gehosteter Remote-Server, der das Model Context Protocol (MCP) implementiert und KI-Clients direkten Zugriff auf Datenbankmetadaten, Schemata, Abfragemuster und Performance-Metriken ermöglicht. Der Server ist über OAuth für konfigurierbare Berechtigungen und Scopes abgesichert. Wer ausschließlich Insights-Daten benötigt, ohne Abfrageausführung, kann den separaten Insights-Only-Endpunkt unter https://mcp.pscale.dev/mcp/planetscale-insights-only nutzen. Für CI-Systeme und kopflose Agenten, die keinen interaktiven OAuth-Flow unterstützen, sind zusätzlich Service-Tokens verfügbar.

Verfügbare Werkzeuge

Der PlanetScale MCP Server stellt laut Anbieter die folgenden Werkzeuge bereit:
get_insights – Query-Performance-Daten und -Muster aus PlanetScale Insights abrufen
list_organizations / get_organization – Organisationen auflisten und inspizieren
list_databases / get_database – Datenbanken innerhalb einer Organisation auflisten und inspizieren
list_branches / get_branch / get_branch_schema – Datenbank-Branches und ihre Schemata auflisten und inspizieren
list_regions_for_organization – Verfügbare Regionen einer Organisation abfragen
list_cluster_size_skus – Verfügbare Clustergrößen auflisten (Engine-Filter, Raten, Region)
search_documentation – PlanetScale-Dokumentation, Code-Beispiele, API-Referenzen und Anleitungen durchsuchen

Mit optionaler Genehmigung zusätzlich verfügbar: execute_read_query (Leseanfragen, automatisch auf Replikas geleitet), execute_write_query (Schreibanfragen mit eingebautem Schutz) sowie list_invoices / get_invoice_line_items (Rechnungs- und Abrechnungsdaten).

Scopes und Berechtigungen

OAuth-Berechtigungen werden über Scopes gesteuert. Per Scope lässt sich festlegen, welche Organisationen, Datenbanken und Branches der Server sehen darf. Für jede Datenbank kann individuell kein Zugriff, Lesezugriff oder voller Zugriff gewählt werden – separat für Produktions- und Entwicklungsbranches. Laut Anbieter sollte Lesezugriff für Produktionsdatenbanken der Standard sein; Schreibzugriff auf Produktionsdatenbanken sollte nur dann gewährt werden, wenn er explizit benötigt wird, und alle Abfragen sollten vor der Ausführung sorgfältig geprüft werden.

Sichere und intelligente Abfrageausführung

Der Server enthält laut Anbieter mehrere eingebaute Sicherheitsfunktionen: Ephemere Zugangsdaten – jede Abfrage nutzt kurzlebige Credentials, die sofort nach der Ausführung gelöscht werden. Automatisches Replikationsrouting – Leseanfragen werden automatisch an ein Replikat geleitet, wenn die Datenbank über Replikas verfügt. Eingebautes Query-Tagging – alle Abfragen enthalten source=planetscale-mcp-SQL-Kommentare zur Identifikation in PlanetScale Insights. Schutz vor destruktiven Abfragen – UPDATE- oder DELETE-Anweisungen ohne WHERE-Klausel werden blockiert, TRUNCATE ist nicht erlaubt. Menschliche Bestätigung für DDL – Schema-ändernde Operationen (CREATE, DROP, ALTER) fordern das Sprachmodell auf, vor der Ausführung eine Bestätigung des Nutzers einzuholen.

Einrichtung

Die Verbindung zum PlanetScale MCP Server erfolgt über die Server-URL https://mcp.pscale.dev/mcp/planetscale. Für Claude Code genügt der Befehl claude mcp add --transport http planetscale https://mcp.pscale.dev/mcp/planetscale. VS Code bietet einen Ein-Klick-Install-Button auf der Dokumentationsseite; manuell wird der Server über „MCP: Add Server" → HTTP → URL hinzugefügt. Für Cursor gibt es ebenfalls einen Ein-Klick-Install-Button; manuell wird die JSON-Konfiguration unter .cursor/mcp.json eingetragen. OpenCode fügt den Server über die globale Konfigurationsdatei ~/.config/opencode/opencode.json hinzu. Der PlanetScale MCP Server ist auch als Connector im Claude-Connectors-Verzeichnis sowie als Claude-Code-Plugin verfügbar.

Anwendungsszenarien

Typische Nutzungsszenarien umfassen laut Anbieter: Schema und Abfragen analysieren und optimieren (Fragen wie „Warum ist diese Abfrage langsam?" oder „Wie sollte ich diese Tabelle indizieren?" auf Basis des tatsächlichen Schemas und der Query-Patterns), Metriken in natürlicher Sprache abfragen (tägliche Anmeldungen, aktive Nutzer, Conversion-Rates ohne manuelles SQL), Fehler mit vollständigem Produktionskontext debuggen (Schema, Indizes und Abfragemuster direkt im KI-Client verfügbar).

Sicherheit und Datenzugriff

Der PlanetScale MCP Server überträgt Datenbankstrukturinformationen und Abfrageergebnisse an den verbundenen KI-Client und von dort an das gewählte Sprachmodell. Zugangsdaten werden kurzlebig und ephemer verwaltet; die OAuth-Scopes bestimmen, welche Datenbanken und Operationen erreichbar sind. Schreiboperationen auf Produktionsdatenbanken sollten nur mit ausdrücklicher Genehmigung eingerichtet werden. Prompt-Injection über Datenbankinhalt ist ein allgemeines Risiko bei MCP-Servern, die Datenbankwerte zurückgeben; Abfragen mit Nutzerdaten in Rückgabewerten sollten vor dem produktiven Einsatz erprobt werden.

FAQ

Ist der PlanetScale MCP Server kostenlos? Der Server selbst ist kostenlos nutzbar. Kosten entstehen durch das PlanetScale-Datenbankabonnement; aktuelle Plan- und Preisdetails stehen auf planetscale.com/pricing. Lese-Werkzeuge wie get_insights, Schema-Abfragen und Dokumentationssuche sind unabhängig vom Plan verfügbar; Schreiboperationen und Rechnungsdaten erfordern entsprechende OAuth-Genehmigungen.

Muss ich lokal etwas installieren? Nein. Der PlanetScale MCP Server läuft ausschließlich als gehosteter Remote-Service. Für die Verbindung genügt die Server-URL im KI-Client; kein npm-Paket, kein lokaler Build und keine eigene Serverinfrastruktur sind nötig. Für CI und kopflose Umgebungen werden Service-Tokens statt OAuth empfohlen.

Was bedeuten die 4 GitHub-Sterne? Das Repository github.com/planetscale/mcp-server enthält die direkt in TypeScript gepflegten MCP-Werkzeuge; der vollständige gehostete Server schließt zusätzliche, aus der PlanetScale-API-OpenAPI-Spezifikation generierte Werkzeuge ein, die nicht im Repository liegen. Die geringe Sternzahl spiegelt den Tooling-Repository-Charakter wider, nicht die Nutzungsbreite des gehosteten Servers.

Aktives PlanetScale-Konto sowie ein MCP-fähiger KI-Client wie Claude Code, Cursor, VS Code oder OpenCode. Für CI und kopflose Umgebungen wird ein PlanetScale-Service-Token statt OAuth empfohlen.

Für Claude Code: claude mcp add --transport http planetscale https://mcp.pscale.dev/mcp/planetscale. VS Code: Server-URL https://mcp.pscale.dev/mcp/planetscale (Typ HTTP) über „MCP: Add Server" hinzufügen. Cursor: Ein-Klick-Install-Button auf planetscale.com/docs/mcp-server oder manuelle JSON-Konfiguration unter .cursor/mcp.json.

claude mcp add --transport http planetscale https://mcp.pscale.dev/mcp/planetscale

OAuth-Flow über den PlanetScale-Login (empfohlen für interaktive Clients) oder PlanetScale-Service-Token für CI und kopflose Umgebungen.

Zugriff wird per OAuth-Scope auf Organisations-, Datenbank- und Branch-Ebene konfiguriert. Lese- und Schreibzugriff sind getrennt einstellbar; Schreibzugriff auf Produktionsbranches erfordert explizite Genehmigung.

Der Server überträgt Datenbankstruktur, Schemata, Query-Performance-Daten und Abfrageergebnisse an den verbundenen KI-Client. Zugangsdaten sind kurzlebig und werden nach jeder Abfrage gelöscht.

Schreibzugriff auf Produktionsdatenbanken sollte nur mit expliziter Genehmigung eingerichtet werden. Prompt-Injection über Datenbankinhalt ist ein allgemeines MCP-Risiko bei Servern, die Datenbankwerte zurückgeben. UPDATE/DELETE ohne WHERE-Klausel sind serverseitig blockiert; DDL-Operationen erfordern Nutzerbestätigung.