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
mcpem 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.
Fonte: https://app.jesseapp.com.br