MCP Roots, Sampling и Logging: варианты миграции после признания устаревшими в редакции 2026-07-28

Что это

По состоянию на 25 октября 2026 года. В редакции 2026-07-28 механизмы Roots, Sampling и Logging объявлены устаревшими. Прежде чем удалять код совместимости, заново проверьте уведомления по каждому из них, реестр устаревших возможностей и политику жизненного цикла. Согласно реестру, удалить их можно не раньше первой редакции, выпущенной 2027-07-28 или позднее. Это условие, при котором становится допустимым будущее изменение спецификации, а не дата автоматического отключения.

Устаревшие возможности остаются в спецификации. Новым реализациям следует избегать их использования, а существующим — перейти на замену. Сроки удаления из SDK определяются отдельно. Общая политика также допускает документированную ускоренную процедуру для рисков безопасности, соответствующих установленным критериям, поэтому обычный двенадцатимесячный срок не гарантирован безусловно во всех обстоятельствах.

Почему это важно

Эти три механизма решают разные задачи. Roots сообщает о значимых расположениях в файловой системе, Sampling делегирует клиенту запрос к модели, а Logging передаёт уведомления с сообщениями журнала по протоколу. При их замене обязанности могут переходить между клиентом, сервером и оператором. Если миграция ограничится удалением флагов возможностей, нужная функциональность может остаться без реализации.

Для Roots прямо указан информационный характер: MCP не обеспечивает изоляцию доступа к файловой системе. Sampling сейчас позволяет клиенту контролировать доступ к модели и разрешения. Протокольный Logging отличается от эксплуатационных журналов сервера. Учитывайте эти различия при выборе замены.

Как применять

• Замените Roots явным контекстом. Документация предлагает параметры инструментов, URI ресурсов или конфигурацию сервера, описывающую каталоги и файлы. Проверяйте пути и права в том компоненте, который обращается к ним. Сохраните получение согласия пользователя и надлежащий контроль доступа: переданный каталог не доказывает, что вызывающая сторона вправе его читать. Если в этой редакции вы сохраняете Roots, объявляйте эту возможность в каждом запросе и выполняйте обмен roots/list через механизм запросов ввода.
• Замените Sampling прямой интеграцией с провайдером. Спецификация рекомендует интеграцию непосредственно с API провайдеров языковых моделей. Считайте это перераспределением ответственности, а не простым переименованием: документируйте, какой компонент получает доступ к модели и какие данные отправляет. Прежний интерфейс Sampling обеспечивал контроль на стороне клиента и рекомендовал проверку человеком. Сохраните равноценную проверку там, где она нужна приложению, и протестируйте сценарий отказа. В переходный период объявляйте возможности Sampling в каждом запросе и избегайте устаревших параметров межсерверного контекста.
• Направьте эксплуатационные журналы в подходящее место. Документированные варианты — stderr для транспортов stdio и OpenTelemetry для структурированной наблюдаемости. Не допускайте попадания секретов и персональных данных в сообщения журнала и контролируйте доступ к собранным журналам. Если для совместимости всё ещё нужен протокольный Logging, сервер объявляет logging, а клиенты запрашивают уровень через io.modelcontextprotocol/logLevel в _meta.
• Проверьте журналирование в рамках отдельного запроса. Сервер не должен отправлять notifications/message, если в этом запросе не указан уровень. Допустимые сообщения относятся к потоку ответа на этот запрос и никогда — к потоку подписки. Убедитесь, что выбор подробности журнала одним клиентом не влияет на запрос другого.
• Откажитесь от каждой зависимости по отдельности. Предлагаемая процедура внедрения: составить перечень потребителей, внедрить замену, проверить тот же разрешённый рабочий сценарий и лишь затем перестать объявлять устаревшую возможность. Сохраняйте подтверждения того, каким клиентам она всё ещё нужна.

Подводные камни

Прямая интеграция с моделью не наследует автоматически интерфейс получения согласия прежнего клиента. Новое место назначения журналов не гарантирует сохранения маскирования чувствительных данных. Параметр с путём не создаёт песочницу. Признание возможностей устаревшими — повод тщательно спланировать изменения, а не разрешение ослабить средства контроля.