Blog

PostHog MCP 서버 시작하는 방법

Ashley Goolam

Ashley Goolam

30 June 2025

PostHog MCP 서버 시작하는 방법

AI로 데이터 게임을 한 단계 업그레이드할 준비가 되셨나요? PostHog MCP 서버는 Cline이나 Cursor와 같은 도구에서 자연어를 사용하여 주석을 생성하거나 사용자 트렌드를 쿼리하는 등 PostHog 분석을 관리할 수 있게 해줍니다. 저는 몇 분 만에 설치를 완료했고, 정말 판도를 바꾸는 도구였습니다! 이 튜토리얼에서는 VS Code의 Cline과 Cursor에 PostHog MCP 서버를 설치하고, 강력한 기능을 살펴보고, PostHog가 오픈소스 분석에서 Google Analytics를 능가하는 이유를 알아보겠습니다. PostHog MCP 서버의 마법에 빠져봅시다!

💡
아름다운 API 문서를 생성하는 훌륭한 API 테스트 도구를 원하시나요?

최대 생산성으로 개발 팀이 함께 작업할 수 있는 통합된 올인원 플랫폼을 원하시나요?

Apidog는 귀하의 모든 요구 사항을 충족하며, 훨씬 저렴한 가격으로 Postman을 대체합니다!
button

PostHog MCP 서버란 무엇인가요?

PostHog MCP 서버는 AI 어시스턴트(Cline 또는 Cursor와 같은)를 자연어 명령을 통해 PostHog의 분석 플랫폼에 연결하는 오픈소스 모델 컨텍스트 프로토콜(MCP) 서버입니다. PostHog의 UI를 건드리지 않고도 주석 생성, 프로젝트 관리, 인사이트 쿼리, 기능 플래그 토글과 같은 작업을 가능하게 합니다. 주요 기능은 다음과 같습니다:

34개 이상의 GitHub 스타가 커뮤니티의 사랑을 보여주듯이, 분석 자동화를 위한 '필수' 도구입니다. 사용해 볼 준비가 되셨나요? 시작해봅시다.

공식 웹사이트

PostHog MCP 서버를 왜 사용해야 할까요?

PostHog MCP 서버는 AI 기반 자동화로 분석 워크플로우를 간소화합니다. 다음은 이 서버가 훌륭한 이유입니다:

Google Analytics와 비교할 때, PostHog는 오픈소스 투명성, 자체 호스팅 유연성, 그리고 올인원 제품군(분석, 세션 재생, 기능 플래그)으로 빛을 발합니다. Google Analytics는 종종 타사 통합을 요구하며 PostHog의 개인 정보 보호 중점을 결여하고 있어, PostHog MCP 서버는 현대 팀을 위한 개발자 친화적인 대안이 됩니다.

저는 몇 초 만에 제품 출시를 주석 처리하는 데 사용했습니다. 대시보드를 클릭하는 것보다 훨씬 빨랐죠!

PostHog MCP 서버 설치 및 사용 방법: 단계별 가이드

VS Code의 Cline과 Cursor에 PostHog MCP 서버를 설치하고 예시와 함께 테스트해 봅시다. Python, PostHog API 키, 그리고 IDE가 필요합니다. 분석 전문가가 아니어도 괜찮습니다. 따라오세요!

1. 전제 조건

2. PostHog MCP 리포지토리 복제

터미널을 열고 리포지토리를 복제합니다:

git clone https://github.com/PostHog/mcp.git
cd mcp

약 5MB의 프로젝트를 가져옵니다. Wi-Fi에서 몇 초 걸렸습니다.

3. VS Code에서 Cline을 사용하여 PostHog MCP 서버 설치

uv venv
source .venv/bin/activate  # macOS/Linux
.venv\Scripts\activate  # Windows
uv pip install .

echo "PERSONAL_API_KEY=your-personal-api-key" > .env

your-personal-api-key를 PostHog API 키(해당 공식 웹사이트에서 얻을 수 있음)로 대체하세요.

cline 설치
Install the PostHog MCP Server using uv and configure it with my API key.

Cline은 uv run posthog_mcp를 실행하고 ~/.aws/amazonq/mcp.json을 업데이트합니다:

{
  "mcpServers": {
    "posthog": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp", "run", "posthog_mcp"],
      "env": {
        "PERSONAL_API_KEY": "your-personal-api-key"
      }
    }
  }
}

/path/to/mcp를 리포지토리 경로(예: /home/user/mcp)로 대체하세요.

MCP 서버는 Cline의 MCP 마켓플레이스에서도 찾을 수 있습니다. 그곳으로 이동하여 "PostHog"를 검색한 다음 설치를 클릭하세요.

posthog mcp 서버 설치

Cline이 자동으로 설치를 수행합니다.

mcp 서버 아이콘

4. Cursor로 PostHog MCP 서버 설치

cursor mcp 서버
{
  "mcpServers": {
    "posthog": {
      "command": "/path/to/uv",
      "args": ["--directory", "/path/to/mcp", "run", "posthog_mcp"],
      "env": {
        "PERSONAL_API_KEY": "your-personal-api-key"
      }
    }
  }
}

which uv (macOS/Linux) 또는 where uv (Windows)로 uv 경로를 찾습니다.

5. PostHog MCP 서버 기능 테스트

Create a PostHog annotation in project 53497 for March 20th, 2025, with the description 'Launched new user onboarding flow' using the PostHog MCP Server.

서버는 PostHog API를 호출하여 주석을 추가합니다. app.posthog.com에서 확인하세요.

Show the trend of user sign-ups in project 98765 over the last 30 days using 
the PostHog MCP Server.

서버는 구조화된 데이터(예: 가입 트렌드가 포함된 JSON)를 가져옵니다. 예시 출력:

{
  "insight": "user_signups",
  "project_id": 98765,
  "data": [
    {"date": "2025-06-01", "count": 120},
    {"date": "2025-06-02", "count": 135}
  ]
}

이것을 실행했더니 약 5초 만에 깔끔한 데이터를 얻었습니다. 정말 멋집니다!

6. 컨테이너화된 설정 (선택 사항)

도커

Docker 설정의 경우:

docker run -i --rm -e PERSONAL_API_KEY=your-personal-api-key ghcr.io/metorial/mcp-container--posthog--posthog-mcp--posthog-mcp posthog-mcp

Cline/Cursor의 mcp.json에 추가합니다:

{
  "mcpServers": {
    "posthog": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/metorial/mcp-container--posthog--posthog-mcp--posthog-mcp", "posthog-mcp"],
      "env": {
        "PERSONAL_API_KEY": "your-personal-api-key"
      }
    }
  }
}

위와 같이 재시작하고 확인합니다. Docker의 정리(--rm) 기능 덕분에 디스크 공간을 절약했습니다.

7. 일반적인 문제 해결

PostHog가 Google Analytics를 능가하는 이유

PostHog의 PostHog MCP 서버는 자체 플랫폼과 통합되어 Google Analytics를 다음 측면에서 능가합니다:

저는 사이드 프로젝트를 PostHog로 전환했고, 개인 정보 보호와 기능 플래그 제어가 마음에 들었습니다. Google Analytics의 불필요한 기능이 없어서 좋았죠!

PostHog MCP 서버 사용자 지정 및 확장

설정을 한 단계 업그레이드하세요:

Generate a Python snippet to toggle feature flag 'new-ui' in project 12345
using the PostHog MCP Server.

PostHog MCP 서버가 개발자에게 필수인 이유

PostHog MCP 서버는 분석 자동화를 데이터 전문가와 대화하는 것처럼 느끼게 합니다. 자연어 인터페이스와 PostHog의 오픈소스 강점은 개인 정보 보호에 민감한 팀에게 Google Analytics보다 우수합니다. 설정은 까다로울 수 있지만(API 키 문제!), PostHog 문서와 커뮤니티는 큰 도움이 됩니다.

PostHog MCP 서버를 사용할 준비가 되셨나요? Cline 또는 Cursor를 실행하고, 인사이트를 쿼리하며, 분석 성공 사례를 공유해 주세요. 여러분의 설정이 빛을 발하는 것을 기대합니다!

💡
아름다운 API 문서를 생성하는 훌륭한 API 테스트 도구를 원하시나요?

최대 생산성으로 개발 팀이 함께 작업할 수 있는 통합된 올인원 플랫폼을 원하시나요?

Apidog는 귀하의 모든 요구 사항을 충족하며, 훨씬 저렴한 가격으로 Postman을 대체합니다!
button

Apidog에서 API 설계-첫 번째 연습

API를 더 쉽게 구축하고 사용하는 방법을 발견하세요

무료 회원가입다운로드
PostHog MCP 서버 시작하는 방법