Zum Inhalt springen
Aurabase-Logo
Aurabasis

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.

Referenz7 Min. gelesenEbene ReferenzÜberarbeitet am 18.10.2026

Die englische Quelle hat sich seit dieser Übersetzung geändert. Einige Informationen sind möglicherweise veraltet.
Diese Seite wurde automatisch übersetzt. Maßgeblich ist die englische Version.

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:

  1. Standardmodus (Standard): Ihr MCP-Client startet den Server als Unterprozess mit npx.
  2. 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.

terminalbash
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:

terminalbash
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:

mcp_config.jsonjson
{
  "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:

.cursor/mcp.jsonjson
{
  "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):

mcp_config.jsonjson
{
  "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:

config.yamlyaml
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.

Tipp

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) oder http
  • --port — – HTTP-Transportport (Standard 3001)
  • --host — – HTTP-Abhörschnittstelle (Standard 127.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-token oder Bearer-Token) – ohne dieses verweigert der Server den Start;
  • validiert den Header Origin und 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.

Um weiter zu gehen#