Автоматизация
Справочник инструментов MCP
Это инструменты, которые выставляет сервер MCP, в обеих его формах, локальной и размещённой. Каждый проксирует одну операцию API управления, так что право, нужное инструменту, это право, нужное этой операции; токен агента должен его держать. Каталог и описания приходят от самого сервера; для точной схемы запроса и ответа операции за инструментом смотри интерактивный справочник API.
Инструмент выполняется, только если стоящий за ним токен имеет право выполнить нижележащую операцию. Колонка Право использует эти значения, которые отображаются на модель прав и охвата команды:
| Значение | Означает |
|---|
| Account | Любой валидный токен на аккаунте. Инструменты выпуска токенов и мест дополнительно требуют мастер-учётных данных аккаунта (сессия панели или персональный токен доступа); токен команды не может выпускать токены или места. |
| 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 оболочки виджета это функция 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 (команда) |
