Skip to main content
Glama
deenesjakoruzh
megha2432

Zeotap CDP MCP Server

by megha2432
OverviewSchemaRelated ServersScoreDiscussions
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 %

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/megha2432/MCP_Zeotap'

If you have feedback or need assistance with the MCP directory API, please join our Discord server