PostHog MCP 서버 📊

PostHog와 상호 작용하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. Claude Desktop을 통해 직접 주석을 생성하고 프로젝트를 관리하세요!

특징 🚀

• 프로젝트 목록 : 조직에서 사용 가능한 모든 PostHog 프로젝트를 확인하세요.
• 주석 만들기 : PostHog 프로젝트에 선택적 타임스탬프와 함께 주석을 추가합니다. [이 목록은 훨씬 더 길어질 수 있습니다. 기본적으로 API가 가지고 있는 모든 것...]

설정 🛠️

1. 필수 조건
   • Python 3.10 이상
   • uv 패키지 관리자
   • 프로젝트 설정 에서 얻은 annotation:write 및 project:read 범위가 있는 PostHog API 키
2. 설치지엑스피1
3. 구성
   • 프로젝트 루트에 .env 파일을 만듭니다.
     PERSONAL_API_KEY=phx_your_posthog_api_key_here
4. 클로드 데스크탑 설정
   • Claude Desktop 설치
   • Claude Desktop 설정을 열고 "구성 편집"을 클릭하세요. 또는 다음 위치에서 파일을 열 수 있습니다.
     • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
     • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • claude_desktop_config.json 에 다음을 추가하세요(시스템에 맞게 경로를 조정하세요):
     { "mcpServers": { "posthog": { "command": "/path/to/uv", # Get this by running: which uv "args": [ "--directory", "/path/to/your/posthog-mcp", # Full path to this project "run", "posthog_mcp" ] } } }
     문제가 발생한 경우 Claude Desktop을 MCP 클라이언트로 설정하는 방법에 대한 최신 문서를 확인하세요.

사용법 💡

설치가 완료되면 Claude Desktop에 망치 🔨 아이콘이 표시됩니다. 다음 명령을 사용할 수 있습니다.

프로젝트 목록

클로드에게 물어보세요:

통찰력 얻기 및 검색

클로드에게 물어보세요:

"내 PostHog 인사이트 나열" 또는 "내 PostHog에서 수익 인사이트 검색"

온라인에서 문서 검색

다음과 같이 질문할 수 있습니다.

• "Posthog에서 NextJS로 역방향 프록시를 어떻게 할 수 있나요?"

주석 만들기

프로젝트 목록에서 얻은 프로젝트 ID를 사용하여 Claude에게 다음과 같이 질문하세요.

또는 특정 날짜로:

문제 해결 🔍

• 망치 아이콘이 나타나지 않으면 Claude Desktop을 다시 시작하세요.
• ~/Library/Logs/Claude/mcp*.log (macOS) 또는 %APPDATA%\Claude\logs (Windows)에서 로그를 확인하세요.
• PostHog API 키에 올바른 권한이 있는지 확인하세요.
• claude_desktop_config.json 의 모든 경로가 절대 경로인지 확인하세요.

기여하기 🤝

자유롭게 이슈와 PR을 남겨주세요! 저희는 PostHog의 기여 가이드라인을 따릅니다.