> For the complete documentation index, see [llms.txt](https://businessdaangn.gitbook.io/business.daangn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://businessdaangn.gitbook.io/business.daangn/ads-pro/tools/mcp.md).

# 당근 광고 MCP

#### 1. 소개

당근 광고 MCP는 평소 쓰던 AI 도구에 당근 광고 계정을 연결해, 질문 한 줄로 광고 성과를 확인하고 분석하는 도구예요.

MCP(Model Context Protocol)는 AI가 외부 서비스의 데이터를 가져올 수 있게 해주는 표준 연결 방식이에요. AI 도구에 당근 광고 계정을 한 번 연결해두면, 필요할 때마다 AI가 당근 계정의 데이터를 직접 가져와 답변에 활용해요.

개발 지식이나 API 키 발급 없이 몇 분이면 연결할 수 있어요.

**MCP 서버 주소**

```
https://ads-mcp.kr.karrotmarket.com/mcp
```

***

#### 2. 연결 방법

**클로드(Claude)**

1. claude.ai에 접속하거나 Claude 데스크톱 앱을 열어요.
2. \[설정] → \[커넥터] → \[추가] 버튼을 눌러요.
3. 커스텀 커넥터 추가 화면에 아래와 같이 채우고 추가해요.
   * 이름: `karrot-ads-mcp`
   * MCP 서버 URL: `https://ads-mcp.kr.karrotmarket.com/mcp`
4. \[연결] 버튼을 눌러 당근 계정으로 인증해요.

**클로드 코드(Claude Code)**

터미널에서 클로드 로그인 후 아래 명령어를 실행하면 바로 등록돼요.

```
claude mcp add --transport http karrot-ads-mcp https://ads-mcp.kr.karrotmarket.com/mcp
```

등록한 뒤 `/mcp` 명령어로 연결 상태를 확인하고, \[Authenticate] 항목을 선택해 인증해요.

**챗GPT(ChatGPT) Desktop**

1. \[설정] → \[플러그인]으로 이동해요.
2. 우측 상단 \[추가] → \[MCP 서버 추가] 버튼을 눌러요.
3. 맞춤형 MCP에 연결 항목을 아래와 같이 채우고 저장해요.
   * 이름: `karrot-ads-mcp`
   * 유형: 스트리밍 가능한 HTTP
   * URL 서버 주소: `https://ads-mcp.kr.karrotmarket.com/mcp`
4. \[플러그인] → \[MCP] 탭에서 `karrot-ads-mcp`를 찾고 \[인증] 버튼을 눌러 당근 계정으로 인증을 끝내요.

**챗GPT(ChatGPT) 웹**

1. chatgpt.com에 접속해요.
2. 설정 > 보안 및 로그인에서 개발자 모드를 켜요.
3. 설정 > 플러그인으로 이동해 우측 상단 + 버튼을 누른 뒤, 사용자 지정 MCP 서버 만들기를 선택해요.
4. 새 플러그인 화면 왼쪽 아래의 MCP 앱 만들기를 눌러요.
5. 항목을 다음과 같이 입력해요.
   * 이름: `karrot-ads-mcp`
   * 연결: 서버 URL
   * 서버 URL 주소: `https://ads-mcp.kr.karrotmarket.com/mcp`
   * 인증: OAuth
6. 맞춤형 MCP 서버 이용 시 주의사항을 확인하고 만들기를 눌러요.
7. 당근 로그인 화면이 열리면 당근비즈니스 계정으로 로그인하고 접근 권한을 허용해요.
8. 인증이 완료되면 새로운 대화에서 mcp를 사용할 수 있어요.

**코덱스(Codex)**

아래 명령어로 MCP 서버를 등록한 뒤 인증을 진행해요. 브라우저가 열리면 로그인하고 접근 권한을 허용하면 연결이 끝나요.

```
codex mcp add karrot-ads-mcp --url https://ads-mcp.kr.karrotmarket.com/mcp
codex mcp login karrot-ads-mcp
```

> ⚠️ 챗GPT 웹에서는 아직 `karrot-ads-mcp` 연결을 지원하지 않아요. 올해 중 지원할 예정이에요.

***

#### 3. 확인할 수 있는 내용

| 구분        | 내용                                               |
| --------- | ------------------------------------------------ |
| 광고 계정 확인  | 소유하거나 운영 중인 광고 계정 목록과 잔액                         |
| 광고 현황 조회  | 집행 중인 캠페인·광고그룹·소재의 설정과 상태                        |
| 성과 확인과 진단 | 기간별 노출 수, 클릭 수, CTR, CPC, 전환 등 주요 지표와 성과가 달라진 이유 |

**이렇게 질문해 보세요**

* "어제 하루 광고 성과를 노출, 클릭, CTR, CPC, 전환 기준으로 요약해줘"
* "지난주 대비 이번 주 CPC가 어떻게 변화했는지 분석해줘"
* "최근 14일간 소재별 성과를 전환당 비용이 낮은 순으로 정렬해줘"

***

#### 4. 이용 전 확인해 주세요

* 클로드(Claude)와 챗GPT(ChatGPT) 클라이언트만 연결할 수 있어요.
* Claude Sonnet-5 이상, ChatGPT-5.6 Terra 이상의 모델에서 이용을 권장해요.
* 간편모드, 전문가모드 상관없이 모두 이용할 수 있어요.
* 연결할 때 당근비즈니스 계정 인증을 거치고, 기존 계정 권한을 그대로 따라요. MCP를 연결한다고 해서 원래 볼 수 없던 데이터에 추가로 접근할 수 있게 되지는 않아요.
* 지금은 조회 기능만 제공해요. 광고 생성, 수정 기능은 이후에 추가할 예정이에요.
* 지역, 성별, 연령 등 세부 기준은 한 번에 최대 2개까지 조합할 수 있고, 지역은 단독으로만 조회할 수 있어요.
* 소재 이미지와 썸네일 조회는 지원하지 않아요.

***

**관련 가이드**

* 성과 확인하기
* 간편모드 광고 성과 보는 방법