MCP 도구 레퍼런스

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

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

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

값	뜻
Account	계정의 모든 유효한 토큰. 토큰·좌석 발급 도구는 추가로 계정 마스터 자격 증명(대시보드 세션 또는 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 서버 쓰기: 두 전송 중 하나로 에이전트 연결하기.
권한과 범위: 위 표가 쓰는 read / create / edit / manage 모델.
대화형 API 레퍼런스: 각 도구 뒤 작업의 정확한 스키마.

MCP 도구 레퍼런스

이 페이지에서