adstage
데이터 허브

AI 분석 연결 (ChatGPT·Claude)

AdStage 를 AI 어시스턴트에 한 번 연결하면, 어시스턴트가 데이터 허브의 커넥터(광고 매체 비용·AdStage 어트리뷰션·통합 데이터)를 직접 조회해 질문에 답합니다. 연결은 읽기 전용이고, 연결할 때 승인한 조직만 볼 수 있습니다.

  • 서버 URL: https://api.adstage.app/mcp (대시보드 데이터 허브 > AI 분석 연결 에서 복사)
  • 인증: 본인 AdStage 계정으로 로그인해 승인(OAuth). 키를 붙여 넣지 않습니다.

1. 연결하기

어시스턴트방법
Claude (claude.ai·데스크톱)설정 > 사용자 지정 > 커넥터 > 추가 > 커스텀 커넥터 추가 → 이름 AdStage, 서버 URL 입력 → 추가 → Connect → AdStage 로그인·조직 선택·승인. Team/Enterprise 는 Owner 가 먼저 Organization settings > Connectors 에 추가
ChatGPT설정 > 통합 > 플러그인 > 추가 > MCP 서버 추가 → 이름 AdStage, 유형 스트리밍 가능한 HTTP, 서버 URL, 인증 OAuth → 연결(로그인)·조직 선택·승인. 이전 UI 는 Settings > Connectors > Advanced 에서 Developer mode 를 켠 뒤 Create
Claude Codeclaude mcp add --transport http adstage https://api.adstage.app/mcp 실행 후 세션에서 /mcp
Cursor·Gemini CLI·기타원격 MCP 서버(Streamable HTTP)로 URL 추가. 예: { "mcpServers": { "adstage": { "url": "https://api.adstage.app/mcp" } } }

메뉴 위치와 플랜별 차이, 여러 조직 연결, 연결 해제·만료는 AI 어시스턴트 연동 문서에 자세히 있습니다.

2. 데이터 허브 도구

연결하면 아래 도구가 추가로 보입니다. 어시스턴트가 질문에 맞춰 알아서 고릅니다.

도구하는 일
list_data_connectors연결된 소스와 연결 상태(연결됨·수집 확인 필요·연결 가능·준비 중)
get_connector_fields커넥터의 필드·계정·날짜 프리셋·필터 연산자
get_connector_datawindsor.ai 형 조회 — 필드·기간·and/or 필터를 골라 호출당 최대 500행
list_data_destinations시트·Looker Studio·Power BI·엑셀·Python·웹훅으로 보내는 방법
get_connector_connect_url소스를 연결하는 대시보드 링크(연결 자체는 브라우저에서)

기존 도구(query_attribution_report, get_funnel_report, query_retention_report, diagnose_tracking_setup 등)도 그대로 쓸 수 있습니다.

3. 이렇게 물어보세요

  • 최근 30일 구글 광고·메타·틱톡의 광고비, 클릭, CPM, 설치, ROAS 를 비교해 줘. 어디에 예산을 더 줘야 할까?
  • 지난주 광고비가 10만 원을 넘었는데 구매가 없는 메타 광고 세트를 보여줘.
  • 최근 90일 전체 채널의 주별 광고비와 AdStage 매출 추이를 표로 보여줘.
  • 이번 달 네이버 검색광고에서 CPC 가 가장 높은 키워드와 그 키워드가 만든 구매 수는?
  • 인스타그램 게재면과 페이스북 게재면의 설치당 비용을 비교해 줘.
  • 광고비에 비해 설치가 적어 보여. 트래킹 설정에 문제가 있는지 진단해 줘.

4. 잘 쓰는 요령

  • 조직을 말하세요. 여러 조직을 연결했다면 질문에 조직 이름을 넣어야 합니다(예: "트립톡 지난주 채널별 광고비").
  • 기간을 분명히. "지난달", "최근 4주"처럼 말하면 조직 타임존으로 계산합니다. 프리셋은 어제까지입니다.
  • 행이 많은 표(수천 행)는 AI 대화보다 데이터 API·시트가 맞습니다. 도구는 호출당 500행까지 돌려줍니다.
  • 숫자가 대시보드와 다르면 기간·필터·귀속 기간(전환 윈도)이 같은지 확인하세요. 같은 조건이면 같은 값이 나옵니다.
  • 어시스턴트가 무엇을 조회했는지는 설정 > AI 어시스턴트 연동 > 호출 이력에서 확인할 수 있습니다.

목차