marketing-meta-ads-manager

Meta 광고 운영 (Meta Ads AI Connectors)

Meta 공식 Meta Ads AI Connectors(한글: Meta 광고 AI 커넥터)에 연결해, 자연어로 Meta 광고를 직접 운영합니다. Ads MCP 서버와 Ads CLI로 구성되며 2026-04-29 오픈 베타로 공개되었습니다.

책임 한 줄: 이 스킬은 Meta 광고의 라이브 운영(생성·수정·예산·온오프) 만 담당합니다. 보고서 분석·진단·설치검증·기획은 형제 스킬이 맡습니다(아래 "형제 스킬 페어 분리" 참고).

---

1. 연결 / 셋업

1-1. OAuth 2.0 커넥터 흐름 (1차 · 권장)

공식 기본 인증 경로입니다. 앱 생성·앱 심사·토큰 수동 복사가 필요 없습니다. 클라이언트(Claude)가 Meta Business OAuth 로그인을 브라우저에서 수행하고 액세스 토큰을 자동 발급합니다.

• 엔드포인트: https://mcp.facebook.com/ads
• 표준: RFC 9728 Protected Resource Metadata + RFC 6750 Bearer
• OAuth scope: ads_management ads_read catalog_management business_management pages_show_list

A. Claude Cowork / Desktop (비개발자 1차 경로)

1. Settings → Connectors → Add custom connector
2. 이름 입력 + URL https://mcp.facebook.com/ads 입력
3. 브라우저가 열리며 Meta Business OAuth 로그인 진행
4. 광고 계정 / 페이지 선택 + 권한 등급 선택
5. 자연어 프롬프트로 연결 확인 (예: "내 광고 계정 목록 보여줘")

B. Claude Code (.mcp.json)

정적 Authorization 헤더를 넣지 않습니다. OAuth 커넥터 흐름이 인증을 처리합니다.

{
  "mcpServers": {
    "meta-ads": {
      "type": "http",
      "url": "https://mcp.facebook.com/ads"
    }
  }
}

1-2. 정적 토큰 (Fallback · 강등됨)

OAuth가 불가한 개발 환경의 fallback 전용 경로입니다. 개발자/시스템 유저 토큰을 Graph API Explorer에서 발급해 META_ACCESS_TOKEN Bearer로 주입합니다. OAuth 보호 엔드포인트에는 일반 정적 Bearer가 403을 반환할 수 있으므로 항상 OAuth를 먼저 시도하고, 이 경로는 우선순위가 낮습니다.

• 토큰을 코드·SKILL.md에 하드코딩 금지
• 환경변수는 ${META_ACCESS_TOKEN} 구문으로만 주입

---

2. 권한 등급

OAuth 로그인 중 사용자가 등급을 선택합니다. 쓰기·결제 동작은 실행할 때마다 사용자 승인이 필요합니다.

등급	범위	권장
read-only	조회·성과 분석만	시작 등급(권장)
read+write	캠페인·광고세트·광고 생성/수정, 예산 조정	운영 시
financial	결제·청구 관련 동작	필요 시에만

권한 회수: Meta Business Suite에서 커넥터 접근을 철회합니다.

---

3. 워크플로우

1. 연결 확인 — read-only로 시작해 광고 계정·페이지 목록을 조회하고 대상을 확정한다.
2. 운영 의도 수집 — 목표(전환/트래픽/도달), 대상 광고 계정, 예산, 기간, 소재를 자연어로 받는다.
3. 생성/수정 제안 — 캠페인 → 광고세트 → 광고 구조로 변경안을 표로 제시한다. 신규 리소스는 PAUSED 상태로 만든다.
4. 사용자 승인 — 쓰기·예산·결제 동작은 실행 전 사용자에게 확인받는다(아래 안전 가드).
5. 실행 — 승인된 동작만 MCP로 실행하고 결과 ID·상태를 회신한다.
6. 검증/체이닝 — 필요 시 한국 시장 audit 또는 분석 스킬로 넘긴다(§7).