Миграция на 2026-07-28

Главные изменения#

Сессии и рукопожатие#

Было (2025-11-25 и ранее). Клиент открывал соединение, отправлял initialize, согласовывал версию и возможности, затем присылал notifications/initialized. Сервер мог выдать идентификатор сессии в заголовке Mcp-Session-Id, и последующие запросы опирались на это состояние.

Стало (2026-07-28). Рукопожатия нет. Каждый запрос самодостаточен:

• версия протокола и возможности клиента передаются в _meta (io.modelcontextprotocol/protocolVersion, io.modelcontextprotocol/clientCapabilities);
• клиентам СЛЕДУЕТ указывать себя в каждом запросе (io.modelcontextprotocol/clientInfo), а серверам СЛЕДУЕТ указывать себя в _meta каждого результата (io.modelcontextprotocol/serverInfo);
• несовпадение версий возвращает UnsupportedProtocolVersionError.

Пример запроса tools/list в новой ревизии:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list",
  "params": {
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": { "name": "example-client", "version": "1.0.0" },
      "io.modelcontextprotocol/clientCapabilities": { "elicitation": {} }
    }
  }
}

Удалённые методы#

Удалены ping, logging/setLevel и notifications/roots/list_changed. Уровень журнала теперь задаётся для каждого запроса ключом io.modelcontextprotocol/logLevel в _meta. Серверы НЕ ДОЛЖНЫ отправлять notifications/message для запросов, где это поле не указано.

Задачи стали расширением#

Экспериментальные задачи вынесены из ядра в официальное расширение io.modelcontextprotocol/tasks. Переработанное расширение:

• вместо блокирующего tasks/result использует опрос через tasks/get;
• добавляет tasks/update для передачи входных данных от клиента серверу;
• удаляет tasks/list;
• позволяет серверам возвращать дескрипторы задач без запроса.

Потоки SSE#

Убраны возобновление потоков и повторная доставка. Оборванный поток ответа теряет находящийся в обработке запрос: клиенты ДОЛЖНЫ отправить его заново как новый запрос с новым идентификатором. Подробнее: «Транспорты».

Что ещё изменилось#

1. В ClientCapabilities и ServerCapabilities добавлено поле extensions для необязательных расширений.
2. Задокументированы соглашения о передаче контекста трассировки OpenTelemetry в _meta (traceparent, tracestate, baggage).
3. Серверам СЛЕДУЕТ возвращать инструменты из tools/list в детерминированном порядке: это упрощает кэширование и повышает попадание в кэш подсказок модели.
4. Обязательные стандартные заголовки Mcp-Method и Mcp-Name в POST-запросах Streamable HTTP и поддержка собственных заголовков из параметров инструментов через x-mcp-header.
5. Обязательные поля ttlMs и cacheScope в результатах tools/list, prompts/list, resources/list, resources/read и resources/templates/list (интерфейс CacheableResult). ttlMs — подсказка свежести в миллисекундах, cacheScope ("public" или "private") определяет, могут ли общие посредники кэшировать ответ. Поля дополняют уведомления listChanged.
6. Код ошибки «ресурс не найден» изменён с -32002 на -32602.
7. Серверам авторизации СЛЕДУЕТ включать параметр iss в ответы авторизации (RFC 9207), а клиенты ДОЛЖНЫ сверять присутствующий iss с записанным эмитентом до обмена кода авторизации.
8. Клиенты ДОЛЖНЫ указывать подходящий application_type при динамической регистрации клиента, чтобы избежать конфликтов redirect URI в OpenID Connect.
9. Учётные данные клиента привязаны к серверу авторизации, который их выдал: клиенты ДОЛЖНЫ хранить сохранённые данные с ключом по идентификатору эмитента, НЕ ДОЛЖНЫ использовать их с другим сервером авторизации и ДОЛЖНЫ заново регистрироваться при смене сервера авторизации.
10. inputSchema и outputSchema допускают любые ключевые слова JSON Schema 2020-12, а structuredContent любое значение JSON. Добавлены требования к разрешению $ref и пределы ресурсов для конструкций композиции.
11. Удалены уведомление notifications/elicitation/complete и поле elicitationId у запросов элицитации в режиме URL (появились в 2025-11-25).
12. Введена политика распределения кодов ошибок: -32000…-32019 остаются реализационными, -32020…-32099 зарезервированы за спецификацией.

Новые коды ошибок#

Ошибка HeaderMismatchError добавлена в схему. Подробнее: «Ошибки».

Устаревшие возможности#

Эти возможности остаются частью спецификации, но их планируют удалить по политике жизненного цикла функций. Новым реализациям их принимать НЕ СЛЕДУЕТ. Минимальное окно устаревания — двенадцать месяцев, а все устаревшие функции собраны в реестре.

Что менять по ролям#

Сводка составлена по перечню изменений.

Клиент

• Добавьте в каждый запрос protocolVersion и clientCapabilities в _meta, а по HTTP заголовки MCP-Protocol-Version, Mcp-Method и Mcp-Name. Кодируйте значения по правилам Base64.
• Если поддерживаете x-mcp-header, дублируйте помеченные параметры в Mcp-Param-*; инструменты с некорректной пометкой исключайте из перечня.
• Обработайте UnsupportedProtocolVersionError и повторяйте запрос с общей версией.
• Для двухэпохной поддержки определите эпоху сервера (пробой server/discover на stdio, современным запросом по HTTP) и кэшируйте результат.
• Считайте отсутствие resultType значением "complete"; обрабатывайте "input_required" повтором запроса.
• Подписывайтесь на изменения через subscriptions/listen, а не через GET и resources/subscribe. Свежесть дополнительно поддерживайте опросом с учётом ttlMs.
• Заново отправляйте запрос, если поток SSE оборвался.

Сервер

Расхождения в источниках#

• В публикациях о ревизии встречается утверждение, что server/discover необязателен. В спецификации серверы ДОЛЖНЫ его реализовать, а необязателен лишь его вызов клиентом.