AdOps MCP

Model Context Protocol을 위한 AI 기반 크로스 플랫폼 광고 관리

License: MIT TypeScript MCP

Google Ads와 Meta Ads 캠페인을 관리하고, 크로스 플랫폼 성과를 분석하며, 예산을 최적화하고, 이상 징후를 탐지하세요. 이 모든 작업은 Claude, Cursor, VS Code와 같은 AI 어시스턴트를 통해 수행할 수 있습니다.

주요 기능

Google Ads 및 Meta Ads를 위한 통합 캠페인 관리
전체 광고 수명 주기를 다루는 14개의 MCP 도구
빠른 대시보드 액세스를 위한 4개의 MCP 리소스
정규화된 지표를 사용한 크로스 플랫폼 성과 보고
실행 가능한 권장 사항을 포함한 AI 기반 예산 최적화
통계적 이상 징후 탐지 (CPC 급증, CTR 하락, 지출 급증)
신뢰도 점수를 포함한 A/B 테스트 분석
업계 벤치마크 비교 (9개 업종)
지출 및 전환 예측 (7/14/30일)
플랫폼별 크리에이티브 사양 참조
42개의 자동화된 테스트 (단위 + E2E 사용자 워크플로우), TypeScript strict 모드, Zod 유효성 검사

빠른 시작

npm에서 설치

npm i adops-mcp-server

MCP 클라이언트에 추가

{
  "mcpServers": {
    "adops": {
      "command": "node",
      "args": ["path/to/node_modules/adops-mcp-server/dist/index.js"]
    }
  }
}

소스에서 빌드

git clone https://github.com/enzoemir1/adops-mcp.git
cd adops-mcp
npm ci && npm run build

도구

도구	설명
`platform_connect`	Google Ads 또는 Meta Ads 계정 연결 등록
`campaign_list`	연결된 모든 플랫폼의 캠페인 목록 조회 및 필터링
`campaign_create`	통합 매개변수를 사용하여 새 캠페인 생성
`campaign_update`	캠페인 설정 업데이트 (예산, 상태, 입찰, 일정)
`campaign_pause_resume`	최대 50개의 캠페인을 한 번에 일시 중지 또는 재개
`ads_report`	통합 크로스 플랫폼 성과 보고서 생성
`budget_analyze`	최적화 권장 사항과 함께 예산 할당 분석
`budget_reallocate`	플랫폼 간 캠페인 예산 이전
`audience_insights`	인구 통계, 지리적 위치 및 기기별 분석 데이터 제공
`creative_specs`	플랫폼별 이미지, 동영상 및 텍스트 요구 사항 확인
`anomaly_detect`	구성 가능한 민감도로 성과 이상 징후 탐지
`ab_test_analyze`	통계적 유의성 검정을 통해 두 캠페인 비교
`competitor_benchmark`	업계 평균과 귀하의 지표 비교
`forecast_spend`	다음 기간의 지출, 전환 및 ROAS 예측

리소스

리소스	설명
`ads://overview`	크로스 플랫폼 대시보드 요약
`ads://campaigns`	주요 지표가 포함된 모든 활성 캠페인
`ads://budget`	플랫폼별 예산 할당 현황
`ads://alerts`	최근 성과 이상 징후 및 경고

구성

모든 통합은 선택 사항입니다. 이 서버는 API 키 없이도 로컬 스토리지를 사용하여 캠페인 관리 및 분석 기능을 수행할 수 있습니다.

변수	플랫폼	필수 여부	설명
`GOOGLE_ADS_DEVELOPER_TOKEN`	Google	실시간 동기화 시	API 개발자 토큰
`GOOGLE_ADS_CLIENT_ID`	Google	실시간 동기화 시	OAuth2 클라이언트 ID
`GOOGLE_ADS_CLIENT_SECRET`	Google	실시간 동기화 시	OAuth2 클라이언트 시크릿
`GOOGLE_ADS_REFRESH_TOKEN`	Google	실시간 동기화 시	OAuth2 리프레시 토큰
`GOOGLE_ADS_CUSTOMER_ID`	Google	실시간 동기화 시	광고 계정 ID (10자리)
`META_APP_ID`	Meta	실시간 동기화 시	Facebook 앱 ID
`META_APP_SECRET`	Meta	실시간 동기화 시	Facebook 앱 시크릿
`META_ACCESS_TOKEN`	Meta	실시간 동기화 시	시스템 사용자 액세스 토큰
`META_AD_ACCOUNT_ID`	Meta	실시간 동기화 시	광고 계정 ID (act_XXX)

전체 템플릿은 .env.example을 참조하세요.

통합 지표

AdOps는 플랫폼 간 지표를 단일 스키마로 정규화합니다:

지표	공식	설명
CTR	클릭수 / 노출수 x 100	클릭률 (%)
CPC	지출 / 클릭수	클릭당 비용
CPM	지출 / 노출수 x 1000	1000회 노출당 비용
ROAS	수익 / 지출	광고 수익률
CPA	지출 / 전환수	획득당 비용
전환율	전환수 / 클릭수 x 100	전환율 (%)

플랫폼 필드 매핑:

AdOps 필드	Google Ads	Meta Ads
`spend`	`cost_micros / 1,000,000`	`amount_spent`
`impressions`	`impressions`	`impressions`
`clicks`	`clicks`	`clicks`
`conversions`	`conversions`	`actions[type=purchase]`
캠페인 > 광고 그룹	광고 그룹	광고 세트

요금제

등급	가격	기능
무료	$0	1개 플랫폼, 읽기 전용 보고서, 크리에이티브 사양, 일일 50회 호출
Pro	$29/월	2개 플랫폼, 전체 CRUD, 이상 징후 탐지, 예산 최적화
Agency	$59/월	무제한, 예측, 벤치마킹, 우선 지원

MCPize에서 이용 가능합니다.

개발

npm run dev        # Hot reload development
npm run build      # Production build
npm test           # Run 42 tests (unit + E2E)
npm run inspect    # Open MCP Inspector

테스트

5개 테스트 스위트에 걸친 42개의 테스트:

스토리지: 연결 CRUD, 캠페인 검색, 지표 집계, 배치 삽입
분석: 지표 계산, 성과 보고서, 예측, 벤치마크
최적화: 예산 분석, 재배분, 확장/일시 중지 권장 사항
이상 징후: CPC 급증 탐지, 전환 하락, 민감도 수준, 심각도 정렬
E2E 워크플로우: 14개의 실제 사용자 시나리오 — 플랫폼 연결, 캠페인 생성, 보고서 생성, 예산 최적화, A/B 테스트 실행, 이상 징후 탐지, 지출 예측, 업계 대비 벤치마킹

npm test

라이선스

MIT 라이선스. 자세한 내용은 LICENSE를 참조하세요.

Automatia BCN 제작.

adops-mcp