MCP-Server

Ein Server für das Model Context Protocol, veröffentlicht als @capydb/mcp. Er läuft lokal über stdio oder remote unter https://mcp.capydb.dev/mcp über Streamable HTTP und ruft dieselbe Steuerebenen-API auf wie Dashboard und CLI - mit derselben Organisationsbindung, denselben Berechtigungen und derselben Prüfspur.

Er bringt einen handgeschriebenen Client mit, statt zur Laufzeit vom SDK abzuhängen, sodass die Installation klein und der Start sofort ist.

Claude im Web, auf dem Desktop und auf dem Handy – und jeder Client, der Remote-MCP-Server unterstützt – verbindet sich mit https://mcp.capydb.dev/mcp. Nichts zu installieren, kein Schlüssel zum Einfügen: Sobald ein Werkzeug zum ersten Mal dein Konto braucht, schickt dich der Client im Browser durch die CapyDB-Anmeldung, wo du den Workspace wählst, den er nutzen darf. Wegwerf-Datenbanken (ephemeral) funktionieren schon vor der Anmeldung.

Die Verbindung ist ein Agent-API-Schlüssel, aufgeführt unter Einstellungen → API-Schlüssel und dort jederzeit widerrufbar. Er läuft nach 90 Tagen ab, danach bittet dich der Client, erneut zu verbinden. In Claude Code fügst du dieselbe URL mit dem Befehl unten hinzu.

claude mcp add --transport http capydb https://mcp.capydb.dev/mcp

Trag ihn in die Serverkonfiguration eines beliebigen MCP-Clients ein. Der Server übernimmt die Authentifizierung selbst: Beim ersten Aufruf ohne Schlüssel liefert er eine Geräte-Login-URL, die du im Browser bestätigst.

{
  "mcpServers": {
    "capydb": {
      "command": "npx",
      "args": ["-y", "@capydb/mcp"],
      "env": { "CAPYDB_API_KEY": "capy_live_..." }
    }
  }
}

• -Claude im Web, auf dem Desktop und auf dem Handy über den Remote-Server; Claude Code remote oder lokal
• -Cursor, Windsurf und andere Editoren mit MCP-Unterstützung
• -Jeder Client, der das Model Context Protocol über stdio oder Streamable HTTP implementiert - der Server bedient die aktuelle und die frühere Protokollfassung
• -Dein eigener Agent, über ein beliebiges MCP-SDK

• -Projekte: auflisten, anlegen, ansehen; Wegwerf-Datenbanken, die du übernehmen oder löschen kannst
• -Verbindungen: direkte und gepoolte Connection Strings holen, dazu die Zugangsdaten des K/V-Stores
• -SQL: reine Leseabfragen und, als eigenes Werkzeug, Anweisungen, die Daten ändern, mit Ergebnissen als strukturiertes JSON
• -Schema: Tabellen, Spalten, Indizes und Extensions inspizieren
• -Previews: Preview-Datenbanken anlegen, auflisten, zurücksetzen und löschen
• -Backups: Backups anlegen und auflisten, Dumps exportieren, Wiederherstellungspunkte setzen, in eine Preview zurückspielen
• -Importe: einen Import von einem anderen Anbieter starten und verfolgen
• -Betrieb: Nutzung, Logs, Observability, Alerts, Jobs und Index-Empfehlungen

Lesende Werkzeuge weisen sich als lesend aus, destruktive als destruktiv, sodass ein Client sie absichern kann. Ein UPDATE oder DELETE ohne WHERE oder ein TRUNCATE wird von der Steuerebene abgewiesen, bevor es läuft, und die Abweisung sagt dem Agenten, wie er den Aufruf korrigiert; der MCP-Server umgeht diese Prüfung nie. Für alles Riskantere weist die Werkzeugbeschreibung den Agenten an, zuerst einen Wiederherstellungspunkt anzulegen.

Das Überschreiben einer Produktionsdatenbank per Wiederherstellung ist bewusst nicht als Werkzeug freigegeben. Ein Agent kann in eine Preview wiederherstellen, die du dann selbst übernimmst; deine Produktionsdaten kann er nicht von sich aus überschreiben.

Alles, was der Server über sich selbst sagt, geht auf die Standardfehlerausgabe, weil die Standardausgabe der Protokollkanal ist. Zeigt ein Client eine leere Werkzeugliste, liegt die Antwort fast immer im MCP-Log des Clients und nicht im Server.