Документ в MCP: resource или tool для чтения
Выбирайте ресурс для адресуемого содержимого, а инструмент — для вызываемой операции с параметрами и явным результатом. Сам факт чтения данных не даёт универсального ответа для любого клиента.
Где появляется ошибка
Внутренний справочник содержит политики компании. Один вариант — ресурс с устойчивым URI для определённого документа. Другой — инструмент поиска, который принимает вопрос и возвращает подходящие фрагменты. Это разные задачи. Если каждую страницу представить отдельным tool, каталог разрастается и затрудняет выбор; если поиск спрятать в непрозрачный ресурс без понятного способа получения, клиент не найдёт нужные данные.
Рабочее решение
Разделите обнаружение и чтение. Поиск может вернуть идентификаторы и метаданные документов; чтение конкретного документа сохраняет его адрес и версию. Проверьте возможности клиента: как он показывает resources пользователю и может ли модель получить их через предусмотренный интерфейс. Не считайте URI публичным разрешением на содержимое. Проверка прав требуется на фактическом чтении, включая ссылки, возвращённые поиском. Для изменяемого документа полезно сообщать актуальность и происхождение.
Контрольные случаи
| Проверка | Ожидаемое поведение |
|---|---|
| Известный URI доступного документа | Клиент получает именно выбранный документ и метаданные, позволяющие отличить версию и источник. |
| Поиск по смысловому вопросу | Результаты содержат доступные пользователю адреса, а не закрытые фрагменты из общего индекса. |
| Недоступный URI из старой истории | Сервер повторно проверяет права; прежнее появление ссылки не становится постоянным разрешением. |
Устойчивый адрес документа не обязан содержать физический путь файла. Лучше сохранять возможность изменить внутреннее хранение без превращения URI ресурса в непреднамеренный доступ к произвольному файлу сервера.
Поддержка ресурсов различается между клиентами. Сначала проведите короткий совместимый сценарий на целевом приложении; архитектурно красивый интерфейс бесполезен, если пользователь не может им воспользоваться.
Курс по MCP полезен, когда нужно выбирать подходящие примитивы интеграции и связывать их с ограничениями клиента. В платном курсе AI Agent Integrations PRO: MCP можно продолжить изучение соответствующего инженерного направления. Перед покупкой сравните программу и открытые материалы со своей задачей.
Документация для проверки технических деталей: Ресурсы MCP: спецификация 2025-06-18.
Следующий шаг: MCP-интеграции: контракты инструментов, ошибки и доступ. По смежным вопросам: Поле отсутствует или равно null в MCP: почему это разные запросы, MCP tool получает лишние аргументы: где нужна строгая проверка.
