MCP (Claude)

Über MCP-Server kann Claude (Claude Code / Desktop) direkt auf unsere Datenquellen zugreifen. Das ist das Werkzeug für Ad-hoc-Analysen, Audits und Kreuz-Auswertungen („Ads-Kosten × echte Buchungen") — Fragen stellen statt Dashboards klicken.

Die drei Server

Server	Zugriff auf	Schreibzugriff?
google-ads-mcp	Google-Ads-Konten via GAQL	Nein — rein lesend
analytics-mcp	GA4-Properties (Reports, Funnel, Realtime)	Nein
kickmobimed-mcp	Praxissystem (Termine, Kontakte, wochenweise)	Nein

Weil alles read-only ist, kann eine MCP-Analyse nie versehentlich etwas am Konto ändern. Änderungen laufen über Web-UI oder Editor.

google-ads-mcp

• Tools: customers_list_accessible_customers, search_search (GAQL-Abfragen), metadata_get_resource_metadata (verfügbare Felder je Resource nachschlagen)
• Setup: läuft via pipx aus dem offiziellen Repo github.com/googleads/google-ads-mcp; registriert im User-Scope (~/.claude.json); Arbeitsordner mit Credentials: /Users/niels/Development/google-ads-mcp/
• Wichtige Umgebungswerte: GOOGLE_ADS_LOGIN_CUSTOMER_ID=6641786149 (MCC als Login-Konto), Abfragen für Spanholtz mit customer_id=5062677310
• Auth: ADC (Application Default Credentials) — der Server ignoriert Service-Account-Keys. Einrichten (interaktiv, mit dem Google-Konto, das MCC-Zugriff hat):

gcloud auth application-default login \
  --client-id-file=/Users/niels/Development/google-ads-mcp/credentials2.json \
  --scopes=https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/analytics.readonly

(Der analytics.readonly-Scope in derselben Anmeldung versorgt auch den analytics-mcp.)

Fertige Abfragen: GAQL-Rezepte. Vorbereitete Sammlung außerdem in /Users/niels/Development/google-ads-mcp/queries-kickmobimed.md.

analytics-mcp

• Tools: get_account_summaries, get_property_details, run_report, run_realtime_report, run_funnel_report, run_conversions_report, list_google_ads_links, get_custom_dimensions_and_metrics, list_property_annotations
• Nutzt dieselbe ADC-Datei wie google-ads-mcp — deshalb müssen die Scopes gemeinsam angemeldet werden (siehe oben).
• Anwendungsbeispiele: GA4-Reports

kickmobimed-mcp

• Tools: 9 get_*_weekly-Auswertungen (Termine/Kontakte je Kalenderwoche, gruppiert nach Standort, Arzt, Leistung, Kampagne, …)
• Liefert ISO-Kalenderwochen; viele Tools haben den Parameter type = booked | scheduled — Unterschied unbedingt verstehen
• Details und Interpretation: kickmobimed-MCP

Troubleshooting

Symptom	Ursache	Fix
ACCESS_TOKEN_SCOPE_INSUFFICIENT (analytics-mcp)	ADC ohne analytics.readonly-Scope angemeldet	ADC-Login mit allen drei Scopes wiederholen (Befehl oben), Session neu starten
NOT_ADS_USER	ADC mit falschem Google-Konto (z. B. Gmail statt Agentur-Konto)	ADC-Login mit dem richtigen Konto wiederholen (~/.config/gcloud/application_default_credentials.json wird ersetzt)
User doesn't have permission to access customer … login-customer-id	Konto hängt nicht unterm MCC bzw. falsches Login-Konto gesetzt	Konto im MCC verknüpfen oder GOOGLE_ADS_LOGIN_CUSTOMER_ID prüfen
Neues MCP-Tool „nicht gefunden"	MCP-Änderungen wirken erst nach Neustart	Claude-Code-Session neu starten
Kosten wirken 1-millionenfach zu hoch	Micros	÷ 1.000.000
change_event liefert alte Änderung nicht	API-Limit 30 Tage	Änderungshistorie in der Web-UI

Wofür MCP das beste Werkzeug ist

• Der Monats-Audit — Playbook mit fertigen Abfragen
• Kreuz-Analysen: „Welche Kampagne liefert echte Buchungen pro Euro?" (Ads-Kosten × Conversion-Mix × Praxissystem-booked)
• Anomalie-Diagnose: „Warum sind die Buchungen in KW X eingebrochen?" — Claude kann alle drei Quellen in einer Session befragen und den Entscheidungsbaum durchgehen