Drop-in OAuth-Anbieter für persönliche FastMCP-Server auf allen Claude-Plattformen

Was das löst

Ein Entwickler hat einen persönlichen Speicherserver mit mem0 erstellt, auf den Claude lesen und schreiben kann, wodurch ein persönliches Wissensarchiv entsteht. Während die Einrichtung auf Claude Code unkompliziert war, stellte die Funktionsfähigkeit über Claude.ai Web, Mobile und Desktop Plattformen Authentifizierungsherausforderungen dar.

Das Kernproblem: Claude.ai benutzerdefinierte Konnektoren erfordern volle OAuth 2.1-Konformität. FastMCP bietet entweder einen In-Memory-Testprovider (ungeeignet für die Produktion) oder einen Proxy, der die Einrichtung externer Identitätsanbieter wie Google, GitHub oder Auth0 erfordert. Für einen Server, der nur für den persönlichen Gebrauch gedacht ist, war die Einrichtung von Auth0 ein unerwünschter Aufwand.

Die Lösung

Der Entwickler hat einen Authentifizierungsanbieter in einer einzigen Python-Datei erstellt, der den gesamten OAuth-Fluss ohne externe Dienste abwickelt. Wichtige Funktionen umfassen:

• Dynamische Client-Registrierung (DCR)
• PKCE (Proof Key for Code Exchange)
• Token-Persistenz
• Vollständige OAuth 2.1-Implementierung

Der Anbieter beschränkt Weiterleitungs-URIs ausschließlich auf claude.ai und localhost, um unbefugten Zugriff zu verhindern, auch wenn die Client-Registrierung offen bleibt (eine Claude.ai-Anforderung, deren Verständnis Zeit in Anspruch nahm).

Implementierungsdetails und Fallstricke

Der Entwickler stieß während der Implementierung auf mehrere undokumentierte Probleme:

• FastAPI's BaseHTTPMiddleware unterbricht Streaming-Antworten stillschweigend, was Workarounds erfordert
• Tool-Namenskonflikte: Wenn Tools generisch benannt sind (wie "add_memory" oder "search"), verwendet Claude seine eigenen integrierten Speicherfunktionen anstatt Ihre Server-Tools aufzurufen. Die Lösung besteht darin, Tool-Namen eindeutig zu präfixieren
• Serverlose Datenbankverbindungen: Neon Postgres (und wahrscheinlich andere serverlose Datenbanken) trennen inaktive Verbindungen. Eine einzelne Verbindung beim Start zu erstellen, führt dazu, dass Tools nach einigen Minuten zufällig ausfallen
• DCR-Konfiguration: Dynamische Client-Registrierung ist in FastMCP standardmäßig deaktiviert. Ohne deren Aktivierung gibt der /register-Endpunkt 404 zurück, und Claude.ai scheitert stillschweigend bei der Verbindung ohne Fehlermeldungen

Verfügbarkeit

Die Lösung ist auf GitHub unter github.com/crumrine/fastmcp-personal-auth als einzelne Python-Datei unter MIT-Lizenz verfügbar. Dies bietet eine praktische Alternative für Entwickler, die möchten, dass ihre persönlichen FastMCP-Server auf allen Claude-Plattformen funktionieren, ohne die Komplexität externer Identitätsanbieter.