MCP SSE устарел: перейдите на Streamable HTTP, прежде чем ваш сервер выйдет из строя.

Транспорт событий, отправленных сервером MCP, завершился 1 апреля 2026 года. Клиентские библиотеки все еще добавить поддержку SSE для обратной совместимости, но следующую второстепенную версию базового протокола удаляет его, и публичный реестр MCP теперь отклоняет новые списки только для SSE. Если ваш сервер MCP все еще отвечает на /sse и /messages, у вас есть окно миграции, а не вечное окно.

SSE держал открытым одно TCP-соединение для каждого клиента. Две копии вашего сервера MCP под нагрузкой балансировщик создавал сеансы разделенного мозга; горизонтальное масштабирование требовало липкой маршрутизации, что большинство управляемые балансировщики нагрузки не могут выражать чисто. Streamable HTTP использует стандартный запрос-ответ. циклы с дополнительными возобновляемыми потоками, что означает, что любой экземпляр может ответить на любой запрос и каждая CDN в мире уже знает, как кэшировать и маршрутизировать данные.

Вот полный путь миграции: код сервера «до» и «после», шаблон хранилища данных для инструменты с отслеживанием состояния, реализация Cloudflare Workers, эквивалент FastAPI и .well-known метаданных, чтобы клиенты могли обнаружить ваш сервер, не открывая подключение в первую очередь.

Шаг 1. Удалите обработчик SSE.

Старый код выглядит так. Два маршрута, карта сеансов, хранящаяся в памяти процесса, и транспортный маршрут. который сохраняет ответ открытым до тех пор, пока клиент не отключится:

В этом фрагменте отображаются все проблемы с SSE. transports Карта только видимый для одного процесса; перезапустите сервер, и каждый открытый сеанс завершится; масштабировать по горизонтали и половина ваших клиентов попадает на сервер, который никогда о них не слышал. Вырвите это.

Шаг 2. Установите потоковый HTTP

Новый обработчик стал меньше. Один маршрут отвечает как GET, так и POST; каждый запрос запускает новый серверно-транспортная пара; сборщик мусора очищает, когда ответ закрывается:

Три ключа имеют значение. sessionIdGenerator: undefined отказывается от закрепления сеанса, поэтому транспорт полностью без гражданства. enableJsonResponse: true возвращает один JSON тело для инструментов, которые не выдают информацию о ходе выполнения, что обеспечивает быстрый и кэшируемый путь. res.on("close") очистка предотвращает утечку сокетов при раннем отключении клиента.

Шаг 3. Переместите состояние сеанса из памяти процесса.

Обработчик без сохранения состояния не означает продукт без сохранения состояния. Долго работающим инструментам все еще нужно сообщать прогресс по нескольким запросам. Поместите это состояние в Redis, Durable Object, DynamoDB или Постгрес; прочитайте его при входе, напишите при выходе:

The Mcp-Session-Id заголовок, если он присутствует, идентифицирует логический сеанс; обработчик использует его как ключ хранилища данных. А Last-Event-Id заголовок от клиента позволяет транспорт возобновляет поток после отключения без перезапуска вызова инструмента. Оба заголовка необязательно; инструменты без сохранения состояния могут полностью их игнорировать.

Шаг 4. Развертывание бессерверной системы

Streamable HTTP разблокирует то, что заблокировано SSE: запуск сервера MCP на Cloudflare Workers, AWS Лямбда, функции Верселя или летающие машины. Вот полный сервер Cloudflare Workers за 40 строк, используя конечную точку поиска IP-адресов Botoi в качестве примера инструмента:

Никакой карты сеансов, никаких фоновых таймеров, никаких сигналов проверки активности. Рабочий раскручивается по требованию, отвечает запрос и выключается. Один Worker обслуживает любое количество параллельных клиентов, поскольку существует нет общего изменяемого состояния. Холодный запуск серверов MCP на рабочих частотах для большинства составляет менее 5 мс. поверхности инструментов; на Лямбде они холодные от 50 до 200 мс.

Шаг 5. Миграция Python с помощью FastAPI

Серверы Python приобретают такую ​​же форму. Обработчик FastAPI создает сервер MCP для каждого запроса. и делегаты на транспорте:

Схема одинакова для всех языков: создание сервера для каждого запроса, передача HTTP-запроса транспорт, возвращайте все, что производит транспорт. Языковые среды выполнения различаются; архитектура нет.

Шаг 6. Публикация карты сервера для обнаружения

Один из пробелов, который закрывает дорожная карта на 2026 год, — это открытия без связи. Реестры и Раньше сканерам требовалось живое рукопожатие, чтобы узнать, что делает ваш сервер. Отправьте документ JSON по адресу /.well-known/mcp/server-card.json и клиенты могут узнать URL-адрес транспорта, схема аутентификации и набор возможностей перед подключением:

Это часть, которая позволяет платформам агентов индексировать ваш сервер, не проверяя его. Auth0 для Агенты, Cloudflare Agent Cloud и публичный реестр MCP используют этот формат; добавить это один раз, и ваш сервер станет доступен для просмотра.

Проверьте миграцию

Прежде чем перевернуть DNS, запустите инспектор или сверьтесь с новой конечной точкой. Первые поверхности a Пользовательский интерфейс со всеми доступными инструментами и ресурсами; второй подтверждает, что формат провода правильный:

Успешный tools/list ответ с полным каталогом инструментов означает, что сервер жить. Если ответ возвращается как text/event-stream когда вы ожидаете JSON, транспорт имеет enableJsonResponse неполноценный; перевернуть флаг.

Что остается прежним, что меняется

Ключевые выводы

• SSE устарел и не удален. Клиенты по-прежнему принимают его до 2026 года, но новый серверы и списки реестра требуют Streamable HTTP.
• Сборка новых по запросу. Никаких карт сеансов в процессе; пусть сервер возражает жить ровно столько, сколько потребуется RPC.
• Отправить состояние в хранилище данных. Redis, Durable Objects или Postgres с ключами на Mcp-Session-Id заголовок.
• Бессерверные технологии снова на столе. Работники Cloudflare, Lambda, Vercel Функции; ни один из них не поддержал долгосрочную SSE.
• Опубликуйте карточку сервера. /.well-known/mcp/server-card.json делает ваш сервер доступен для обнаружения без подключения.

Сервер MCP Botoi поставляется на Streamable HTTP по адресу api.botoi.com/mcp с 49 тщательно подобранными инструментами для поиска IP, проверки электронной почты, DNS, хеширования, подписи JWT и QR. поколение. Источник имеет лицензию MIT и отражает приведенную выше схему; прочитать документация по настройке для Конфигурации Claude Desktop, Claude Code, Cursor, VS Code и Windsurf.