Aller au contenu
Logo Aurabase
aurabase

Serveur MCP

Contrôlez votre backend Aurabase depuis Claude Desktop, Cursor, Windsurf, Antigravity, Mistral AI, VS Code ou tout client compatible Model Context Protocol — 86 outils, aucune valeur manufacturée.

Référence7 min de lectureNiveau référenceRévisé le 18 oct. 2026

La source anglaise a changé depuis cette traduction. Certaines informations peuvent être en retard.
Cette page a été traduite automatiquement. La version anglaise fait foi.

Mode stdio local par défaut, mode HTTP local#

Le serveur officiel Aurabase MCP expose 86 outils pour inspecter et contrôler votre backend (82 avec une clé de projet). Il s'exécute sur votre ordinateur, dans l'un des deux modes suivants :

  1. mode stdio (par défaut): votre client MCP démarre le serveur en tant que sous-processus avec npx.
  2. Mode HTTP (Streamable HTTP): vous démarrez un serveur local (http://127.0.0.1:3001/mcp) et pointez chaque client vers son URL.

Le service hébergé (https://mcp.aurabase.dev/mcp, connexion avec OAuth 2.1) est prévu, pas encore disponible.

Le package contient deux binaires (aurabase-mcp et aurabase-mcp-hosted), donc npx a besoin du nom binaire : npx -y -p @aurabase/mcp-server aurabase-mcp. --project-id est requis.

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

Pour démarrer le serveur HTTP local, ajoutez le transport, le port et le jeton :

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

Configuration par client et par mode#

mode stdio (par défaut)

Cursor (.cursor/mcp.json), Claude Desktop (claude_desktop_config.json), Windsurf (~/.codeium/windsurf/mcp_config.json), Google Antigravity (~/.gemini/config/mcp_config.json) et VS Code avec Cline ou Roo Code (cline_mcp_settings.json) utilisent le même bloc :

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

Sur une pile Docker/k3d locale, définissez AURABASE_URL sur http://localhost:8080.

Mode HTTP (serveur local)

Démarrez le serveur HTTP local (voir ci-dessus), puis ajoutez son URL et la valeur --auth-token en tant que jeton Bearer.

Curseur — .cursor/mcp.json ou ~/.cursor/mcp.json:

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

Planche à voile — ~/.codeium/windsurf/mcp_config.json (la clé est 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 avec 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 & Connecteurs) atteint les serveurs MCP via une URL HTTPS publique : il utilisera le service hébergé (https://mcp.aurabase.dev/mcp), prévu, pas encore opérationnel.

Un outil renvoie la réponse du backend, ou une erreur#

Jamais une valeur fabriquée. Cette règle n'est pas une intention : elle est vérifiée à chaque exécution du CI par un banc qui lance le serveur contre une URL morte et échoue si le moindre outil répond avec succès. Chaque outil déclare également un schéma de sortie que le SDK valide avant d'émettre la réponse.

Astuce

Le mode lecture seule (--read-only) supprime les outils de mutation du catalogue et demande à PostgreSQL d'exécuter le SQL dans une transaction en lecture seule (37 outils sur 86) — la garantie vient du moteur, pas seulement du filtrage côté client.

Indicateurs et variables d'environnement#

  • --url (AURABASE_URL) — Aurabase URL de l'instance
  • --project-id (AURABASE_PROJECT_ID) — ID du projet
  • --service-role-key (AURABASE_SERVICE_ROLE_KEY) — Clé d'administration
  • --read-only (AURABASE_READ_ONLY) — Expose uniquement les outils de lecture (37 sur 86)
  • --allowed-tools (AURABASE_ALLOWED_TOOLS) — Liste blanche, séparée par des virgules
  • --destructive-policy (MCP_DESTRUCTIVE_POLICY) — Confirmation interactive des opérations SQL destructives : elicit (par défaut), token, deny
  • --state-key (MCP_STATE_KEY) — Clé (≥ 32 octets) qui signe les confirmations multitours
  • --transport — stdio (par défaut) ou http
  • --port — Port de transport HTTP (3001 par défaut)
  • --host — Interface d'écoute HTTP (par défaut 127.0.0.1)
  • --auth-token (AURABASE_MCP_AUTH_TOKEN) — Jeton requis sur /mcp — requis en mode http

Distribué par domaine#

82 exposés avec une simple clé de projet, 4 réservés au plan de gestion (clés API et list_all_projects — mieux vaut pas d'outil qu'un outil qui échoue systématiquement sans ce canal).

Base de données (23)list_tables, décrire_table, get_performance_advisors, list_extensions, exécuter_sql, query_table, insert_rows, update_rows, delete_rows, call_rpc, generate_types, diff_schema, apply_migration, list_migrations, expliquer_query, analyser_table, get_db_size, list_sql_functions, create_sql_function, drop_sql_function, list_sql_triggers, create_sql_trigger, drop_sql_trigger
Stockage (9)list_buckets, get_bucket, create_bucket, list_files, delete_files, move_file, create_signed_url, upload_file, empty_bucket
Authentification (7)list_users, get_user, create_user, update_user, delete_user, ban_user, generate_link
Notifications (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
Sauvegardes (5)list_backups, create_backup, restaurer_backup, get_backup_schedule, set_backup_schedule
Edge Functions (6)Invoquer_fonction, list_fonctions, get_function_info, déployer_fonction, delete_function, set_function_env
RLS (6)list_rls_policies, create_rls_policy, update_rls_policy, drop_rls_policy, toggle_rls, get_security_advisors
IA (5)index_document, rag_query, vector_search, create_vector_index, ai_completion
Observabilité (4)get_project_metrics, list_slow_queries, list_active_queries, Cancel_query
Temps réel (3)list_realtime_channels, get_realtime_settings, update_realtime_settings
Projet (4)project_info, switch_project, get_active_project, list_all_projects (canal de gestion)
Clés API (3)create_api_key, list_api_keys, revoke_api_key (canal de gestion)
Documents (1)search_docs — recherche dans la documentation intégrée (anglais)

Les outils *_sql_function / *_sql_trigger créent de véritables fonctions et déclencheurs PostgreSQL stockés dans le schéma du projet - sans rapport avec list_functions / deploy_function (Edge Functions WASM, un runtime distinct).

Mode HTTP pour les clients qui se connectent par URL#

stdio est le transport par défaut. Le mode http (Streamable HTTP, protocoles MCP 2025-11-25 et 2026-07-28) :

  • écoute sur 127.0.0.1 par défaut (--host pour le changer) ;
  • nécessite un jeton (--auth-token ou jeton Bearer) — sans lui, le serveur refuse de démarrer ;
  • valide l'entête Origin et répond 403 à une origine non autorisée (protection anti-CSRF) ;
  • une instance de serveur par session, avec expiration et plafond configurable ;
  • compare les jetons en temps constant et limite la taille du corps de la demande.

Pour aller plus loin#