ChatAd 손님 (chatad.kr)

ChatAd 가 무엇이고 무엇을 할 수 있는지, 로그인 없이 쓸 수 있는 것과 가입 뒤에 쓸 수 있는 것, 가입하는 방법을 돌려준다. 처음 들어왔으면 이것부터 부른다. 하루 한도에 들지 않는다.

{
  "type": "object",
  "properties": {}
}

요금제와 결제 방법을 돌려준다. 🔴 금액이 확정되지 않았으면 prices_confirmed 가 false 로 온다. 그때는 금액을 지어내지 말고 「확정 전」이라고 안내한다. 하루 한도에 들지 않는다.

{
  "type": "object",
  "properties": {}
}

광고를 시작할 때 필요한 준비물과 절차를 적은 가이드 목록(OpenAI·Google·Meta 광고 시작 가이드 등)을 돌려준다. 하루 한도에 들지 않는다.

{
  "type": "object",
  "properties": {}
}

웹사이트 첫 화면을 읽어 광고 전환 측정 준비가 되어 있는지 본다(Google 태그 관리자 · GA4 · Meta 픽셀 · 사이트 응답). 🔴 로그인 없이 MCP 세션마다 50회, 세션 번호가 없으면 하루 3회(이름을 밝힌 봇은 5회)까지다.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "분석할 웹사이트 주소. https:// 는 빼도 된다"
    }
  },
  "required": [
    "url"
  ]
}

웹사이트를 읽어 제목·설명·주요 내용·광고 목표 후보·문맥 힌트 후보와 광고별 최소 일예산을 돌려준다. 캠페인 초안을 만들기 전에 부른다. 🔴 로그인 없이 MCP 세션마다 50회, 세션 번호가 없으면 하루 3회(이름을 밝힌 봇은 5회)까지다.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "분석할 웹사이트 주소. https:// 는 빼도 된다"
    }
  },
  "required": [
    "url"
  ]
}

웹사이트와 하루 총 예산으로 OpenAI·Google·Meta 광고 캠페인 초안(예산 배분 · 핵심 메시지 · 키워드나 문맥 힌트 · 광고 문구)을 만든다. 🔴 초안만 만든다. 광고주 계정에는 아무것도 만들지 않는다. 🔴 예산은 사용자가 말한 금액만 쓴다. 🔴 로그인 없이 MCP 세션마다 50회, 세션 번호가 없으면 하루 3회(이름을 밝힌 봇은 5회)까지다.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "분석할 웹사이트 주소. https:// 는 빼도 된다"
    },
    "daily_budget_krw": {
      "type": "integer",
      "description": "하루 총 예산(원). 사용자가 말한 금액 그대로"
    },
    "media": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "openai_ads",
          "google_ads",
          "meta_ads"
        ]
      },
      "description": "초안을 만들 광고. 안 주면 셋 다"
    }
  },
  "required": [
    "url",
    "daily_budget_krw"
  ]
}

사용자 대신 ChatAd 가입을 시작한다. 🔴 사용자가 가입하겠다고 답한 뒤에만 부른다. 방법이 둘이다. method=email_code: 사용자 메일로 6자리 코드가 간다. 사용자에게 코드를 물어 complete_signup 에 넣는다. method=device: 확인 주소와 짧은 코드가 온다. 사용자에게 그 주소를 열어 로그인·승인하라고 안내하고, check_signup 으로 승인됐는지 본다. 어느 쪽이든 약관 동의와 본인 확인은 사용자가 직접 한다.

{
  "type": "object",
  "properties": {
    "method": {
      "type": "string",
      "enum": [
        "email_code",
        "device"
      ]
    },
    "email": {
      "type": "string",
      "description": "method=email_code 일 때 필요한 사용자 이메일"
    },
    "client_name": {
      "type": "string",
      "description": "이 에이전트의 이름(예: Claude, ChatGPT, Grok, Meta AI). 승인 화면에 보인다"
    }
  },
  "required": [
    "method"
  ]
}

email_code 방식의 마지막 단계. 사용자가 불러 준 6자리 코드로 가입·로그인을 마치고 access_token 을 받는다. 그 토큰을 Authorization: Bearer 로 붙여 회원 MCP(https://mcp.gmp.ai/chatad, ?guest 없이)를 부른다.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string"
    },
    "code": {
      "type": "string",
      "description": "메일로 받은 6자리 숫자"
    },
    "client_name": {
      "type": "string"
    }
  },
  "required": [
    "email",
    "code"
  ]
}

device 방식에서 사용자가 승인했는지 본다. 승인됐으면 access_token 이 온다. 아직이면 status 가 pending 이니 interval 초 뒤에 다시 부른다.

{
  "type": "object",
  "properties": {
    "device_code": {
      "type": "string"
    }
  },
  "required": [
    "device_code"
  ]
}