1

Pitch: Como construí um servidor MCP para um app de finanças pessoais (FastAPI + SDK oficial + OAuth 2.1)

Sou o Nicolas, estudante de Economia e fundador do Jesse, um app brasileiro de finanças pessoais. Nas últimas semanas coloquei no ar um servidor MCP para que a pessoa converse com os próprios dados financeiros dentro da IA que ela já usa, como o Claude.

Divido aqui as lições que valeram para mim.

Por que MCP

A pessoa já tem uma IA favorita. Em vez de construir mais um chat dentro do app, o Jesse entrega os dados e a IA dela faz a conversa. Ela fica com a ferramenta que já conhece, agora com os números de verdade dela.

Stack

  • O backend FastAPI que eu já tinha
  • SDK oficial mcp em Python, montado dentro do mesmo app
  • Transporte streamable HTTP
  • Servidor sem estado, porque a hospedagem pode rodar mais de uma instância

Autenticação: não reinvente

O SDK oficial já monta todo o OAuth 2.1 (autorização, token, registro e revogação). Eu só implementei a parte que consulta o banco. Para dado financeiro, usar o que é padrão e auditado vale mais do que qualquer solução criativa.

Permissão checada em cada chamada

O acesso não fica congelado no momento do login: cada ferramenta confere na hora o que aquela conta pode fazer. Se algo muda na conta da pessoa, a IA já enxerga a mudança na próxima pergunta, sem precisar reconectar.

O bug que só o teste de ponta a ponta pegou

Por um detalhe na forma como eu anunciava as permissões, o cliente pedia menos acesso do que deveria, e nenhum usuário conseguia ler dado nenhum. Os testes unitários passavam todos. Só a conexão real com um cliente mostrou o problema.

Lição: em MCP com autenticação, teste com um cliente de verdade antes de publicar.

Escrita com cuidado, porque é dinheiro

  • As ferramentas de leitura são marcadas como somente leitura
  • A conexão pode criar e alterar registros, mas nunca apagar
  • A IA é instruída a mostrar o que vai gravar e esperar a confirmação da pessoa

A descrição da ferramenta é a interface

A IA escolhe a ferramenta pela descrição. Gastei mais tempo reescrevendo descrições do que escrevendo código. Uma ferramenta de "por onde começar", que a IA chama primeiro, ajudou muito.

Publicação

Publiquei no MCP Registry oficial, de onde vários diretórios copiam.


Se alguém aqui estiver construindo MCP com autenticação, bora trocar ideia. Críticas são bem-vindas.

Carregando publicação patrocinada...
1