No ar · sem instalar nada

Seu banco de dados dentro do Claude

Conecte o SuperDB ao Claude, ao Cursor ou a qualquer cliente MCP. O agente enxerga o seu schema, roda SQL, cria tabelas e buckets — no seu projeto, com a sua permissão, e sem você colar chave nenhuma em lugar nenhum.

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

Criar projeto grátis Ver a documentação

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

Os quatro primeiros nós testamos de ponta a ponta. Os tracejados atendem à mesma especificação — HTTPS público, Streamable HTTP e OAuth 2.1 — e devem conectar da mesma forma, 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á está valendo na sua próxima pergunta.

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.

Adicione como conector

No Claude, vá em Configurações → Conectores → Adicionar, dê o nome SuperDB e cole a URL.

No Cursor e no Claude Code, é a mesma URL no arquivo de configuração de MCP.

Entre e escolha os projetos

Você faz login no SuperDB e marca quais projetos aquele agente pode alcançar. 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.

Preciso guardar os retornos dos pacientes. Cria a tabela e deixa cada clínica vendo só os retornos dela.

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 · …

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)

Quantos retornos estão marcados para esta semana?

superdb_run_sql({ sql: "SELECT count(*) FROM retornos WHERE data BETWEEN …" }) → 47

São 47 retornos entre segunda e domingo.

O que o agente ganha

Nove ferramentas. Nada de "acesso ao banco" genérico — cada uma faz uma coisa nomeada, e é isso que aparece no seu registro de auditoria.

superdb_list_tables

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

superdb_describe_table

Colunas, tipos, chaves e índices de uma tabela — para o agente reaproveitar o que já existe em vez de duplicar.

superdb_run_sql

Executa SQL no seu projeto: consultar, criar, alterar. É 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.

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.
✓ Um projeto novo não entra sozinho Criou o sexto projeto? Ele fica de fora até você adicioná-lo em Conta → Aplicativos conectados — sem reconectar nada.
✓ 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.

Funciona no ChatGPT?

Deve funcionar: o ChatGPT aceita conector MCP remoto que seja HTTPS público, fale Streamable HTTP ou SSE e autentique por OAuth — e o nosso atende os três, com registro dinâmico de cliente e PKCE. É a mesma URL, colada em Configurações → Conectores.

Dito isso: ainda não testamos lá, e preferimos escrever isso a deixar você descobrir sozinho. Se tentar e não funcionar, escreva para contato@superdb.com.br — o retorno de quem testou primeiro 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 — navegador, aplicativo de computador e 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.

Por isso a tela de autorização diz, com todas as letras, que inclui escrita e comandos que apagam. Se você quer só leitura, autorize um projeto de teste — ou use uma management key com um role restrito.

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