MCP-инструменты и права
Обновлено
Инструменты приложений
Агент получает инструменты через реестр приложения MCP. Список зависит от установленных MCP-плагинов и роли, выбранной в MCP → Агенты → Права. Единого набора инструментов заказов, CRM или рекламы для всех установок нет.
Плагин не регистрирует собственный набор инструментов для внешних MCP-клиентов. Описанные ниже agent_* — внутренние инструменты его модели. Они не появляются автоматически как инструменты сервера для Claude Desktop, Cursor или других клиентов.
Внутренние инструменты
| Имя | Назначение и условия |
|---|---|
agent_read_skill |
Прочитать справочник из доступного набора; появляется, если есть выбранные справочники |
agent_append_skill |
Дописать наблюдение в собственный справочник, для которого разрешены правки агента; недоступен в режиме «только чтение» |
agent_edit_skill |
Заменить или удалить точный фрагмент такого справочника, при необходимости изменить «Когда применять»; сохраняет предыдущую версию |
agent_create_skill |
Предложить новый справочник черновиком для человека; недоступен в режиме «только чтение» |
agent_read_file |
Прочитать материал текущего проекта по имени; появляется у проекта с материалами |
agent_generate_image |
Нарисовать изображение; требует настроенную модель в блоке «Рисование» текущего подключения |
agent_view_image |
Посмотреть изображение из публичного каталога wa-data/public этой установки; произвольные внешние ссылки не читает |
agent_view_crm_attachments |
Получить изображения и список файлов сообщения или переписки CRM; появляется при доступном роли srm_get_file. Файлы проверяются через него, изображения из параметров сообщения — через srm_get_message |
agent_fetch_url |
Прочитать текст общедоступной страницы по разрешённой ссылке из разговора |
Большинство внутренних инструментов имеют собственные ограничения и не выдаются правами роли MCP. Для agent_view_crm_attachments дополнительно нужна доступность указанных инструментов CRM в роли агента. Для общего черновика CRM используется отдельный профиль чтения: инструменты изменения данных и рисование в нём недоступны.
Подтверждения
При запросе подтверждения проверьте название инструмента и его аргументы. Нажатие «Подтвердить» разрешает конкретный вызов. Параметр обязательного подтверждения инструмента сервер не позволяет модели подтвердить самостоятельно.
Режим «без вопросов» не отменяет обязательное подтверждение, объявленное самим инструментом, и отдельные ограничения чтения ссылок. Права роли проверяются независимо от выбранного режима.
Чтение страниц
Для agent_fetch_url действуют два источника разрешённых адресов:
- Адрес, который пользователь сам написал в разговоре, открывается без дополнительного вопроса.
- Адрес, полученный только в результате инструмента — например, из письма клиента, — требует подтверждения пользователя, в том числе в режиме «без вопросов».
Произвольный придуманный адрес не открывается. Агент также не может свободно переходить по ссылкам внутри скачанной страницы. Читаются публичные HTTP/HTTPS-страницы; внутренние сетевые адреса и неподдерживаемые ответы отклоняются. Предельный размер скачивания — 2 МиБ, извлекаемый текст — до 60 000 символов. Это не браузер с авторизацией и выполнением JavaScript.
Примеры просьб
Перечисли доступные инструменты и объясни, какие данные ты можешь читать.Прочитай регламент из материалов проекта и составь список вопросов для проверки заказа.Посмотри скриншот, приложенный к сообщению. Перепиши текст ошибки и объясни, что видно.Прочитай страницу по этой ссылке: https://example.org/help/
Кратко изложи условия доставки из её текста.Предложи новый справочник по порядку проверки оплаты. Сначала подготовь черновик для меня.Задачи с заказами, CRM или рекламой выполняются только при наличии соответствующих инструментов. Просьба на естественном языке не добавляет агенту новых прав.