Reddit Ads MCP コネクタ

平易な言葉で使える Reddit Ads API v3 用 MCP
API ベース: https://ads-api.reddit.com/api/v3

シンプルな英語で質問できます — エンドポイントのパスや広告アカウント ID を覚える必要はありません（アカウントが1つ設定されている場合）。

できること

Related MCP server: Google Ads API v20 MCP Server

前提条件

1. reddit.com/prefs/apps で Reddit アプリを作成 — タイプは web app または script

2. client ID（アプリ名の下）と client secret を控える

3. adsread スコープの refresh token を取得（一度だけの 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. 認可 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 の Settings → MCP → 更新

3. reddit が緑色で表示され、list_campaigns、get_performance_report などのツールが表示されるはずです…

その後、「List my campaigns」や「Spend and impressions last 7 days」と質問します。

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. Settings → Connectors → Add custom connector

3. URL: https://YOUR-SERVICE.run.app/mcp（/mcp を含める必要があります）

4. OAuth Client ID は空のままにする（DCR 有効）

プロンプト例

• 「List my Reddit ad accounts」

• 「Show campaigns for my ad account」

• 「Spend and impressions last 7 days」

• 「Daily performance trend this month」

• 「Break down performance by campaign」

• 「List conversion pixels」

ツール

セキュリティに関する注意

Cloud Run のデプロイでは --allow-unauthenticated を使用するため、MCP URL に到達可能です。Claude OAuth はツールへのアクセスを登録済みクライアントに制限します。認証情報と URL は機密情報として扱ってください。