---
type: reference
title: Справочник инструментов MCP
summary: Каждый инструмент MCP Caputchin, что он делает и какое право должен держать его токен, сгруппированные по области.
---

Это инструменты, которые выставляет [сервер 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** | Любой валидный токен на аккаунте. Инструменты выпуска токенов и мест дополнительно требуют мастер-учётных данных аккаунта (сессия панели или [персональный токен доступа](/docs/account-management/personal-access-token)); токен команды не может выпускать токены или места. |
| **read** | Право `read`. Инструменты с охватом до сайта также требуют, чтобы ключ сайта был в охвате токена. |
| **create** | Право `create` на команде (создание ключа сайта в ней). |
| **edit** | Право `edit`, с охватом до ключа сайта, на который нацелен инструмент. |
| **manage** | Право `manage`: администрирование команды (участники, токены, общекомандные настройки). |

Нескольким инструментам также нужен уровень тарифа, отмеченный в описании: white-label это **Apex**, настройка языка игры и скина это **Alpha и выше**, а журналы аудита это **Apex**.

## Аккаунт и здоровье

| Инструмент | Делает | Право |
|---|---|---|
| `caputchin_ping` | Проверка здоровья; возвращает разрешённый id аккаунта, когда токен валиден. | Account |
| `caputchin_get_account` | Аутентифицированный аккаунт (id, email, тариф). | Account |
| `caputchin_me_billing` | Сводка по оплате (тариф, статус, период). | Account |
| `caputchin_get_seats` | Использование мест для аккаунта (использовано, всего, разбивка). | Account |

## Токены и места

| Инструмент | Делает | Право |
|---|---|---|
| `caputchin_list_tokens` | Перечислить токены аккаунта; никогда не возвращает секреты. | Account |
| `caputchin_create_token` | Выпустить токен (`type` команды или аккаунта); значение возвращается один раз. | Account (мастер) |
| `caputchin_rotate_token` | Обновить секрет токена; новое значение возвращается один раз. | Account (мастер) |
| `caputchin_revoke_token` | Отозвать токен; вступает в силу немедленно. | Account (мастер) |
| `caputchin_invite_seat_user` | Пригласить пользователя в команду (с учётом мест); потребляет место, если новый. | Account (мастер) |
| `caputchin_remove_seat_user` | Убрать пользователя из каждой команды в аккаунте. | Account (мастер) |
| `caputchin_mint_seat_pat` | Выпустить и привязать токен команды одним вызовом; значение возвращается один раз. | Account (мастер) |
| `caputchin_attach_seat_pat` | Привязать существующий токен команды к другой команде. | Account (мастер) |
| `caputchin_revoke_seat_pat` | Отозвать токен команды по всему аккаунту. | Account (мастер) |

## Команды

| Инструмент | Делает | Право |
|---|---|---|
| `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` | Добавить пользователя по email с правами и охватом; может потребить место. | 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` | Создать ключ сайта (в команде или Личной); возвращает одноразовый секрет. | 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 (сайт) или manage (команда) |
| `caputchin_repin_customized_game` | Перезакрепить зарегистрированную игру на последнюю версию. | edit (сайт) или manage (команда) |
| `caputchin_update_customized_game` | Обновить настройки зарегистрированной игры (авто-обновление). | edit (сайт) или manage (команда) |
| `caputchin_delete_customized_game` | Удалить зарегистрированную игру с охвата. | edit (сайт) или manage (команда) |
| `caputchin_list_game_presets` | Пресеты настройки для охвата и игры. | read |
| `caputchin_set_game_preset` | Создать или обновить пресет игры. Alpha+. | edit (сайт) или manage (команда) |
| `caputchin_delete_game_preset` | Удалить пресет игры. Alpha+. | edit (сайт) или manage (команда) |
| `caputchin_set_game_default` | Задать пресет игры по умолчанию для оси. Alpha+. | edit (сайт) или manage (команда) |
| `caputchin_get_custom_game_schema` | Схема полей пользовательской игры для охвата. | read |
| `caputchin_set_custom_game_schema` | Задать схему полей пользовательской игры. Alpha+. | edit (сайт) или manage (команда) |
| `caputchin_delete_custom_game_schema` | Удалить схему полей пользовательской игры. Alpha+. | edit (сайт) или manage (команда) |
| `caputchin_upload_custom_game_run` | Загрузить артефакт headless-прогона пользовательской игры. | edit (сайт) или manage (команда) |
| `caputchin_get_custom_game_run` | Получить ссылку на сохранённый артефакт прогона пользовательской игры. | read |
| `caputchin_delete_custom_game_run` | Удалить артефакт прогона пользовательской игры. | edit (сайт) или manage (команда) |

## White-label

White-label оболочки виджета это функция **Apex**. Как и с настройкой игр, изменение с охватом до сайта требует `edit`, а общекомандное требует `manage`.

| Инструмент | Делает | Право |
|---|---|---|
| `caputchin_list_white_label_presets` | White-label пресеты для охвата. | read |
| `caputchin_set_white_label_preset` | Создать или обновить white-label пресет. Apex. | edit (сайт) или manage (команда) |
| `caputchin_delete_white_label_preset` | Удалить white-label пресет. Apex. | edit (сайт) или manage (команда) |
| `caputchin_set_white_label_default` | Задать white-label пресет по умолчанию для оси. Apex. | edit (сайт) или manage (команда) |

## См. также

- [Используй сервер MCP](/docs/automation/mcp): подключение агента через любой транспорт.
- [Права и охват](/docs/troops/permissions): модель read / create / edit / manage, которую использует таблица выше.
- [Интерактивный справочник API](/docs/api-reference): точная схема операции за каждым инструментом.