캠페인 계층 구조 — 캠페인(목표, 채널, 일일 예산) → 광고 그룹(입찰 전략 + 입찰/목표, 잠재고객) → 광고/크리에이티브.
Ads MCP Server
ADK-Rust Enterprise 영업 및 마케팅 에이전트를 위한 디지털 광고 플랫폼. 캠페인, 광고 그룹, 광고/크리에이티브, 예산 및 입찰, 잠재고객, 일일 성과 지표 및 파생 KPI를 다루는 19개 MCP 도구 제공.
에이전트에게 제공하는 것
하나의 MCP 연결 뒤에 구축된 목적 특화 기능입니다.
서버는 도메인 로직을 소유하며 MCP 클라이언트가 발견할 수 있는 도구 계약을 게시합니다. ADK-Rust는 그 계약을 에이전트에 로드하고, 선택한 모델 공급자에 맞게 각 스키마를 정규화하며, 연결 수명 주기를 에이전트의 비즈니스 로직 밖에서 관리합니다.
잠재고객 — 관심사 / 리마케팅 / 유사 잠재고객 / 맞춤형, 예상 크기 포함.
지표 및 KPI — 일일 노출/클릭/지출/전환/수익 수집; 광고 그룹 및 캠페인 수준에서 파생된 CTR, CPC, CPA, CVR, ROAS 제공.
예산 페이싱 — 오늘 지출과 일일 예산 비교, 페이싱 플래그(과소 지출 / 정상 / 과열 / 예산 소진) 표시.
최적화 — 광고 그룹별 규칙 기반 제안: 높은 ROAS 우승자 확장, 손익분기점 이하 또는 전환 없는 그룹 축소/일시 중지, 낮은 CTR 플래그, 목표 CPA 초과 CPA 감지…
아키텍처
Ads MCP Server이(가) 에이전트 시스템에 어떻게 적합한지.
모델은 서버 뒤 시스템의 구현 세부사항이나 자격 증명을 절대 필요로 하지 않습니다. 검토된 도구 정의만 봅니다. MCP 클라이언트가 발견과 호출을 처리하며, 서버는 검증, 정책, 도메인 시스템과의 통신을 소유합니다.
ADK-Rust 에이전트
검토된 도구 카탈로그에서 기능을 선택합니다.
MCP 클라이언트
스키마를 발견하고 호출을 보내며 타입화된 콘텐츠를 수신합니다.
Ads MCP Server
요청을 검증하고 19개의 문서화된 도구 계약을 소유합니다.
도메인 시스템
서버 뒤의 API, 데이터, 자격 증명, 비즈니스 규칙을 유지합니다.
프로젝트 문서에서
서버가 게시한 아키텍처
도구 카탈로그
에이전트가 Ads MCP Server에게 무엇을 요청할 수 있나요?
각 도구는 안정적인 이름, 사람이 읽을 수 있는 목적, MCP 초기화 중 발견된 JSON 입력 계약을 가집니다. 위험 등급은 프로젝트의 레지스트리 매니페스트에서 제공됩니다(있는 경우).
19개의 명명된 도구들
create_campaign캠페인 생성(초안)
internal writeget_campaignID로 캠페인 가져오기
read onlylist_campaigns상태/채널별 캠페인 목록
read onlyset_campaign_status캠페인 상태 설정(지출 영향) — 게이트 적용
external writeset_budget캠페인 일일 예산 설정 — 게이트 적용(지출)
external writecreate_ad_group캠페인 내 광고 그룹 생성
internal writeget_ad_groupID로 광고 그룹 가져오기
read onlylist_ad_groups캠페인 내 광고 그룹 목록
read onlyset_bid광고 그룹 입찰/목표 설정 — 게이트 적용(지출)
external writecreate_ad광고/크리에이티브 생성
internal writelist_ads광고 그룹 내 광고 목록
read onlycreate_audience잠재고객 생성
internal write거버넌스
모든 도구의 효과를 이해하세요.
서버 연결은 자격 증명과 배포 환경의 권한을 상속합니다. 아래 선언은 이 프로젝트의 README와 MCP 레지스트리 매니페스트에서 가져온 것이며, 애플리케이션은 에이전트가 어떤 도구를 받고 어디서 승인이 필요한지 결정합니다.
- 직접 지출에 영향을 주는 세 가지 쓰기 작업은 게이트 적용(승인 필요, 외부 쓰기): set_budget, set_bid, set_campaign_status(캠페인 일시 중지/활성화는 지출 여부 변경).
- optimize는 읽기 전용 — 추천만 제공; 추천 적용은 게이트 도구를 통해 수행. 예산과 입찰은 음수 불가; 종료된 캠페인은 종료 상태.
- 모든 중요 내용은 감사 추적에 기록됨(감사 로그). 샘플 데이터는 가상임.
MCP 인터페이스
현재 문서가 선언하는 내용
MCP는 도구, 리소스, 프롬프트, 구조화된 결과, 진행 상황, 취소, 장기 작업을 전달할 수 있습니다. 이 기록은 이 저장소에서 명시적으로 언급한 최신 프로토콜 기능을 강조합니다.
설치 및 연결
프로젝트 문서에 명시된 시작점을 따르세요.
자격 증명과 도메인 접근 권한을 소유한 환경에 서버를 설치하세요. MCP 호스트에 추가하고 발견된 도구를 검증한 후 도구 세트를 좁혀 프로덕션 에이전트에 제공합니다.
cargo install mcp-adslet toolset = McpToolset::from_stdio(
"mcp-ads",
["mcp-ads"],
).await?;
let agent = LlmAgentBuilder::new("agent")
.tools(toolset.tools().await?)
.build()?;명령과 구성은 공개 README에서 추출됩니다. 배포 전에 공식 문서에서 전제 조건, 환경 변수, 릴리스별 옵션을 확인하세요.
공식 문서
프로젝트 유지 관리자의 신뢰할 수 있는 출처를 계속 사용하세요.
이 페이지는 서버의 친근한 지도를 제공합니다. 저장소는 정확한 스키마, 전제 조건, 구성, 예제, 테스트, 릴리스, 보안 업데이트에 대해 권위 있는 출처로 남아 있습니다.
계속 탐색하기
비즈니스 운영에서 더 보기.
소스 기록
이 카탈로그 항목의 릴리스 및 저장소 메타데이터입니다.
- 버전
- 1.0.0
- 라이선스
- Apache-2.0
- 도구
- 19
- 수정
- dc3ea76c6b46
- 업데이트됨
- 2026년 6월 9일