MCP 연동 가이드
Model Context Protocol로 Claude, Cursor 또는 자체 AI 에이전트가 DEXUN AdWhiz의 데이터(3개 플랫폼의 연결된 광고 계정, AI 추천, 최근 활동)를 조회하도록 하세요. 읽기 전용입니다.
MCP란?
MCP(Model Context Protocol)는 Anthropic이 2024년에 발표한 개방형 표준으로, AI 애플리케이션이 외부 데이터와 도구에 안전하게 접근하는 방식을 정의합니다. "AI 시대의 USB-C"라고 생각하면 됩니다 — 하나의 통합 인터페이스로 모든 MCP 클라이언트(Claude Desktop, Cursor, 자체 에이전트)가 모든 MCP 서버(DEXUN AdWhiz, Notion, GitHub 등)를 호출할 수 있습니다.
DEXUN AdWhiz MCP 서버는 읽기 전용 도구 5개를 제공합니다. 연결된 광고 계정, AI의 미처리 추천, 절감액 요약, 최근 계정 활동, API 사용 한도입니다. 광고 계정의 어떤 항목도 변경·일시중지·생성할 수 없습니다. 모든 호출은 API 키로 인증되며 REST API와 동일한 요금제별 속도 제한이 적용됩니다.
빠른 시작
세 단계, 약 5분이면 AI 어시스턴트에게 광고 계정에 대해 물어볼 수 있습니다.
Claude Desktop 설정
claude_desktop_config.json(macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\)을 열고 다음을 추가하세요:
# Claude Desktop config: ~/.../claude_desktop_config.json
{
"mcpServers": {
"dexun-adwhiz": {
"command": "npx",
"args": ["-y", "@dexun/adwhiz-mcp@latest"],
"env": {
"ADWHIZ_API_KEY": "dxk_live_..."
}
}
}
}Cursor 설정
프로젝트 수준의 .cursor/mcp.json 또는 전역 설정에서:
# Cursor: ~/.cursor/mcp.json (or Project → Settings → MCP)
{
"mcpServers": {
"dexun-adwhiz": {
"command": "npx",
"args": ["-y", "@dexun/adwhiz-mcp@latest"],
"env": { "ADWHIZ_API_KEY": "dxk_live_..." }
}
}
}연결 확인
Claude 또는 Cursor를 다시 시작한 뒤 이 프롬프트를 입력해 보세요. AI가 list_ad_accounts 또는 list_recommendations를 호출해 실제 데이터를 반환하면 연동이 완료된 것입니다.
Claude에게 물어보세요:
“연결된 광고 계정 목록을 보여 주고, AI의 미처리 추천을 요약해 줘. 어떤 캠페인을 바꾸라고 하는지, 이유는 뭔지 알려 줘.”
도구 목록
MCP 서버는 도구 5개를 제공하며 모두 읽기 전용입니다. 모든 도구에 완전한 JSON Schema가 있어 AI가 언제 어떤 도구를 호출할지 스스로 판단합니다.
list_ad_accounts
읽기 전용연결된 Google Ads, Meta Ads, TikTok Ads 계정과 연결 상태.
list_recommendations
읽기 전용AI의 미처리 최적화 추천(예산 증액, 감액, 일시중지). 각각 이유, 예상 효과, 신뢰도 포함.
get_savings_summary
읽기 전용절감액 요약: 대시보드의 절감액 화면 안내와 이용 중인 요금제.
get_recent_activity
읽기 전용최근 계정 활동: 로그인, API 키 변경, 광고 계정 연결, 구독 변경.
get_quota
읽기 전용현재 API 속도 제한: 분당 요청 수, 남은 횟수, 초기화 시각.
AI 클라이언트에서 표준 MCP tools/list 요청으로 같은 도구와 파라미터를 확인할 수 있습니다.
세션 예시
읽기 전용 접근이 실제로 어떤 모습인지 보여 주는 예시 대화입니다(샘플 데이터):
AdWhiz에 연결된 광고 계정이 뭐가 있어?
연결된 계정은 3개입니다. Google Ads, Meta Ads, TikTok Ads 계정이 하나씩 있으며 모두 연결 상태입니다.
지금 AI가 추천하는 건 뭐야?
미처리 추천이 2건 있습니다. ① Meta 캠페인 “Lookalike 1%”의 일일 예산 감액 — 지난 1주일간 ROAS가 계정 평균보다 낮았습니다. ② TikTok Spark Ads 캠페인의 예산 증액. 각 추천에는 이유와 신뢰도가 포함되어 있습니다. 적용하려면 광고 플랫폼에서 직접 진행해 주세요. 여기서는 아무것도 변경할 수 없습니다.
최근에 계정에 바뀐 게 있어?
지난 7일간 로그인 2회, 새 API 키 1개 발급, TikTok Ads 계정 다시 연결이 있었습니다. 그 외 기록은 없습니다.
보안 및 권한
- 도구 5개는 모두 읽기 전용입니다. AI는 데이터를 조회할 수 있지만 예산 변경, 광고 일시중지, 캠페인 생성은 할 수 없습니다
- MCP 서버는 로컬에서 실행되며, dxk_ API 키는 사용자 컴퓨터를 벗어나 제3자에게 전송되지 않습니다
- 호출은 API 키로 인증되며 요금제의 REST API 속도 제한을 함께 사용합니다(get_quota로 확인 가능)
- 캠페인 변경은 MCP가 아닌 사용자가 직접 진행합니다
- 대시보드 → 설정 → API Keys에서 언제든지 MCP 접근 권한을 취소할 수 있습니다