Provedor OAuth Plug-and-Play para Servidores FastMCP Pessoais em Todas as Plataformas Claude

O Que Isso Resolve

Um desenvolvedor construiu um servidor de memória pessoal usando mem0 ao qual o Claude pode ler e escrever, criando um cofre de conhecimento pessoal. Embora fazer funcionar no Claude Code tenha sido direto, fazê-lo funcionar nas plataformas web, móvel e Desktop do Claude.ai apresentou desafios de autenticação.

O problema central: os conectores personalizados do Claude.ai exigem conformidade total com OAuth 2.1. O FastMCP fornece um provedor de teste em memória (inadequado para produção) ou um proxy que requer configuração de provedores de identidade externos como Google, GitHub ou Auth0. Para um servidor destinado apenas ao uso pessoal, configurar o Auth0 era uma sobrecarga indesejável.

A Solução

O desenvolvedor criou um provedor de autenticação de arquivo único escrito em Python que gerencia todo o fluxo OAuth sem serviços externos. Principais recursos incluem:

• Registro Dinâmico de Cliente (DCR)
• PKCE (Proof Key for Code Exchange)
• Persistência de token
• Implementação completa do OAuth 2.1

O provedor restringe URIs de redirecionamento apenas para claude.ai e localhost, impedindo acesso não autorizado mesmo que o registro de cliente permaneça aberto (um requisito do Claude.ai que levou tempo para entender).

Detalhes de Implementação e Armadilhas

O desenvolvedor encontrou vários problemas não documentados durante a implementação:

• BaseHTTPMiddleware do FastAPI quebra silenciosamente respostas de streaming, exigindo soluções alternativas
• Conflitos de nomenclatura de ferramentas: Se as ferramentas tiverem nomes genéricos (como "add_memory" ou "search"), o Claude usará suas próprias funções de memória integradas em vez de chamar as ferramentas do seu servidor. A solução é prefixar os nomes das ferramentas distintamente
• Conexões de banco de dados serverless: Neon Postgres (e provavelmente outros bancos de dados serverless) descarta conexões ociosas. Criar uma única conexão na inicialização faz com que as ferramentas falhem aleatoriamente após alguns minutos
• Configuração DCR: O Registro Dinâmico de Cliente está desabilitado por padrão no FastMCP. Sem habilitá-lo, o endpoint /register retorna 404, e o Claude.ai falha silenciosamente em conectar sem mensagens de erro

Disponibilidade

A solução está disponível no GitHub em github.com/crumrine/fastmcp-personal-auth como um único arquivo Python sob licença MIT. Isso fornece uma alternativa prática para desenvolvedores que desejam que seus servidores pessoais FastMCP funcionem em todas as plataformas Claude sem a complexidade de provedores de identidade externos.