Ir para o conteúdo
Aura Logo
aurabase

MCP Servidor

Controle seu back-end Aurabase do Claude Desktop, Cursor, Windsurf, Antigravity, Mistral AI, VS Code ou qualquer cliente compatível com Model Context Protocol — 86 ferramentas, sem valor fabricado.

Referência7 min lidoNível referênciaRevisado em 18 de out. de 2026

A fonte em inglês mudou desde esta tradução. Algumas informações podem estar desatualizadas.
Esta página foi traduzida automaticamente. A versão em inglês é oficial.

Modo stdio local por padrão, modo HTTP local#

O servidor oficial Aurabase MCP expõe 86 ferramentas para inspecionar e controlar seu backend (82 com uma chave de projeto). Ele é executado na sua máquina, em um dos dois modos:

  1. modo stdio (padrão): seu cliente MCP inicia o servidor como um subprocesso com npx.
  2. Modo HTTP (HTTP Streamável): você inicia um servidor local (http://127.0.0.1:3001/mcp) e aponta cada cliente para sua URL.

O serviço hospedado (https://mcp.aurabase.dev/mcp, login com OAuth 2.1) está planejado, ainda não está ativo.

O pacote possui dois binários (aurabase-mcp e aurabase-mcp-hosted), então npx precisa do nome do binário: npx -y -p @aurabase/mcp-server aurabase-mcp. --project-id é obrigatório.

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

Para iniciar o servidor HTTP local, adicione o transporte, a porta e o 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_…

Configuração por cliente e por modo#

modo stdio (padrão)

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 com Cline ou Roo Code (cline_mcp_settings.json) usam o mesmo bloco:

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

Em uma pilha Docker/k3d local, defina AURABASE_URL como http://localhost:8080.

Modo HTTP (servidor local)

Inicie o servidor HTTP local (veja acima) e adicione seu URL e o valor --auth-token como um token de portador.

Cursor — .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"
      }
    }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json (a chave é serverUrl):

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

Continue.dev (Código VS e JetBrains com 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 (Agentes e Conectores) atinge servidores MCP através de uma URL HTTPS pública: usará o serviço hospedado (https://mcp.aurabase.dev/mcp), planejado, ainda não ativo.

Uma ferramenta retorna a resposta do back-end ou um erro#

Nunca um valor fabricado. Esta regra não é uma intenção: ela é verificada a cada execução do CI por um banco que lança o servidor contra uma URL morta e falha se a menor ferramenta responder com sucesso. Cada ferramenta também declara um esquema de saída que o SDK valida antes de emitir a resposta.

Dica

O modo somente leitura (--read-only) remove ferramentas mutantes do catálogo e instrui PostgreSQL a executar o SQL em uma transação somente leitura (37 ferramentas de 86) — a garantia vem do mecanismo, não apenas da filtragem do lado do cliente.

Sinalizadores e variáveis de ambiente#

  • --url (AURABASE_URL) — Aurabase URL da instância
  • --project-id (AURABASE_PROJECT_ID) — ID do projeto
  • --service-role-key (AURABASE_SERVICE_ROLE_KEY) — Chave de administrador
  • --read-only (AURABASE_READ_ONLY) — Expõe apenas ferramentas de leitura (37 de 86)
  • --allowed-tools (AURABASE_ALLOWED_TOOLS) — Lista de permissões, separadas por vírgulas
  • --destructive-policy (MCP_DESTRUCTIVE_POLICY) — Confirmação interativa de operações SQL destrutivas: elicit (padrão), token, deny
  • --state-key (MCP_STATE_KEY) — Chave (≥ 32 bytes) que assina confirmações multivoltas
  • --transport — stdio (padrão) ou http
  • --port — porta de transporte HTTP (padrão 3001)
  • --host — Interface de escuta HTTP (padrão 127.0.0.1)
  • --auth-token (AURABASE_MCP_AUTH_TOKEN) — Token necessário em /mcp — necessário no modo http

Distribuído por domínio#

82 expostas com uma chave de projeto simples, 4 reservadas para o plano de gerenciamento (chaves de API e list_all_projects — melhor nenhuma ferramenta do que uma ferramenta que falha sistematicamente sem este canal).

Banco de dados (23)list_tables, description_table, get_performance_advisors, list_extensions, execute_sql, query_table, insert_rows, update_rows, delete_rows, call_rpc, generate_types, diff_schema, apply_migration, list_migrations, explica_query, analyze_table, get_db_size, list_sql_functions, create_sql_function, drop_sql_function, list_sql_triggers, create_sql_trigger, drop_sql_trigger
Armazenamento (9)list_buckets, get_bucket, create_bucket, list_files, delete_files, move_file, create_signed_url, upload_file, empty_bucket
Autorização (7)list_users, get_user, create_user, update_user, delete_user, ban_user, generate_link
Notificações (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
Backups (5)list_backups, criar_backup, restaurar_backup, get_backup_schedule, set_backup_schedule
Edge Functions (6)invocar_função, listar_funções, get_função_info, implantar_função, excluir_função, set_função_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
Observabilidade (4)get_project_metrics, list_slow_queries, list_active_queries, cancel_query
Tempo real (3)list_realtime_channels, get_realtime_settings, update_realtime_settings
Projeto (4)project_info, switch_project, get_active_project, list_all_projects (canal de gerenciamento)
Chaves de API (3)create_api_key, list_api_keys, revoke_api_key (canal de gerenciamento)
Documentação (1)search_docs — pesquisa em documentação incorporada (inglês)

As ferramentas *_sql_function / *_sql_trigger criam funções e gatilhos PostgreSQL reais armazenados no esquema do projeto - não relacionados a list_functions / deploy_function (Edge Functions WASM, um tempo de execução separado).

Modo HTTP para clientes que se conectam por URL#

stdio é o transporte padrão. O modo http (HTTP streamable, protocolos MCP 2025-11-25 e 2026-07-28):

  • escuta em 127.0.0.1 por padrão (--host para alterá-lo);
  • requer um token (--auth-token ou token de portador) — sem ele, o servidor se recusa a iniciar;
  • valida o cabeçalho Origin e responde 403 a uma origem não autorizada (proteção anti-CSRF);
  • uma instância de servidor por sessão, com vencimento e limite configurável;
  • compara tokens em tempo constante e limita o tamanho do corpo da solicitação.

Para ir mais longe#