> 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를 연결하면 콘솔에 들어가지 않아도 AI 도구에서 워크스페이스, 미니앱, 검수, 번들, 대시보드, 인앱 결제, 인앱 광고, 프로모션, 푸시 알림 등 콘솔 작업을 할 수 있어요.

자연어로 요청하면 콘솔 정보를 조회하거나 필요한 작업을 진행해줘요. 예를 들어 "최근 7일 DAU 알려줘"처럼 요청하면 돼요.

***

### 1. 콘솔 MCP 연결하기

콘솔은 앱을 등록하고 관리하는 앱인토스 웹사이트예요. 이 MCP를 연결하면 콘솔 사이트에 직접 들어가지 않고도, AI에게 요청하는 것만으로 워크스페이스, 미니앱, 검수, 번들 같은 콘솔 작업을 진행할 수 있어요.

아래처럼 요청해 보세요.

{% tabs %}
{% tab title="Claude Code" %}

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

{% endtab %}

{% tab title="Codex" %}

```bash
codex mcp add apps-in-toss-console --url https://mcp.toss.im/adapters/apps-in-toss-console/mcp --oauth-client-id mcp-gateway
```

{% endtab %}
{% endtabs %}

MCP 연결 후 로그인 창이 뜨면 안내에 따라 인증을 완료해 주세요. 완료되면 아래처럼 확인해 보세요.\
AI가 정상적으로 연결되고 인증까지 끝났다고 알려주면 완료된 거예요.

```
콘솔 MCP가 잘 연결됐는지 확인해줘
```

***

### 2. 콘솔 작업 요청하기

AI에게 자연어로 요청하면 아래 콘솔 작업을 실행할 수 있어요. 예를 들면 이렇게 요청하면 돼요.

* "최근 7일 DAU 알려줘" → `dashboard_dau`
* "새 푸시 템플릿 만들어줘" → `push_template_create`
* "직전 번들 버전으로 롤백해줘" → `bundle_rollback`

{% hint style="warning" %}
번들 롤백, 푸시 발송처럼 되돌리기 어렵거나 비용이 발생하는 작업은 AI가 제안한 내용을 실행하기 전에 꼭 확인해 주세요. 프로모션 예산 충전은 MCP로 할 수 없어요. 콘솔 웹의 비즈월렛에서 충전해 주세요.
{% endhint %}

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

<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_overview</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>workspace_members_overview</code></td><td>멤버 목록과 내 역할, 권한을 한 번에 조회해요.</td></tr><tr><td><code>miniapp_list</code></td><td>워크스페이스 안의 미니앱 목록을 조회해요.</td></tr><tr><td><code>miniapp_list_overview</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_meta_status</code></td><td>미니앱 앱정보의 검토 상태와 수정 가능 여부를 확인해요.</td></tr><tr><td><code>miniapp_category_list</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>image_upload_url</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><tr><td><code>miniapp_rating_list</code></td><td>유저가 남긴 별점과 후기 목록, 평균 별점을 조회해요.</td></tr><tr><td><code>miniapp_rating_get</code></td><td>별점과 후기 한 건의 상세 정보를 조회해요.</td></tr><tr><td><code>miniapp_inquiry_list</code></td><td>미니앱 유저 문의 목록을 조회해요.</td></tr></tbody></table>

**토스 로그인 설정**

| 도구 이름                     | 설명                 |
| ------------------------- | ------------------ |
| `toss_login_get_config`   | 토스 로그인 설정을 조회해요.   |
| `toss_login_update_terms` | 토스 로그인 약관을 업데이트해요. |

**미니앱 출시**

<table data-search="false"><thead><tr><th>도구 이름</th><th>설명</th></tr></thead><tbody><tr><td><code>bundle_list</code></td><td>업로드된 번들 목록을 조회해요.</td></tr><tr><td><code>bundle_upload</code></td><td>새 번들을 업로드해요.</td></tr><tr><td><code>bundle_upload_complete</code></td><td>번들 업로드를 마친 뒤 컴파일을 시작해요.</td></tr><tr><td><code>bundle_build_status</code></td><td>빌드 중인 번들을 조회해요.</td></tr><tr><td><code>bundle_test_push</code></td><td>업로드한 번들을 내 토스 앱으로 테스트 푸시해요.</td></tr><tr><td><code>bundle_get_live_version</code></td><td>현재 라이브 배포된 버전을 확인해요.</td></tr><tr><td><code>miniapp_release_status</code></td><td>출시 가능 여부와 번들 검수 요청 가능 여부 같은 출시 상태를 확인해요.</td></tr><tr><td><code>bundle_submit_review</code></td><td>번들 검수를 신청해요.</td></tr><tr><td><code>review_list</code></td><td>검수 요청 목록을 조회해요.</td></tr><tr><td><code>review_get</code></td><td>검수 요청 상세 정보를 조회해요.</td></tr><tr><td><code>review_get_feedback</code></td><td>검수 피드백을 확인해요.</td></tr><tr><td><code>review_submit</code></td><td>검수를 신청해요.</td></tr><tr><td><code>review_cancel</code></td><td>검수를 취소해요.</td></tr><tr><td><code>bundle_set_release_note</code></td><td>릴리즈 노트를 작성해요.</td></tr><tr><td><code>bundle_rollback</code></td><td>이전 버전으로 되돌려요.</td></tr></tbody></table>

**대시보드와 분석**

<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><tr><td><code>core_metric_list</code></td><td>활성과 전환 핵심 지표의 기간별 집계를 조회해요.</td></tr><tr><td><code>core_metric_get</code></td><td>핵심 지표 하나의 설정 상세를 조회해요.</td></tr><tr><td><code>core_metric_details</code></td><td>활성 지표와 전환 지표 설정을 함께 조회해요.</td></tr><tr><td><code>core_metric_template_event_types</code></td><td>핵심 지표 설정에 쓰는 활성, 전환 템플릿 선택지를 조회해요.</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_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_abuse_status_get</code></td><td>미니앱의 인앱 광고 어뷰징 상태를 조회해요.</td></tr><tr><td><code>iaa_report_performance</code></td><td>성과 리포트를 조회해요.</td></tr><tr><td><code>iaa_report_analytics</code></td><td>분석 리포트를 조회해요.</td></tr><tr><td><code>iaa_dashboard_report_v2</code></td><td>대시보드 리포트를 조회해요.</td></tr><tr><td><code>iaa_workspace_dashboard_report_v2</code></td><td>워크스페이스 전체 미니앱의 대시보드 리포트를 조회해요.</td></tr><tr><td><code>iaa_settlement_summary_v2</code></td><td>광고 정산 요약을 조회해요.<br>(관리자만 조회할 수 있어요)</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_review_comment</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>business_wallet_get</code></td><td>비즈월렛 잔액과 기본 정보를 조회해요.</td></tr><tr><td><code>promotion_stats</code></td><td>프로모션 성과 통계를 조회해요.</td></tr><tr><td><code>promotion_user_reward_history</code></td><td>프로모션의 유저 리워드 지급과 취소 이력을 조회해요.</td></tr><tr><td><code>share_reward_list</code></td><td>공유 리워드 목록을 조회해요.</td></tr><tr><td><code>share_reward_get</code></td><td>공유 리워드 상세 정보를 조회해요.</td></tr></tbody></table>

**푸시 알림**

<table data-search="false"><thead><tr><th>도구 이름</th><th>설명</th></tr></thead><tbody><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_notification_agreement_list</code></td><td>기능성 푸시에 연결할 알림동의문 목록을 조회해요.</td></tr><tr><td><code>push_notification_agreement_create</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_test_send</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><tr><td><code>push_history_list</code></td><td>푸시 발송 내역을 조회해요.</td></tr><tr><td><code>push_stats</code></td><td>푸시 통계를 확인해요.</td></tr></tbody></table>

**공지**

| 도구 이름         | 설명              |
| ------------- | --------------- |
| `notice_list` | 공지 목록을 조회해요.    |
| `notice_get`  | 공지 상세 정보를 조회해요. |


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.