Abfragen Ihrer Marketing Cloud Intelligence-Daten mit dem MCP-Server

Funktionsweise des Marketing Cloud Intelligence-MCP-Servers

Der MCP-Server verbindet Ihren MCI-Account mit einem kompatiblen AI-Client wie Claude Code oder Cursor. Wenn Sie eine Frage stellen, sendet der Client die Anforderung an den Server. Der Server greift nur auf die von Ihren konfigurierten Berechtigungen zulässigen Daten zu und gibt die Ergebnisse in einem lesbaren Format zurück.

Verfügbare MCP-Tools

Parameter für mci_query

Unterstützte Datumsbereiche

Sicherheit

Der MCI-MCP-Server verwendet Ihre konfigurierten MCI-Anmeldeinformationen und -Berechtigungen für den Zugriff auf Daten. Ihr Account hat nur Zugriff auf seine autorisierten Arbeitsumgebungen und Daten. Der MCI-MCP-Server sendet alle Anforderungen über HTTPS.

Beispielunterhaltung mit dem MCP-Server

Zeige mir die Top-Kampagnen der letzten Woche von ROAS.

Der AI-Client gibt die wichtigsten Kampagnen nach ROAS für den angeforderten Zeitraum zurück.

Vergleichen Sie diese mit dem letzten Monat.

Der AI-Client vergleicht die Ergebnisse mit dem Vormonat und fasst die Änderungen zusammen.

Einrichten des MCP-Servers für Marketing Cloud Intelligence

Richten Sie den MCI-MCP-Server ein, um Marketingdaten aus Claude Code, Cursor oder einem anderen MCP-kompatiblen AI-Client abzufragen.

Stellen Sie zunächst sicher, dass Sie über Folgendes verfügen:

• Ein Marketing Cloud Intelligence-Account mit API-Zugriff.
• Ein MCP-kompatibler AI-Client.

1. Laden Sie Ihre API-Anmeldeinformationen herunter.

   1. Melden Sie sich bei Marketing Cloud Intelligence an.
   2. Öffnen Sie auf der Navigationsleiste die Dropdown-Liste und wählen Sie dann Ihren Namen aus, um auf Ihre Profileinstellungen zuzugreifen.
   3. Wählen Sie neben dem API-Zugriffstoken die Option Generieren/Aktualisieren aus.
   4. Speichern Sie die heruntergeladene JSON-Anmeldeinformationsdatei an einem sicheren Ort, beispielsweise ~/.mci/credentials.json.

2. Konfigurieren Sie Ihren AI-Client.

   1. Fügen Sie der MCP-Serverkonfiguration Ihres AI-Clients den MCI-MCP-Server hinzu.

      Bei Claude Code befindet sich die Konfigurationsdatei in der Regel hier:

      • MacOS und Linux ~/.config/claude/mcp_servers.json
      • %APPDATA%\claude\mcp_servers.json
   2. Identifizieren Sie den Host-URL für Ihre MCI-Instanz.

      MCI-Instanz	Host-URL
      EU	https://app-eu.datorama.com/api/mcp
      EU2	https://app-eu2.datorama.com/api/mcp
      USA	https://app.datorama.com/api/mcp
      US2	https://app-us2.datorama.com/api/mcp

   3. Fügen Sie diese Konfiguration hinzu. In diesem Beispiel wird der US-Host-URL verwendet.

      {
        "mci": {
          "command": "npx",
          "args": ["-y", "@datorama/mci-mcp-sdk"],
          "env": {
            "PRIVATE_KEY_PATH": "/absolute/path/to/credentials.json",
            "HOST": "https://app.datorama.com/api/mcp"
          }
        }
      }

   4. Ersetzen Sie PRIVATE_KEY_PATH /absolute/path/to/credentials.json durch den absoluten Pfad zu Ihrer JSON-Anmeldeinformationsdatei. Ersetzen Sie HOST den Beispiel-URL durch den Host-URL für Ihre MCI-Instanz.
   5. Starten Sie Ihren AI-Client neu, um die Konfiguration anzuwenden.

3. Testen Sie Ihr Setup. Fragen Sie in Ihrem AI-Client:

   Zeigen Sie mir meinen Account und die Arbeitsumgebungen, auf die ich zugreifen kann.

   Wenn die Antwort Ihren Account und die Arbeitsumgebungen mit barrierefreiem Zugriff enthält, ist das Setup abgeschlossen. Überprüfen Sie andernfalls den Pfad der Anmeldeinformationsdatei, den regionalen Endpunkt und die Accountberechtigungen und versuchen Sie es erneut.