---
title: 마켓탭 MCP 연결하기
description: ChatGPT·Claude·Claude Code 에 마켓탭을 연결해 캠페인 성과를 확인하고 초안을 만드는 방법
---

## 개요

마켓탭은 ChatGPT 플러그인 디렉토리와 Claude 커넥터 디렉토리에 등록되어 있습니다. 각 서비스에서 마켓탭을 찾아 연결하고 콘솔 계정으로 로그인하면, 대화 중에 캠페인 성과, 오디언스, 발송 이력, 가이드 문서를 조회하고 캠페인·오디언스 초안을 만들 수 있습니다.

실제 발송과 캠페인 활성화는 하지 않습니다. AI 가 만드는 것은 작성중(DRAFT) 상태의 초안이고, 발송은 사람이 콘솔에서 확인한 뒤에 합니다. 예외는 테스트 발송 하나로, 콘솔에 등록해 둔 테스트 유저에게만 실제 메시지가 나갑니다.

| 항목 | 값 |
|---|---|
| 지원 클라이언트 | ChatGPT, Claude(웹·데스크톱), Claude Code, Codex CLI 등 원격 MCP 를 지원하는 클라이언트 |
| 로그인 | 마켓탭 콘솔 계정으로 OAuth |
| 접근 범위 | 로그인한 계정이 콘솔에서 볼 수 있는 프로젝트 |
| 쓰기 범위 | 캠페인·오디언스 초안 만들기와 수정, 테스트 발송 |
| 서버 주소 | `https://api.console.marketap.io/api/mcp` (디렉토리를 쓰지 않고 직접 등록할 때만 필요) |

## 연결하기

ChatGPT 와 Claude 는 디렉토리에서 찾아 연결합니다. 주소를 입력할 필요가 없습니다. Claude Code 와 Codex 같은 CLI 는 서버 주소를 직접 등록합니다.

### ChatGPT

1. ChatGPT 에서 **설정** → **플러그인** → **플러그인 둘러보기** 로 갑니다.
2. 검색창에 `마켓탭` 또는 `Marketap` 을 입력하고 마켓탭을 엽니다.
3. **연결** 을 누릅니다.
4. 마켓탭 로그인 화면이 열리면 콘솔 계정으로 로그인하고, 동의 화면에서 권한을 승인합니다.
5. 새 대화를 시작하고 입력창의 **+** 메뉴에서 마켓탭을 선택합니다.

연결은 ChatGPT 계정 단위라 한 번만 하면 됩니다. 이후 대화에서는 마켓탭을 선택하기만 하면 됩니다.

### Claude (웹·데스크톱)

[Claude 디렉토리의 마켓탭 페이지](https://claude.ai/directory/marketap)에서 **연결** 을 누르고 콘솔 계정으로 로그인합니다.

### Claude Code

Claude 에서 마켓탭을 연결했고 Claude Code 에 같은 claude.ai 계정으로 로그인했다면 따로 할 일이 없습니다. `claude mcp list` 에 claude.ai 커넥터로 표시되고 바로 쓸 수 있습니다.

Claude 에서 연결하지 않았거나 API 키로 Claude Code 를 쓰는 경우에는 원격 HTTP 서버로 직접 추가합니다.

```bash
claude mcp add --transport http marketap https://api.console.marketap.io/api/mcp
```

등록만 하고 인증은 아직 하지 않은 상태라, `claude mcp list` 에서 인증 필요로 보일 수 있습니다. 세션에서 마켓탭 도구가 필요한 질문을 하면 브라우저 OAuth 흐름이 열립니다. 로그인하고 동의하면 Claude Code 가 발급된 토큰으로 서버를 호출합니다.

```bash
claude mcp list
claude mcp get marketap
```

정상 연결이면 `claude mcp get marketap` 이 `Type: http` 와 `Status: ✔ Connected` 를 보여 줍니다.

`.mcp.json` 으로 관리할 때는 로컬 실행 명령이 아니라 원격 주소를 씁니다.

```json
{
  "mcpServers": {
    "marketap": {
      "type": "http",
      "url": "https://api.console.marketap.io/api/mcp"
    }
  }
}
```

프로젝트 단위로 공유하려면 `--scope project` 를 붙여 추가합니다. 다른 사람이 그 저장소를 열면 승인 대기 상태로 보이고, 각자 승인한 뒤 자기 계정으로 로그인합니다.

### Codex CLI

`--url` 로 원격 서버를 추가합니다.

```bash
codex mcp add marketap --url https://api.console.marketap.io/api/mcp
```

추가 직후 인증이 끝나지 않았거나 토큰을 다시 받아야 하면 로그인 명령을 실행합니다.

```bash
codex mcp login marketap
```

설정 파일로 직접 관리할 때는 `~/.codex/config.toml` 에 적습니다.

```toml
[mcp_servers.marketap]
url = "https://api.console.marketap.io/api/mcp"
```

```bash
codex mcp get marketap
codex mcp list
```

### 그 밖의 클라이언트

원격 MCP 와 OAuth 로그인을 지원하는 클라이언트라면 서버 주소를 등록해 연결할 수 있습니다.

| 설정 항목 | 값 |
|---|---|
| 서버 주소 | `https://api.console.marketap.io/api/mcp` |
| 연결 방식 | Streamable HTTP (STDIO 아님) |
| 인증 | OAuth |
| OAuth 클라이언트 ID·시크릿 | 비워 둡니다. 마켓탭은 동적 클라이언트 등록(RFC 7591)과 PKCE 를 지원합니다 |

## 할 수 있는 일

| 범주 | 하는 일 |
|---|---|
| 프로젝트 | 접근 가능한 프로젝트 목록, 프로젝트 기본 정보와 연동 상태 |
| 캠페인 | 캠페인 목록, 설정 상세, 성과(발송·클릭·전환·매출·ROAS), 상세 리포트 |
| 오디언스 | 오디언스 목록과 검색, 조건 확인, 조건 작성 규칙 |
| 유저 진단 | 유저 한 명의 수신 동의와 기기 상태, 캠페인별 발송 결과와 실패·제외 사유 |
| 데이터 스키마 | 유저 속성·이벤트·이벤트 속성 목록과 실제 수집된 값 예시 |
| 지표 | 요약 지표, 일별 KPI 팩트, 매일 생성되는 인사이트 문장, 콘솔 차트 데이터 |
| 상품 | 상품 카탈로그 목록과 속성 스키마 |
| 발송 기록 | 최근 3일치 개별 발송 건 조회 |
| 문서 | 마켓탭 가이드 문서 검색과 원문 읽기 |
| 초안 | 문자·카카오 브랜드메시지 캠페인과 오디언스 초안 만들기·수정 |
| 테스트 발송 | 등록된 테스트 유저에게 실제 메시지 보내기 |

## 예시 프롬프트와 응답 형태

아래는 실제 계정 데이터가 아니라 응답이 어떤 모양으로 돌아오는지 보여 주는 예시입니다.

### 캠페인 성과 확인

```
지난주에 보낸 캠페인들 성과 정리해 줘.
```

```
캠페인 4건을 조회했습니다.

- 가을 신상 입고 안내: 문자, 발송 12,340 / 클릭 820 / 전환 113
- 장바구니 리마인드: 카카오 브랜드메시지, 발송 3,210 / 클릭 402 / 전환 -
- 휴면 고객 쿠폰: 문자, 발송 8,900 / 클릭 611 / 전환 87
- 주말 특가: 작성중, 아직 발송하지 않았습니다

장바구니 리마인드의 전환이 '-' 인 것은 어제 발송분이라
아직 집계 전이기 때문입니다. 전환율의 분모는 클릭 수입니다.
```

### 특정 고객이 못 받은 이유 확인

```
user_10293 이 장바구니 리마인드를 왜 못 받았는지 확인해 줘.
```

```
두 단계로 확인했습니다.

1. 유저 조회: 카카오 수신 동의는 있지만 문자 수신 거부 상태입니다.
2. 발송 결과: 해당 캠페인에서 '수신 거부' 사유로 발송 전에 제외됐습니다.

오디언스 조건에는 들어갔지만 채널 수신 동의에서 걸렸습니다.
이름과 전화번호는 가려진 형태로 조회됩니다(홍*동, 010****5678).
```

### 오디언스와 캠페인 초안 만들기

```
최근 30일 안에 구매한 고객 오디언스를 만들고,
그 대상으로 문자 캠페인 초안까지 만들어 줘. 발송은 하지 말고.
```

```
오디언스 조건 작성 규칙을 먼저 확인한 뒤 만들었습니다.

- 오디언스: 최근 30일 구매 고객 (작성중)
- 캠페인: 문자, 작성중, 발송 예약 없음

둘 다 작성중 상태로만 저장했습니다.
콘솔에서 문구와 대상을 확인한 뒤 발행하고 발송하세요.
```

### 기능 사용법 묻기

```
카카오 알림톡 템플릿은 어떻게 등록해?
```

```
가이드 문서를 검색해서 해당 페이지를 읽었습니다.
(문서 링크와 함께 절차를 안내)
```

## 연결 끊기

ChatGPT 는 **설정** → **플러그인** 에서, Claude 는 **사용자 지정** → **커넥터** 에서 마켓탭을 열고 연결을 해제합니다. 계정을 바꾸려면 연결을 해제하고 다시 연결합니다.

CLI 에서는 등록을 지웁니다.

```bash
claude mcp remove marketap
codex mcp remove marketap
```

콘솔 프로젝트 멤버에서 빠지면 연결을 따로 끊지 않아도 그 다음 요청부터 접근이 막힙니다.