Vai al contenuto
Logo Aurabase
aurabase

MCP Server

Controlla il tuo backend Aurabase da Claude Desktop, Cursor, Windsurf, Antigravity, Mistral AI, VS Code o qualsiasi client compatibile con Model Context Protocol: 86 strumenti, nessun valore fabbricato.

Riferimento7 min lettoLivello riferimentoRevisionato il 18 ott 2026

La fonte inglese è cambiata da questa traduzione. Alcune informazioni potrebbero non essere aggiornate.
Questa pagina è stata tradotta automaticamente. Fa fede la versione inglese.

Modalità stdio locale per impostazione predefinita, modalità HTTP locale#

Il server ufficiale Aurabase MCP espone 86 strumenti per ispezionare e controllare il tuo backend (82 con una chiave di progetto). Funziona sulla tua macchina, in una delle due modalità:

  1. modalità stdio (predefinita): il tuo client MCP avvia il server come sottoprocesso con npx.
  2. Modalità HTTP (HTTP streaming): si avvia un server locale (http://127.0.0.1:3001/mcp) e si indirizza ciascun client al relativo URL.

Il servizio ospitato (https://mcp.aurabase.dev/mcp, accedi con OAuth 2.1) è pianificato, non ancora attivo.

Il pacchetto ha due file binari (aurabase-mcp e aurabase-mcp-hosted), quindi npx necessita del nome binario: npx -y -p @aurabase/mcp-server aurabase-mcp. --project-id è obbligatorio.

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

Per avviare invece il server HTTP locale, aggiungi il trasporto, la porta e il token:

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

Configurazione per client e per modalità#

modalità stdio (predefinita)

Cursor (.cursor/mcp.json), Claude Desktop (claude_desktop_config.json), Windsurf (~/.codeium/windsurf/mcp_config.json), Google Antigravity (~/.gemini/config/mcp_config.json) e VS Code con Cline o Roo Code (cline_mcp_settings.json) utilizzano lo stesso blocco:

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

Contro uno stack Docker/k3d locale, imposta AURABASE_URL su http://localhost:8080.

Modalità HTTP (server locale)

Avvia il server HTTP locale (vedi sopra), quindi aggiungi il suo URL e il valore --auth-token come token Bearer.

Cursore — .cursor/mcp.json o ~/.cursor/mcp.json:

.cursor/mcp.jsonjson
{
  "mcpServers": {
    "aurabase": {
      "url": "http://127.0.0.1:3001/mcp",
      "headers": {
        "Authorization": "Bearer my_secret_token"
      }
    }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json (la chiave è serverUrl):

mcp_config.jsonjson
{
  "mcpServers": {
    "aurabase": {
      "serverUrl": "http://127.0.0.1:3001/mcp",
      "headers": {
        "Authorization": "Bearer my_secret_token"
      }
    }
  }
}

Continue.dev (VS Code e JetBrains con 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) raggiunge i server MCP tramite un URL HTTPS pubblico: utilizzerà il servizio ospitato (https://mcp.aurabase.dev/mcp), pianificato, non ancora attivo.

Uno strumento restituisce la risposta dal backend o un errore#

Mai un valore fabbricato. Questa regola non è un'intenzione: viene controllata ad ogni esecuzione del CI da un banco che lancia il server contro un URL morto e fallisce se il minimo strumento risponde con successo. Ogni strumento dichiara inoltre uno schema di output che l'SDK convalida prima di emettere la risposta.

Suggerimento

La modalità di sola lettura (--read-only) rimuove gli strumenti mutanti dal catalogo e indica a PostgreSQL di eseguire l'SQL in una transazione di sola lettura (37 strumenti di 86) — la garanzia viene dal motore, non solo dal filtraggio lato client.

Flag e variabili d'ambiente#

  • --url (AURABASE_URL) — Aurabase URL dell'istanza
  • --project-id (AURABASE_PROJECT_ID) — ID progetto
  • --service-role-key (AURABASE_SERVICE_ROLE_KEY) — Chiave amministratore
  • --read-only (AURABASE_READ_ONLY) — Espone solo gli strumenti di lettura (37 di 86)
  • --allowed-tools (AURABASE_ALLOWED_TOOLS) — Lista bianca, separata da virgole
  • --destructive-policy (MCP_DESTRUCTIVE_POLICY) — Conferma interattiva delle operazioni SQL distruttive: elicit (predefinito), token, deny
  • --state-key (MCP_STATE_KEY) — Chiave (≥ 32 byte) che firma conferme multigiro
  • --transport — stdio (predefinito) o http
  • --port — Porta di trasporto HTTP (predefinita 3001)
  • --host — Interfaccia di ascolto HTTP (predefinita 127.0.0.1)
  • --auth-token (AURABASE_MCP_AUTH_TOKEN) — Token richiesto su /mcp: richiesto in modalità http

Distribuito per dominio#

82 esposti con una semplice chiave di progetto, 4 riservati al piano di gestione (chiavi API e list_all_projects — meglio nessuno strumento che uno strumento che fallisce sistematicamente senza questo canale).

Banca dati (23)list_tables, description_table, get_performance_advisors, list_extensions,execu_sql, query_table, insert_rows, update_rows, delete_rows, call_rpc, generate_types, diff_schema, apply_migration, list_migrations, aware_query, analyze_table, get_db_size, list_sql_functions, create_sql_function, drop_sql_function, list_sql_triggers, create_sql_trigger, drop_sql_trigger
Stoccaggio (9)list_buckets, get_bucket, create_bucket, list_files, delete_files, move_file, create_signed_url, upload_file, empty_bucket
Autentico (7)list_users, get_user, create_user, update_user, delete_user, ban_user, generate_link
Notifiche (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
Backup (5)list_backups, create_backup, Restore_backup, get_backup_schedule, set_backup_schedule
Edge Functions (6)richiama_funzione, elenca_funzioni, ottieni_funzione_info, distribuisci_funzione, elimina_funzione, set_funzione_env
RLS (6)list_rls_policies, create_rls_policy, update_rls_policy, drop_rls_policy, toggle_rls, get_security_advisors
IA (5)indice_documento, rag_query, ricerca_vettore, creazione_indice_vettore, ai_completion
Osservabilità (4)get_project_metrics, list_slow_queries, list_active_queries, cancel_query
In tempo reale (3)list_realtime_channels, get_realtime_settings, update_realtime_settings
Progetto (4)project_info, switch_project, get_active_project, list_all_projects (canale di gestione)
Chiavi API (3)create_api_key, list_api_keys, revoke_api_key (canale di gestione)
Documentazione (1)search_docs: ricerca nella documentazione incorporata (inglese)

Gli strumenti *_sql_function / *_sql_trigger creano funzioni e trigger PostgreSQL reali memorizzati nello schema del progetto, non correlati a list_functions / deploy_function (Edge Functions WASM, un runtime separato).

Modalità HTTP per i client che si connettono tramite URL#

stdio è il trasporto predefinito. La modalità http (protocolli Streamable HTTP, MCP 2025-11-25 e 2026-07-28):

  • ascolta su 127.0.0.1 per impostazione predefinita (--host per modificarlo);
  • richiede un token (--auth-token o token Bearer) — senza di esso, il server si rifiuta di avviarsi;
  • valida l'intestazione Origin e risponde 403 ad un'origine non autorizzata (protezione anti-CSRF);
  • un'istanza del server per sessione, con scadenza e limite configurabile;
  • confronta i token in tempo costante e limita la dimensione del corpo della richiesta.

Per andare oltre#