Für Entwickler · Claude & Cursor unterstützt

MCP-Integrationsleitfaden

Mit dem Model Context Protocol können Claude, Cursor oder Ihr eigener KI-Agent Ihre DEXUN AdWhiz-Daten abfragen: verbundene Werbekonten auf allen drei Plattformen, KI-Empfehlungen und letzte Aktivitäten. Nur Lesezugriff.

Was ist MCP?

MCP (Model Context Protocol) ist der offene Standard, den Anthropic 2024 eingeführt hat und der festlegt, wie KI-Anwendungen sicher auf externe Daten und Tools zugreifen. Stellen Sie es sich als „USB-C für KI“ vor – eine einheitliche Schnittstelle, über die jeder MCP-Client (Claude Desktop, Cursor, Ihr eigener Agent) jeden MCP-Server (DEXUN AdWhiz, Notion, GitHub usw.) aufrufen kann.

Der DEXUN AdWhiz-MCP-Server stellt 5 Tools mit reinem Lesezugriff bereit: Ihre verbundenen Werbekonten, die offenen Empfehlungen der KI, Ihre Einsparungsübersicht, die letzten Kontoaktivitäten und Ihr API-Kontingent. Er kann in Ihren Werbekonten nichts ändern, pausieren oder erstellen. Jeder Aufruf wird mit Ihrem API-Schlüssel authentifiziert und unterliegt denselben tarifabhängigen Rate-Limits wie unsere REST API.

Schnellstart

Drei Schritte. Rund fünf Minuten, bis Sie Ihren KI-Assistenten nach Ihren Werbekonten fragen können.

1

Claude Desktop konfigurieren

Bearbeiten Sie claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\) und fügen Sie hinzu:

# Claude Desktop config: ~/.../claude_desktop_config.json
{
  "mcpServers": {
    "dexun-adwhiz": {
      "command": "npx",
      "args": ["-y", "@dexun/adwhiz-mcp@latest"],
      "env": {
        "ADWHIZ_API_KEY": "dxk_live_..."
      }
    }
  }
}
2

Cursor konfigurieren

Über die projektbezogene .cursor/mcp.json oder die globale Konfiguration:

# Cursor: ~/.cursor/mcp.json (or Project → Settings → MCP)
{
  "mcpServers": {
    "dexun-adwhiz": {
      "command": "npx",
      "args": ["-y", "@dexun/adwhiz-mcp@latest"],
      "env": { "ADWHIZ_API_KEY": "dxk_live_..." }
    }
  }
}
3

Überprüfen

Starten Sie Claude oder Cursor neu und probieren Sie diesen Prompt aus. Wenn die KI list_ad_accounts oder list_recommendations aufruft und Ihre echten Daten zurückgibt, ist die Verbindung hergestellt.

Fragen Sie Claude:

„Liste meine verbundenen Werbekonten auf und fasse die offenen Empfehlungen der KI zusammen: Welche Kampagnen sollte ich laut ihr ändern, und warum?“

Tool-Katalog

Der MCP-Server stellt 5 Tools bereit, alle mit reinem Lesezugriff. Jedes hat ein vollständiges JSON Schema, sodass die KI selbst entscheidet, wann sie welches aufruft.

list_ad_accounts

Nur Lesen

Ihre verbundenen Google Ads-, Meta Ads- und TikTok Ads-Konten samt Verbindungsstatus.

list_recommendations

Nur Lesen

Die offenen Optimierungsempfehlungen der KI (Budget erhöhen, senken, pausieren), jeweils mit Begründung, erwarteter Wirkung und Konfidenz.

get_savings_summary

Nur Lesen

Ihre Einsparungsübersicht: verweist auf die Einsparungswerte in Ihrem Dashboard, dazu Ihr Tarif.

get_recent_activity

Nur Lesen

Letzte Kontoaktivitäten: Anmeldungen, Änderungen an API-Schlüsseln, Verbindungen von Werbekonten und Abo-Änderungen.

get_quota

Nur Lesen

Ihr aktuelles API-Limit: Anfragen pro Minute, verbleibende Anfragen und Zeitpunkt des Zurücksetzens.

Ihr KI-Client listet dieselben Tools samt Parametern über die standardmäßige MCP-Anfrage tools/list auf.

Beispielsitzung

Ein Beispielgespräch (Beispieldaten), das zeigt, wie der reine Lesezugriff in der Praxis aussieht:

Welche Werbekonten habe ich mit AdWhiz verbunden?

Sie haben drei verbundene Konten – je eines bei Google Ads, Meta Ads und TikTok Ads. Alle drei sind als verbunden markiert.

list_ad_accounts

Was empfiehlt die KI gerade?

Es gibt 2 offene Empfehlungen: ① das Tagesbudget der Meta-Kampagne „Lookalike 1%“ senken – ihr ROAS liegt seit einer Woche unter dem Kontodurchschnitt; ② das Budget einer TikTok-Spark-Ads-Kampagne erhöhen. Jede enthält eine Begründung und einen Konfidenzwert. Umsetzen können Sie sie in Ihrer Werbeplattform – von hier aus kann ich nichts ändern.

list_recommendations

Hat sich in letzter Zeit etwas an meinem Konto geändert?

In den letzten 7 Tagen: 2 Anmeldungen, 1 neuer API-Schlüssel, und Ihr TikTok Ads-Konto wurde erneut verbunden. Sonst ist nichts verzeichnet.

get_recent_activity

Sicherheit & Berechtigungen

  • Alle 5 Tools haben reinen Lesezugriff: Die KI kann Ihre Daten abfragen, aber keine Budgets ändern, keine Anzeigen pausieren und keine Kampagnen erstellen
  • Der MCP-Server läuft lokal – Ihr dxk_-API-Schlüssel verlässt Ihren Rechner nie in Richtung Dritter
  • Aufrufe werden mit Ihrem API-Schlüssel authentifiziert und teilen sich die REST-API-Limits Ihres Tarifs (abrufbar mit get_quota)
  • Änderungen an Ihren Kampagnen nehmen Sie selbst vor, nicht über MCP
  • MCP-Zugriff jederzeit unter Dashboard → Einstellungen → API Keys widerrufen