마켓탭 MCP 연결하기

개요

마켓탭은 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 디렉토리의 마켓탭 페이지에서 연결 을 누르고 콘솔 계정으로 로그인합니다.

Claude Code

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

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

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

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

claude mcp list
claude mcp get marketap

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

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

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

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

Codex CLI

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

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

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

codex mcp login marketap

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

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

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 에서는 등록을 지웁니다.

claude mcp remove marketap
codex mcp remove marketap

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