Das MCP-Handbuch

Das MCP-Handbuch – Inhaltsverzeichnis

Eine praxisorientierte Einführung in das Model Context Protocol
Autor: Michael Lechner | Version: 2.2.0 (Oktober 2026)
Lizenz: Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)

Willkommen im MCP-Handbuch. Dieses Handbuch führt Entwickler, Architekten und KI-Ingenieure von den elementaren Grundlagen bis zu agentischen Produktivumgebungen nach der offiziellen Spezifikation des Model Context Protocol (Stand Oktober 2026).

📚 Kapitelübersicht

Teil I: Grundlagen & Kernprotokoll

  1. Kapitel 1: Einleitung
    Das USB-C für KI-Modelle. Warum eigene Server? Der sichere Datenbank-Gatekeeper, "Rechnen statt Denken" (wollmilchsau) und die Living-Document-Philosophie.
  2. Kapitel 2: Wie LLMs kommunizieren
    Prompts, Rollen (system, user, assistant, tool), Function Calling und JSON-RPC 2.0 als Fundament.
  3. Kapitel 3: Minimal MCP (Stdio)
    Der erste MCP-Server von Grund auf in Go über Standard Input/Output (stdio).
  4. Kapitel 4: Tools – Die Hände des Modells
    Aktionen ausführen, mathematische Berechnungen auslagern, strategische Fehlerbehandlung (SEP-1303) und Tool Annotations (readOnlyHint, destructiveHint, idempotentHint).
  5. Kapitel 5: Resources – Das Gedächtnis des Modells
    URIs, statische vs. dynamische Templates, Echtzeit-Subscriptions und Workspace Roots (roots/list).
  6. Kapitel 6: Prompts – Die Anweisungen und Vorlagen
    Wiederverwendbare Prompt-Templates, Argumentvalidierung und Kontextinjektion.
  7. Kapitel 7: Die Macht der Kombination – Multi-Server Orchestrierung
    Mehrere spezialisierte Server parallel betreiben und Workflows kombinieren.

Teil II: Skalierung, Daten & Modell-Grenzen

  1. Kapitel 8: Die Tool-Falle – Probleme bei zu vielen Werkzeugen
    Kontextüberlastung, Selektionsrauschen und Progressive Disclosure.
  2. Kapitel 9: Rückgabewerte – Von Text zu strukturierten Daten
    JSON-Schemata für Tool-Returns, typisierte Antworten und Reduktion von Halluzinationen.
  3. Kapitel 10: Binärdaten – Wenn die KI Bilder schickt
    Base64-Payloads, Bildgenerierung, Diagramme und MIME-Types im MCP-Protokoll.
  4. Kapitel 11: Echtzeit-Feedback & Abbruch – Interaktive Tools
    Fortschrittsbalken (notifications/progress), Cancellation-Tokens und Streaming.
  5. Kapitel 12: Die Grenzen der KI – Modell-Limits und Kontext-Sprengung
    Token-Budgets, Kontextfenster-Management und Fallbacks.
  6. Kapitel 13: Das Artifact-Pattern
    Effiziente Trennung von Modell-Kontext und Benutzeroberfläche.

Teil III: Qualitätssicherung, Betrieb & Sicherheit

  1. Kapitel 14: Qualitätssicherung – Server-Inspector & Quality-Scoring
    Interaktive Tests mit dem MCP Inspector und automatisierte Validierung mit dem `mcp-tester` (0–100 Score, Spec-Drift-Erkennung).
  2. Kapitel 15: Automatisierung & CI/CD
    Headless-Testing in Pipelines, Regressionstests und Deployment-Strategien.
  3. Kapitel 16: Transporte im Detail – stdio und Streamable HTTP
    Zustandsloses MCP, ein Endpunkt mit POST, Pflicht-Header, subscriptions/listen, Origin-Prüfung, HTTP/2 und Proxies, mcp-tester http-check.
  4. Kapitel 17: Sicherheit & Authentifizierung – OAuth 2.1 für Remote-Server
    OAuth 2.1 mit PKCE, Protected Resource Metadata, Client ID Metadata Documents, Zielgruppen-Prüfung, Scope-Step-up, kein Token-Durchreichen, Indirekte Prompt-Injection (IPI) & Sicherheits-Checkliste.

Teil IV: Agentische Protokolle & Erweiterungen

  1. Kapitel 18: Erweiterungen – Notifications (Push-Nachrichten)
    Einweg-Nachrichten vom Server zum Client für asynchrone Ereignisse.
  2. Kapitel 19: Tasks – Lang laufende Aufgaben & Asynchronität (SEP-2663)
    Die Tasks-Extension 2026-07-28: State Machine, tasks/get/tasks/update/tasks/cancel, Rückfragen über inputRequests, Task-Store in Go – und Tasks als Hülle für Sub-Agenten.
  3. Kapitel 20: Agentische Server & Sampling
    Sampling (deprecated) über MRTR, der Weg zum eigenen Modell – und der Server als Sub-Agent: ein Code-Review-Wächter mit lokalem Qwen.
  4. Kapitel 21: Benutzerabfragen & Elicitation – Human-in-the-Loop
    Rückfragen an den Menschen: Formular- und URL-Modus, der Ablauf über Multi Round-Trip Requests, ein getestetes Go-Beispiel mit signiertem requestState.
  5. Kapitel 22: Die Wahl der richtigen Programmiersprache
    Go, TypeScript/JavaScript und Python im objektiven Architekturvergleich.
  6. Kapitel 23: Agent Skills – Modulares Expertenwissen & "Skills over MCP"
    Lokale Skills (.agents/skills/) vs. offizielle Wire-Erweiterung io.modelcontextprotocol/skills (SEP-2640), skills/list und Progressive Disclosure.

📖 Anhang

English version available in book/en/chapters/.

Lizenz: CC BY-NC 4.0