Ресурсы и подсказки

Тема дорожной карты · Claude от Anthropic

MCP-серверы предоставляют два ключевых примитива: Resources и Prompts. Эти примитивы играют важную роль в оптимизации взаимодействия между Claude и внешними системами. Resources представляют собой адресуемые блоки данных, такие как файлы, строки баз данных или ответы API, идентифицируемые по URI. Prompts — это параметризованные шаблоны, хранящиеся на сервере, которые позволяют пользователю формировать запросы к модели с помощью заранее определенных шаблонов. Оба примитива снижают потребление токенов, так как клиенты запрашивают только необходимые данные, что уменьшает размер контекста и улучшает производительность. Важно помнить, что URI ресурсов определяются сервером, поэтому необходимо валидировать их для предотвращения path-traversal.

Как это работает

Ресурсы и подсказки — это ключевые элементы Model Context Protocol (MCP), открытого стандарта для подключения LLM к внешним системам (tools, data, context). MCP-серверы экспонируют данные и функции через транспортные средства (stdio для локальных серверов, SSE/HTTP для удаленных). Клиенты, такие как Claude Code, Claude Desktop, Cursor и пользовательские приложения, используют эти ресурсы и инструменты для взаимодействия с моделью. Примеры использования включают подключение Claude к базам данных, календарям, тикет-системам, внутренним документам и системам мониторинга.

Когда применять

MCP-серверы следует использовать для любой внутренней системы, к которой Claude должен иметь доступ. Это может быть база данных, система управления тикетами (например, Linear, Jira), система мониторинга (например, Grafana, Prometheus) или внутренние документы и wiki. Для локальной разработки рекомендуется использовать транспорт stdio, а для удаленных серверов — HTTP/SSE. Всегда используйте аутентификацию на удаленных MCP-серверах, чтобы предотвратить несанкционированный доступ. Также важно контролировать права доступа, чтобы каждый MCP-сервер экспонировал только те инструменты, которые нужны для выполнения конкретных задач.

Типичные ошибки

Типичные ошибки при использовании ресурсов и подсказок включают экспонирование write-tools без подтверждения (например, Claude может автономно вызывать delete_db), использование MCP-серверов с перmissive-кредентами (что позволяет Claude наследовать все права доступа), запуск нескольких MCP-серверов одновременно (что может вызвать путаницу у модели из-за перегрузки инструментами) и отсутствие обновления MCP-серверов по мере эволюции схемных требований Claude.

Связанные понятия

Полезные ресурсы