MCP SSE obsoleto: migre para Streamable HTTP antes que seu servidor seja interrompido

O transporte de eventos enviados pelo servidor MCP atingiu o fim da vida útil em 1º de abril de 2026. As bibliotecas cliente ainda envia suporte SSE para compatibilidade com versões anteriores, mas a próxima versão secundária do protocolo base remove-o, e o registro público do MCP agora rejeita novas listagens somente de SSE. Se o seu servidor MCP ainda responde em /sse e /messages, você tem uma janela de migração, não uma janela para sempre.

O SSE manteve uma conexão TCP aberta por cliente. Duas cópias do seu servidor MCP atrás de uma carga o balanceador produziu sessões de divisão cerebral; o dimensionamento horizontal exigia roteamento fixo que a maioria balanceadores de carga gerenciados não podem se expressar de forma clara. HTTP streamable usa solicitação-resposta padrão ciclos com fluxos recuperáveis ​​opcionais, o que significa que qualquer instância pode responder a qualquer solicitação e todo CDN do mundo já sabe como armazená-lo em cache e roteá-lo.

Aqui está o caminho completo da migração: o código do servidor antes e depois, um padrão de armazenamento de dados para ferramentas com estado, uma implementação Cloudflare Workers, um equivalente FastAPI e um .well-known arquivo de metadados para que os clientes possam descobrir seu servidor sem abrir um conexão primeiro.

Etapa 1: excluir o manipulador SSE

O código antigo se parece com isso. Duas rotas, um mapa de sessão mantido na memória do processo e um mapa de transporte que mantém a resposta aberta até que o cliente se desconecte:

Todos os problemas com o SSE aparecem nesse trecho. O transports O mapa é apenas visível para um processo; reinicie o servidor e todas as sessões abertas serão encerradas; dimensionar horizontalmente e metade dos seus clientes acessa um servidor que nunca ouviu falar deles. Arranque-o.

Etapa 2: instalar HTTP streamável

O novo manipulador é menor. Uma rota responde GET e POST; cada solicitação gera um novo par servidor e transporte; o coletor de lixo limpa quando a resposta é fechada:

Três chaves são importantes. sessionIdGenerator: undefined desativa a fixação da sessão, então o transporte é totalmente apátrida. enableJsonResponse: true retorna um único JSON body para ferramentas que não emitem progresso, o que mantém o caminho rápido e armazenável em cache. O res.on("close") a limpeza evita vazamentos de soquete na desconexão antecipada do cliente.

Etapa 3: Remover o estado da sessão da memória do processo

Um manipulador sem estado não significa um produto sem estado. Ferramentas de longa duração ainda precisam ser relatadas progresso em várias solicitações. Coloque esse estado no Redis, um objeto durável, DynamoDB ou Postgres; leia na entrada, escreva na saída:

O Mcp-Session-Id o cabeçalho, se presente, identifica a sessão lógica; o manipulador usa-o como uma chave de armazenamento de dados. UM Last-Event-Id cabeçalho do cliente permite que o transporte retoma um fluxo após uma desconexão sem reiniciar a chamada da ferramenta. Ambos os cabeçalhos são opcional; ferramentas sem estado podem ignorá-las completamente.

Etapa 4: implantar sem servidor

HTTP streamable desbloqueia o que o SSE bloqueou: executar um servidor MCP no Cloudflare Workers, AWS Lambda, Vercel Functions ou Fly Machines. Aqui está o servidor Cloudflare Workers completo em 40 linhas, atingindo o endpoint de pesquisa de IP do Botoi como uma ferramenta de exemplo:

Sem mapa de sessão, sem temporizadores em segundo plano, sem pings de manutenção de atividade. O Worker gira sob demanda, responde a solicitação e desliga. Um Worker lida com qualquer número de clientes paralelos porque há nenhum estado mutável compartilhado. Inicializações a frio para servidores MCP em Workers atingem menos de 5 ms para a maioria superfícies de ferramentas; no Lambda eles ficam de 50 a 200 ms frios.

Etapa 5: migração Python com FastAPI

Os servidores Python têm o mesmo formato. O manipulador FastAPI constrói o servidor MCP por solicitação e delegados ao transporte:

O padrão é o mesmo em todas as linguagens: construir o servidor por solicitação, entregar a solicitação HTTP ao transporte, devolva tudo o que o transporte produz. Os tempos de execução da linguagem são diferentes; a arquitetura não.

Etapa 6: publicar uma placa de servidor para descoberta

Uma das lacunas que o roteiro para 2026 preenche é a descoberta sem conexão. Registros e os rastreadores costumavam precisar de um aperto de mão ao vivo para saber o que seu servidor fazia. Servir um documento JSON em /.well-known/mcp/server-card.json e os clientes podem aprender o URL de transporte, esquema de autenticação e capacidade definida antes de se conectarem:

Esta é a parte que permite que as plataformas de agentes indexem seu servidor sem investigá-lo. Autenticação0 para Agentes, Cloudflare Agent Cloud e o registro público MCP consomem esse formato; adicione uma vez e seu servidor se tornará listável.

Verifique a migração

Antes de inverter o DNS, execute o inspetor ou faça curl no novo endpoint. O primeiro emerge um UI com todas as ferramentas e recursos expostos; a segunda confirma que o formato do fio está correto:

Um sucesso tools/list resposta com seu catálogo completo de ferramentas significa que o servidor está viver. Se a resposta voltar como text/event-stream quando você espera JSON, o transporte tem enableJsonResponse desabilitado; vire a bandeira.

O que permanece igual, o que muda

Principais conclusões

• SSE está obsoleto, não removido. Os clientes ainda aceitam até 2026, mas novos servidores e listagens de registro exigem HTTP Streamable.
• Crie novos por solicitação. Nenhum mapa de sessão em processo; deixe o objeto do servidor viva apenas enquanto o RPC durar.
• Envie o estado para um armazenamento de dados. Redis, objetos duráveis ​​ou Postgres digitados no Mcp-Session-Id cabeçalho.
• Serverless está de volta à mesa. Trabalhadores Cloudflare, Lambda, Vercel Funções; nenhum deles apoiou bem a ESS de longa duração.
• Publique uma placa de servidor. /.well-known/mcp/server-card.json faz seu servidor detectável sem uma conexão.

O servidor MCP do Botoi é fornecido em Streamable HTTP em api.botoi.com/mcp com 49 ferramentas selecionadas para pesquisa de IP, validação de e-mail, DNS, hashing, assinatura JWT e QR geração. A fonte é licenciada pelo MIT e reflete o padrão acima; leia o documentos de configuração para Configurações de Claude Desktop, Claude Code, Cursor, VS Code e Windsurf.