Skip to main content
Glama
deenesjakoruzh
megha2432

Zeotap CDP MCP Server

by megha2432
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Zeotap CDP MCP-Server

Ein MCP-Server (Model Context Protocol), der Claude mit den Audience- und Destination-APIs von Zeotap verbindet. Clients können Fragen in einfachem Englisch stellen – Claude übernimmt intern alle API-Aufrufe und ID-Suchvorgänge.

Funktionsweise

  • Ruft Zielgruppen, Ziele und den Synchronisierungsstatus von Zeotap ab

  • Komprimiert API-Antworten um ca. 85 % mittels tiktoken, damit Claude mehr Daten verarbeiten kann

  • Verknüpft Zielgruppen- und Zieldaten (repliziert Ihre SQL-Joins über API-Aufrufe)

  • Akzeptiert Organisations- und Zielgruppennamen – Clients müssen niemals IDs kennen

Dateien

Datei

Zweck

server.py

MCP-Server – verarbeitet Tool-Aufrufe, API-Anfragen, Antwortkomprimierung

tools.yaml

Konfiguration – Organisations-IDs, Tool-Definitionen, LLM-freundliche Beschreibungen

requirements.txt

Python-Abhängigkeiten

Skills.md

Vollständiger API-Entwurf und Referenz für das Tool-Design

.env

Bearer-Token (nicht im Repository – stündlich aktualisieren)

Einrichtung

1. Abhängigkeiten installieren

python3 -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt

2. Bearer-Token abrufen

  1. Melden Sie sich bei unity.zeotap.com an

  2. Öffnen Sie die Entwicklertools → Netzwerk-Tab → klicken Sie auf eine beliebige Anfrage

  3. Kopieren Sie den Wert Authorization: Bearer eyJ... (nur den Teil eyJ...)

3. Token festlegen

echo 'ZEOTAP_TOKEN=your-token-here' > .env

⚠️ Token laufen alle 1 Stunde ab. Wiederholen Sie Schritt 2–3, wenn Sie einen 401-Fehler erhalten.

4. Mit MCP Inspector ausführen (zum Testen)

npx @modelcontextprotocol/inspector .venv/bin/python server.py

Öffnen Sie die im Terminal angezeigte URL.

Hinzufügen einer neuen Organisation

Jede Organisation benötigt zwei IDs. Sie finden diese in den Entwicklertools, während Sie die Organisation in der Zeotap-App durchsuchen:

ID

Fundort

Verwendung

Numerische ID (z. B. 1918)

URL: /audiences/orgs/1918/...

Audience-APIs

UUID (z. B. efc1d9ad-...)

Netzwerk-Tab: /channelSettings/...?orgId=efc1...

Suche nach Zielnamen

Aktualisieren Sie tools.yaml:

audience_org_id: 1918
org_uuid: "efc1d9ad-8bb2-48a2-8c84-46f2e9f2b9b4"
org_name: "Your Org Name"

Tools

Tool

Beschreibung

Erforderliche Parameter

get_org_overview

Gesamtzahl der Zielgruppen, Statusaufschlüsselung, Top 5 nach Größe

keine

search_audiences

Zielgruppen nach Name oder Status finden

optional: query, status

get_audience_full

Vollständige Details + Filter + Ziele für eine Zielgruppe

audience_name oder audience_id

get_org_full_report

Alle Zielgruppen verknüpft mit ihren Zielen und dem Synchronisierungsstatus

keine

list_all_destinations

Alle in der Organisation konfigurierten Ziele

keine (benötigt UUID)

get_destination_full

Details für ein Ziel

destination_name oder destination_id (benötigt UUID)

list_orgs

Listet bekannte Kundenorganisationen mit ihren IDs auf

keine

Beispiel-Abfragen für Claude

Sobald die Verbindung zu Claude Desktop hergestellt ist, können Clients fragen:

Frage

Verwendetes Tool

"Gib mir eine Zusammenfassung unserer Zielgruppen"

get_org_overview

"Liste alle aktiven Zielgruppen auf"

search_audiences

"Erzähl mir etwas über die Zielgruppe Loyalty Program"

get_audience_full

"Welche Zielgruppen werden nicht synchronisiert?"

get_org_full_report

"An welche Plattformen synchronisiert unser CDP?"

get_org_full_report

"Welche Ziele haben wir?"

list_all_destinations

Verbindung zu Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "zeotap-cdp": {
      "command": "/Users/megha/Documents/MCP1/.venv/bin/python",
      "args": ["/Users/megha/Documents/MCP1/server.py"],
      "env": {
        "ZEOTAP_TOKEN": "your-token-here"
      }
    }
  }
}

Auf dem Mac befindet sich die Konfigurationsdatei unter: ~/Library/Application Support/Claude/claude_desktop_config.json

Starten Sie Claude Desktop nach dem Aktualisieren der Konfiguration neu.

Audience ↔ Destination Join

Das Tool get_org_full_report repliziert diesen SQL-Join über zwei API-Aufrufe:

SELECT fpa.name, fpa.status, csw.status, ip.int_partner_name
FROM public_audience_destinations pad
JOIN public_first_party_audience fpa ON pad.first_party_audience_id = fpa.id
JOIN public_channel_service_workflow csw ON pad.latest_channel_service_workflow_id = csw.id
JOIN public_integration_partner ip ON pad.channel_id = ip.int_id
WHERE fpa.org_id = 1918

SQL-Feld

API-Quelle

fpa.name, fpa.status

audienceSummaries Antwort

csw.status, csw.status_detail

destinationsSummary.status + statusDetail.message

ip.int_partner_name

channelSettings → integrationPartnerName (verknüpft über channelId = intId)

channelSegmentId

destinationsSummary.integrationDetail.channelSegmentId

Token-Reduzierung

Tool

Roh-Token

Minifiziert

Reduzierung

get_org_overview (100 Zielgruppen)

~15.000

~800

~95 %

search_audiences (20 Ergebnisse)

~8.000

~600

~93 %

get_audience_full

~3.000

~300

~90 %

get_org_full_report

~20.000

~2.000

~90 %

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Resources

Related MCP Connectors