Pular para o conteúdo

Seu banco de dados dentro do Claude, do ChatGPT, do Cursor e do Codex

Conecte o SuperDB ao Claude, ao ChatGPT, ao Cursor ou a qualquer cliente MCP. O agente enxerga o seu schema, roda SQL e cria tabelas e buckets no seu projeto, só com a sua permissão. Não há nada para instalar nem chave para colar.

https://mcp.superdb.com.br/mcp
Adicionar ao Claude Conectar no ChatGPT

Ainda sem conta? Crie um projeto grátis antes. O login é pedido na hora de autorizar.

Claude (web) Claude Desktop Claude no celular Claude Code ChatGPT Codex Cursor outros clientes MCP

No Claude, testamos de ponta a ponta no navegador, no aplicativo, no celular e no Claude Code. No Claude, no ChatGPT e no Codex, testamos também a conexão pelo login do navegador. Os tracejados seguem a mesma especificação (HTTPS público, Streamable HTTP e OAuth 2.1) e devem conectar do mesmo jeito, mas ainda não passaram pelo nosso teste.

Três passos, uma vez só

O servidor é remoto. Não há pacote para instalar, versão para atualizar nem Node para manter na sua máquina. A correção que sai hoje já vale na sua próxima pergunta.

1

Copie a URL de conexão

É a mesma para todo mundo: https://mcp.superdb.com.br/mcp

Não há chave para gerar agora. A autorização acontece no passo 3, com você logado.

2

Adicione como conector

Claude: o botão Adicionar ao Claude abre a janela de conector com o nome SuperDB e a URL já preenchidos. Você só confirma. À mão, é em Configurações → Conectores → Adicionar.

ChatGPT (planos pagos, na web): ligue o Modo desenvolvedor em Configurações → Segurança e login. Depois, no + em chatgpt.com/plugins, cole a URL e escolha OAuth.

Codex: um bloco no ~/.codex/config.toml e o comando codex mcp login superdb (passo a passo). Cursor e Claude Code: a mesma URL no arquivo de configuração de MCP.

3

Entre e escolha os projetos

Você faz login no SuperDB e marca quais projetos aquele agente pode alcançar: um por um, ou todos, inclusive os que você criar depois. Nenhum vem marcado por padrão. Escolher é um ato, não um descuido.

Como fica na prática

Você descreve o que quer. O agente faz no banco e mostra o que fez.

EU
Preciso guardar os retornos dos pacientes. Cria a tabela e deixa cada clínica vendo só os retornos dela.
AI
Vou olhar o que já existe antes de criar, para reaproveitar as chaves.
superdb_list_tables() → pacientes, profissionais, atendimentos, clinicas
superdb_describe_table({ table: "pacientes" }) → id uuid PK · clinica_id uuid FK → clinicas · nome text · …
AI
Criei retornos com FK para pacientes e clinicas, e liguei RLS filtrando por clinica_id.
superdb_run_sql({ sql: "CREATE TABLE retornos (…); ALTER TABLE retornos ENABLE ROW LEVEL SECURITY; CREATE POLICY …" }) → ok · 1 tabela, 2 chaves estrangeiras, 1 policy
superdb_list_policies({ table: "retornos" }) → retornos_por_clinica (SELECT, INSERT, UPDATE, DELETE)
EU
Quantos retornos estão marcados para esta semana?
AI
superdb_query_sql({ sql: "SELECT count(*) FROM retornos WHERE data BETWEEN …" }) → 47
São 47 retornos entre segunda e domingo.

O que o agente ganha

Nada de "acesso ao banco" genérico. Cada ferramenta faz uma coisa nomeada, e é isso que aparece no seu registro de auditoria. Ler e alterar são ferramentas separadas: a de leitura roda direto, e a que altera o banco pede a sua confirmação antes.

superdb_list_tables

Lista as tabelas do projeto. É por onde o agente começa antes de sugerir qualquer coisa.

superdb_describe_table

Colunas, tipos, valor padrão e chave primária de uma tabela. Assim o agente reaproveita o que já existe em vez de duplicar.

superdb_query_sql

Consulta com SQL sem mudar nada: a transação roda em modo somente leitura, e o próprio Postgres recusa qualquer escrita.

superdb_run_sql

Executa SQL que altera o projeto: criar tabela, ligar RLS, inserir, apagar. É a ferramenta que faz o trabalho pesado.

superdb_list_policies

Mostra as policies de RLS em vigor. Serve para conferir quem enxerga o quê, inclusive depois de o agente mexer.

superdb_list_buckets

Lista os buckets de arquivos do projeto, com visibilidade e limites.

superdb_create_bucket

Cria um bucket novo, público ou privado, sem sair da conversa.

superdb_list_tenants

Para quem vende o mesmo app para vários clientes: lista os tenants do seu Group.

superdb_group_status

Situação do Group: quantos tenants, quantos inclusos no plano, o que excede.

superdb_publish_template

Publica a versão do template do Group: é o passo de deploy de quem provisiona tenants por API.

fiscal_listar_notas

Para quem usa o SuperDB Fiscal (planos Pro e Escala): lista as notas fiscais (NFS-e) do projeto, da mais nova para a mais antiga, com situação, número e o motivo da recusa quando houve.

fiscal_consultar_nota

Uma nota pelo id: situação, número, chave de acesso, ambiente e, se o Sistema Nacional NFS-e recusou, o código e a dica do que mudar.

fiscal_previa_nfse

Confere o pedido de uma nota antes de emitir, sem valor fiscal, sem gravar e sem gastar a cota do mês.

fiscal_prontidao

O que falta para um emitente emitir: certificado, serviço padrão, município e o estado do pedido de produção.

fiscal_emitir_nfse

Pede a emissão de uma NFS-e, de forma idempotente pela ref. Em homologação o agente testa à vontade; em produção a nota tem valor fiscal e só sai depois de você confirmar.

fiscal_cancelar_nfse

Cancela uma nota já emitida. É um ato fiscal que não se desfaz, e o agente confirma com você antes.

Dar acesso a um agente não é dar a chave do banco

Um MCP que pede a senha do seu Postgres transfere para o agente tudo o que você pode fazer, em todos os projetos, para sempre. Aqui a autorização é explícita, por projeto, e some no instante em que você revoga.

  • ✓ Você escolhe os projetos Na tela de autorização, nenhum vem pré-marcado. Marcou três, o agente alcança três.
  • ✓ Você vê para onde o acesso vai A tela de autorização mostra o endereço que vai receber o acesso, ao lado do nome do aplicativo. Se não for o Claude, o ChatGPT, o Cursor ou um aplicativo no seu computador, ela avisa: só autorize se foi você que iniciou a conexão.
  • ✓ Projeto novo entra só se você quiser Criou o sexto projeto? Ele fica de fora até você adicioná-lo em Conta → Aplicativos conectados, sem reconectar nada. Ou ligue Todos os projetos, inclusive os novos, e ele entra sozinho.
  • ✓ Saiu do projeto, o agente sai junto A conexão só alcança projeto em que você ainda é dono ou admin. Removido ou rebaixado, o acesso do agente cai na chamada seguinte.
  • ✓ Revogar corta na hora A conexão inteira, ou só um projeto dela. A próxima chamada do agente já falha.
  • ✓ Nenhuma chave passa por você A credencial nasce no consentimento e vive entre o cliente e o SuperDB. Não há o que colar, guardar ou vazar sem querer num print.
projeto autorizado 200 ok
projeto NÃO autorizado 403 forbidden
projeto de outra conta 403 forbidden
conexão revogada 401 unauthorized
sem credencial 401 unauthorized

Comportamento medido em produção, não prometido em documento.

Perguntas que todo mundo faz

Preciso gerar uma API key?
Não. Você adiciona a URL do conector, faz login no SuperDB e marca os projetos. A credencial é criada nesse momento e nunca é mostrada a você: não há o que guardar.

Se preferir uma chave (automação sem navegador, CI, script), dá: crie uma management key no painel e mande no header Authorization: Bearer. Os dois modos existem e funcionam.
Tenho vários projetos. Preciso conectar várias vezes?
Não. Uma conexão alcança quantos projetos você marcar. Quando a conexão tem mais de um, o agente ganha uma ferramenta para listar os seus projetos e precisa dizer em qual quer operar. Se não disser, a chamada é recusada com a lista de opções.

Deixar o agente "escolher o primeiro" nunca daria erro: só escreveria na base errada.

Quer que os projetos novos entrem sozinhos? Marque todos os projetos, inclusive os novos na hora de autorizar, ou ligue depois em Conta → Aplicativos conectados.
Funciona no ChatGPT?
Sim. Conectamos o ChatGPT ao SuperDB pelo login do navegador em setembro de 2026. Hoje o caminho é o Modo desenvolvedor (Configurações → Segurança e login), disponível nos planos pagos, na web. Depois, no + em chatgpt.com/plugins, cole a mesma URL e escolha OAuth.

Se alguma coisa não funcionar do seu lado, escreva para contato@superdb.com.br. O retorno de quem usa vale mais do que qualquer suposição nossa.
Funciona no Claude do celular?
Sim. O servidor é remoto, então funciona em qualquer lugar onde o Claude rode: no navegador, no aplicativo de computador e no celular. Um MCP local, que roda como processo na sua máquina, não consegue atender esses dois últimos por construção.
Como atualizo o MCP?
Você não atualiza. Não há pacote instalado na sua máquina: o servidor é nosso, e a correção que sai hoje vale na sua próxima pergunta. Isso também significa que não existem duas pessoas rodando versões diferentes e recebendo respostas diferentes.
O agente pode apagar meus dados?
Pode, nos projetos que você autorizou. superdb_run_sql executa DDL, e é isso que permite criar tabela e ligar RLS numa conversa: o mesmo poder de quem abre o editor de SQL do painel. Para só ler, o agente usa superdb_query_sql, que roda numa transação somente leitura. Essa não apaga nada, nem se pedirem.

Por isso a tela de autorização diz, com todas as letras, que inclui escrita e comandos que apagam. E no Claude a ferramenta que altera o banco é marcada como destrutiva: ele pede a sua confirmação a cada uso. Se você quer só testar, autorize um projeto de teste.
Quanto custa?
Nada além do plano do seu projeto. O MCP não tem cobrança separada, não consome créditos e está disponível inclusive no plano grátis.
Dá para usar no meu próprio agente?
Sim. É MCP sobre HTTP (StreamableHTTP), com descoberta em /.well-known/oauth-protected-resource. Qualquer cliente compatível com a especificação conecta apontando para a mesma URL.
E se eu já uso o pacote @superdb/mcp?
Continua funcionando. O pacote no npm roda localmente e é útil para automação sem navegador. Mas para uso do dia a dia, a conexão remota é melhor em tudo que importa: não exige Node, funciona no celular e não fica para trás numa versão antiga.

Conecte em dois minutos

Crie um projeto grátis, cole a URL no seu cliente MCP e peça a primeira tabela.

Criar projeto grátis Documentação técnica