Pular para o conteúdo
🤖 MCP

MCP — IA fala com seu SuperDB.

Servidor MCP oficial. Claude, Cursor, Codex e Continue interagem direto com sua instância.

O servidor MCP liga o Claude Desktop, o Cursor ou o Codex ao banco do seu projeto. Eles passam a consultar o schema, rodar migrations, revisar as políticas de RLS e criar buckets — sem você sair do editor.

Conectar sem instalar nada (recomendado)

Desde agosto de 2026 existe um servidor MCP remoto. É a forma mais simples de conectar, e não usa este pacote:

https://mcp.superdb.com.br/mcp

Cole essa URL como conector no seu cliente MCP, faça login e escolha quais projetos aquele agente pode alcançar. Não há chave para copiar nem para guardar: a credencial nasce no consentimento e vive entre o cliente e o SuperDB.

  • Sem Node na sua máquina e sem pacote para atualizar.
  • Funciona no Claude web e no celular — um servidor local não alcança esses dois por construção.
  • Uma conexão, N projetos. Marcou três, alcança três; adicionar um quarto depois não exige reconectar.
  • Revogar corta na hora, em Conta → Aplicativos conectados.

Detalhes e passo a passo: superdb.com.br/mcp.

💡

Quando usar o pacote local (o resto desta página)? Quando não houver navegador para completar o login — automação, CI, um script que roda sozinho. Aí a autenticação por management key é o caminho, e continua suportada.

O que você precisa

Duas coisas, as duas no painel em app.superdb.com.br:

  1. O ID do projeto — está na URL quando você abre o projeto.
  2. Uma management key — em Configurações › Chaves de gerenciamento. Ela aparece uma única vez; copie na hora.
⚠️

Use a management key, não a service role. A service role e a anon key não funcionam nestas rotas — e a service role é poderosa demais para ficar num arquivo de configuração do editor. A management key vale só para um projeto, é auditada por chave no servidor e você revoga quando quiser.

Configuração por IDE

Claude Desktop

Arquivo: ~/Library/Application Support/Claude/claude_desktop_config.json no macOS, %APPDATA%\Claude\claude_desktop_config.json no Windows. Reinicie o app depois de salvar.

claude_desktop_config.json
{
  "mcpServers": {
    "superdb": {
      "command": "npx",
      "args": ["-y", "@superdb/mcp"],
      "env": {
        "SUPERDB_PROJECT_ID": "seu-uuid-de-projeto",
        "SUPERDB_MGMT_KEY": "sdb_pmk_..."
      }
    }
  }
}

Cursor

Arquivo: .cursor/mcp.json na raiz do projeto, com o mesmo bloco mcpServers acima.

Codex (OpenAI)

Mesma estrutura. As variáveis também podem ser exportadas no terminal antes de abrir.

Ferramentas disponíveis

  • superdb_run_sql — roda SQL no schema do projeto. Aceita SELECT e DDL (CREATE TABLE, ALTER, CREATE POLICY): é o mesmo executor das migrations.
  • superdb_list_tables — lista as tabelas, separando as suas das auth_* que o SuperDB mantém.
  • superdb_describe_table — colunas de uma tabela: tipo, se aceita nulo, valor padrão e chave primária.
  • superdb_list_policies — políticas de RLS. Sem argumento, mostra as do projeto inteiro — serve para achar tabela desprotegida.
  • superdb_list_buckets — buckets de Storage.
  • superdb_create_bucket — cria bucket. Privado por padrão.

Variáveis de ambiente

  • SUPERDB_PROJECT_ID — obrigatória. UUID do projeto.
  • SUPERDB_MGMT_KEY — obrigatória. A chave sdb_pmk_….
  • SUPERDB_URL — opcional (default https://auth.superdb.com.br).

Exemplos de prompt

  • "Quais tabelas minhas ainda não têm política de RLS?"
  • "Cria uma tabela de agendamentos com FK para pacientes, e a policy que isola por clínica."
  • "Descreve a tabela de pacientes e me diz quais colunas guardam dado pessoal."
  • "Roda essa migration e confirma que a coluna entrou."

Limites

  • SELECT sem LIMIT recebe LIMIT 1000 automaticamente.
  • Cada query tem timeout de 30 segundos.
  • As chamadas são rate-limited e auditadas por chave, no servidor.
  • O executor recusa schemas de sistema (information_schema, pg_catalog, storage, auth_global). Se você escrever a query à mão, use pg_tables e pg_policies sem qualificar o schema.
Essa página ajudou?