de en es ja ko ru zh

Zeotap CDP MCP Server

Name: Zeotap CDP MCP Server
Author: megha2432

by megha2432

Overview Schema Related Servers Score Discussions

Python

Remote

Zeotap CDP MCP 서버

Claude를 Zeotap의 오디언스 및 목적지 API에 연결하는 MCP(Model Context Protocol) 서버입니다. 클라이언트는 평이한 영어로 질문할 수 있으며, Claude가 내부적으로 모든 API 호출과 ID 조회를 처리합니다.

주요 기능

Zeotap에서 오디언스, 목적지, 동기화 상태를 가져옵니다.
tiktoken을 사용하여 API 응답을 약 85% 압축함으로써 Claude가 더 많은 데이터를 처리할 수 있게 합니다.
오디언스와 목적지 데이터를 결합합니다(API 호출을 통해 SQL 조인을 복제).
조직 이름과 오디언스 이름을 허용하므로 클라이언트는 ID를 알 필요가 없습니다.

파일 구성

파일	용도
`server.py`	MCP 서버 — 도구 호출, API 요청, 응답 압축 처리
`tools.yaml`	구성 — 조직 ID, 도구 정의, LLM 친화적인 설명
`requirements.txt`	Python 종속성
`Skills.md`	전체 API 설계도 및 도구 설계 참조
`.env`	Bearer 토큰 (커밋되지 않음 — 매시간 업데이트 필요)

설정

1. 종속성 설치

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

2. Bearer 토큰 가져오기

unity.zeotap.com에 로그인합니다.
개발자 도구(DevTools) → 네트워크(Network) 탭 → 아무 요청이나 클릭합니다.
Authorization: Bearer eyJ... 값을 복사합니다 (eyJ... 부분만).

3. 토큰 설정

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

⚠️ 토큰은 1시간마다 만료됩니다. 401 오류가 발생하면 2~3단계를 반복하세요.

4. MCP Inspector로 실행 (테스트용)

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

터미널에 출력된 URL을 엽니다.

새 조직 추가

각 조직에는 두 개의 ID가 필요합니다. Zeotap 앱에서 해당 조직을 탐색할 때 개발자 도구에서 찾을 수 있습니다:

ID	찾는 위치	용도
숫자 ID (예: `1918`)	URL: `/audiences/orgs/1918/...`	오디언스 API
UUID (예: `efc1d9ad-...`)	네트워크 탭: `/channelSettings/...?orgId=efc1...`	목적지 이름 조회

tools.yaml 업데이트:

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

도구

도구	설명	필수 매개변수
`get_org_overview`	전체 오디언스, 상태 분석, 크기 기준 상위 5개	없음
`search_audiences`	이름 또는 상태로 오디언스 찾기	선택 사항: `query`, `status`
`get_audience_full`	오디언스 하나에 대한 전체 세부 정보 + 필터 + 목적지	`audience_name` 또는 `audience_id`
`get_org_full_report`	목적지 및 동기화 상태와 결합된 모든 오디언스	없음
`list_all_destinations`	조직에 구성된 모든 목적지	없음 (UUID 필요)
`get_destination_full`	목적지 하나에 대한 세부 정보	`destination_name` 또는 `destination_id` (UUID 필요)
`list_orgs`	ID가 포함된 알려진 클라이언트 조직 목록	없음

Claude 쿼리 예시

Claude Desktop에 연결되면 다음과 같이 질문할 수 있습니다:

질문	사용되는 도구
"오디언스 요약을 알려줘"	`get_org_overview`
"활성 오디언스를 모두 나열해줘"	`search_audiences`
"Loyalty Program 오디언스에 대해 알려줘"	`get_audience_full`
"동기화에 실패한 오디언스는 무엇인가요?"	`get_org_full_report`
"우리 CDP가 어떤 플랫폼으로 동기화 중인가요?"	`get_org_full_report`
"어떤 목적지들이 있나요?"	`list_all_destinations`

Claude Desktop에 연결

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"
      }
    }
  }
}

Mac의 경우 구성 파일 위치: ~/Library/Application Support/Claude/claude_desktop_config.json

구성을 업데이트한 후 Claude Desktop을 다시 시작하세요.

오디언스 ↔ 목적지 조인

get_org_full_report 도구는 두 번의 API 호출을 통해 이 SQL 조인을 복제합니다:

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 필드	API 소스
`fpa.name`, `fpa.status`	`audienceSummaries` 응답
`csw.status`, `csw.status_detail`	`destinationsSummary.status` + `statusDetail.message`
`ip.int_partner_name`	`channelSettings` → `integrationPartnerName` (`channelId = intId`로 조인)
`channelSegmentId`	`destinationsSummary.integrationDetail.channelSegmentId`

토큰 감소

도구	원본 토큰	축소본	감소율
`get_org_overview` (100개 오디언스)	~15,000	~800	~95%
`search_audiences` (20개 결과)	~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

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Related MCP Connectors

platform7nOAuth
tech.p7n
Connect Claude to your Platform7n workspaces — chat, links, and tasks. One-click OAuth.
Communication Project Management Workplace & Productivity
2
Nevent MCP A
io.github.nevent-dev
Talk to your live-events CRM (campaigns, analytics, paid ads, segments) in Claude and ChatGPT.
CRM Marketing
5921
ContextfloOAuth
com.contextflo
Query your warehouse or a CSV with Claude/ChatGPT over MCP, governed by table-level ACL + audit.
Databases Security
1
Fathom MCP ServerOAuth
io.github.agencyenterprise
Connect Claude to Fathom meeting recordings, transcripts, and summaries
Communication App Automation Search
216

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

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