1. HilltopAds MCP란 무엇이며, 무엇을 할 수 있나요?

HilltopAds MCP란 무엇인가요?

MCP(Model Context Protocol) 서버는 AI 클라이언트를 위한 HilltopAds 공식 커넥터입니다. 연결이 완료되면 AI는 계정 데이터를 읽을 수 있으며, 사용자의 승인을 받은 경우 캠페인 생성이나 업데이트와 같은 작업도 안전한 전용 채널을 통해 수행할 수 있습니다. 따라서 데이터를 직접 복사하여 붙여넣을 필요가 없습니다.

로그인 ID와 비밀번호는 AI 클라이언트와 절대 공유되지 않습니다. 연결은 계정에서 직접 생성한 API 키를 사용하여 인증됩니다.

이 커넥터는 여러 도구(Tools) 를 통해 HilltopAds 계정에 접근합니다. AI는 사용자의 요청에 가장 적합한 도구를 선택하여 실행하고, 결과를 표, 요약 또는 그래프와 같이 이해하기 쉬운 형태로 제공합니다.

무엇을 할 수 있나요?

사용 가능한 도구는 크게 두 가지 유형으로 나뉩니다.

조회 작업(Read Operations): 잔액, 광고 인벤토리, 통계, 특정 캠페인의 세부 정보 또는 캠페인의 트래픽 소스 목록과 같은 데이터를 조회합니다.

실행 작업(Action Operations): 캠페인 생성 및 수정, 시작 및 중지, 입찰가(Bid) 및 목적지 URL 변경, 소스 블랙리스트 및 화이트리스트 관리 등 계정에 실제 변경 사항을 적용합니다.

사용 가능한 도구는 계정 유형(Advertiser, Publisher, 또는 둘 다)에 따라 달라집니다. 현재 MCP는 총 27개의 작업을 지원하며, Advertiser용 23개, Publisher용 4개가 제공됩니다.

실행 작업(Action Operations) 은 반드시 사용자의 승인을 받은 후에만 실행됩니다. AI 클라이언트는 각 도구를 읽기 전용(Read-only) 또는 쓰기/삭제(Write/Delete) 로 표시하며, 변경 사항을 적용하기 전에 사용자에게 확인을 요청합니다.

계정 및 리포트 도구

도구	기능
`advertiser_get_balance`	Advertiser 계정의 현재 잔액을 조회합니다.
`advertiser_list_inventory`	캠페인과 해당 광고를 조회합니다.
`advertiser_get_stats`	날짜, Zone, GEO, 캠페인, 운영체제(OS), 시간 또는 트래픽 소스를 기준으로 필터링하거나 그룹화한 통계를 조회합니다.
`advertiser_get_campaign`	Campaign ID를 사용하여 특정 캠페인의 상세 정보를 조회합니다.

캠페인 관리 도구

참고: 이 가이드의 예시에서는 AI가 모든 캠페인을 비활성(Inactive) 상태로 생성합니다. 이는 예산이 사용되기 전에 캠페인을 검토할 수 있도록 AI가 선택한 기본 설정일 뿐이며, 반드시 따라야 하는 규칙은 아닙니다. 캠페인을 비활성 상태로 생성하거나 즉시 시작하고 싶다면, 요청 시 이를 명확하게 지정해 주세요.

도구	기능
`advertiser_create_campaign`	새 캠페인을 생성합니다.
`advertiser_update_campaign`	캠페인 설정을 부분적으로 수정합니다.
`advertiser_start_campaign`	승인된 캠페인을 시작합니다.
`advertiser_stop_campaign`	실행 중인 캠페인을 중지합니다.
`advertiser_archive_campaign`	캠페인을 보관함으로 이동합니다.
`advertiser_unarchive_campaign`	보관함에서 캠페인을 복원합니다.
`advertiser_set_bid`	Wildcard GEO의 입찰가(Bid)를 변경합니다.
`advertiser_set_destination_url`	Popunder 캠페인의 목적지 URL을 변경합니다.
`advertiser_replace_domain`	Advertiser 계정의 모든 광고에서 특정 도메인을 일괄 변경합니다.

소스 블랙리스트 관리 도구

도구	기능
`advertiser_get_blacklist`	캠페인의 소스 블랙리스트를 조회합니다.
`advertiser_add_to_blacklist`	블랙리스트에 소스를 추가합니다.
`advertiser_remove_from_blacklist`	블랙리스트에서 소스를 제거합니다.
`advertiser_clear_campaign_blacklist`	캠페인의 블랙리스트를 모두 삭제합니다.
`advertiser_set_blacklist`	블랙리스트 전체를 교체하고 캠페인을 BLACKLIST 모드로 전환합니다.

소스 화이트리스트 관리 도구

도구	기능
`advertiser_get_whitelist`	캠페인의 소스 화이트리스트를 조회합니다.
`advertiser_add_to_whitelist`	화이트리스트에 소스를 추가합니다.
`advertiser_remove_from_whitelist`	화이트리스트에서 소스를 제거합니다.
`advertiser_clear_campaign_whitelist`	캠페인의 화이트리스트를 모두 삭제합니다.
`advertiser_set_whitelist`	화이트리스트 전체를 교체하고 캠페인을 WHITELIST 모드로 전환합니다.