> For the complete documentation index, see [llms.txt](https://developers-apps-in-toss.toss.im/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers-apps-in-toss.toss.im/guide/console-mcp.md).

# AI로 콘솔 사용하기

앱인토스 콘솔 MCP를 연결하면 콘솔에 들어가지 않아도 Claude에서 워크스페이스, 미니앱, 검수, 번들, 인앱결제, 인앱광고 작업을 할 수 있어요.

자연어로 요청하면 콘솔 정보를 조회하거나 필요한 작업을 진행해줘요. 지금은 Claude에서만 쓸 수 있고, Codex는 준비 중이에요.

***

### 1. 콘솔 MCP 등록하기

터미널에서 아래 명령어를 실행해 주세요.

```bash
claude mcp add --transport http apps-in-toss-console \
  https://mcp.toss.im/adapters/apps-in-toss-console/mcp \
  --client-id mcp-gateway
```

***

### 2. 인증하기

Claude에서 콘솔 MCP를 사용하려면 Toss SSO와 비즈 로그인을 통해 인증해야 해요.

1. 새 터미널에서 `claude`를 실행해요.
2. Claude에서 `/mcp`를 입력해 MCP 목록으로 이동해요.
3. `apps-in-toss-console`을 선택해요.
4. `Authenticate`를 눌러 Toss SSO와 비즈 로그인을 완료해요.
5. 상태가 `Connected`인지 확인해요.

***

### 3. 사용할 수 있는 콘솔 작업

AI에게 말로 요청하면 아래 콘솔 작업을 실행할 수 있어요.

**워크스페이스와 미니앱**

<table data-search="false"><thead><tr><th>도구 이름</th><th>설명</th></tr></thead><tbody><tr><td><code>workspace_list</code></td><td>내가 속한 워크스페이스 목록을 조회해요.</td></tr><tr><td><code>workspace_get</code></td><td>특정 워크스페이스 상세 정보를 조회해요.</td></tr><tr><td><code>workspace_create</code></td><td>새 워크스페이스를 만들어요.</td></tr><tr><td><code>workspace_update</code></td><td>워크스페이스 정보를 수정해요.</td></tr><tr><td><code>workspace_members_list</code></td><td>워크스페이스 멤버 목록을 조회해요.</td></tr><tr><td><code>miniapp_list</code></td><td>워크스페이스 안의 미니앱 목록을 조회해요.</td></tr><tr><td><code>miniapp_get</code></td><td>특정 미니앱 상세 정보를 조회해요.</td></tr><tr><td><code>miniapp_create</code></td><td>새 미니앱을 만들어요.</td></tr><tr><td><code>miniapp_get_status</code></td><td>미니앱 검수와 운영 상태를 확인해요.</td></tr><tr><td><code>miniapp_update_basic_info</code></td><td>미니앱 이름, 설명 같은 기본 정보를 수정해요.</td></tr><tr><td><code>miniapp_update_category</code></td><td>미니앱 카테고리를 변경해요.</td></tr><tr><td><code>miniapp_update_icon</code></td><td>미니앱 아이콘 이미지를 교체해요.</td></tr><tr><td><code>miniapp_update_screenshots</code></td><td>미니앱 스크린샷을 교체해요.</td></tr><tr><td><code>miniapp_update_age_rating</code></td><td>미니앱 연령등급을 변경해요.</td></tr><tr><td><code>miniapp_update_privacy_policy</code></td><td>개인정보처리방침을 업데이트해요.</td></tr></tbody></table>

**검수**

| 도구 이름                 | 설명                 |
| --------------------- | ------------------ |
| `review_list`         | 검수 요청 목록을 조회해요.    |
| `review_get`          | 검수 요청 상세 정보를 조회해요. |
| `review_submit`       | 검수를 신청해요.          |
| `review_cancel`       | 검수를 취소해요.          |
| `review_get_feedback` | 검수 피드백을 확인해요.      |

**번들**

| 도구 이름                     | 설명                   |
| ------------------------- | -------------------- |
| `bundle_list`             | 업로드된 번들 목록을 조회해요.    |
| `bundle_get_live_version` | 현재 라이브 배포된 버전을 확인해요. |
| `bundle_upload`           | 새 번들을 업로드해요.         |
| `bundle_submit_review`    | 번들 검수를 신청해요.         |
| `bundle_rollback`         | 이전 버전으로 되돌려요.        |
| `bundle_set_release_note` | 릴리즈 노트를 작성해요.        |

**대시보드와 분석**

<table data-search="false"><thead><tr><th>도구 이름</th><th>설명</th></tr></thead><tbody><tr><td><code>dashboard_dau</code></td><td>일간 활성 유저(DAU)를 조회해요.</td></tr><tr><td><code>dashboard_session</code></td><td>세션 수와 세션 길이 통계를 조회해요.</td></tr><tr><td><code>dashboard_retention</code></td><td>리텐션을 확인해요.</td></tr><tr><td><code>dashboard_conversion</code></td><td>전환율 통계를 조회해요.</td></tr><tr><td><code>dashboard_compare_period</code></td><td>기간별 지표를 비교해요.</td></tr><tr><td><code>dashboard_revenue_iap</code></td><td>인앱 결제 매출 현황을 조회해요.</td></tr><tr><td><code>dashboard_revenue_iaa</code></td><td>인앱 광고 매출 현황을 조회해요.</td></tr><tr><td><code>dashboard_export_csv</code></td><td>대시보드 데이터를 CSV로 내보내요.</td></tr></tbody></table>

**이벤트 로그**

| 도구 이름                  | 설명               |
| ---------------------- | ---------------- |
| `event_log_list`       | 이벤트 로그 목록을 조회해요. |
| `event_log_search`     | 이벤트 로그를 검색해요.    |
| `event_pageview_stats` | 페이지뷰 통계를 조회해요.   |
| `event_act_type_get`   | 이벤트 타입 정의를 조회해요. |
| `event_act_type_set`   | 이벤트 타입 정의를 설정해요. |

**인앱 결제**

<table data-search="false"><thead><tr><th>도구 이름</th><th>설명</th></tr></thead><tbody><tr><td><code>iap_product_list</code></td><td>인앱 상품 목록을 조회해요.</td></tr><tr><td><code>iap_product_get</code></td><td>인앱 상품 상세 정보를 조회해요.</td></tr><tr><td><code>iap_product_create_inspection</code></td><td>새 상품 검수를 신청해요.</td></tr><tr><td><code>iap_product_update_inspection</code></td><td>상품 수정 검수를 신청해요.</td></tr><tr><td><code>iap_product_change_status</code></td><td>상품 판매를 시작하거나 중지해요.</td></tr><tr><td><code>iap_order_list</code></td><td>결제 주문 내역을 조회해요.</td></tr><tr><td><code>iap_refund_list</code></td><td>환불 요청 목록을 조회해요.</td></tr><tr><td><code>iap_revenue</code></td><td>인앱 결제 매출 통계를 조회해요.</td></tr></tbody></table>

**인앱 광고**

<table data-search="false"><thead><tr><th>도구 이름</th><th>설명</th></tr></thead><tbody><tr><td><code>iaa_ad_unit_group_list</code></td><td>광고 단위 그룹 목록을 조회해요.</td></tr><tr><td><code>iaa_ad_unit_group_get</code></td><td>광고 단위 그룹 상세 정보를 조회해요.</td></tr><tr><td><code>iaa_ad_unit_group_change_status</code></td><td>광고 단위를 켜거나 꺼요.</td></tr><tr><td><code>iaa_ad_unit_group_delete</code></td><td>광고 단위를 삭제해요.</td></tr><tr><td><code>iaa_mediation_groups</code></td><td>미디에이션 그룹 목록을 조회해요.</td></tr><tr><td><code>iaa_placement_group_list</code></td><td>플레이스먼트 그룹 목록을 조회해요.</td></tr><tr><td><code>iaa_placement_group_get</code></td><td>플레이스먼트 그룹 상세 정보를 조회해요.</td></tr><tr><td><code>iaa_placement_group_create</code></td><td>플레이스먼트 그룹을 만들어요.</td></tr><tr><td><code>iaa_placement_group_update</code></td><td>플레이스먼트 그룹을 수정해요.</td></tr><tr><td><code>iaa_dashboard_report</code></td><td>광고 성과 리포트를 조회해요.</td></tr><tr><td><code>iaa_dashboard_report_v2</code></td><td>광고 성과 리포트 v2를 조회해요.</td></tr><tr><td><code>iaa_workspace_dashboard_report_v2</code></td><td>워크스페이스 전체 광고 리포트를 조회해요.</td></tr><tr><td><code>iaa_settlement_summary</code></td><td>광고 정산 요약을 조회해요.</td></tr><tr><td><code>iaa_settlement_summary_v2</code></td><td>광고 정산 요약 v2를 조회해요.</td></tr></tbody></table>

**프로모션**

<table data-search="false"><thead><tr><th>도구 이름</th><th>설명</th></tr></thead><tbody><tr><td><code>promotion_list</code></td><td>프로모션 목록을 조회해요.</td></tr><tr><td><code>promotion_get</code></td><td>프로모션 상세 정보를 조회해요.</td></tr><tr><td><code>promotion_create</code></td><td>새 프로모션을 만들어요.</td></tr><tr><td><code>promotion_modify</code></td><td>프로모션을 수정해요.</td></tr><tr><td><code>promotion_change_status</code></td><td>프로모션 상태를 변경해요.</td></tr><tr><td><code>promotion_money_balance</code></td><td>프로모션 예산 잔액을 확인해요.</td></tr><tr><td><code>promotion_money_charge</code></td><td>프로모션 예산을 충전해요.</td></tr><tr><td><code>promotion_money_history</code></td><td>예산 충전과 사용 내역을 조회해요.</td></tr><tr><td><code>promotion_stats</code></td><td>프로모션 성과 통계를 조회해요.</td></tr><tr><td><code>promotion_review_comment</code></td><td>프로모션 검수 코멘트를 확인해요.</td></tr></tbody></table>

**푸시 알림**

<table data-search="false"><thead><tr><th>도구 이름</th><th>설명</th></tr></thead><tbody><tr><td><code>push_history_list</code></td><td>푸시 발송 내역을 조회해요.</td></tr><tr><td><code>push_stats</code></td><td>푸시 통계를 확인해요.</td></tr><tr><td><code>push_template_list</code></td><td>푸시 템플릿 목록을 조회해요.</td></tr><tr><td><code>push_template_create</code></td><td>푸시 템플릿을 만들어요.</td></tr><tr><td><code>push_template_update</code></td><td>푸시 템플릿을 수정해요.</td></tr><tr><td><code>push_target_segment_list</code></td><td>타겟 세그먼트 목록을 조회해요.</td></tr><tr><td><code>push_target_segment_create</code></td><td>타겟 세그먼트를 만들어요.</td></tr><tr><td><code>push_send_scheduled</code></td><td>푸시 예약 발송을 등록해요.</td></tr><tr><td><code>push_cancel_scheduled</code></td><td>푸시 예약 발송을 취소해요.</td></tr></tbody></table>

**공지와 기타 설정**

| 도구 이름                     | 설명                 |
| ------------------------- | ------------------ |
| `notice_list`             | 공지 목록을 조회해요.       |
| `notice_get`              | 공지 상세 정보를 조회해요.    |
| `toss_login_get_config`   | 토스 로그인 설정을 조회해요.   |
| `toss_login_update_terms` | 토스 로그인 약관을 업데이트해요. |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers-apps-in-toss.toss.im/guide/console-mcp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.