Промпты и ресурсы через инструменты: когда клиент их не показывает
Почему агент видит только инструменты, но не playbooks и справочники - и как четыре инструмента Bestrank MCP открывают сценарии и ресурсы даже в «урезанном» клиенте.
Вы включили в MCP промпт «брифинг перед созвоном» и ресурс с стадиями сделок. В AI-агенте всё работает. А в n8n нода не видит промпты и ресурсы как будто их и не было.
Ожидание: «подключил MCP - увидел всё». Реальность: клиенты по-разному обрабатывают стандартные возможности протокола MCP. Инструменты показываются практически у всех. Список промптов и чтение ресурсов - уже больше похоже на лотерею. Мы придумали возможность для каждого токена обмануть систему и насильно скормить то, что она не видит.
Теория тройки «действие / ресурсы / промпты» - в Как агент работает с инструментами, ресурсами и промптами. Каталог группы - Сценарии для агента.
В чём ломается картина у агента
У MCP три рычага:
- Инструменты - сделать действие: найти сделку, создать задачу, прочитать письмо.
- Ресурсы - прочитать справочник или снимок: стадии воронки, поля карточки, инструкция по разделу.
- Промпты (сценарии) - пройти знакомый маршрут: утренняя сводка, брифинг, разбор заявки.
Если клиент умеет только инструменты, агент остаётся «умелым стажёром без регламента и без папки с инструкциями». Он может тыкать кнопки CRM, но не видит промпт «что проверять по понедельникам» и не подтягивает ваш словарь стадий одним чтением.
Отсюда типичные жалобы: «агент выдумал стадии», «забыл шаги сводки», «не знает, с чего начать». Часто дело не в «глупой модели», а в том, что каталог промптов и ресурсов до неё просто не доехал.
Почему так бывает у разных клиентов
MCP - общий язык, а оболочки, которые его используют, разные. Кто-то показывает только вызовы tools. У кого-то промпты спрятаны в отдельном меню, и агент в чате их не трогает. У кого-то resources/read есть в спецификации, но в практике диалога модель предпочитает «ещё один tool», который уже видит в списке.
Мы не обещаем «починить чужой UI». Мы даём обходной путь на стороне сервера: то же содержимое, что отдаёт протокол для prompts и resources, но упакованное в четыре инструмента, которые клиент почти наверняка умеет вызывать.
Эти четыре пункта входят в служебный набор платформы и доступны на любом токене BestrankMCP. Подключать лишний продукт не нужно.
Четыре инструмента: зачем каждый из них
Группа в каталоге называется Сценарии для агента. Подробнее:
| Что делает | Зачем |
|---|---|
| Список доступных промптов | Увидеть, какие сценарии реально открыты этому подключению |
| Получить доступный промпт | Прочитать текст сценария и понять, какие инструменты и ресурсы от него зависят |
| Список доступных ресурсов | Увидеть справочники и шаблоны адресов, которые можно читать |
| Получить доступный ресурс | Прочитать один справочник по адресу; для шаблонов - с параметрами |
Смысл тот же: сначала список доступных промптов или список доступных ресурсов, потом получить доступный промпт или получить доступный ресурс - уже подробнее.
Список и чтение сценариев
Список возвращает имена, короткие описания, какие аргументы ждут сценарий (например ID сделки) и зависимости: какие инструменты и справочники сценарий предполагает дальше. Это не правка шаблона - только «что мне разрешено запускать».
Получение отдаёт уже собранный текст сценария (с подставленными аргументами, если вы их передали) плюс те же зависимости. Дальше агент идёт по шагам: вызывает нужные tools, читает нужные resources.
Подробнее про сами промпты - Промпты: готовые сценарии. Как админ настраивает базовые и свои промпты - Базовые и пользовательские промпты.
Список и чтение справочников
Список ресурсов показывает и обычные адреса (один снимок), и шаблон с плейсхолдерами - например календарь на год, где год подставляется параметром.
Чтение берёт один URI. Если это шаблон без параметров - сервер ответит, что не хватает значений. Если адрес не входит в разрешённые возможности токена - «нельзя». Если URI неизвестен - «не найдено».
Зачем ресурсы отдельно от tools - Ресурсы: справочники без лишних вызовов.
Как пользоваться по шагам
Практический порядок для агента (и для вас, если подсказываете в чате):
- Спросите список сценариев.
- Выберите нужный по названию или описанию.
- Получите текст сценария; посмотрите зависимости.
- При необходимости запросите список справочников/ресурсов и прочитайте те, что в зависимостях.
- Выполните шаги сценария инструментами.
Кейс 1. РОП в клиенте без меню промптов: «Собери утреннюю сводку». Агент сначала берёт список сценариев, находит «утреннюю сводку», читает текст, видит зависимости на поиск просроченных сделок и справочник стадий - и только потом ходит в Bitrix24. Без этого шага он часто сразу зовёт случайный поиск и забывает половину чек-листа.
Кейс 2. Внедренец проверяет новый токен: «Что тебе вообще доступно из справочников?» Агент вызывает список ресурсов и показывает: производственный календарь, гайд по задачам, словарь воронки - без ручного лазанья по вкладкам админки.
Чем это не является
Это не замена вкладки «Промпты» в административном разделе: создавать и править пользовательские сценарии по-прежнему нужно самостоятельно (или через отдельные инструменты редактирования шаблонов).
Это не «расширение прав». Если сценарий или справочник не включены в возможности токена, список и чтение их не покажут. Ограничение остаётся на стороне токена - меняется только способ узнать, что уже разрешено.
Это не магический обход плохого промпта в чате. Сценарий всё равно нужно один раз описать и включить. Инструменты лишь делают его видимым там, где UI клиента «глухой» к native-спискам.
Про осознанный набор галочек на токене - Возможности токена.
Что проверить сегодня
- В клиенте агент видит четыре инструмента группы Сценарии для агента.
- Список промптов не пустой - если вы ожидали включённые промпты.
- Получение одного сценария возвращает текст и зависимости.
- Список ресурсов содержит нужные справочники; чтение одного URI работает (для шаблона - с параметром).
- Если чего-то нет в списке - сначала смотрите возможности токена, а не «ломается ли модель».
Подключение клиента - Cursor, Claude и другие клиенты. Справочник группы - Сценарии для агента. Если останутся вопросы по конкретному клиенту - напишите, разберём по шагам в Подключении MCP.