AdOps MCP

KI-gestütztes plattformübergreifendes Ad-Management für das Model Context Protocol

License: MIT TypeScript MCP

Verwalten Sie Google Ads- und Meta Ads-Kampagnen, analysieren Sie die plattformübergreifende Performance, optimieren Sie Budgets und erkennen Sie Anomalien – alles über KI-Assistenten wie Claude, Cursor und VS Code.

Funktionen

Einheitliche Kampagnenverwaltung für Google Ads und Meta Ads
14 MCP-Tools, die den gesamten Werbe-Lebenszyklus abdecken
4 MCP-Ressourcen für schnellen Dashboard-Zugriff
Plattformübergreifendes Performance-Reporting mit normalisierten Metriken
KI-gestützte Budgetoptimierung mit umsetzbaren Empfehlungen
Statistische Anomalieerkennung (CPC-Spitzen, CTR-Einbrüche, Ausgabensprünge)
A/B-Testanalyse mit Konfidenzbewertung
Branchen-Benchmark-Vergleich (9 Branchen)
Prognose für Ausgaben und Conversions (7/14/30 Tage)
Referenz für plattformspezifische Creative-Spezifikationen
42 automatisierte Tests (Unit + E2E-Benutzer-Workflows), TypeScript Strict Mode, Zod-Validierung

Schnellstart

Installation über npm

npm i adops-mcp-server

Zum MCP-Client hinzufügen

{
  "mcpServers": {
    "adops": {
      "command": "node",
      "args": ["path/to/node_modules/adops-mcp-server/dist/index.js"]
    }
  }
}

Aus Quellcode bauen

git clone https://github.com/enzoemir1/adops-mcp.git
cd adops-mcp
npm ci && npm run build

Tools

Tool	Beschreibung
`platform_connect`	Registrierung einer Google Ads- oder Meta Ads-Kontoverbindung
`campaign_list`	Auflisten und Filtern von Kampagnen über alle verbundenen Plattformen
`campaign_create`	Erstellen einer neuen Kampagne mit einheitlichen Parametern
`campaign_update`	Aktualisieren von Kampagneneinstellungen (Budget, Status, Gebote, Zeitplan)
`campaign_pause_resume`	Stapelweises Pausieren oder Fortsetzen von bis zu 50 Kampagnen gleichzeitig
`ads_report`	Erstellen eines einheitlichen plattformübergreifenden Performance-Berichts
`budget_analyze`	Analysieren der Budgetverteilung mit Optimierungsempfehlungen
`budget_reallocate`	Übertragen von Budgets zwischen Kampagnen über Plattformen hinweg
`audience_insights`	Abrufen von demografischen, geografischen und gerätebezogenen Aufschlüsselungen
`creative_specs`	Abrufen plattformspezifischer Anforderungen für Bild, Video und Text
`anomaly_detect`	Erkennen von Performance-Anomalien mit konfigurierbarer Empfindlichkeit
`ab_test_analyze`	Vergleich zweier Kampagnen mit statistischem Signifikanztest
`competitor_benchmark`	Vergleich Ihrer Metriken mit Branchendurchschnitten
`forecast_spend`	Prognose von Ausgaben, Conversions und ROAS für den nächsten Zeitraum

Ressourcen

Ressource	Beschreibung
`ads://overview`	Zusammenfassung des plattformübergreifenden Dashboards
`ads://campaigns`	Alle aktiven Kampagnen mit Schlüsselmetriken
`ads://budget`	Budgetverteilung über Plattformen hinweg
`ads://alerts`	Aktuelle Performance-Anomalien und Warnungen

Konfiguration

Alle Integrationen sind optional. Der Server funktioniert ohne API-Schlüssel unter Verwendung des lokalen Speichers für Kampagnenverwaltung und Analysen.

Variable	Plattform	Erforderlich	Beschreibung
`GOOGLE_ADS_DEVELOPER_TOKEN`	Google	Für Live-Sync	API-Entwickler-Token
`GOOGLE_ADS_CLIENT_ID`	Google	Für Live-Sync	OAuth2-Client-ID
`GOOGLE_ADS_CLIENT_SECRET`	Google	Für Live-Sync	OAuth2-Client-Secret
`GOOGLE_ADS_REFRESH_TOKEN`	Google	Für Live-Sync	OAuth2-Refresh-Token
`GOOGLE_ADS_CUSTOMER_ID`	Google	Für Live-Sync	Werbekonto-ID (10 Ziffern)
`META_APP_ID`	Meta	Für Live-Sync	Facebook-App-ID
`META_APP_SECRET`	Meta	Für Live-Sync	Facebook-App-Secret
`META_ACCESS_TOKEN`	Meta	Für Live-Sync	Systembenutzer-Zugriffstoken
`META_AD_ACCOUNT_ID`	Meta	Für Live-Sync	Werbekonto-ID (act_XXX)

Siehe .env.example für eine vollständige Vorlage.

Einheitliche Metriken

AdOps normalisiert Metriken über Plattformen hinweg in ein einheitliches Schema:

Metrik	Formel	Beschreibung
CTR	Klicks / Impressionen x 100	Klickrate (%)
CPC	Ausgaben / Klicks	Kosten pro Klick
CPM	Ausgaben / Impressionen x 1000	Kosten pro 1000 Impressionen
ROAS	Umsatz / Ausgaben	Return on Ad Spend
CPA	Ausgaben / Conversions	Kosten pro Akquisition
Conversion Rate	Conversions / Klicks x 100	Conversion-Rate (%)

Zuordnung der Plattformfelder:

AdOps-Feld	Google Ads	Meta Ads
`spend`	`cost_micros / 1.000.000`	`amount_spent`
`impressions`	`impressions`	`impressions`
`clicks`	`clicks`	`clicks`
`conversions`	`conversions`	`actions[type=purchase]`
Kampagne > Anzeigengruppe	Ad Group	Ad Set

Preise

Stufe	Preis	Funktionen
Free	$0	1 Plattform, schreibgeschützte Berichte, Creative-Spezifikationen, 50 Aufrufe/Tag
Pro	$29/Monat	2 Plattformen, volles CRUD, Anomalieerkennung, Budgetoptimierung
Agency	$59/Monat	Unbegrenzt, Prognosen, Benchmarking, bevorzugter Support

Verfügbar auf MCPize.

Entwicklung

npm run dev        # Hot reload development
npm run build      # Production build
npm test           # Run 42 tests (unit + E2E)
npm run inspect    # Open MCP Inspector

Tests

42 Tests in 5 Test-Suiten:

Speicher: Verbindungs-CRUD, Kampagnensuche, Metriken-Aggregation, Batch-Einfügungen
Analytik: Metriken-Berechnungen, Performance-Berichte, Prognosen, Benchmarks
Optimierer: Budgetanalyse, Umverteilung, Skalierungs-/Pausierungsempfehlungen
Anomalie: CPC-Spitzenerkennung, Conversion-Einbrüche, Empfindlichkeitsstufen, Schweregrad-Sortierung
E2E-Workflow: 14 echte Benutzerszenarien — Plattformen verbinden, Kampagnen erstellen, Berichte generieren, Budgets optimieren, A/B-Tests durchführen, Anomalien erkennen, Ausgaben prognostizieren, Branchen-Benchmarking

npm test

Lizenz

MIT-Lizenz. Siehe LICENSE für Details.

Erstellt von Automatia BCN.

adops-mcp