Skip to main content
Glama
deenesjakoruzh
megha2432

Zeotap CDP MCP Server

by megha2432
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Servidor MCP de Zeotap CDP

Un servidor MCP (Model Context Protocol) que conecta a Claude con las APIs de Audiencias y Destinos de Zeotap. Los clientes pueden hacer preguntas en lenguaje sencillo: Claude gestiona internamente todas las llamadas a la API y las búsquedas de ID.

Qué hace

  • Obtiene audiencias, destinos y estados de sincronización de Zeotap

  • Comprime las respuestas de la API en un ~85% usando tiktoken para que Claude pueda manejar más datos

  • Une datos de audiencia + destino (replicando su unión SQL mediante llamadas a la API)

  • Acepta nombres de organizaciones y nombres de audiencias: los clientes nunca necesitan conocer los IDs

Archivos

Archivo

Propósito

server.py

Servidor MCP: gestiona llamadas a herramientas, solicitudes de API, compresión de respuestas

tools.yaml

Configuración: IDs de organización, definiciones de herramientas, descripciones amigables para LLM

requirements.txt

Dependencias de Python

Skills.md

Referencia completa del diseño de la API y las herramientas

.env

Token de portador (no se incluye en el repositorio; actualizar cada hora)

Configuración

1. Instalar dependencias

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

2. Obtener su token de portador

  1. Inicie sesión en unity.zeotap.com

  2. Abra DevTools → pestaña Network → haga clic en cualquier solicitud

  3. Copie el valor Authorization: Bearer eyJ... (solo la parte eyJ...)

3. Establecer el token

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

⚠️ Los tokens caducan cada 1 hora. Repita los pasos 2 y 3 cuando reciba un error 401.

4. Ejecutar con MCP Inspector (para pruebas)

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

Abra la URL que aparece en la terminal.

Agregar una nueva organización

Cada organización necesita dos IDs. Encuéntrelos en DevTools mientras navega por esa organización en la aplicación Zeotap:

ID

Dónde encontrarlo

Se utiliza para

ID numérico (ej. 1918)

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

APIs de audiencia

UUID (ej. efc1d9ad-...)

Pestaña Network: /channelSettings/...?orgId=efc1...

Búsqueda de nombre de destino

Actualice tools.yaml:

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

Herramientas

Herramienta

Descripción

Parámetros requeridos

get_org_overview

Total de audiencias, desglose de estados, top 5 por tamaño

ninguno

search_audiences

Buscar audiencias por nombre o estado

opcional: query, status

get_audience_full

Detalles completos + filtros + destinos para una audiencia

audience_name o audience_id

get_org_full_report

Todas las audiencias unidas con sus destinos y estado de sincronización

ninguno

list_all_destinations

Todos los destinos configurados en la organización

ninguno (necesita UUID)

get_destination_full

Detalles para un destino

destination_name o destination_id (necesita UUID)

list_orgs

Lista las organizaciones de clientes conocidas con sus IDs

ninguno

Ejemplos de consultas para Claude

Una vez conectado a Claude Desktop, los clientes pueden preguntar:

Pregunta

Herramienta utilizada

"Dame un resumen de nuestras audiencias"

get_org_overview

"Lista todas las audiencias activas"

search_audiences

"Cuéntame sobre la audiencia del Programa de Lealtad"

get_audience_full

"¿Qué audiencias están fallando al sincronizarse?"

get_org_full_report

"¿A qué plataformas se está sincronizando nuestro CDP?"

get_org_full_report

"¿Qué destinos tenemos?"

list_all_destinations

Conectar a Claude Desktop

Agréguelo a su claude_desktop_config.json:

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

En Mac, el archivo de configuración se encuentra en: ~/Library/Application Support/Claude/claude_desktop_config.json

Reinicie Claude Desktop después de actualizar la configuración.

Unión de Audiencia ↔ Destino

La herramienta get_org_full_report replica esta unión SQL mediante dos llamadas a la API:

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

Campo SQL

Fuente de la API

fpa.name, fpa.status

Respuesta de audienceSummaries

csw.status, csw.status_detail

destinationsSummary.status + statusDetail.message

ip.int_partner_name

channelSettings → integrationPartnerName (unido mediante channelId = intId)

channelSegmentId

destinationsSummary.integrationDetail.channelSegmentId

Reducción de tokens

Herramienta

Tokens brutos

Minificado

Reducción

get_org_overview (100 audiencias)

~15,000

~800

~95%

search_audiences (20 resultados)

~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