Model Context Protocol (MCP) — Connecter Claude au Monde

Module 1 — Comprendre MCP : le standard universel de connexion IA

• Le problème N×M de l'intégration IA et la solution N+M apportée par MCP
• L'analogie USB-C : un protocole ouvert pour connecter toute application IA à tout système
• Écosystème et adoption : Claude, ChatGPT, VS Code, Cursor, Claude Code et serveurs communautaires
• Cas d'usage concrets : assistants connectés, agents autonomes, analyse de données par chat

Module 2 — Architecture MCP : Host, Client, Server

• Les trois rôles : MCP Host (application IA), MCP Client (connexion dédiée), MCP Server (fournisseur de contexte)
• Les deux couches du protocole : Data Layer (JSON-RPC 2.0) et Transport Layer (STDIO/HTTP)
• Cycle de vie et négociation de capacités : handshake, protocolVersion, capabilities
• Notifications bidirectionnelles et mises à jour dynamiques des outils et ressources
• Démonstration : inspection d'une connexion MCP avec le MCP Inspector

Module 3 — Les trois primitives serveur : Tools, Resources, Prompts

• Tools (model-controlled) : découverte via tools/list, exécution via tools/call, types de contenu (texte, image, audio, JSON structuré)
• Resources (application-controlled) : exposition de données, URI schemes, templates RFC 6570, abonnements aux changements
• Prompts (user-controlled) : templates réutilisables, messages structurés, slash commands
• Annotations, gestion d'erreurs (protocole vs exécution) et pagination par curseur
• Atelier : explorer les primitives d'un serveur MCP existant avec le MCP Inspector

Module 4 — Transports : STDIO, Streamable HTTP et sessions

• Transport STDIO : communication locale, stdin/stdout, règles critiques (ne jamais écrire sur stdout)
• Transport Streamable HTTP : endpoint unique, POST + SSE, sessions Mcp-Session-Id
• Gestion de sessions HTTP : assignation d'ID cryptographique, resumabilité (Last-Event-ID), terminaison
• Comparatif stateful vs stateless et stratégies de scaling horizontal
• Atelier : configurer un serveur en mode STDIO puis en mode HTTP distant

Module 5 — Construire un serveur MCP en Python et TypeScript

• Python SDK (FastMCP) : décorateur @mcp.tool(), type hints automatiques, docstrings comme descriptions
• TypeScript SDK : McpServer, StdioServerTransport, validation Zod pour les schémas d'entrée
• Piège STDIO : ne jamais utiliser print() (Python) ou console.log() (TS) — uniquement stderr
• Configuration dans Claude Desktop : claude_desktop_config.json, commandes uv et node
• TP guidé : créer un serveur MCP météo complet (Python puis TypeScript) avec 2 outils

Module 6 — Fonctionnalités avancées : Sampling, Roots, Elicitation

• Sampling : permettre au serveur de demander des complétions LLM via le client (human-in-the-loop)
• Préférences de modèle : hints, costPriority, speedPriority, intelligencePriority
• Roots : définir les frontières filesystem, validation des URI, changement dynamique
• Elicitation : demander des informations supplémentaires à l'utilisateur depuis le serveur
• TP guidé : ajouter le Sampling et les Roots à un serveur MCP existant

Module 7 — Sécurité et bonnes pratiques MCP

• Principes fondamentaux : human-in-the-loop, validation des entrées, contrôles d'accès, rate limiting
• Sécurité du transport HTTP : validation du header Origin, binding localhost, OAuth
• Sécurité des outils : afficher les entrées avant appel, timeouts, journalisation
• Annotations de confiance et serveurs de confiance vs non vérifiés
• Checklist de sécurité pour un déploiement MCP en production

Module 8 — Écosystème et déploiement multi-serveurs

• Serveurs MCP communautaires : filesystem, bases de données, GitHub, Slack, Google Calendar, Notion, Sentry
• Architecture multi-serveurs : combiner Resources, Tools et Prompts de sources différentes
• Scénario complet : planificateur IA avec 3 serveurs MCP (calendrier, météo, réservations)
• Débogage avancé avec le MCP Inspector et les logs JSON-RPC
• TP final : concevoir et déployer une architecture MCP multi-serveurs pour un cas métier réel