# Mission: Model Context Protocol (MCP)

## Why
Sebastian will MCP so tief verstehen, dass er es bei Puzzle ITC in einem Workshop
**lehren** kann — präzise erklären *und* live vorführen. Gleichzeitig soll am Ende
ein **echt nützlicher** Python-MCP-Server entstehen (z.B. für ein konkretes System),
den er an einen Agent anbindet.

## Success looks like
- Kann das client-host-server-Modell und die drei Primitive (Tools, Resources,
  Prompts) frei am Whiteboard erklären — ohne Spickzettel.
- Kann den `initialize`-Handshake + Capability Negotiation auf JSON-RPC-Ebene nachzeichnen.
- Baut einen lauffähigen MCP-Server mit dem offiziellen Python-SDK (eigenes Tool).
- Bindet diesen Server an mindestens einen Agent an (Claude Code / GitLab Duo) und
  ruft das Tool live auf.
- Versteht STDIO vs. Streamable HTTP gut genug, um die Wahl im Workshop zu begründen.

## Constraints
- Lektionen auf **Deutsch**, Fachbegriffe **Englisch**.
- Solide KI-Coding-Erfahrung vorhanden (Agents/Tool-Calls konzeptionell klar) →
  nicht bei Null anfangen. Neu ist das *Protokoll* selbst.
- MCP entwickelt sich schnell → Aussagen immer gegen die offizielle Spec prüfen,
  nie aus dem Gedächtnis. Aktuelle stabile Spec: **2025-11-25**.
- Sprache des Servers: **Python** (offizielles SDK).

## Out of scope
- Tiefe OAuth/Authorization-Flows für Remote-Server (erst, wenn ein echter
  Remote-Deploy ansteht).
- MCP-Client *bauen* (wir konsumieren bestehende Hosts wie Claude Code / Duo).
- Andere SDK-Sprachen (TS, Go, …) außer als Randnotiz.