· von Michael Kerkhoff

MCP-Integrations-Entwicklungshandbuch 2026

MCP-Integrationsleitfaden 2026: finale Stateless-Spezifikation 2026-07-28, stabile TypeScript/Python-SDKs v2, Paketnamen-Migration, Vercel Functions und Security-Patterns.

Wesentliche Tools & SDKs

(01)

MCP TypeScript SDK v2

Das offizielle TypeScript-SDK ist keine Beta mehr. v2.0.0 ist die stabile Release-Linie für die Spezifikation 2026-07-28 und erscheint als getrennte Pakete: @modelcontextprotocol/core für Schemas und Protokollkonstanten, @modelcontextprotocol/server, @modelcontextprotocol/client und @modelcontextprotocol/express. Das alte Paket @modelcontextprotocol/sdk bleibt die v1-Maintenance-Linie; Teams, die nur diesen Paketnamen beobachten, glauben fälschlich, MCP v2 sei noch nicht gelandet. Neue stateless Server sollten die v2-Pakete nutzen; bestehende v1-Imports per Codemod und Migrationsnotizen umziehen.

Stabile v2-Server/Clients, v1-Paketnamen-MigrationFree / Open SourceAI-Native
(02)

MCP Python SDK (modelcontextprotocol/python-sdk)

Offizielle Python-Implementierung. mcp 2.0.0 erschien am 28. Juli 2026 als stabile v2-Version und unterstützt die MCP-Revision 2026-07-28, während derselbe Server frühere Revisionen bedienen kann. pip install mcp installiert jetzt 2.x; v1.x ist nur noch Maintenance für kritische Fixes und Security-Patches. Beste Wahl für Python-Datenwerkzeuge, lokale CLIs und FastMCP-artige Server, bei denen Decorators und Pydantic-Modelle Tool-Schemas nah an der Fachlogik halten.

Stabile Python-v2-Server, Datenwerkzeuge, Decorator-basierte ToolsFree / Open SourceAI-Native
(03)

Vercel MCP Adapter (@vercel/mcp-adapter)

Erstklassiges MCP-Deployment auf Vercel Functions und Fluid Compute. Kapselt Ihren MCP-Server in eine Next.js-Route oder Node-Funktion — kein dauerhafter Prozess zu betreiben. Streamable HTTP und stateless MCP-v2-Requests passen zu normalem Load Balancing; OAuth-2.1-nahe Absicherung macht Remote-Server für echte Clients nutzbar. Fluid Compute ist gegenüber Edge-only Functions die kompatiblere Vorgabe, solange kein gemessener Edge-Zwang existiert.

Serverless-Deployment, Next.js-Integration, OAuth 2.1Free Tier; kostenpflichtige Pläne – siehe Vercel-PreisseiteAI-Native
(04)

FastMCP (Python)

High-Level-Python-Framework auf Basis des offiziellen Python-SDK. Reduziert MCP-Server-Boilerplate auf nahezu null — eine Funktion wird in 3 Zeilen als MCP-Tool exponiert. Schema-Generierung aus Python-Typ-Annotationen erfolgt automatisch. Beste Wahl für schnelle Python-MCP-Prototypen und datenwissenschaftsnahe Server. Community-gepflegt und weit verbreitet.

Rapid Prototyping, minimaler Boilerplate, typgetriebene SchemasFree / Open SourceAI-Native
(05)

MCP Inspector (@modelcontextprotocol/inspector)

Offizielles visuelles Debugging-Tool für MCP-Server. Verbindet sich mit jedem MCP-Server (stdio oder HTTP) und bietet eine Web-UI zum Durchsuchen verfügbarer Tools, zur Ausführung mit eigenen Eingaben und zur Inspektion roher JSON-RPC-Nachrichten. Das Äquivalent von Postman für MCP — unverzichtbar für Entwicklung und Validierung. Lokal starten mit `npx @modelcontextprotocol/inspector`.

Debugging, Tool-Erkundung, JSON-RPC-InspektionFree / Open SourceAI-Native
(06)

Zod (Schema Validation)

Nicht MCP-spezifisch, aber weiterhin der Standard-Begleiter für TypeScript-Tool-Input-Schemas. MCP v2 unterstützt Standard-Schema-kompatible Libraries, darunter Zod v4, ArkType, Valibot per Converter oder rohes JSON Schema. Die Regel bleibt: Jeder produktive MCP-Server braucht Runtime-Validierung, bevor ein Tool Shell-Befehle, SQL, CRM-Daten oder Kundendateien berührt.

TypeScript-Schema-Validierung, JSON-Schema-GenerierungFree / Open Source
(07)

mcp-remote / mcp-proxy

Überbrückt die Lücke zwischen stdio-only-MCP-Clients (Claude Desktop Config) und HTTP-gehosteten MCP-Servern. Fungiert als lokaler Proxy, der stdio-Aufrufe an einen remote Streamable-HTTP- oder SSE-Endpunkt weiterleitet. Unverzichtbares Muster, um Claude Desktop oder Cursor mit produktiven Cloud-MCP-Servern zu verbinden, ohne sie lokal betreiben zu müssen.

Transport-Bridging, stdio-to-HTTP-ProxyFree / Open SourceAI-Native
(08)

Smithery MCP Registry

Eines der großen MCP-Server-Verzeichnisse, 2026 stark gewachsen. Discovery, Installation und Publishing von MCP-Servern; Hosted Remote Server Infrastructure ermöglicht Drittanbieter-Server ohne lokalen Prozessbetrieb. Zum Vergleich: Glama.ai mit einem breiten, kuratierten Katalog und die Official MCP Registry für geprüfte First-Party-Server. Registry-Discovery ist ein Startpunkt, keine Trust Boundary: Source, Auth, Scopes und Egress vor Produktion prüfen.

Server-Discovery, Registry, MarktplatzKostenlos zum Durchsuchen; Premium-Server variierenAI-Native

SDK- & Tool-Vergleich

NameFokusbereichTech-StackMaintainerPreisKI-nativ
(01) MCP TypeScript SDK v2Stabile v2-Server/Clients, v1-Paketnamen-MigrationTypeScript, Node.js 20+, Standard Schema/Zod, JSON-RPC 2.0Anthropic + Linux FoundationFree / Open Source✓ Ja
(02) MCP Python SDK (modelcontextprotocol/python-sdk)Stabile Python-v2-Server, Datenwerkzeuge, Decorator-basierte ToolsPython 3.10+, asyncio, Pydantic v2, JSON-RPC 2.0Anthropic + Linux FoundationFree / Open Source✓ Ja
(03) Vercel MCP Adapter (@vercel/mcp-adapter)Serverless-Deployment, Next.js-Integration, OAuth 2.1Next.js, Vercel Functions, Fluid Compute, TypeScript SDKVercelFree Tier; kostenpflichtige Pläne – siehe Vercel-Preisseite✓ Ja
(04) FastMCP (Python)Rapid Prototyping, minimaler Boilerplate, typgetriebene SchemasPython 3.10+, FastMCP, Pydantic, asyncioCommunity (jlowin + contributors)Free / Open Source✓ Ja
(05) MCP Inspector (@modelcontextprotocol/inspector)Debugging, Tool-Erkundung, JSON-RPC-InspektionNode.js, Web-UI, JSON-RPC 2.0 TraceAnthropic + communityFree / Open Source✓ Ja
(06) Zod (Schema Validation)TypeScript-Schema-Validierung, JSON-Schema-GenerierungTypeScript, keine AbhängigkeitenColin McDonnell + communityFree / Open Source– Nein
(07) mcp-remote / mcp-proxyTransport-Bridging, stdio-to-HTTP-ProxyNode.js, stdio, HTTP/SSE, Streamable HTTPCommunity (geelen + contributors)Free / Open Source✓ Ja
(08) Smithery MCP RegistryServer-Discovery, Registry, MarktplatzWeb-Plattform, npm-ähnliche InstallationSmitheryKostenlos zum Durchsuchen; Premium-Server variieren✓ Ja

← Horizontal scrollen, um alle Spalten zu sehen

Implementierungs-Playbook

  1. (01)

    Zuerst die Spezifikationslinie wählen: 2026-07-28 plus SDK v2 ist jetzt der stabile Greenfield-Pfad; 2025-11-25 plus SDK v1 ist der Maintenance-Pfad für bestehende Clients und Server. Wenn die Dependency noch @modelcontextprotocol/sdk heißt, beobachten Sie v1, nicht die aktuelle TypeScript-Linie.

  2. (02)

    Mit dem Transport starten: stdio bleibt ideal für lokale Entwicklung und CLI-Agenten; Streamable HTTP ist 2026 der Standard für Cloud-gehostetes MCP; SSE ist für neue Deployments Legacy. MCP v2 entfernt Handshake/Session-Annahmen aus dem Protokollkern, also für routbares Request/Response statt Sticky Sessions planen.

  3. (03)

    SDK nach Team-Stack wählen: TypeScript-v2-Pakete für neue Node/Vercel/Gateway-Arbeit; Python mcp 2.0.0 für Datenwerkzeuge und FastMCP-artige Server; v1 nur behalten, wenn ein bestehender Client, Proxy oder Host den 2026-07-28-Kompatibilitätstest noch nicht bestanden hat.

  4. (04)

    Tools stateless designen, auch wenn die Anwendung Zustand hat. Dauerhaften Zustand in Datenbank oder Queue legen, Tool-Aufrufe möglichst idempotent machen und niemals In-Memory-MCP-Session-State für Autorisierung, Fortschritt oder Billing voraussetzen.

  5. (05)

    Vercel Functions/Fluid Compute oder einen ähnlichen Node-Host nutzen, wenn Zero-Ops Remote MCP nötig ist. Der @vercel/mcp-adapter übernimmt heute HTTPS und Streamable HTTP; die v2-Stateless-Richtung reduziert Sticky-Load-Balancing-Bedarf bei wachsendem Traffic.

  6. (06)

    Alle Eingaben mit Zod, einer anderen Standard-Schema-Library oder Pydantic v2 validieren. MCP-Tools erhalten nicht vertrauenswürdige AI-generierte Eingaben — Schema-Validierung ist die wichtigste Verteidigung gegen Prompt-Injection-gesteuerte Parameter-Manipulation.

  7. (07)

    Lazy-Loading für Multi-Server-Umgebungen implementieren: Tool-Manifeste erst bei Aufruf laden, nicht beim Agent-Start. Das verhindert, dass Agents mit 10+ MCP-Servern ihr Kontextfenster verbrauchen, bevor sie arbeiten.

  8. (08)

    Authentifizierung von Anfang an planen: API-Key-Header für Server-zu-Server, OAuth/OIDC-nahe Flows für benutzer-delegierten Zugriff, per-Tool-Scopes, Rate Limits, Audit Logs und Backend-Credentials mit minimalen Rechten.

Häufige Fragen

(01)Was ist MCP (Model Context Protocol)?
MCP (Model Context Protocol) ist ein offenes Standardprotokoll — seit Dezember 2025 unter der Verwaltung der Linux Foundation — das definiert, wie AI-Modelle externe Tools, Datenquellen und Services nutzen. Ein MCP-Server exponiert typisierte Tools mit strukturierten Ein-/Ausgabe-Schemas; ein MCP-Client wie Claude, Cursor, Windsurf, GitHub Copilot oder ein eigener Agent entdeckt und ruft diese Tools zur Laufzeit auf. MCP ersetzt ad-hoc Function-Calling-Glue-Code durch ein interoperables Protokoll.
(02)Wie baut man einen MCP-Server in TypeScript?
Für die stabile 2026-07-28-Linie installieren Sie `@modelcontextprotocol/server` plus Ihre Schema-Library; `@modelcontextprotocol/client` brauchen Sie nur, wenn Sie einen Client, Gateway oder Proxy bauen. Die getrennten v2-Pakete ersetzen das monolithische Import-Modell: `@modelcontextprotocol/core` enthält gemeinsame Schemas und Konstanten, während server/client/express die Runtime-Flächen paketieren. Wenn Ihre Installation noch `@modelcontextprotocol/sdk` heißt, nutzen Sie das v1-Maintenance-Paket.
(03)Was ändert die finale MCP-Spezifikation 2026-07-28?
Die finale Juli-2026-Spezifikation ist die bislang größte MCP-Revision. Kernänderung ist ein stateless Protokollkern: initialize/initialized und Mcp-Session-Id entfallen, jeder Request trägt Protokoll-Metadaten, und server/discover wird ein optionaler Capability-Probe. Außerdem werden Extensions erstklassig, MCP Apps und Tasks kommen hinzu, Autorisierung rückt näher an OAuth/OIDC-Deployment-Muster, ein mindestens zwölfmonatiges Deprecation-Fenster kommt hinzu und Tools nutzen vollständiges JSON Schema 2020-12.
(04)Wie sichert man einen MCP-Server ab?
Vier Verteidigungsebenen für produktive MCP-Server: (1) Authentifizierung — API-Keys für Server-zu-Server oder OAuth/OIDC-nahe Bearer Tokens für benutzer-delegierten Zugriff. (2) Eingabevalidierung — jeden Tool-Parameter mit Zod, Standard Schema, JSON Schema oder Pydantic validieren. Rohe AI-generierte Strings niemals direkt an Shell oder SQL weitergeben. (3) Rate Limits und Audit Logs — Agents rufen Tools in Bursts auf, Traceability pro Key, User und Tool ist Pflicht. (4) Least Privilege — jeder Server bekommt nur Zugriff auf Ressourcen, die seine Tools wirklich brauchen.
(05)Welche MCP-Transporte gibt es 2026?
2026 bleibt stdio ideal für lokale Prozessintegration und CLI-Agenten, während Streamable HTTP der Standard für moderne Cloud-MCP-Server ist. Die Spezifikation 2026-07-28 macht den Remote-Pfad stateless: Request-Handling hängt nicht mehr an einer Protokoll-Session, Traffic kann nach MCP-Methode geroutet werden und Clients können Tool-Discovery-Antworten cachen, wenn der Server eine TTL liefert. SSE ist für neue Deployments Legacy.
(06)Was ist der Unterschied zwischen MCP und REST APIs?
REST APIs sind für Entwickler gebaut, die Code gegen dokumentierte Endpunkte schreiben. MCP ist für AI-Clients gebaut, die Tools dynamisch zur Laufzeit entdecken. MCP-Server beschreiben Tool-Namen, Beschreibungen, Parameter und Schemas selbst; Clients können diese Tools ohne hart codierte Integration nutzen. 2026 wird die Grenze sauberer: MCP v2 macht den Protokollkern stateless wie normales HTTP, behält aber AI-native Discovery, Tool-Schemas, Server-Capabilities und Extension Points bei, die REST nicht automatisch liefert.
(07)Warum zeigt @modelcontextprotocol/sdk weiter 1.x?
Weil die TypeScript-v2-Linie unter neuen Paketnamen läuft. @modelcontextprotocol/sdk ist das v1-Maintenance-Paket; @modelcontextprotocol/core, @modelcontextprotocol/server, @modelcontextprotocol/client und @modelcontextprotocol/express sind die stabilen v2-Pakete. Dieser Package Split ist die wichtigste Migrationsfalle im Juli 2026: Wer nur den alten npm-Namen prüft, glaubt fälschlich, v2 sei noch nicht erschienen.
(08)Wo finde ich bestehende MCP-Server?
Mehrere Registries nutzen, weil Coverage und Vertrauen unterschiedlich sind. Smithery ist stark bei Discovery und Hosted Remote Execution. Glama katalogisiert einen sehr großen Bestand mit breiter Crawling- und Kurationsabdeckung. Die Official MCP Registry unter registry.modelcontextprotocol.io ist der sicherere Startpunkt für geprüfte First-Party-Server. Drittanbieter-Server vor Produktion immer auf Source, Dependencies, Auth, Scopes und ausgehenden Netzwerkverkehr prüfen.

Bereit für Ihr KI-Projekt?

Buchen Sie ein kostenloses 30-Minuten-Gespräch, um Ihre Anforderungen zu besprechen.