PlanetScale MCP Server
Offizieller PlanetScale-MCP-Server: Datenbankschema, Query-Performance-Daten und Insights direkt aus jedem kompatiblen KI-Client abrufen – authentifiziert per OAuth.
- Skill Road
- PlanetScale MCP Server
Kategorien
Beschreibung
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.
Voraussetzungen
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.
Installationsanleitung
Schnellstart
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
Was der PlanetScale MCP Server ist
Der PlanetScale MCP Server verbindet KI-gestützte Entwicklungswerkzeuge wie Claude, Cursor oder Codex direkt mit PlanetScale-Datenbanken. PlanetScale ist ein Anbieter von verwalteten Datenbankdiensten auf Basis von Vitess sowie inzwischen auch Postgres. Laut Anbieter handelt es sich um einen gehosteten MCP-Server, der auf Organisationen, Datenbanken, Branches, Schemainformationen, Insights-Daten und sogar die hinterlegte Zahlungsmethode der Organisation zugreifen kann. Da der Server zentral gehostet wird und nicht lokal installiert werden muss, ist die Einrichtung für Endnutzer vergleichsweise einfach: Es genügt, den Server in einem MCP-fähigen Client über eine feste Server-Adresse einzubinden.
Schritt 1: Authentifizierung und Zugriffskontrolle
Die Verbindung zum Server erfolgt laut Dokumentation über OAuth. Jeder Client, etwa Claude Code oder Cursor, registriert sich dabei als eigene OAuth-Anwendung bei PlanetScale, und beim Verbindungsaufbau wird der Nutzer zur Anmeldung und Freigabe des Zugriffs weitergeleitet. Für automatisierte oder unbeaufsichtigte Szenarien wie Continuous-Integration-Pipelines unterstützt der Server zusätzlich Service-Token, die über einen benutzerdefinierten HTTP-Header übergeben werden. Der Zugriffsumfang wird über sogenannte Scopes gesteuert: Nutzer legen fest, ob der Server keinen, nur lesenden oder vollständigen Zugriff auf Organisationen und einzelne Datenbanken erhält. Der Zugriff auf die Zahlungsmethode ist davon separat regelbar, mit den Stufen kein Zugriff, nur lesend oder vollständiger Zugriff inklusive der Möglichkeit, einen Checkout zu starten.
Sicherheit bei Datenbankabfragen
Ein zentrales Sicherheitsmerkmal ist laut Anbieter, dass jede einzelne Abfrage über kurzlebige, eigens für diesen Zweck erzeugte Zugangsdaten läuft, die unmittelbar nach der Ausführung wieder gelöscht werden. Dennoch warnt PlanetScale ausdrücklich davor, einem Sprachmodell unbedacht Schreibrechte auf eine Produktionsdatenbank zu geben, und empfiehlt, jede vom Agenten vorgeschlagene Abfrage vor der Ausführung sorgfältig zu prüfen. Für Nutzer, die ausschließlich Insights-Daten und Schemaempfehlungen benötigen, ohne dass tatsächlich Abfragen gegen die Datenbank ausgeführt werden, bietet PlanetScale eine eingeschränkte Serverversion an, die die entsprechenden Ausführungswerkzeuge komplett ausschließt.
Schritt 2: Einrichtung in gängigen Werkzeugen
Für die bekanntesten Clients wie Cursor oder Visual Studio Code stellt PlanetScale laut Dokumentation eine Ein-Klick-Installation bereit. Für Claude Code, OpenCode, Codex CLI, Amp CLI, Notion und weitere Werkzeuge sind eigene Anleitungsschritte hinterlegt, da sich die Konfigurationssyntax je nach Client unterscheidet. Nutzer, die mit mehreren Postgres-Datenbanken innerhalb einer Organisation arbeiten, finden zudem Hinweise, wie der Agent gezielt auf die richtige Datenbank des jeweiligen Projekts ausgerichtet wird, um Verwechslungen zwischen Umgebungen zu vermeiden.
Praxisnutzen und Grenzen
Der Server eignet sich gut, um während der Entwicklung schnell Schema-Informationen abzurufen, langsame Abfragen zu identifizieren oder organisatorische Kennzahlen direkt im Chat mit dem Assistenten einzusehen, ohne zwischen mehreren Oberflächen wechseln zu müssen. Die Grenzen liegen dort, wo automatisierte Schreibzugriffe auf produktive Datenbanken ins Spiel kommen: Hier bleibt menschliche Kontrolle unverzichtbar, und die vom Anbieter selbst ausgesprochene Warnung sollte ernst genommen werden. Zudem hängt die Nutzbarkeit vollständig von einer funktionierenden Internetverbindung zum gehosteten Server ab, da es sich nicht um eine lokal betriebene Komponente handelt. Wer den Server produktiv einsetzt, sollte außerdem regelmäßig prüfen, welche Scopes tatsächlich noch benötigt werden, und nicht länger genutzte Berechtigungen zurückziehen, da die meisten Clients eine erneute Autorisierung mit angepassten Rechten unkompliziert ermöglichen. Auch das regelmäßige Rotieren von Service-Tokens in automatisierten Pipelines gehört zu einer soliden Sicherheitspraxis, da ein kompromittierter Token sonst dauerhaft Zugriff behalten könnte.
claude mcp add --transport http planetscale https://mcp.pscale.dev/mcp/planetscale
Authentifizierung
OAuth-Flow über den PlanetScale-Login (empfohlen für interaktive Clients) oder PlanetScale-Service-Token für CI und kopflose Umgebungen.
Benötigte Zugriffsrechte
Zugriff wird per OAuth-Scope auf Organisations-, Datenbank- und Branch-Ebene konfiguriert. Lese- und Schreibzugriff sind getrennt einstellbar; Schreibzugriff auf Produktionsbranches erfordert explizite Genehmigung.
Übertragene oder gespeicherte Daten
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.
Sicherheitsrisiken
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.
Lizenz und Kosten
- Lizenz
- Apache-2.0
- Kosten
- kostenlos
Der MCP-Server ist kostenlos nutzbar. Kosten entstehen durch das PlanetScale-Datenbankabonnement. Aktuelle Preise auf planetscale.com/pricing.
Alternativen
Noch nicht erfasst.
Auf einen Blick
- Anbieter
- PlanetScale
- Status
- Offizieller Server
- Betriebsart
- Remote
- Aktuelle Version
- Noch nicht erfasst.
- GitHub-Sterne
- 5
- Zuletzt geprüft
- 08.09.2026
Repository und Dokumentation
Kategorien
Unterstützte Clients
Passende Ratgeber
Anleitungen und Hintergrund, die zu diesem Eintrag passen.