---
type: reference
title: MCP 도구 레퍼런스
summary: 모든 Caputchin MCP 도구, 그것이 하는 일, 그리고 그 토큰이 지녀야 하는 권한, 영역별로 묶음.
---

이것들은 [MCP 서버](/docs/automation/mcp)가 로컬과 호스팅 형태 둘 다에서 노출하는 도구입니다. 각각은 단일 [관리 API](/docs/automation/management-api) 작업을 프록시하니, 도구가 필요로 하는 권한은 그 작업이 필요로 하는 권한입니다; 에이전트의 [토큰](/docs/automation/management-api#mint-an-access-token)이 그것을 지녀야 합니다. 카탈로그와 설명은 서버 자체에서 옵니다; 도구 뒤 작업의 정확한 요청·응답 스키마는 [대화형 API 레퍼런스](/docs/api-reference)를 보세요.

## 여기서 권한이 동작하는 방식

도구는 그 뒤의 토큰이 바탕 작업을 수행하도록 허용된 경우에만 돕니다. **권한** 열은 이 값들을 쓰며, 그것들은 팀 [권한과 범위](/docs/troops/permissions) 모델에 대응합니다:

| 값 | 뜻 |
|---|---|
| **Account** | 계정의 모든 유효한 토큰. 토큰·좌석 발급 도구는 추가로 계정 마스터 자격 증명(대시보드 세션 또는 [Personal Access Token](/docs/account-management/personal-access-token))을 요구합니다; 팀 토큰은 토큰이나 좌석을 발급할 수 없습니다. |
| **read** | `read` 권한. 사이트 범위 도구는 사이트 키가 토큰의 범위 안에 있어야 합니다. |
| **create** | 팀에 대한 `create` 권한(그 안에 사이트 키 만들기). |
| **edit** | 도구가 겨냥하는 사이트 키로 범위 지정된 `edit` 권한. |
| **manage** | `manage` 권한: 팀 관리(멤버, 토큰, 팀 전역 설정). |

몇몇 도구는 설명에 적힌 요금제 등급도 필요합니다: 화이트라벨링은 **Apex**, 게임 언어와 스킨 맞춤화는 **Alpha 이상**, 감사 로그는 **Apex**입니다.

## 계정과 상태

| 도구 | 하는 일 | 권한 |
|---|---|---|
| `caputchin_ping` | 상태 확인; 토큰이 유효할 때 해소된 계정 id를 돌려줍니다. | Account |
| `caputchin_get_account` | 인증된 계정(id, 이메일, 요금제). | Account |
| `caputchin_me_billing` | 결제 요약(요금제, 상태, 기간). | Account |
| `caputchin_get_seats` | 계정의 좌석 사용량(사용, 전체, 분해). | Account |

## 토큰과 좌석

| 도구 | 하는 일 | 권한 |
|---|---|---|
| `caputchin_list_tokens` | 계정의 토큰 나열; 시크릿은 결코 돌려주지 않음. | Account |
| `caputchin_create_token` | 토큰 발급(`type` troop 또는 account); 값은 한 번 돌려줌. | Account (master) |
| `caputchin_rotate_token` | 토큰의 시크릿 교체; 새 값은 한 번 돌려줌. | Account (master) |
| `caputchin_revoke_token` | 토큰 취소; 즉시 적용. | Account (master) |
| `caputchin_invite_seat_user` | 팀에 사용자 초대(좌석 인지); 새로우면 좌석을 씀. | Account (master) |
| `caputchin_remove_seat_user` | 계정의 모든 팀에서 사용자 제거. | Account (master) |
| `caputchin_mint_seat_pat` | 한 호출로 팀 토큰을 발급해 연결; 값은 한 번 돌려줌. | Account (master) |
| `caputchin_attach_seat_pat` | 기존 팀 토큰을 다른 팀에 연결. | Account (master) |
| `caputchin_revoke_seat_pat` | 계정 전반에서 팀 토큰 취소. | Account (master) |

## 팀

| 도구 | 하는 일 | 권한 |
|---|---|---|
| `caputchin_list_troops` | 계정의 팀 나열. | Account |
| `caputchin_get_troop` | id로 팀 하나. | read |
| `caputchin_create_troop` | 공유 팀 만들기. | Account |
| `caputchin_rename_troop` | 팀 이름 바꾸기. | manage |
| `caputchin_delete_troop` | 팀 삭제; 사이트 키를 아직 소유하면 거부. | manage |
| `caputchin_list_troop_members` | 팀의 멤버와 그 권한·범위. | read |
| `caputchin_add_troop_member` | 권한·범위로 이메일로 사용자 추가; 좌석을 쓸 수 있음. | manage |
| `caputchin_update_troop_member` | 멤버의 권한이나 범위 바꾸기. | manage |
| `caputchin_remove_troop_member` | 멤버 제거; 그게 마지막이었으면 좌석을 비움. | manage |
| `caputchin_list_troop_pats` | 팀에 연결된 팀 토큰. | read |
| `caputchin_attach_troop_pat` | 권한·범위로 팀 토큰 연결; 좌석을 씀. | manage |
| `caputchin_update_troop_pat` | 연결된 토큰의 권한이나 범위 바꾸기. | manage |
| `caputchin_detach_troop_pat` | 팀 토큰 연결 해제; 그 좌석을 비움. | manage |
| `caputchin_get_troop_security` | 팀의 보안 설정(게임 강제 천장과 미리보기 모드 및 검증 재사용 기본값). | read |
| `caputchin_update_troop_security` | 게임 강제 천장과 팀 전체의 미리보기 모드 및 검증 재사용 기본값을 설정. | manage |

## 사이트 키

| 도구 | 하는 일 | 권한 |
|---|---|---|
| `caputchin_list_sites` | 계정 팀 전반의 모든 사이트 키. | read |
| `caputchin_get_site` | id로 사이트 키 하나. | read |
| `caputchin_create_site` | 사이트 키 만들기(팀 안, 또는 Personal); 일회용 시크릿을 돌려줌. | create |
| `caputchin_update_site` | 키의 이름이나 비활성화 플래그 갱신. | edit |
| `caputchin_delete_site` | 키 삭제; 세션과 구성을 연쇄. 되돌릴 수 없음. | edit |
| `caputchin_rotate_site_secret` | 시크릿 교체; 기존 것은 즉시 멈춤; 새 것은 한 번 돌려줌. | edit |
| `caputchin_get_site_cap_config` | 키의 proof-of-work 구성. | read |
| `caputchin_update_site_cap_config` | proof-of-work 구성 갱신. | edit |
| `caputchin_get_site_security` | 키의 보안 설정(게임 요구 게이트, 미리보기 모드, 검증 재사용). | read |
| `caputchin_update_site_security` | 키별 게임 요구 게이트, 미리보기 모드, 검증 재사용을 토글. | edit |
| `caputchin_list_site_sessions` | 키의 최근 검증 세션. | read |

## 호스팅 인증

| 도구 | 하는 일 | 권한 |
|---|---|---|
| `caputchin_get_hosted_verification` | 키의 호스팅 인증 구성. | read |
| `caputchin_set_hosted_verification` | 활성화 플래그와 대상 설정. | edit |
| `caputchin_test_hosted_verification` | 구성된 대상으로 합성 전달 발사. | edit |

## 통계, 전달, 감사 로그

| 도구 | 하는 일 | 권한 |
|---|---|---|
| `caputchin_site_stats` | 범위에 걸친 사이트 검증 통계. | read |
| `caputchin_site_stats_dashboard` | 사이트 통계 대시보드 합산. | read |
| `caputchin_site_stats_activity` | 사이트 통계 활동 시계열. | read |
| `caputchin_site_stats_durations` | 사이트 통계 타이밍 백분위. | read |
| `caputchin_site_stats_rejections` | 사이트 거부 카운트. | read |
| `caputchin_troop_stats` | 팀 통계 누적 합계. | read |
| `caputchin_troop_stats_dashboard` | 팀 통계 대시보드 합산. | read |
| `caputchin_troop_stats_activity` | 팀 통계 활동 시계열. | read |
| `caputchin_troop_stats_durations` | 팀 통계 타이밍 백분위. | read |
| `caputchin_troop_stats_rejections` | 팀 거부 카운트. | read |
| `caputchin_quick_stats_sites` | 계정 전반의 간결한 사이트별 통계 스냅샷. | read |
| `caputchin_quick_stats_troops` | 계정 전반의 간결한 팀별 통계 스냅샷. | read |
| `caputchin_site_delivery_dashboard` | 사이트의 호스팅 인증 전달 통계. Apex. | read |
| `caputchin_troop_delivery_dashboard` | 팀의 호스팅 인증 전달 통계. Apex. | read |
| `caputchin_account_audit_logs` | 계정 수준 감사 로그. Apex. | Account |
| `caputchin_troop_audit_logs` | 팀 감사 로그. Apex. | read |
| `caputchin_site_audit_logs` | 사이트 키 감사 로그. Apex. | read |

## 마켓플레이스 게임

| 도구 | 하는 일 | 권한 |
|---|---|---|
| `caputchin_list_games` | 마켓플레이스 게임 나열. | Account |
| `caputchin_search_games` | 텍스트로 마켓플레이스 게임 검색. | Account |
| `caputchin_get_game` | id로 마켓플레이스 게임 하나. | Account |

## 게임 맞춤화

이것들은 범위(사이트 키 또는 팀)를 겨냥하니, 사이트 범위 변경은 그 키에 대한 `edit`을, 팀 전역 변경은 `manage`를 필요로 합니다. 언어와 스킨 맞춤화는 **Alpha 이상**입니다.

| 도구 | 하는 일 | 권한 |
|---|---|---|
| `caputchin_list_customized_games` | 범위의 등록(설치)된 게임. | read |
| `caputchin_register_customized_game` | 범위에 게임 등록(설치); 스냅샷을 고정. | edit (site) 또는 manage (troop) |
| `caputchin_repin_customized_game` | 등록된 게임을 최신 버전으로 다시 고정. | edit (site) 또는 manage (troop) |
| `caputchin_update_customized_game` | 등록된 게임의 설정 갱신(자동 갱신). | edit (site) 또는 manage (troop) |
| `caputchin_delete_customized_game` | 범위에서 등록된 게임 제거. | edit (site) 또는 manage (troop) |
| `caputchin_list_game_presets` | 범위와 게임에 대한 맞춤화 프리셋. | read |
| `caputchin_set_game_preset` | 게임 프리셋 생성 또는 갱신. Alpha+. | edit (site) 또는 manage (troop) |
| `caputchin_delete_game_preset` | 게임 프리셋 삭제. Alpha+. | edit (site) 또는 manage (troop) |
| `caputchin_set_game_default` | 축의 기본 게임 프리셋 설정. Alpha+. | edit (site) 또는 manage (troop) |
| `caputchin_get_custom_game_schema` | 범위에 대한 커스텀 게임의 필드 스키마. | read |
| `caputchin_set_custom_game_schema` | 커스텀 게임의 필드 스키마 설정. Alpha+. | edit (site) 또는 manage (troop) |
| `caputchin_delete_custom_game_schema` | 커스텀 게임의 필드 스키마 삭제. Alpha+. | edit (site) 또는 manage (troop) |
| `caputchin_upload_custom_game_run` | 커스텀 게임의 헤드리스 실행 산출물 업로드. | edit (site) 또는 manage (troop) |
| `caputchin_get_custom_game_run` | 커스텀 게임의 저장된 실행 산출물 참조 가져오기. | read |
| `caputchin_delete_custom_game_run` | 커스텀 게임의 실행 산출물 삭제. | edit (site) 또는 manage (troop) |

## 화이트라벨

위젯 셸 화이트라벨링은 **Apex** 기능입니다. 게임 맞춤화와 마찬가지로, 사이트 범위 변경은 `edit`을, 팀 전역 변경은 `manage`를 필요로 합니다.

| 도구 | 하는 일 | 권한 |
|---|---|---|
| `caputchin_list_white_label_presets` | 범위에 대한 화이트라벨 프리셋. | read |
| `caputchin_set_white_label_preset` | 화이트라벨 프리셋 생성 또는 갱신. Apex. | edit (site) 또는 manage (troop) |
| `caputchin_delete_white_label_preset` | 화이트라벨 프리셋 삭제. Apex. | edit (site) 또는 manage (troop) |
| `caputchin_set_white_label_default` | 축의 기본 화이트라벨 프리셋 설정. Apex. | edit (site) 또는 manage (troop) |

## 함께 보기

- [MCP 서버 쓰기](/docs/automation/mcp): 두 전송 중 하나로 에이전트 연결하기.
- [권한과 범위](/docs/troops/permissions): 위 표가 쓰는 read / create / edit / manage 모델.
- [대화형 API 레퍼런스](/docs/api-reference): 각 도구 뒤 작업의 정확한 스키마.