MCP 연동 — KoreanAds

1499 광고 상품

745 가격 검증 상품

1238 A/B 등급 상품

63 매체 서브타입

📡

MCP란?

Model Context Protocol (MCP)은 AI 모델이 외부 데이터와 도구에 접근할 수 있게 해주는 개방형 프로토콜입니다. KoreanAds는 MCP 서버를 통해 12가지 전문 도구를 제공하여, AI가 한국 광고 상품 데이터베이스에 실시간으로 접근하고 전문적인 광고 전략까지 생성할 수 있게 합니다.

핵심 사용 사례

KoreanAds MCP는 광고 탐색, 비교 판단, 예산 배분을 AI 대화 안에서 끝내도록 설계되어 있습니다.

Find

브리프와 예산에 맞는 광고 상품을 자연어로 찾습니다.

Evaluate

가격 신뢰도와 오디언스/타겟 근거로 왜 맞는 상품인지 설명합니다.

Allocate

검증된 가격 상품만으로 실행 가능한 미디어믹스를 구성합니다.

브리프에서 아웃리치까지 한 흐름으로

기술 데모가 아니라 실제 미디어 플래닝과 영업 커뮤니케이션에 바로 쓰는 흐름을 기준으로 구성했습니다.

에이전시 플래닝

AI에게 타겟, 예산, KPI를 설명하면 KoreanAds MCP가 후보 매체와 추천 근거를 함께 제시합니다.

브랜드 구매 검토

후보 상품을 비교한 뒤 문의 초안을 만들어 매체사 또는 세일즈 팀과 바로 대화를 시작할 수 있습니다.

글로벌 팀 핸드오프

영어와 중국어 인터페이스, MCP 툴 설명, 구조화된 응답으로 한국 시장 정보를 비한국어 팀에도 전달하기 쉽습니다.

🛠️ 제공 도구

MCP를 통해 12가지 전문 도구를 사용할 수 있습니다

🔍 검색 · 조회

🔍 search_ad_products

자연어로 광고 상품을 검색합니다. 벡터 시맨틱 검색 + SQL 폴백으로 예산·서브타입·품질 점수 필터링까지 지원합니다.

query 필수 — 검색어 (어떤 언어든 가능)

media_type 선택 — 매체 유형 (디지털, TV, OOH 등)

media_subtype 선택 — 매체 서브타입 (검색, 디스플레이, 소셜, 동영상 등)

max_budget_krw 선택 — 최대 예산 (원)

min_quality_score 선택 — 최소 품질 점수 (0-100)

top_k 선택 — 최대 결과 수 (기본 5)

📋 get_product_detail

특정 광고 상품의 전체 상세 정보를 조회합니다. 가격, 타겟팅, 스펙, KPI 벤치마크 등 모든 정보를 포함합니다.

product_id 필수 — 상품 ID

⭐ get_top_quality_products

데이터 품질 점수가 가장 높은 프리미엄 광고 상품을 품질 순으로 브라우징합니다. 키워드 없이 탐색 가능합니다.

limit 선택 — 최대 결과 수 (기본 10)

media_type 선택 — 매체 유형 (디지털, TV, OOH 등)

media_subtype 선택 — 매체 서브타입 (검색, 디스플레이, 소셜, 동영상 등)

🏢 get_media_owner_portfolio

특정 매체사(카카오, 네이버, 토스 등)가 보유한 전체 광고 상품 포트폴리오와 가격 범위를 조회합니다.

media_owner_name 필수 — 매체사 이름

📊 분석 · 전략

🎯 recommend_for_brief

캠페인 브리프에 맞는 광고 상품을 DB 근거만으로 추천합니다. 검증된 상품 후보와 추천 이유를 grounded JSON으로 반환합니다.

brief 필수 — 캠페인 브리프

budget 선택 — 예산

media_type 선택 — 매체 유형 (디지털, TV, OOH 등)

media_subtype 선택 — 매체 서브타입 (검색, 디스플레이, 소셜, 동영상 등)

📊 build_media_mix_from_db

DB의 실제 광고 상품으로 미디어 믹스(예산 배분안)를 자동 생성합니다. 가격 검증된 상품만 포함하며, 채널별 비중과 예산을 계산합니다.

brief 필수 — 캠페인 설명

monthly_budget_krw 필수 — 월 예산 (원)

media_type 선택 — 매체 유형 (디지털, TV, OOH 등)

media_subtype 선택 — 매체 서브타입 (검색, 디스플레이, 소셜, 동영상 등)

🔄 generate_full_funnel_strategy

인지→고려→전환 3단계 풀퍼널 마케팅 전략을 DB 상품 기반으로 자동 생성합니다. 예산을 40/30/30으로 분배합니다.

brief 필수 — 캠페인 브리프

monthly_budget_krw 필수 — 월 예산 (원)

💰 analyze_market_pricing

매체 카테고리별 시장 가격 벤치마크를 분석합니다. CPM/CPC/CPV 평균 단가와 예산 기준을 제공합니다.

media_type 선택 — 매체 유형 (디지털, TV, OOH 등)

media_subtype 선택 — 매체 서브타입 (검색, 디스플레이, 소셜, 동영상 등)

⚡ 유틸리티

⚖️ compare_products

2~5개 광고 상품을 가격·타겟팅·과금 방식·KPI 기준으로 나란히 비교합니다.

product_ids 필수 — 상품 ID 목록 (2~5개)

📈 simulate_campaign_perf

특정 광고 상품과 예산을 입력하면 CPM/CPC/CPV 단가 기반으로 예상 노출수, 클릭수, 조회수를 시뮬레이션합니다.

product_id 필수 — 상품 ID

budget_krw 필수 — 예산 (원)

🧭 check_db_coverage

사용자 쿼리가 DB 범위인지 판단하는 라우팅 도구입니다. 트렌드, 카피 작성 등 DB 외 요청을 자동 분류합니다.

query 필수 — 검색어 (어떤 언어든 가능)

📉 get_db_stats

DB 전체 통계를 조회합니다. 총 상품 수, 매체 유형별 분포, 데이터 완성도, 평균 품질 점수 등을 포함합니다.

— No parameters required —

🌐 엔드포인트

사용 환경에 따라 적절한 엔드포인트를 선택하세요

권장

Streamable HTTP

https://koreanads.com/mcp

최신 MCP 표준. Claude Desktop, Cursor 등 대부분의 클라이언트에서 지원합니다.

레거시

SSE (Server-Sent Events)

https://koreanads.com/sse

구버전 MCP 클라이언트를 위한 SSE 호환 엔드포인트입니다.

ChatGPT

OpenAPI Actions

https://koreanads.com/openapi-actions.json

Custom GPT Actions에서 바로 가져올 수 있는 slim OpenAPI 스키마입니다. MCP가 아니라 HTTP Actions 방식으로 연결합니다.

ChatGPT Custom GPT / HTTP Actions

Custom GPT에서 KoreanAds HTTP API를 직접 붙이고 싶다면 이 방법을 쓰세요. MCP 앱 경로와는 별개이며, 검색·비교·상세·미디어 믹스를 HTTP Actions로 호출합니다.

1

Custom GPT 열기

ChatGPT에서 Create a GPT 또는 GPT 설정 화면으로 이동한 뒤 Configure 탭에서 Actions를 엽니다.

2

OpenAPI 가져오기

아래 URL을 Actions의 스키마 URL로 입력하세요.

OpenAPI URL

https://koreanads.com/openapi-actions.json

3

지침 붙여넣기

Instructions에는 아래 내용을 그대로 넣으세요. 기본 원칙은 <strong>API 우선, grounded JSON 우선</strong>입니다.

Custom GPT Instructions

HTTP API를 직접 사용하세요.

우선 사용하는 도구:
- 광고 상품 검색: POST /api/tools/search
- 상품 상세 조회: GET /api/tools/products/{product_id}
- 상품 비교: POST /api/tools/compare
- DB 통계 조회: GET /api/tools/stats
- 매체사 포트폴리오 조회: GET /api/tools/media-owner-portfolio
- 미디어 믹스 생성: POST /api/strategy/media-mix
- 브리프 기반 grounded 추천: POST /api/strategy/recommend

운영 규칙:
- 가능한 한 문장 생성보다 직접 JSON 도구 호출을 우선하세요.
- MCP에서는 grounded JSON 결과만 사용하세요.
- 사용자가 광고 상품을 찾고 싶다고 하면 먼저 /api/tools/search를 호출하세요.
- 사용자가 특정 상품 2~5개 비교를 원하면 /api/tools/compare를 호출하세요.
- 사용자가 특정 상품 하나의 상세 정보를 원하면 /api/tools/products/{product_id}를 호출하세요.
- 사용자가 예산 배분안이나 미디어 플랜을 원하면 /api/strategy/media-mix를 호출하세요.
- 사용자가 브리프 기반 추천을 원하면 /api/strategy/recommend를 호출하세요.
- 응답할 때는 먼저 도구 결과에 있는 사실과 수치를 기반으로 설명하고, 필요한 경우에만 짧은 해설을 덧붙이세요.
- API 결과에 없는 상품 정보나 가격 정보를 추정해서 만들어내지 마세요.
- 상품 ID가 필요한 경우 먼저 검색 결과에서 ID를 찾은 뒤 다음 도구를 호출하세요.
- 불필요한 장문 전략 문서를 생성하지 마세요.

4

운영 방식

검색/비교/상세/통계/추천은 Actions 결과의 JSON 사실값을 그대로 우선 사용하세요. Apps(MCP)와 Actions는 하나의 GPT에서 동시에 쓸 수 없습니다. 장문 전략 생성은 MCP 범위에서 제외합니다.

⚙️ 연동 방법

사용 중인 AI 도구에 맞는 설정 방법을 따라하세요

1

설정 파일 열기

Claude Desktop → Settings → Developer → Edit Config 클릭

또는 직접 파일을 편집하세요:

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

2

MCP 서버 등록

아래 JSON을 설정 파일에 추가하세요:

claude_desktop_config.json

{
  "mcpServers": {
    "koreanads": {
      "url": "https://koreanads.com/mcp"
    }
  }
}

3

Claude 재시작

설정 저장 후 Claude Desktop을 재시작하면 도구 목록에 KoreanAds가 나타납니다.

1

MCP 설정 열기

Cursor → Settings → MCP 탭으로 이동

2

서버 추가

+ Add new MCP server 클릭 후 아래 정보를 입력:

.cursor/mcp.json

{
  "mcpServers": {
    "koreanads": {
      "url": "https://koreanads.com/mcp"
    }
  }
}

3

사용하기

Agent 모드에서 "한국 광고 상품 검색해줘" 같은 자연어로 MCP 도구를 호출할 수 있습니다.

1

ChatGPT에서 연동하기

ChatGPT 웹에서 Settings → Apps로 이동하세요. 사용 가능 여부는 요금제와 워크스페이스 권한에 따라 달라집니다. 자체 MCP 앱을 등록하려면 developer mode를 켠 뒤 Apps → Create 또는 Workspace Settings → Apps → Create를 사용합니다.

2

서버 URL 입력

원격 MCP 서버 URL을 입력하세요. ChatGPT는 로컬 MCP 서버를 지원하지 않으므로 공개 HTTPS 엔드포인트를 사용해야 합니다:

MCP Server URL

https://koreanads.com/mcp

3

연결 및 업데이트 반영

새 채팅에서 Apps 메뉴로 KoreanAds를 선택해 사용하세요. 관리자가 한 번 승인한 뒤에는 ChatGPT가 도구 스냅샷을 고정해서 쓰므로, MCP 도구를 바꿨다면 Workspace Settings → Apps → Refresh 후 다시 Publish해야 합니다.

1

HTTP로 직접 연결

MCP 클라이언트 라이브러리를 사용해 프로그래밍 방식으로 연결할 수 있습니다:

Python (fastmcp)

from fastmcp import Client

async with Client("https://koreanads.com/mcp") as client:
    result = await client.call_tool(
        "search_ad_products",
        {"query": "20대 여성 타겟 SNS 광고"}
    )
    print(result)

TypeScript

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const transport = new StreamableHTTPClientTransport(
  new URL("https://koreanads.com/mcp")
);
const client = new Client({ name: "my-app", version: "1.0" });
await client.connect(transport);

const result = await client.callTool({
  name: "search_ad_products",
  arguments: { query: "20대 여성 타겟 SNS 광고" }
});

2

SSE 레거시 방식

구버전 MCP 클라이언트는 SSE 엔드포인트를 사용하세요:

SSE URL

https://koreanads.com/sse

🚀 지금 바로 시작하세요

AI 도구에 KoreanAds를 연동하고, 대화만으로 광고 매체를 검색하고 비교하고 미디어 믹스를 추천받으세요.

광고 검색 해보기 미디어 믹스 추천

AI 도구에 광고 데이터를 연결하세요

MCP란?

핵심 사용 사례

Find

Evaluate

Allocate

브리프에서 아웃리치까지 한 흐름으로

에이전시 플래닝

브랜드 구매 검토

글로벌 팀 핸드오프

🛠️ 제공 도구

🔍 검색 · 조회

📊 분석 · 전략

⚡ 유틸리티

🌐 엔드포인트

Streamable HTTP

SSE (Server-Sent Events)

OpenAPI Actions

ChatGPT Custom GPT / HTTP Actions

Custom GPT 열기

OpenAPI 가져오기

지침 붙여넣기

운영 방식

⚙️ 연동 방법

설정 파일 열기

MCP 서버 등록

Claude 재시작

MCP 설정 열기

서버 추가

사용하기

ChatGPT에서 연동하기

서버 URL 입력

연결 및 업데이트 반영

HTTP로 직접 연결

SSE 레거시 방식

🚀 지금 바로 시작하세요

AI 도구에
광고 데이터를 연결하세요