BestrankMCP: Промпты и ресурсы через инструменты: когда клиент их не показывает

Промпты и ресурсы через инструменты: когда клиент их не показывает

Почему агент видит только инструменты, но не playbooks и справочники - и как четыре инструмента Bestrank MCP открывают сценарии и ресурсы даже в «урезанном» клиенте.

Вы включили в MCP промпт «брифинг перед созвоном» и ресурс с стадиями сделок. В AI-агенте всё работает. А в n8n нода не видит промпты и ресурсы как будто их и не было.

Ожидание: «подключил MCP - увидел всё». Реальность: клиенты по-разному обрабатывают стандартные возможности протокола MCP. Инструменты показываются практически у всех. Список промптов и чтение ресурсов - уже больше похоже на лотерею. Мы придумали возможность для каждого токена обмануть систему и насильно скормить то, что она не видит.

Теория тройки «действие / ресурсы / промпты» - в Как агент работает с инструментами, ресурсами и промптами. Каталог группы - Сценарии для агента.

В чём ломается картина у агента

У MCP три рычага:

  1. Инструменты - сделать действие: найти сделку, создать задачу, прочитать письмо.
  2. Ресурсы - прочитать справочник или снимок: стадии воронки, поля карточки, инструкция по разделу.
  3. Промпты (сценарии) - пройти знакомый маршрут: утренняя сводка, брифинг, разбор заявки.

Если клиент умеет только инструменты, агент остаётся «умелым стажёром без регламента и без папки с инструкциями». Он может тыкать кнопки CRM, но не видит промпт «что проверять по понедельникам» и не подтягивает ваш словарь стадий одним чтением.

Отсюда типичные жалобы: «агент выдумал стадии», «забыл шаги сводки», «не знает, с чего начать». Часто дело не в «глупой модели», а в том, что каталог промптов и ресурсов до неё просто не доехал.

Почему так бывает у разных клиентов

MCP - общий язык, а оболочки, которые его используют, разные. Кто-то показывает только вызовы tools. У кого-то промпты спрятаны в отдельном меню, и агент в чате их не трогает. У кого-то resources/read есть в спецификации, но в практике диалога модель предпочитает «ещё один tool», который уже видит в списке.

Мы не обещаем «починить чужой UI». Мы даём обходной путь на стороне сервера: то же содержимое, что отдаёт протокол для prompts и resources, но упакованное в четыре инструмента, которые клиент почти наверняка умеет вызывать.

Эти четыре пункта входят в служебный набор платформы и доступны на любом токене BestrankMCP. Подключать лишний продукт не нужно.

Четыре инструмента: зачем каждый из них

Группа в каталоге называется Сценарии для агента. Подробнее:

Что делает Зачем
Список доступных промптов Увидеть, какие сценарии реально открыты этому подключению
Получить доступный промпт Прочитать текст сценария и понять, какие инструменты и ресурсы от него зависят
Список доступных ресурсов Увидеть справочники и шаблоны адресов, которые можно читать
Получить доступный ресурс Прочитать один справочник по адресу; для шаблонов - с параметрами

Смысл тот же: сначала список доступных промптов или список доступных ресурсов, потом получить доступный промпт или получить доступный ресурс - уже подробнее.

Список и чтение сценариев

Список возвращает имена, короткие описания, какие аргументы ждут сценарий (например ID сделки) и зависимости: какие инструменты и справочники сценарий предполагает дальше. Это не правка шаблона - только «что мне разрешено запускать».

Получение отдаёт уже собранный текст сценария (с подставленными аргументами, если вы их передали) плюс те же зависимости. Дальше агент идёт по шагам: вызывает нужные tools, читает нужные resources.

Подробнее про сами промпты - Промпты: готовые сценарии. Как админ настраивает базовые и свои промпты - Базовые и пользовательские промпты.

Список и чтение справочников

Список ресурсов показывает и обычные адреса (один снимок), и шаблон с плейсхолдерами - например календарь на год, где год подставляется параметром.

Чтение берёт один URI. Если это шаблон без параметров - сервер ответит, что не хватает значений. Если адрес не входит в разрешённые возможности токена - «нельзя». Если URI неизвестен - «не найдено».

Зачем ресурсы отдельно от tools - Ресурсы: справочники без лишних вызовов.

Как пользоваться по шагам

Практический порядок для агента (и для вас, если подсказываете в чате):

  1. Спросите список сценариев.
  2. Выберите нужный по названию или описанию.
  3. Получите текст сценария; посмотрите зависимости.
  4. При необходимости запросите список справочников/ресурсов и прочитайте те, что в зависимостях.
  5. Выполните шаги сценария инструментами.

Кейс 1. РОП в клиенте без меню промптов: «Собери утреннюю сводку». Агент сначала берёт список сценариев, находит «утреннюю сводку», читает текст, видит зависимости на поиск просроченных сделок и справочник стадий - и только потом ходит в Bitrix24. Без этого шага он часто сразу зовёт случайный поиск и забывает половину чек-листа.

Кейс 2. Внедренец проверяет новый токен: «Что тебе вообще доступно из справочников?» Агент вызывает список ресурсов и показывает: производственный календарь, гайд по задачам, словарь воронки - без ручного лазанья по вкладкам админки.

Чем это не является

Это не замена вкладки «Промпты» в административном разделе: создавать и править пользовательские сценарии по-прежнему нужно самостоятельно (или через отдельные инструменты редактирования шаблонов).

Это не «расширение прав». Если сценарий или справочник не включены в возможности токена, список и чтение их не покажут. Ограничение остаётся на стороне токена - меняется только способ узнать, что уже разрешено.

Это не магический обход плохого промпта в чате. Сценарий всё равно нужно один раз описать и включить. Инструменты лишь делают его видимым там, где UI клиента «глухой» к native-спискам.

Про осознанный набор галочек на токене - Возможности токена.

Что проверить сегодня

  • В клиенте агент видит четыре инструмента группы Сценарии для агента.
  • Список промптов не пустой - если вы ожидали включённые промпты.
  • Получение одного сценария возвращает текст и зависимости.
  • Список ресурсов содержит нужные справочники; чтение одного URI работает (для шаблона - с параметром).
  • Если чего-то нет в списке - сначала смотрите возможности токена, а не «ломается ли модель».

Подключение клиента - Cursor, Claude и другие клиенты. Справочник группы - Сценарии для агента. Если останутся вопросы по конкретному клиенту - напишите, разберём по шагам в Подключении MCP.