Reddit Ads MCP 커넥터

Reddit Ads API v3용 자연어 MCP
API 기본 주소: https://ads-api.reddit.com/api/v3

간단한 영어로 질문하세요 — 엔드포인트 경로나 광고 계정 ID를 외울 필요가 없습니다(계정이 하나만 구성된 경우).

할 수 있는 작업

Related MCP server: Google Ads API v20 MCP Server

사전 요구 사항

1. reddit.com/prefs/apps에서 Reddit 앱 생성 — 유형은 웹 앱 또는 스크립트

2. 클라이언트 ID(앱 이름 아래)와 클라이언트 시크릿을 기록

3. adsread 범위의 리프레시 토큰(1회성 OAuth — 아래 참조)

설정 (로컬)

cd reddit-mcp-connector
python -m venv .venv
# Windows:
.venv\Scripts\activate
pip install -r requirements.txt
copy .env.example .env

.env를 작성하세요:

REDDIT_CLIENT_ID=your_client_id
REDDIT_CLIENT_SECRET=your_secret
REDDIT_REFRESH_TOKEN=your_refresh_token
REDDIT_USER_AGENT=web:reddit-mcp-connector:v1.0.0 (by /u/YOUR_USERNAME)
REDDIT_AD_ACCOUNT_ID=t2_xxxxx   # optional but recommended

서버를 시작하세요:

python reddit_mcp_server.py --http

http://127.0.0.1:8002/mcp에서 수신 대기합니다.

리프레시 토큰 받기 (1회)

1. 인증 URL 생성 (자리 표시자 교체):

https://www.reddit.com/api/v1/authorize?client_id=YOUR_CLIENT_ID&response_type=code&state=anything&redirect_uri=http://localhost:8080&duration=permanent&scope=adsread

2. 브라우저에서 열고 액세스를 승인한 후 리디렉션 URL에서 code를 복사하세요.

3. 코드를 교환하세요:

curl -X POST https://www.reddit.com/api/v1/access_token ^
  -u "CLIENT_ID:CLIENT_SECRET" ^
  -d "grant_type=authorization_code&code=CODE&redirect_uri=http://localhost:8080"

4. JSON 응답의 refresh_token을 .env에 REDDIT_REFRESH_TOKEN으로 저장하세요.

Reddit 앱 설정의 리디렉션 URI가 정확히 일치해야 합니다 (예: http://localhost:8080).

Cursor (로컬)

"reddit": {
  "url": "http://127.0.0.1:8002/mcp"
}

1. 서버를 계속 실행하세요: python reddit_mcp_server.py --http

2. Cursor 설정 → MCP → 새로고침

3. reddit이 list_campaigns, get_performance_report 등의 도구와 함께 초록색으로 표시되어야 합니다

그런 다음 "내 캠페인 목록" 또는 "지난 7일간 지출 및 노출수"라고 질문하세요.

Google Cloud Run

동일한 HTTP MCP 엔드포인트를 Cloud Run에서 호스팅하세요.

배포

.\deploy-cloudrun.ps1 -ProjectId "YOUR_GCP_PROJECT_ID"

자격 증명은 Secret Manager에 JSON(reddit-mcp-credentials)으로 저장됩니다. 스크립트는 누락된 값을 묻거나 .env에서 읽습니다.

Cursor (Cloud Run)

"reddit": {
  "url": "https://YOUR-CLOUD-RUN-URL/mcp"
}

Claude 사용자 지정 커넥터

MCP_PUBLIC_URL이 설정되면(배포 스크립트가 자동으로 수행) Claude.ai OAuth + DCR이 활성화됩니다.

1. .\deploy-cloudrun.ps1 -ProjectId "..."로 배포하세요

2. 설정 → 커넥터 → 사용자 지정 커넥터 추가

3. URL: https://YOUR-SERVICE.run.app/mcp (/mcp 포함 필수)

4. OAuth 클라이언트 ID는 비워 두세요 (DCR 활성화됨)

예시 프롬프트

• "내 Reddit 광고 계정 목록"

• "내 광고 계정의 캠페인 표시"

• "지난 7일간 지출 및 노출수"

• "이번 달 일별 성과 추세"

• "캠페인별 성과 분석"

• "전환 픽셀 목록"

도구

보안 참고 사항

Cloud Run 배포는 --allow-unauthenticated를 사용하므로 MCP URL에 접근할 수 있습니다. Claude OAuth는 등록된 클라이언트로 도구 액세스를 제한합니다. 자격 증명과 URL을 민감한 정보로 취급하세요.