Reddit Ads MCP Connector

MCP in einfacher Sprache für Reddit Ads API v3
API-Basis: https://ads-api.reddit.com/api/v3

Frag in einfachem Englisch — du musst keine Endpunkt-Pfade oder Werbekonto-IDs auswendig lernen (wenn ein Konto konfiguriert ist).

Was es kann

Related MCP server: Google Ads API v20 MCP Server

Voraussetzungen

1. Eine Reddit-App unter reddit.com/prefs/apps — Typ Web-App oder Skript

2. Notiere Client-ID (unter dem App-Namen) und Client-Secret

3. Ein Refresh-Token mit adsread-Bereich (einmaliges OAuth — siehe unten)

Einrichtung (lokal)

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

.env ausfüllen:

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

Server starten:

python reddit_mcp_server.py --http

Lauscht auf http://127.0.0.1:8002/mcp.

Refresh-Token abrufen (einmalig)

1. Autorisierungs-URL erstellen (Platzhalter ersetzen):

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. In einem Browser öffnen, Zugriff genehmigen, den code aus der Redirect-URL kopieren.

3. Code eintauschen:

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. refresh_token aus der JSON-Antwort in .env als REDDIT_REFRESH_TOKEN speichern.

Deine Redirect-URI in den Reddit-App-Einstellungen muss exakt übereinstimmen (z. B. http://localhost:8080).

Cursor (lokal)

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

1. Server laufen lassen: python reddit_mcp_server.py --http

2. Cursor Einstellungen → MCP → aktualisieren

3. reddit sollte grün angezeigt werden mit Tools wie list_campaigns, get_performance_report, …

Dann frag: „Liste meine Kampagnen" oder „Ausgaben und Impressionen der letzten 7 Tage".

Google Cloud Run

Hoste denselben HTTP-MCP-Endpunkt auf Cloud Run.

Bereitstellen

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

Anmeldedaten werden in Secret Manager als JSON gespeichert (reddit-mcp-credentials). Das Skript fragt nach fehlenden Werten oder liest aus .env.

Cursor (Cloud Run)

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

Claude Custom Connector

Wenn MCP_PUBLIC_URL gesetzt ist (das Bereitstellungsskript macht das automatisch), sind Claude.ai OAuth + DCR aktiviert.

1. Bereitstellen mit .\deploy-cloudrun.ps1 -ProjectId "..."

2. Einstellungen → Connectors → Custom Connector hinzufügen

3. URL: https://YOUR-SERVICE.run.app/mcp (muss /mcp enthalten)

4. OAuth-Client-ID leer lassen (DCR aktiviert)

Beispiel-Abfragen

• „Liste meine Reddit-Werbekonten auf"

• „Zeige Kampagnen für mein Werbekonto"

• „Ausgaben und Impressionen der letzten 7 Tage"

• „Täglicher Leistungstrend in diesem Monat"

• „Leistung nach Kampagne aufschlüsseln"

• „Conversion-Pixel auflisten"

Tools

Sicherheitshinweis

Die Cloud-Run-Bereitstellung verwendet --allow-unauthenticated, damit die MCP-URL erreichbar ist. Claude OAuth beschränkt den Tool-Zugriff auf registrierte Clients. Behandle Anmeldedaten und URLs als vertraulich.