SearchAds Manager에는 앱 안에서 실행되는 macOS 전용 로컬 MCP 서버가 포함되어 있습니다. 계정 설정에 이미 구성한 Apple Search Ads 자격 증명을 재사용합니다.

주요 기능

• 캠페인을 만들기 전에 소유한 앱과 지원 국가를 확인하세요.
• 사용자 정의 API 스크립트를 만들지 않고 캠페인, 광고 그룹 및 키워드 보고서를 가져오세요.
• 인증된 로컬 엔드포인트를 통해 Codex에서 캠페인, 광고 그룹 및 키워드를 생성, 업데이트 및 삭제하세요.
• 앱이 실행되는 동안 연결을 Mac의 로컬 범위로 유지하세요.

실행 방식

1. 서버는 127.0.0.1에만 바인딩됩니다.
2. 서버는 macOS 앱이 실행 중일 때만 사용할 수 있습니다.
3. 접근은 앱 설정에 저장된 생성 토큰으로 보호됩니다.
4. MCP 엔드포인트는 /mcp입니다.
5. 상태 확인 엔드포인트는 /health에 있습니다.

SearchAds Manager 설정

macOS 설정 화면에는 다음 항목이 있는 Codex MCP 서버 카드가 있습니다.

1. 활성화 스위치
2. 설정 가능한 TCP 포트
3. 생성된 접근 토큰
4. 인증 정보가 포함된 전체 MCP URL
5. 바로 실행할 수 있는 Codex 명령
6. 로컬 리스너의 상태 표시

사용 가능한 MCP 도구

검색 및 메타데이터

• list_apps
• list_supported_countries

보고

• get_campaign_report
• get_adgroup_report
• get_keyword_report

캠페인 관리

• list_campaigns
• create_campaigns
• update_campaigns
• delete_campaigns

광고 그룹 관리

• list_adgroups
• add_adgroups
• update_adgroups
• delete_adgroups

키워드 관리

• list_keywords
• add_keywords
• update_keywords
• delete_keywords

일반적인 작업 흐름

1. list_apps를 호출하여 홍보할 앱의 adam_id를 찾으세요.
2. list_supported_countries를 호출하여 유효한 국가 또는 지역 코드를 확인하세요.
3. get_campaign_report, get_adgroup_report 또는 get_keyword_report로 현재 성과를 확인하세요.
4. list_campaigns, list_adgroups 및 list_keywords로 현재 상태를 확인하세요.
5. 오류를 쉽게 이해하고 필요할 때 되돌릴 수 있도록 쓰기 작업을 작고 명확한 묶음으로 적용하세요.

다음 단계

서버를 Codex에 추가하고 일회성 스모크 테스트를 실행하려면 SearchAds Manager를 Codex에 연결을 여세요.