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.
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:
- stdio-modus (standaard): uw MCP-client start de server als een subproces met
npx. - 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.
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:
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:
{
"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:
{
"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):
{
"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:
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.
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) ofhttp--port— HTTP-transportpoort (standaard 3001)--host— HTTP-luisterinterface (standaard127.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(--hostom dit te wijzigen); - vereist een token (
--auth-tokenof Bearer-token) — zonder dit token weigert de server te starten; - valideert de
Originheader 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.