Saltar al contenido
Logotipo de Aurabase
aurabase

MCP Servidor

Controle su backend Aurabase desde Claude Desktop, Cursor, Windsurf, Antigravity, Mistral AI, VS Code o cualquier cliente compatible con Model Context Protocol: 86 herramientas, sin valor de fabricación.

Referencia7 min leerNivel referenciaRevisado el 18 oct 2026

La fuente en inglés ha cambiado desde esta traducción. Es posible que parte de la información esté desactualizada.
Esta página fue traducida automáticamente. La versión en inglés es autorizada.

Modo stdio local por defecto, modo HTTP local#

El servidor oficial Aurabase MCP expone 86 herramientas para inspeccionar y controlar su backend (82 con una clave de proyecto). Se ejecuta en su máquina, en uno de dos modos:

  1. modo stdio (predeterminado): su cliente MCP inicia el servidor como un subproceso con npx.
  2. Modo HTTP (HTTP transmitible): inicia un servidor local (http://127.0.0.1:3001/mcp) y apunta a cada cliente a su URL.

El servicio alojado (https://mcp.aurabase.dev/mcp, inicie sesión con OAuth 2.1) está planificado, aún no está disponible.

El paquete tiene dos binarios (aurabase-mcp y aurabase-mcp-hosted), por lo que npx necesita el nombre binario: npx -y -p @aurabase/mcp-server aurabase-mcp. Se requiere --project-id.

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

Para iniciar el servidor HTTP local, agregue el transporte, el puerto y el 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_…

Configuración por cliente y por modo#

modo stdio (predeterminado)

Cursor (.cursor/mcp.json), Claude Desktop (claude_desktop_config.json), Windsurf (~/.codeium/windsurf/mcp_config.json), Google Antigravity (~/.gemini/config/mcp_config.json) y VS Code con Cline o Roo Code (cline_mcp_settings.json) usan el mismo bloque:

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

En una pila Docker/k3d local, establezca AURABASE_URL en http://localhost:8080.

Modo HTTP (servidor local)

Inicie el servidor HTTP local (ver arriba), luego agregue su URL y el valor --auth-token como token de portador.

Cursor: .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 clave es serverUrl):

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

Continuar.dev (Código VS y 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) llega a los servidores MCP a través de una URL HTTPS pública: utilizará el servicio alojado (https://mcp.aurabase.dev/mcp), planificado, aún no activo.

Una herramienta devuelve la respuesta del backend o un error#

Nunca un valor fabricado. Esta regla no es una intención: es verificada en cada ejecución del CI por un banco que lanza el servidor contra una URL inactiva y falla si la más mínima herramienta responde con éxito. Cada herramienta también declara un esquema de salida que el SDK valida antes de emitir la respuesta.

Consejo

El modo de solo lectura (--read-only) elimina las herramientas mutantes del catálogo y indica a PostgreSQL que ejecute SQL en una transacción de solo lectura (37 herramientas de 86): la garantía proviene del motor, no solo del filtrado del lado del cliente.

Banderas y variables de entorno.#

  • --url (AURABASE_URL) — Aurabase URL de instancia
  • --project-id (AURABASE_PROJECT_ID) — ID del proyecto
  • --service-role-key (AURABASE_SERVICE_ROLE_KEY) — Clave de administrador
  • --read-only (AURABASE_READ_ONLY) — Solo expone herramientas de lectura (37 de 86)
  • --allowed-tools (AURABASE_ALLOWED_TOOLS) — Lista blanca, separada por comas
  • --destructive-policy (MCP_DESTRUCTIVE_POLICY) — Confirmación interactiva de operaciones SQL destructivas: elicit (predeterminado), token, deny
  • --state-key (MCP_STATE_KEY) — Clave (≥ 32 bytes) que firma confirmaciones multiturno
  • --transport — stdio (predeterminado) o http
  • --port — Puerto de transporte HTTP (predeterminado 3001)
  • --host — Interfaz de escucha HTTP (predeterminada 127.0.0.1)
  • --auth-token (AURABASE_MCP_AUTH_TOKEN) — Se requiere token en /mcp; se requiere en modo http

Distribuido por dominio#

82 expuestos con una clave de proyecto simple, 4 reservados para el plan de gestión (claves API y list_all_projects; mejor ninguna herramienta que una herramienta que falla sistemáticamente sin este canal).

Base de datos (23)list_tables, describe_table, get_rendimiento_advisors, list_extensions, ejecutar_sql, query_table, insert_rows, update_rows, eliminar_rows, call_rpc, generate_types, diff_schema, apply_migration, list_migrations, explicar_query, analice_table, get_db_size, list_sql_functions, create_sql_function, drop_sql_function, list_sql_triggers, crear_sql_trigger, soltar_sql_trigger
Almacenamiento (9)list_buckets, get_bucket, create_bucket, list_files, delete_files, move_file, create_signed_url, upload_file, vacio_bucket
Autenticación (7)listar_usuarios, obtener_usuario, crear_usuario, actualizar_usuario, eliminar_usuario, banear_usuario, generar_enlace
Notificaciones (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
Copias de seguridad (5)list_backups, crear_copia de seguridad, restaurar_copia de seguridad, get_backup_schedule, set_backup_schedule
Edge Functions (6)invocar_función, listar_funciones, obtener_función_info, implementar_función, eliminar_función, establecer_función_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
Observabilidad (4)get_project_metrics, list_slow_queries, list_active_queries, cancel_query
Tiempo real (3)list_realtime_channels, get_realtime_settings, update_realtime_settings
Proyecto (4)project_info, switch_project, get_active_project, list_all_projects (canal de gestión)
Claves API (3)create_api_key, list_api_keys, revoke_api_key (canal de gestión)
Documentación (1)search_docs — buscar en documentación integrada (inglés)

Las herramientas *_sql_function / *_sql_trigger crean funciones y activadores PostgreSQL reales almacenados en el esquema del proyecto, sin relación con list_functions / deploy_function (Edge Functions WASM, un tiempo de ejecución separado).

Modo HTTP para clientes que se conectan por URL#

stdio es el transporte predeterminado. El modo http (HTTP transmitible, protocolos MCP 2025-11-25 y 2026-07-28):

  • escucha en 127.0.0.1 de forma predeterminada (--host para cambiarlo);
  • requiere un token (--auth-token o token de portador); sin él, el servidor se niega a iniciarse;
  • valida el encabezado Origin y responde 403 a un origen no autorizado (protección anti-CSRF);
  • una instancia de servidor por sesión, con vencimiento y límite configurable;
  • compara tokens en tiempo constante y limita el tamaño del cuerpo de la solicitud.

para ir más lejos#