1

[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:

  1. Faz o registro dinâmico do cliente (DCR, RFC 7591), em que ele mesmo escolhe o próprio nome.
  2. Manda o usuário para a tela de consentimento, com PKCE.
  3. 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

  1. 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.
  2. 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.
  3. 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.exemplo não passa).
  4. 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.
  5. 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 state fica 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

Carregando publicação patrocinada...