Liquidium MCP 서버

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

특징

• 프로젝트 목록 : 조직에서 사용 가능한 모든 PostHog 프로젝트를 확인하세요.
• 주석 만들기 : 선택적 타임스탬프를 사용하여 PostHog 프로젝트에 주석을 추가합니다.
• 통찰력 목록 및 검색 : PostHog 프로젝트에서 통찰력을 보고 검색합니다.
• 통찰력 세부 정보 가져오기 : 특정 통찰력에 대한 자세한 정보를 봅니다.

설정

옵션 1: 대장간(추천)

Liquidium MCP를 사용하는 가장 쉬운 방법은 Smithery를 이용하는 것입니다.

1. Smithery에서 Liquidium MCP를 방문하세요
2. "Claude에 추가"를 클릭하세요
3. 메시지가 표시되면 PostHog API 키를 입력하세요.
4. Claude에서 Liquidium 도구를 사용해 보세요!

옵션 2: 로컬 설치

1. 필수 조건
   • Python 3.10 이상
   • pip 또는 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/python", # Get this by running: which python "args": [ "-m", "posthog_mcp", "--directory", "/path/to/your/posthog-mcp" # Full path to this project ] } } }
     문제가 발생한 경우 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의 기여 가이드라인을 따릅니다.