MCP Server
Steuern Sie Ihr Aurabase-Backend über Claude Desktop, Cursor, Windsurf, Antigravity, Mistral AI, VS Code oder einen beliebigen Model Context Protocol-kompatiblen Client – 86 Tools, kein hergestellter Wert.
Standardmäßig lokaler Standardmodus, lokaler HTTP-Modus#
Der offizielle Server Aurabase MCP stellt 86 Tools zur Inspektion und Steuerung Ihres Backends zur Verfügung (82 mit einem Projektschlüssel). Es läuft auf Ihrem Computer in einem von zwei Modi:
- Standardmodus (Standard): Ihr MCP-Client startet den Server als Unterprozess mit
npx. - HTTP-Modus (Streamable HTTP): Sie starten einen lokalen Server (
http://127.0.0.1:3001/mcp) und verweisen jeden Client auf seine URL.
Der gehostete Dienst (https://mcp.aurabase.dev/mcp, Anmeldung mit OAuth 2.1) ist geplant, aber noch nicht live.
Das Paket verfügt über zwei Binärdateien (aurabase-mcp und aurabase-mcp-hosted), daher benötigt npx den Binärnamen: npx -y -p @aurabase/mcp-server aurabase-mcp. --project-id ist erforderlich.
npx -y -p @aurabase/mcp-server aurabase-mcp \
--url https://<slug>.aurabase.cloud \
--project-id <uuid> \
--service-role-key aura_sk_…
Um stattdessen den lokalen HTTP-Server zu starten, fügen Sie Transport, Port und Token hinzu:
npx -y -p @aurabase/mcp-server aurabase-mcp \
--transport http \
--port 3001 \
--auth-token my_secret_token \
--url http://localhost:8080 \
--project-id <uuid> \
--service-role-key aura_sk_…
Konfiguration pro Client und pro Modus#
Standardmodus (Standard)
Cursor (.cursor/mcp.json), Claude Desktop (claude_desktop_config.json), Windsurf (~/.codeium/windsurf/mcp_config.json), Google Antigravity (~/.gemini/config/mcp_config.json) und VS Code mit Cline oder Roo Code (cline_mcp_settings.json) verwenden denselben Block:
{
"mcpServers": {
"aurabase": {
"command": "npx",
"args": ["-y", "-p", "@aurabase/mcp-server", "aurabase-mcp"],
"env": {
"AURABASE_URL": "https://<slug>.aurabase.cloud",
"AURABASE_PROJECT_ID": "<uuid>",
"AURABASE_SERVICE_ROLE_KEY": "aura_sk_…"
}
}
}
}
Setzen Sie für einen lokalen Docker/k3d-Stack AURABASE_URL auf http://localhost:8080.
HTTP-Modus (lokaler Server)
Starten Sie den lokalen HTTP-Server (siehe oben) und fügen Sie dann seine URL und den Wert --auth-token als Bearer-Token hinzu.
Cursor – .cursor/mcp.json oder ~/.cursor/mcp.json:
{
"mcpServers": {
"aurabase": {
"url": "http://127.0.0.1:3001/mcp",
"headers": {
"Authorization": "Bearer my_secret_token"
}
}
}
}
Windsurfen – ~/.codeium/windsurf/mcp_config.json (der Schlüssel ist serverUrl):
{
"mcpServers": {
"aurabase": {
"serverUrl": "http://127.0.0.1:3001/mcp",
"headers": {
"Authorization": "Bearer my_secret_token"
}
}
}
}
Continue.dev (VS Code & JetBrains mit Codestral) – ~/.continue/config.yaml:
models:
- name: Codestral
provider: mistral
model: codestral-latest
apiKey: MISTRAL_API_KEY
mcpServers:
- name: aurabase
url: http://127.0.0.1:3001/mcp
headers:
Authorization: Bearer my_secret_token
Mistral AI (Agents & Connectors) erreicht MCP Server über eine öffentliche HTTPS-URL: Es wird den gehosteten Dienst (https://mcp.aurabase.dev/mcp) nutzen, geplant, aber noch nicht live.
Ein Tool gibt die Antwort vom Backend oder einen Fehler zurück#
Niemals ein hergestellter Wert. Diese Regel ist nicht beabsichtigt: Sie wird bei jeder Ausführung des CI von einer Bank überprüft, die den Server mit einer toten URL startet und fehlschlägt, wenn das kleinste Tool erfolgreich antwortet. Jedes Tool deklariert außerdem ein Ausgabeschema, das das SDK vor der Ausgabe der Antwort validiert.
Der schreibgeschützte Modus (--read-only) entfernt mutierende Tools aus dem Katalog und weist PostgreSQL an, die SQL in einer schreibgeschützten Transaktion auszuführen (37 Tools von 86) – die Garantie kommt von der Engine, nicht nur von der clientseitigen Filterung.
Flags und Umgebungsvariablen#
--url(AURABASE_URL) — Aurabase Instanz-URL--project-id(AURABASE_PROJECT_ID) — Projekt-ID--service-role-key(AURABASE_SERVICE_ROLE_KEY) — Admin-Schlüssel--read-only(AURABASE_READ_ONLY) — Macht nur Lesetools verfügbar (37 von 86)--allowed-tools(AURABASE_ALLOWED_TOOLS) — Whitelist, durch Kommas getrennt--destructive-policy(MCP_DESTRUCTIVE_POLICY) — Interaktive Bestätigung destruktiver SQL-Operationen:elicit(Standard),token,deny--state-key(MCP_STATE_KEY) — Schlüssel (≥ 32 Bytes), der Multiturn-Bestätigungen signiert--transport— –stdio(Standard) oderhttp--port— – HTTP-Transportport (Standard 3001)--host— – HTTP-Abhörschnittstelle (Standard127.0.0.1)--auth-token(AURABASE_MCP_AUTH_TOKEN) — Token auf /mcp erforderlich – im HTTP-Modus erforderlich
Verteilt nach Domäne#
82 werden mit einem einfachen Projektschlüssel offengelegt, 4 sind für den Managementplan reserviert (API-Schlüssel und list_all_projects – besser kein Tool als ein Tool, das ohne diesen Kanal systematisch versagt).
| Datenbank (23) | list_tables, beschreiben_tabelle, get_performance_advisors, list_extensions, ausführen_sql, query_table, einfügen_zeilen, aktualisieren_zeilen, löschen_zeilen, call_rpc, generieren_typen, diff_schema, anwenden_migration, list_migrations, erklären_query, analysieren_tabelle, get_db_size, list_sql_funktionen, erstellen_sql_funktion, drop_sql_funktion, list_sql_triggers, create_sql_trigger, drop_sql_trigger |
|---|---|
| Lagerung (9) | list_buckets, get_bucket, create_bucket, list_files, delete_files, move_file, create_signed_url, upload_file, empty_bucket |
| Authentifizierung (7) | list_users, get_user, create_user, update_user, delete_user, ban_user, generic_link |
| Benachrichtigungen (10) | send_email, send_push_notification, send_sms, list_notification_logs, get_notification_settings, update_notification_settings, list_notification_templates, create_notification_template, delete_notification_template, get_notification_stats |
| Backups (5) | list_backups, create_backup, restart_backup, get_backup_schedule, set_backup_schedule |
| Edge Functions (6) | invoke_function, list_functions, get_function_info,ploy_function, delete_function, set_function_env |
| RLS (6) | list_rls_policies, create_rls_policy, update_rls_policy, drop_rls_policy, toggle_rls, get_security_advisors |
| KI (5) | index_document, rag_query, vector_search, create_vector_index, ai_completion |
| Beobachtbarkeit (4) | get_project_metrics, list_slow_queries, list_active_queries, cancel_query |
| Echtzeit (3) | list_realtime_channels, get_realtime_settings, update_realtime_settings |
| Projekt (4) | project_info, switch_project, get_active_project, list_all_projects (Verwaltungskanal) |
| API-Schlüssel (3) | create_api_key, list_api_keys, revoke_api_key (Verwaltungskanal) |
| Dokumentation (1) | search_docs – Suche in eingebetteter Dokumentation (Englisch) |
Die Tools *_sql_function / *_sql_trigger erstellen echte PostgreSQL-Funktionen und Trigger, die im Projektschema gespeichert sind – unabhängig von list_functions / deploy_function (Edge Functions WASM, eine separate Laufzeit).
HTTP-Modus für Clients, die eine Verbindung per URL herstellen#
stdio ist der Standardtransport. Der http-Modus (Streamable HTTP, MCP-Protokolle 2025-11-25 und 2026-07-28):
- hört standardmäßig auf
127.0.0.1(--host, um es zu ändern); - erfordert ein Token (
--auth-tokenoder Bearer-Token) – ohne dieses verweigert der Server den Start; - validiert den Header
Originund antwortet 403 auf einen nicht autorisierten Ursprung (Anti-CSRF-Schutz); - eine Serverinstanz pro Sitzung, mit Ablauf und konfigurierbarer Obergrenze;
- Vergleicht Token in konstanter Zeit und begrenzt die Größe des Anforderungskörpers.