개인 FastMCP 서버를 위한 모든 Claude 플랫폼용 Drop-in OAuth 제공자

이것이 해결하는 문제

한 개발자가 mem0를 사용하여 Claude가 읽고 쓸 수 있는 개인 메모리 서버를 구축하여 개인 지식 저장소를 만들었습니다. Claude Code에서 작동하게 하는 것은 간단했지만, Claude.ai 웹, 모바일, 데스크톱 플랫폼 전반에서 기능하게 만드는 것은 인증 문제를 제기했습니다.

핵심 문제: Claude.ai 사용자 지정 커넥터는 완전한 OAuth 2.1 준수를 요구합니다. FastMCP는 메모리 내 테스트 제공자(프로덕션에는 부적합) 또는 Google, GitHub, Auth0 같은 외부 신원 제공자 설정이 필요한 프록시를 제공합니다. 개인 사용만을 위한 서버의 경우, Auth0 설정은 바람직하지 않은 오버헤드였습니다.

해결책

개발자는 외부 서비스 없이 전체 OAuth 흐름을 처리하는 Python으로 작성된 단일 파일 인증 제공자를 만들었습니다. 주요 기능은 다음과 같습니다:

• 동적 클라이언트 등록(DCR)
• PKCE(Proof Key for Code Exchange)
• 토큰 지속성
• 완전한 OAuth 2.1 구현

이 제공자는 리디렉션 URI를 claude.ai와 localhost로만 제한하여, 클라이언트 등록이 열려 있어도(이해하는 데 시간이 걸린 Claude.ai 요구사항) 무단 접근을 방지합니다.

구현 세부사항과 주의사항

개발자는 구현 중에 여러 문서화되지 않은 문제를 발견했습니다:

• FastAPI의 BaseHTTPMiddleware는 스트리밍 응답을 자동으로 중단시켜 해결 방법이 필요합니다
• 도구 이름 충돌: 도구를 일반적으로 이름 짓는 경우(예: "add_memory" 또는 "search"), Claude는 서버 도구를 호출하는 대신 자체 내장 메모리 기능을 사용합니다. 해결책은 도구 이름에 구별되는 접두사를 붙이는 것입니다
• 서버리스 데이터베이스 연결: Neon Postgres(및 아마도 다른 서버리스 데이터베이스)는 유휴 연결을 끊습니다. 시작 시 단일 연결을 생성하면 몇 분 후에 도구가 무작위로 실패합니다
• DCR 구성: 동적 클라이언트 등록은 FastMCP에서 기본적으로 비활성화되어 있습니다. 이를 활성화하지 않으면 /register 엔드포인트가 404를 반환하고, Claude.ai는 오류 메시지 없이 조용히 연결에 실패합니다

가용성

이 해결책은 GitHub의 github.com/crumrine/fastmcp-personal-auth에서 단일 Python 파일로 MIT 라이선스 하에 이용할 수 있습니다. 이는 외부 신원 제공자의 복잡성 없이 개인 FastMCP 서버가 모든 Claude 플랫폼에서 작동하기를 원하는 개발자들에게 실용적인 대안을 제공합니다.