ketl cloud
HjemMCPStreamable HTTP

Migrer fra SSE til Streamable HTTP

MCP-spesifikasjonen forlot SSE-transporten i 2025-03-26-revisjonen på grunn av dårlig proxy-kompatibilitet, manglende resumable streams og skaleringsproblemer. ketl cloud følger det samme — Streamable HTTP er primær-transport, SSE-endepunktet stenges 30. november 2026.

SSE-endepunktet (https://api.ketl.no/mcp/sse) er deprecated

Alle responses har Deprecation: true og Sunset-header. Etter sunset-dato returneres 410 Gone.

Hvorfor Streamable HTTP?

SSE-problemer

• Enveis stream — klient sender via separat POST

• Timeouts i corporate proxies og load balancers

• Ikke resumable — avbrutt forbindelse krever restart

• Vanskelig å skalere bak cloudfronts og CDN-er

• Stateless-problemer med sesjonsmanagement

Streamable HTTP-fordeler

• Toveis over samme HTTPS-path (POST init, GET upgrade)

• Proxy- og WAF-vennlig (standard HTTP-semantikk)

• Resumable via Mcp-Session-Id + Last-Event-ID

• Skalerer horisontalt uten sticky sessions

• Batching av flere JSON-RPC-kall i én forbindelse

Klient-matrise

KlientMin. versjonAnbefalt transportMerknad
Claude Desktop0.12.0streamable-httpBruk 'transport': 'streamable-http' i mcpServers-config. Eldre versjoner faller tilbake til SSE.
Cursor0.44.0streamable-http—
Cline3.10.0streamable-http—
Windsurf1.9.0streamable-http—
MCP Inspector0.11.0streamable-httpBrukes for e2e-validering i CI.
Egen klient / SDK—streamable-httpBruk @modelcontextprotocol/sdk >= 1.0 som implementerer Streamable HTTP og håndterer resumable streams automatisk.

6-stegs migrasjonsguide

  1. 1
    Oppgrader MCP-klienten
    Sjekk at klienten din støtter Streamable HTTP. Se tabellen for minimumsversjoner. Eldre klienter må oppgraderes før migrasjonen.
  2. 2
    Bytt endepunkt-URL
    Endre `/mcp/sse` til `/mcp` i konfigurasjonen. Ikke legg til `/events` eller `/stream` — Streamable HTTP håndterer POST + GET over samme path.
    - "url": "https://api.ketl.no/mcp/sse"
+ "url": "https://api.ketl.no/mcp"
  3. 3
    Sett transport eksplisitt
    Noen klienter autodeteksjonerer, men sett `"transport": "streamable-http"` (eller `"type": "streamable-http"`) for å unngå fallback til SSE.
    "ketl": {
  "url": "https://api.ketl.no/mcp",
  "transport": "streamable-http",
  "headers": { "Authorization": "Bearer <token>" }
}
  4. 4
    Valider med MCP Inspector
    Kjør `npx @modelcontextprotocol/inspector` lokalt og sjekk at alle verktøy listes, at `initialize` returnerer uten feil, og at en prøve-`tools/call` fungerer.
    npx @modelcontextprotocol/inspector \
  --transport streamable-http \
  --url https://api.ketl.no/mcp \
  --header "Authorization: Bearer $KETL_API_KEY"
  5. 5
    Overvåk Deprecation-header
    SSE-endepunktet sender `Deprecation: true` og `Sunset: Sun, 30 Nov 2026 22:59:59 GMT`. Sett opp monitoring i klienten slik at du fanger det opp hvis noe fortsatt bruker det gamle endepunktet.
  6. 6
    Verifiser resumable streams
    Nye Streamable HTTP gjenopptar avbrutte tilkoblinger ved hjelp av Mcp-Session-Id + Last-Event-ID. Test at langvarige `tools/call` overlever nettverksglitch uten å starte på nytt.

Deprecation-headers på SSE-endepunktet

Hver response fra https://api.ketl.no/mcp/sse sender følgende headers mens endepunktet fortsatt er aktivt:

Deprecation: true
Sunset: Mon, 30 Nov 2026 22:59:59 GMT
Link: <https://api.ketl.no/mcp>; rel="successor-version"
X-Ketl-Mcp-Transport: sse (deprecated)

Sett opp monitoring i klienten for Deprecation: true slik at du fanger det opp hvis noe fortsatt bruker det gamle endepunktet.

Nytt endepunkt
Bruk dette i stedet for /mcp/sse.
https://api.ketl.no/mcp

Kilder

  • MCP Specification 2025-03-26 (modelcontextprotocol.io)
  • Why MCP deprecated SSE (fka.dev)
  • SSE vs Streamable HTTP (Bright Data)

Sunset-dato i ISO 8601: 2026-11-30T23:59:59+01:00

ketl cloud
DataApperMCPPriser
AI-transparensPersonvernSikkerhet

© 2026 ketl cloud

build c372edd · 2026-05-11 14:18:12 UTC