AdMob MCP-Server

Ein lokaler Model Context Protocol-Server, der Claude mit der Google AdMob API verbindet und Ihnen eine Konversationsschnittstelle zu Ihren Werbeeinnahmendaten bietet.

Zwei Möglichkeiten, diesen Server zu verwenden:

• Lokales stdio (Claude Code auf einem Rechner): Führen Sie ./setup.sh aus und wählen Sie L.

• Vercel + Claude.ai Connector (geräteübergreifend): Klicken Sie auf den Button oben und folgen Sie dann docs/VERCEL.md. Oder führen Sie ./setup.sh aus und wählen Sie V.

Voraussetzungen

• Node.js 18+

• Ein Google Cloud-Projekt mit aktivierter AdMob API

• OAuth 2.0-Client-Anmeldedaten — Typ Desktop-App für den lokalen Modus, Typ Webanwendung für den Vercel-Modus (siehe docs/VERCEL.md für die Vercel-spezifische Einrichtung).

Related MCP server: Google Ads MCP Server

Einrichtung

1. Google OAuth-Anmeldedaten abrufen

1. Gehen Sie zur Google API Console

2. Erstellen Sie ein Projekt oder wählen Sie eines aus

3. Aktivieren Sie die AdMob API in der API-Bibliothek

4. Gehen Sie zu Anmeldedaten > Anmeldedaten erstellen > OAuth-Client-ID

5. Wählen Sie Desktop-App, geben Sie ihr einen Namen und klicken Sie auf Erstellen

6. Klicken Sie auf JSON herunterladen, um die Client-Secret-Datei herunterzuladen

7. Kopieren Sie die heruntergeladene Datei in den Ordner secrets/ in diesem Projekt

2. Installieren und konfigurieren

cd admob-mcp
./setup.sh

Das Setup-Skript führt folgende Schritte aus:

• Findet und benennt die Google OAuth-JSON-Datei in secrets/client_secret.json um

• Installiert Abhängigkeiten und führt den Build aus

• Öffnet einen Browser für die Google OAuth-Autorisierung (Token wird unter secrets/token.json gespeichert)

• Registriert den MCP-Server bei Claude Code

Um die Autorisierung mit aktualisierten Scopes erneut durchzuführen (z. B. nach dem Hinzufügen eines weiteren Google MCP):

./setup.sh --reauth

Hinweis: Wenn der OAuth-Zustimmungsbildschirm Ihres Google Cloud-Projekts nicht veröffentlicht wurde (d. h. er befindet sich noch im Status "Testen"), erhalten Sie einen Autorisierungsfehler. Um dies zu beheben, veröffentlichen Sie entweder die App oder fügen Sie Ihr Google-Konto unter OAuth-Zustimmungsbildschirm > Zielgruppe in der Google Cloud Console als Testbenutzer hinzu.

Manuelle Konfiguration

Wenn Sie setup.sh nicht verwenden möchten, fügen Sie dies Ihrer Claude Code MCP-Konfiguration hinzu:

{
  "mcpServers": {
    "admob": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/admob-mcp/dist/src/index.js"],
      "env": {
        "ADMOB_CREDENTIALS_PATH": "/absolute/path/to/admob-mcp/secrets/client_secret.json"
      }
    }
  }
}

Connector-Einrichtung (Vercel)

Verwenden Sie dies, wenn die AdMob-Tools in Claude.ai auf jedem Gerät verfügbar sein sollen, nicht nur in Claude Code auf Ihrem Laptop.

1. Forken Sie das Repo.

2. Klicken Sie oben auf Deploy with Vercel.

3. Stellen Sie Upstash Redis im Vercel Storage-Tab bereit — es injiziert automatisch die KV_*-Umgebungsvariablen, die unser Code verwendet. (Vercel hat das eigenständige "Vercel KV" eingestellt; Upstash ist dasselbe Backend.)

4. Erstellen Sie einen Google Cloud OAuth-Client (Webanwendung). Autorisierte Redirect-URI = https://<your-deploy>.vercel.app/api/oauth/callback.

5. Setzen Sie die Umgebungsvariablen in Vercel: GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, OAUTH_REDIRECT_URI, CONNECTOR_TOKEN (generieren mit openssl rand -hex 32). Achten Sie auf Leerzeichen.

6. Besuchen Sie https://<your-deploy>.vercel.app/api/setup, fügen Sie das CONNECTOR_TOKEN ein, klicken Sie auf Autorisieren und schließen Sie die Google-Anmeldung ab. Dies autorisiert den Server, in Ihrem Namen AdMob-Daten zu lesen.

7. In Claude.ai → Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen: Fügen Sie https://<your-deploy>.vercel.app/api/mcp als URL ein, lassen Sie OAuth Client ID und Secret leer, klicken Sie auf Hinzufügen und dann auf Verbinden. Ein Browser-Tab öffnet sich unter /oauth/authorize — fügen Sie dort einmalig dasselbe CONNECTOR_TOKEN ein. Claude.ai erledigt den Rest.

Zwei OAuth-Flows werden durch dasselbe CONNECTOR_TOKEN geschützt: Google ↔ Server (Schritt 6) und Claude.ai ↔ Server (Schritt 7). Vollständige Anleitung inklusive Fehlerbehebung: docs/VERCEL.md.

Verwendung

Fragen Sie Claude einfach in natürlicher Sprache nach Ihren AdMob-Daten. Bei der ersten Verwendung ruft Claude automatisch list_accounts auf, um Ihre AdMob-Konten zu finden, und fragt Sie, mit welchem Sie arbeiten möchten. Danach verwendet es die entsprechenden Tools, um Ihre Fragen zu beantworten.

Tools

Kern-API-Tools

Reporting-Tools

Tools zur Umsatzoptimierung

Projektstruktur

• src/index.ts — stdio-Einstiegspunkt (Claude Code).

• src/tools.ts — alle 36 Tool-Definitionen; registerTools(server, getClient).

• src/auth.ts — Google OAuth-Helfer (getAuthenticatedClient, authorizeViaLocalServer).

• src/token-store.ts — TokenStore-Schnittstelle + FileTokenStore (lokal) + KvTokenStore (Vercel KV).

• src/oauth-store.ts — KV-basierter Speicher für den Connector-OAuth-Flow (Auth-Codes + Access-Tokens).

• src/http-auth.ts — Timing-sichere Bearer-Prüfung für HTTP-Endpunkte (Synchronisation gegen CONNECTOR_TOKEN, asynchron gegen KV-ausgegebene Access-Tokens).

• src/admob-client.ts, src/helpers.ts — REST-Client und Dienstprogramme zur Berichtsformatierung.

• api/mcp.ts — Vercel-Funktion: HTTP-MCP-Endpunkt (Streamable HTTP, Bearer-geschützt, sendet WWW-Authenticate bei 401).

• api/setup.ts — Vercel-Funktion: Formular, das den Google ↔ Server OAuth-Flow initiiert.

• api/oauth/callback.ts — Vercel-Funktion: Googles Redirect-URI; speichert Tokens in KV.

• api/oauth/authorize.ts, api/oauth/token.ts, api/oauth/register.ts — Vercel-Funktionen, die den Claude.ai ↔ Server OAuth 2.1-Flow mit PKCE und dynamischer Client-Registrierung implementieren.

• api/well-known/oauth-authorization-server.ts, api/well-known/oauth-protected-resource.ts — RFC 8414 / RFC 9728 Metadaten, damit Claude.ai die OAuth-Endpunkte entdecken kann.

• setup.sh — Interaktives Setup-Skript ([L]okal / [V]ercel / [B]eides).

• docs/VERCEL.md — Deployment-Anleitung für Forker.

• AGENTS.md — Kanonische Projektnotizen (CLAUDE.md ist ein Symlink darauf).

Entwicklung

npm run build     # Compile TypeScript
npm run start     # Run the server directly (stdio)