Naar de inhoud springen
Aurabase-logo
aurabasis

MCP Server

Beheer uw Aurabase-backend vanaf Claude Desktop, Cursor, Windsurf, Antigravity, Mistral AI, VS Code of een andere Model Context Protocol-compatibele client - 86 tools, geen fabriekswaarde.

Referentie7 min lezenNiveau referentieHerzien op 18 okt 2026

De Engelse bron is sinds deze vertaling veranderd. Sommige informatie kan verouderd zijn.
Deze pagina is automatisch vertaald. De Engelse versie is gezaghebbend.

Standaard lokale stdio-modus, lokale HTTP-modus#

De officiële Aurabase MCP server stelt 86 tools ter beschikking om uw backend te inspecteren en te controleren (82 met een projectsleutel). Het draait op uw machine, in een van de twee modi:

  1. stdio-modus (standaard): uw MCP-client start de server als een subproces met npx.
  2. HTTP-modus (Streamable HTTP): u start een lokale server (http://127.0.0.1:3001/mcp) en verwijst elke client naar zijn URL.

De gehoste service (https://mcp.aurabase.dev/mcp, inloggen met OAuth 2.1) is gepland, maar nog niet live.

Het pakket bevat twee binaire bestanden (aurabase-mcp en aurabase-mcp-hosted), dus npx heeft de binaire naam nodig: npx -y -p @aurabase/mcp-server aurabase-mcp. --project-id is vereist.

terminalbash
npx -y -p @aurabase/mcp-server aurabase-mcp \
  --url https://<slug>.aurabase.cloud \
  --project-id <uuid> \
  --service-role-key aura_sk_…

Om in plaats daarvan de lokale HTTP-server te starten, voegt u het transport, de poort en het token toe:

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_…

Configuratie per client en per modus#

stdio-modus (standaard)

Cursor (.cursor/mcp.json), Claude Desktop (claude_desktop_config.json), Windsurf (~/.codeium/windsurf/mcp_config.json), Google Antigravity (~/.gemini/config/mcp_config.json) en VS Code met Cline of Roo Code (cline_mcp_settings.json) gebruiken hetzelfde blok:

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_…"
      }
    }
  }
}

Stel voor een lokale Docker/k3d-stack AURABASE_URL in op http://localhost:8080.

HTTP-modus (lokale server)

Start de lokale HTTP-server (zie hierboven) en voeg vervolgens de URL en de waarde --auth-token toe als Bearer-token.

Cursor — .cursor/mcp.json of ~/.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 (de sleutel is 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 met 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) bereikt MCP-servers via een openbare HTTPS-URL: het zal de gehoste service gebruiken (https://mcp.aurabase.dev/mcp), gepland, nog niet live.

Een tool retourneert het antwoord van de backend, of een fout#

Nooit een vervaardigde waarde. Deze regel is geen bedoeling: hij wordt bij elke uitvoering van de CI gecontroleerd door een bank die de server opstart tegen een dode URL en mislukt als de geringste tool succesvol reageert. Elke tool declareert ook een uitvoerschema dat de SDK valideert voordat het antwoord wordt verzonden.

Tip

Alleen-lezen modus (--read-only) verwijdert muterende tools uit de catalogus en instrueert PostgreSQL om de SQL uit te voeren in een alleen-lezen transactie (37 tools van 86) — de garantie komt van de engine, niet alleen van filtering aan de clientzijde.

Vlaggen en omgevingsvariabelen#

  • --url (AURABASE_URL) — Aurabase exemplaar-URL
  • --project-id (AURABASE_PROJECT_ID) — Project-ID
  • --service-role-key (AURABASE_SERVICE_ROLE_KEY) — Beheerdersleutel
  • --read-only (AURABASE_READ_ONLY) — Toont alleen leeshulpmiddelen (37 van 86)
  • --allowed-tools (AURABASE_ALLOWED_TOOLS) — Witte lijst, gescheiden door komma's
  • --destructive-policy (MCP_DESTRUCTIVE_POLICY) — Interactieve bevestiging van destructieve SQL-bewerkingen: elicit (standaard), token, deny
  • --state-key (MCP_STATE_KEY) — Sleutel (≥ 32 bytes) die bevestigingen voor meerdere beurten ondertekent
  • --transport — stdio (standaard) of http
  • --port — HTTP-transportpoort (standaard 3001)
  • --host — HTTP-luisterinterface (standaard 127.0.0.1)
  • --auth-token (AURABASE_MCP_AUTH_TOKEN) — Token vereist op /mcp — vereist in http-modus

Verdeeld per domein#

82 blootgesteld met een eenvoudige projectsleutel, 4 gereserveerd voor het managementplan (API-sleutels en list_all_projects – beter geen tool dan een tool die systematisch faalt zonder dit kanaal).

Databank (23)list_tables, write_table, get_performance_advisors, list_extensions, execute_sql, query_table, insert_rows, update_rows, delete_rows, call_rpc, genereren_types, diff_schema, apply_migration, list_migrations, uitleg_query, analyseer_tabel, get_db_size, list_sql_functions, create_sql_function, drop_sql_function, list_sql_triggers, create_sql_trigger, drop_sql_trigger
Opslag (9)list_buckets, get_bucket, create_bucket, list_files, delete_files, move_file, create_signed_url, upload_file, empty_bucket
Autorisatie (7)list_users, get_user, create_user, update_user, delete_user, ban_user, genereer_link
Meldingen (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
Back-ups (5)list_backups, create_backup, herstel_backup, get_backup_schedule, set_backup_schedule
Edge Functions (6)aanroepen_functie, lijst_functies, get_function_info, implement_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
AI (5)index_document, rag_query, vector_search, create_vector_index, ai_completion
Waarneembaarheid (4)get_project_metrics, list_slow_queries, list_active_queries, cancel_query
Realtime (3)list_realtime_channels, get_realtime_settings, update_realtime_settings
Project(4)project_info, switch_project, get_active_project, list_all_projects (beheerkanaal)
API-sleutels (3)create_api_key, list_api_keys, revoke_api_key (beheerkanaal)
Documentatie (1)search_docs — zoeken in ingebedde documentatie (Engels)

De *_sql_function / *_sql_trigger tools creëren echte PostgreSQL functies en triggers die zijn opgeslagen in het projectschema - niet gerelateerd aan list_functions / deploy_function (Edge Functions WASM, een aparte runtime).

HTTP-modus voor clients die verbinding maken via URL#

stdio is het standaardtransport. De http-modus (streambare HTTP-, MCP-protocollen 2025-11-25 en 2026-07-28):

  • luistert standaard op 127.0.0.1 (--host om dit te wijzigen);
  • vereist een token (--auth-token of Bearer-token) — zonder dit token weigert de server te starten;
  • valideert de Origin header en reageert 403 op een ongeautoriseerde oorsprong (anti-CSRF-bescherming);
  • één serverinstantie per sessie, met vervaldatum en configureerbare limiet;
  • vergelijkt tokens in constante tijd en lichaamsgrootte van het verzoek.

Om verder te gaan#