MCP 연동 가이드

📡

MCP란?

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

🛠️ 제공 도구

MCP를 통해 4가지 강력한 도구를 사용할 수 있습니다

🔍 search_ad_products

자연어로 광고 상품을 검색합니다. 벡터 시맨틱 검색으로 의미를 이해하여 관련성 높은 결과를 반환합니다.

query 필수 — 검색어

media_type 선택 — 매체 유형 필터

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

📋 get_product_detail

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

product_id 필수 — 상품 ID

🎯 recommend_for_brief

광고주의 브리프(요구사항)에 맞는 광고 상품을 추천합니다. 캠페인 목표와 예산을 고려합니다.

brief 필수 — 캠페인 브리프

budget 선택 — 예산

media_type 선택 — 매체 유형

📊 build_media_mix_from_db

DB의 실제 광고 상품으로 미디어 믹스(예산 배분안)를 자동 생성합니다. 채널별 비중과 예산을 계산합니다.

brief 필수 — 캠페인 설명

monthly_budget_krw 필수 — 월 예산 (원)

media_type 선택 — 매체 유형

🌐 엔드포인트

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

권장

Streamable HTTP

https://koreanads.com/mcp

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

레거시

SSE (Server-Sent Events)

https://koreanads.com/sse

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

⚙️ 연동 방법

사용 중인 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 → Connected Apps → Add MCP Server

2

서버 URL 입력

아래 URL을 입력하세요:

MCP Server URL

https://koreanads.com/mcp

3

확인

연결 후 대화에서 KoreanAds 도구가 자동으로 사용 가능해집니다.

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 도구에 광고 데이터를 연결하세요