MCP — IA fala com seu SuperDB.

Instalação

# Global (recomendado)
npm install -g @superdb/mcp

# Ou via npx (sem instalar)
npx @superdb/mcp

Configuração por IDE

Claude Desktop

Arquivo: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "superdb": {
      "command": "npx",
      "args": ["-y", "@superdb/mcp"],
      "env": {
        "SUPERDB_PM_URL": "https://pm.superdb.com.br",
        "SUPERDB_AUTH_URL": "https://auth.superdb.com.br",
        "SUPERDB_SERVICE_KEY": "seu-service-role-jwt",
        "SUPERDB_PROJECT": "meu-projeto"
      }
    }
  }
}

Cursor

Arquivo: .cursor/mcp.json na raiz do workspace. Mesma estrutura do Claude Desktop.

Codex (OpenAI)

Na configuração do Codex, mesma estrutura. Variáveis de ambiente podem ser exportadas no terminal antes.

Continue (VS Code)

Arquivo: ~/.continue/config.json (sintaxe ligeiramente diferente — array de servers):

{
  "mcpServers": [
    {
      "name": "superdb",
      "command": "npx",
      "args": ["-y", "@superdb/mcp"],
      "env": { "SUPERDB_SERVICE_KEY": "..." }
    }
  ]
}

Ferramentas disponíveis (10)

• superdb_create_project — Cria projeto (schema + Organization)
• superdb_list_projects — Lista projetos
• superdb_run_sql — SELECT no banco (apenas leitura)
• superdb_list_tables — Descobre schema do projeto
• superdb_create_user — Cria usuário via service-role
• superdb_signup_user — Signup anônimo (fluxo normal)
• superdb_setup_auth — Configura providers OAuth
• superdb_query_audit — Consulta log de auditoria
• superdb_export_data — Export LGPD de um usuário
• superdb_create_org — Cria organização

Variáveis de ambiente

• SUPERDB_SERVICE_KEY — obrigatório. Service-role JWT
• SUPERDB_PM_URL — URL do Project Manager (default: http://localhost:4002)
• SUPERDB_AUTH_URL — URL do Auth (default: http://localhost:9999)
• SUPERDB_PROJECT — slug padrão (opcional)

Exemplos de prompt

Coisas que você pode pedir pra IA fazer (com MCP configurado):

• "Liste todas as tabelas do meu projeto loja-ja"
• "Crie um usuário de teste com email teste@exemplo.com.br e CPF aleatório válido"
• "Mostre o log de auditoria dos últimos 10 eventos do projeto"
• "Faça export LGPD do usuário com id abc-123"
• "Cria uma organização chamada Acme Corp"