MCP 연결 가이드
Claude·ChatGPT에 ChatAd를 추가합니다
AI 서비스에 서버 주소를 추가하면 ChatAd 승인 화면이 열립니다. 로그인한 뒤 접근을 허용할 워크스페이스를 선택하면 연결이 완료됩니다. AI 서비스에 비밀번호나 API 키를 입력하지 않습니다. 서버 주소는 아래 안내 카드에서 복사할 수 있습니다.
연결 3단계
가입, 광고주 계정 연결, AI 서비스 추가
조회하려면 워크스페이스에 광고주 계정이 연결되어 있어야 합니다.
- 1ChatAd 시작Google 계정이나 이메일 인증으로 시작합니다. 별도 회원가입 절차는 없습니다.
- 2광고주 계정 연결OpenAI 광고 API 키를 등록하고 Google·Meta 광고주 계정을 연결합니다. 사용 중인 플랫폼만 연결해도 됩니다.
- 3AI 서비스에 추가아래 Claude·ChatGPT 안내에 따라 서버 주소를 추가하고, ChatAd 승인 화면에서 워크스페이스를 선택한 뒤 승인합니다.
Claude에 연결
버튼을 누르면 정보가 입력된 추가 창이 열립니다
- 1아래 버튼을 누르면 새 창에서 이름(ChatAd)과 주소가 입력된 Claude 커넥터 추가 창이 열립니다.
- 2‘추가’에 이어 ‘연결’을 누르면 ChatAd 승인 화면이 열립니다.
- 3연결할 워크스페이스를 선택하고 승인하면 연결이 완료됩니다.
ChatGPT에 연결
버튼을 누르면 주소가 복사되고 ChatGPT가 열립니다
- 1처음 한 번만: ChatGPT 설정 → 보안 및 로그인(Security and login)에서 개발자 모드(Developer mode)를 활성화하십시오.
- 2아래 버튼을 누르면 연결 주소가 복사되고, 새 창에서 ChatGPT 플러그인 화면이 열립니다.
- 3+ 버튼을 누르고 이름에 ChatAd를 입력한 뒤, 연결 주소 칸에 붙여 넣고 생성합니다.
- 4ChatAd 승인 화면에서 워크스페이스를 선택하면 연결이 완료됩니다.
개발자 모드는 Plus·Pro·Business·Enterprise·Edu 요금제에서 활성화할 수 있습니다. + 버튼이 보이지 않으면 ChatGPT 설정에서 개발자 모드가 활성화되어 있는지 확인하십시오.
https://mcp.gmp.ai/chatadClaude Code 및 기타 MCP 클라이언트
claude mcp add --transport http chatad https://mcp.gmp.ai/chatadStreamable HTTP와 OAuth 2.1(동적 클라이언트 등록·PKCE)을 지원하는 클라이언트라면 같은 주소로 연결할 수 있습니다.
제공 도구
도구 35종과 절차서 7편
절차서(skill)는 AI가 도구를 쓰기 전에 먼저 확인하는 짧은 작업 순서입니다. 조회 순서와 오해하기 쉬운 부분이 정리되어 있어, 처음 연결한 AI도 같은 방식으로 작업합니다. 항목을 선택하면 펼쳐집니다.
제공 도구 35종방패 표시는 2단 승인을 거치는 도구입니다
시작과 절차서
AI가 처음 연결되었거나 작업이 막혔을 때 먼저 조회합니다.
- skill_list
- 사용 절차서 목록을 조회합니다. 도구 사용 순서와 오해하기 쉬운 부분이 정리되어 있습니다.
- skill_get
- 절차서 한 편의 본문을 조회합니다.
- get_me
- 연결한 계정, 접근 가능한 워크스페이스, 플랫폼별 연결 상태를 한 번에 조회합니다.
- list_workspaces
- 이 연결로 관리할 수 있는 워크스페이스 목록을 조회합니다.
아침 브리핑과 확인할 일
ChatAd 에이전트가 매일 아침 정리한 결과를 대화에서 조회합니다.
- get_briefing
- 전일 광고비·클릭·전환을 플랫폼별로 집계해 직전 7일 평균과 비교한 브리핑과 확인할 일을 조회합니다.
- list_findings
- 확인할 일 목록과 근거 수치를 조회합니다.
- resolve_finding
- 확인할 일을 ‘처리함’ 또는 ‘넘김’으로 표시합니다. 기록만 변경되며 광고 설정은 변경되지 않습니다.
성과와 설정 조회
조회 전용이므로 광고 설정에 영향을 주지 않습니다.
- list_campaigns
- 세 플랫폼의 캠페인 목록과 게재 여부를 하나의 목록으로 조회합니다.
- list_product_feeds
- OpenAI 광고주 계정의 상품 피드 목록과 상품 피드 기능이 열려 있는지를 조회합니다.
- current_settings
- 캠페인의 현재 예산과 광고그룹별 입찰가를 조회합니다. 금액을 변경하기 전에 사용합니다.
- campaign_performance
- 캠페인 하나의 노출·클릭·클릭률·광고비·전환을 조회합니다.
- ad_group_performance
- 광고그룹별 성과를 조회합니다.
- creative_performance
- 소재별 성과를 조회합니다. 반응이 좋은 문구와 이미지를 비교할 때 사용합니다.
- compare_campaigns
- 모든 캠페인의 최근 성과를 한 표로 비교합니다.
- list_creatives
- 게재 중인 소재의 제목·설명·연결 주소·심사 상태를 조회합니다.
- why_not_serving
- 광고 미게재 원인을 캠페인·광고그룹·소재 순서로 진단하고, 계정 하루 지출 한도 도달 여부도 함께 확인합니다.
- list_change_history
- OpenAI Ads 광고주 계정의 변경 기록(누가·무엇을·언제)을 조회합니다. OpenAI 광고 관리자 화면에서 변경한 내용도 포함합니다.
- list_custom_audiences
- OpenAI Ads 광고주 계정의 맞춤 잠재고객 목록과 규모를 조회합니다. 명단 생성과 변경은 OpenAI 광고 관리자 화면에서 합니다.
- list_keywords
- Google 키워드와 키워드별 입찰가·품질평가점수·성과를 조회합니다.
- list_search_terms
- 실제 검색어와 해당 검색어에 연결된 키워드를 조회합니다.
- generate_keyword_ideas
- 키워드 후보와 월 검색량·경쟁도·입찰가 범위를 조회합니다.
- analyze_site
- 웹사이트의 주요 페이지를 분석해 캠페인 설계에 사용할 요점과 문맥 힌트 후보를 제공합니다.
- get_conversion_diagnostic
- OpenAI 광고의 전환이 측정되지 않는 원인을 측정 설정·서버 전송·광고 플랫폼의 전환 인정 순서로 진단합니다. 확인된 원인과 아직 단정할 수 없는 항목을 구분해 제공합니다.
- get_job_status
- 변경 작업의 처리 결과를 작업 번호로 다시 확인합니다.
변경
광고비가 걸린 변경은 변경 전후 값을 검토해 승인하신 뒤에 반영합니다.
- set_status
- 캠페인·광고그룹·소재의 게재를 시작하거나 일시중지합니다. 게재 시작은 승인을 거치며, 일시중지는 바로 반영합니다.
- set_budget
- 캠페인 예산을 변경합니다.
- set_bid
- 광고그룹 입찰가를 변경합니다. 여러 광고그룹을 같은 값으로 한 번에 변경할 수 있습니다.
- set_schedule
- ChatGPT 광고 캠페인의 게재 기간(시작일·종료일)을 변경합니다. 종료일로 지정하신 날까지 게재되며, 지출 기간이 달라지므로 승인을 거칩니다.
- set_context_hints
- ChatGPT 광고의 광고그룹에 대화 맥락 힌트를 설정합니다.
- edit_ad_creative
- 소재의 문구와 이미지를 수정합니다. 수정한 소재는 다시 심사를 받습니다.
- add_negative_keywords
- 제외 키워드를 등록해 해당 검색어에 광고가 노출되지 않도록 합니다.
생성
새로 만드는 캠페인·광고그룹·소재는 일시중지 상태로 만들어집니다.
- create_campaign
- 캠페인을 새로 만듭니다.
- create_ad_group
- 광고그룹을 새로 만듭니다.
- create_ad
- 소재를 만들어 심사를 요청합니다.
- add_keywords
- 광고그룹에 키워드를 등록합니다. 등록 즉시 노출될 수 있어 승인을 거칩니다.
절차서 7편
overview
처음 사용하는 순서
처음 연결했거나 어디서부터 시작할지 모를 때
creative-image
소재 이미지의 출처
소재에 잘못된 이미지가 붙었거나, 이미지를 정하지 못했다는 결과가 나올 때
performance
단계별 성과 조회
‘어느 소재의 반응이 좋은가’처럼 캠페인 합계로는 답할 수 없는 질문을 받았을 때
troubleshooting
문제 해결
같은 단계에서 두 번 이상 막혔을 때. 다른 도구를 찾기 전에 먼저 확인합니다
two-media
OpenAI 광고와 Google 광고의 차이
두 플랫폼을 함께 다룰 때 같은 용어가 다른 뜻으로 쓰이는 경우
morning-briefing
아침 브리핑과 확인할 일
매일 아침 광고 현황을 받거나, 에이전트가 찾은 확인할 일을 처리할 때
changelog
변경 사항
이전과 다르게 동작하거나, 예전 방식으로 익혀 둔 경우
MCP로 제공하지 않는 일
- 캠페인 삭제·보관 (되돌릴 수 없는 작업이므로 제공하지 않습니다)
- 소재 삭제 (같은 이유로 제공하지 않습니다. 사용하지 않는 소재는 set_status로 일시중지할 수 있습니다)
- OpenAI 캠페인 생성 (설정 항목이 많아 ChatAd 화면에서 진행합니다. Google 캠페인은 create_campaign으로 생성할 수 있습니다)
- 광고 API 키 등록·Google 계정 연결 (ChatAd 화면에서 진행합니다)
- 연결 주소 도메인의 심사 상태 조회 (OpenAI Ads가 조회 API를 제공하지 않습니다)
- 결제·청구서 조회
- 상품 피드 만들기·SFTP 접속 정보 발급·상품 피드 캠페인 생성 (준비 중입니다. 피드 목록과 상품 피드 기능이 열려 있는지는 list_product_feeds로 조회할 수 있습니다)
- Meta 새 소재로 광고 생성 (기존 페이스북 페이지 게시물로는 생성할 수 있습니다)
- Meta 캠페인 보관·소재 문구 수정·키워드 (Meta는 키워드 광고를 지원하지 않습니다)
- Meta 지면 고르기 (페이스북과 인스타그램에 함께 게재되며 지면은 선택할 수 없습니다)
MCP 서버 https://mcp.gmp.ai/chatad · 운영 (주)비즈스프링 · Claude는 Anthropic, ChatGPT는 OpenAI의 상표입니다. ChatAd는 각 회사와 제휴 관계가 아닙니다.