[Pitch] Meu servidor MCP deixou um agente criar tabela no projeto errado: o que mudei no OAuth
Eu mantenho o SuperDB, um backend brasileiro (Postgres por projeto, login, arquivos). Ele tem um servidor MCP remoto, para assistentes como Claude, ChatGPT, Cursor e Lovable mexerem no banco. Num teste com o Lovable, o agente criou uma tabela com RLS correta, só que no projeto errado: um projeto real, e não o de teste. Nenhum dado se perdeu (a tabela estava vazia), mas o caso ensinou bastante sobre como montar o consentimento de um servidor MCP. Divido aqui o que aprendi, porque vale para qualquer servidor MCP com OAuth.
Como funciona o fluxo
O cliente MCP descobre o servidor de autorização pelo /.well-known/oauth-protected-resource (RFC 9728). Depois:
- Faz o registro dinâmico do cliente (DCR, RFC 7591), em que ele mesmo escolhe o próprio nome.
- Manda o usuário para a tela de consentimento, com PKCE.
- Troca o código por um token.
No nosso caso, o token aponta para um CONJUNTO de projetos escolhidos na tela, e não para a conta inteira.
O que deu errado
A tela de consentimento era uma página só: quem pede, as permissões e uma lista de projetos com caixas de marcar. Dentro de uma janela pequena de popup, ela virava uma rolagem longa. A pessoa marcou um projeto vizinho na lista, rolou até o botão e autorizou. O agente fez exatamente o que tinha permissão para fazer. O defeito era do consentimento, não do agente.
O que mudamos
- Etapas, e o botão só na conferência. Agora são quatro: quem pede e para onde vai o acesso; o que o agente poderá fazer; a escolha dos projetos; e uma conferência com o nome de cada projeto escolhido em letra grande. O botão Autorizar só existe na última. Não dá para autorizar sem ter visto, por extenso, o que vai ser liberado.
- Nada vem marcado. "Selecionar todos" é um clique a mais, e "todos, inclusive os que eu criar depois" é uma chave separada, porque são consentimentos diferentes.
- O nome do cliente não é confiável. No DCR, qualquer um registra um cliente chamado "Claude". Por isso a tela mostra em destaque o HOST do
redirect_uri, que é para onde o código vai de fato, e marca como "não verificado" o que não está numa lista curta de destinos conhecidos (comparação exata do host:claude.ai.coletor.exemplonão passa). - Autorizar de novo o mesmo cliente substitui o token anterior. Sem isso, reconectar três vezes deixa três tokens vivos, e revogar um não corta os outros.
- Tudo auditado. Cada autorização grava cliente, destino e projetos. Foi o registro de auditoria que mostrou o projeto errado em segundos.
Duas surpresas do lado do cliente
- O Lovable só aceita a volta do OAuth na janela que ele mesmo abriu: o
statefica preso àquela sessão. Concluir o mesmo endereço em outra aba dá "Session expired". - Revogação passa despercebida: depois que revogamos o token no servidor, o Lovable continuou mostrando o conector como "Connected" e falhava com "não autorizado". Foi preciso remover o conector e adicionar de novo.
Lição para quem faz servidor MCP
A tela de consentimento é a única barreira entre um agente que roda SQL e o banco errado. Trate ela como trata um "apagar conta":
- uma etapa de conferência;
- o destino real do acesso visível;
- nada pré-marcado;
- auditoria de cada concessão.
O passo a passo de Lovable com o SuperDB, se servir para alguém: https://superdb.com.br/docs/guias/lovable?utm_source=tabnews&utm_campaign=organico-out26