> 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가 제안한 내용을 실행하기 전에 꼭 확인해 주세요.
{% 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_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>

**토스 로그인 설정**

| 도구 이름                     | 설명                 |
| ------------------------- | ------------------ |
| `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_get_live_version</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></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_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>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></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_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><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 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.