Fonctionnalités optionnelles et évolutives
- Leçon 22
- 45 min
- Module 7 : Exploiter et maintenir l'intégration
Où nous en sommes
Dans les deux leçons précédentes, nous avons testé le contrat du serveur et nous l'avons rendu sûr pour une journée entière. Mais MCP offre plus de fonctionnalités que notre serveur n'en utilise, et certaines anciennes ont disparu. Dans cette leçon, nous classons les fonctionnalités en essentielles, optionnelles, obsolètes et héritées, et nous en observons deux sur la liaison, comme les options d'une voiture.
Leçon 22 sur 22 · MCP : connecter les applications d'IA aux outils et aux donnéesFonctionnalités optionnelles et évolutives
1. Comprendre le problème d'intégration
2. Concevoir des capacités de serveur utiles
3. Créer et examiner un serveur local
4. Connecter une application d'IA
5. Accès à distance et autorisation
6. Protéger les outils et le contrôle de l'utilisateur
7. Exploiter et maintenir l'intégration
Ce que vous saurez faire
Découvrez ce que MCP offre encore, et ce qu’il n’offre plus, avant d’en avoir besoin. Classez les fonctionnalités : essentielles, optionnelles, obsolètes et héritées. Utilisez les tables de méthodes du SDK comme preuves. Observez les messages d’élicitation et de progression dans les deux générations du protocole. Terminez ensuite le module avec votre propre liste de vérification de compatibilité.
Avant de commencerCe qu’il faut savoir et avoir sous la main
Ce que vous devez savoir
- La découverte et les capacités, dans Les messages JSON-RPC.
- Les deux générations du protocole et la lecture d’un ancien tutoriel, dans Tenir compte des versions.
- L’approbation en dehors de l’application d’IA, dans Approbation des actions à effet.
Votre projet
~/projects/support-mcp, avec l’environnement virtuel actif :python -m pytest -qaffiche94 passed(94 tests réussis). Cette leçon n’ajoute aucun fichier au projet.- Pour l’exercice du module :
harbour_server.pyde la leçon Examiner le comportement, dans le dossier du projet.
Les options d’une voiture
Section intitulée « Les options d’une voiture »Chaque voiture a des roues, des freins et un volant. Certaines ont aussi des sièges chauffants ou une caméra de stationnement. Ces options sont utiles, mais vous ne pouvez pas compter dessus : une voiture de location peut ne pas en avoir. Et certaines pièces ont disparu. Une vieille voiture a un lecteur de cassettes. Vous pouvez le reconnaître, mais vous ne concevriez pas une nouvelle voiture autour de lui.
Un conducteur prudent vérifie les options avant un long trajet. Un développeur prudent vérifie les fonctionnalités optionnelles avant de les utiliser, et indique lesquelles sont anciennes.
Le problème : une fonctionnalité absente de l’autre côté
Section intitulée « Le problème : une fonctionnalité absente de l’autre côté »Omar a une idée pour l’application partenaire. Quand l’assistant rédige des excuses, il devrait d’abord poser une question à l’agent : « ton formel ou amical? » MCP offre une fonctionnalité pour cela, l’élicitation : un serveur demande une information à la personne pendant un appel.
L’équipe du cours a créé un petit serveur de démonstration construit pour cette leçon, feature_server.py. Il ne fait pas partie de support-mcp. Son outil draft_apology demande le ton. L’équipe l’a ensuite appelé avec un client qui ne déclarait pas l’élicitation. C’est le cas habituel : l’hôte du cours ne la déclare pas non plus.
draft_apology -> MCPError -32021: Client did not declare the form elicitation capability required by resolver '__main__:ask_tone' data={'requiredCapabilities': {'elicitation': {'form': {}}}}L’appel a échoué avant l’exécution de l’outil, dans les deux générations, avec l’erreur −32021. Les données indiquent exactement ce qui manquait. Une fonctionnalité présente d’un seul côté n’est pas utilisable.
Il y a un deuxième piège. Tomás trouve un tutoriel sur l’élicitation. Le serveur y envoie une requête elicitation/create au client. Dans la révision 2026-07-28, telle que l’implémente le SDK 2.3.0, le serveur n’envoie aucune requête au client. La fonctionnalité existe toujours, mais ses messages ont changé.
L’idée : essentielle, optionnelle, obsolète ou héritée
Section intitulée « L’idée : essentielle, optionnelle, obsolète ou héritée »Classez chaque fonctionnalité dans l’un de ces quatre groupes :
- Essentielle : chaque client et serveur l’utilise. Outils, ressources, requêtes, découverte et annulation.
- Optionnelle : un côté l’offre dans ses capacités, et l’autre peut l’utiliser. Si une capacité manque, n’utilisez pas la fonctionnalité. Élicitation, progression, notifications de changement, complétion et tâches longues.
- Obsolète : encore présente, mais destinée à être supprimée. Ne commencez pas à l’utiliser.
- Héritée : provenant d’une ancienne révision. Reconnaissez-la dans l’ancien code, sans jamais construire de nouvelles fonctionnalités dessus.
D’où viennent les capacités? Dans la révision 2026-07-28, un client les déclare dans _meta à chaque requête, sous io.modelcontextprotocol/clientCapabilities. Dans l’ancienne génération, il les déclare une seule fois, dans initialize. Un serveur les déclare dans sa réponse à server/discover, ou à initialize.
Que contient chaque révision? Le SDK officiel conserve une table de toutes les méthodes pour chaque révision, dans mcp_types.methods. L’équipe du cours l’a affichée pour le SDK 2.3.0 et a comparé 2025-11-25 à 2026-07-28. Voici certaines lignes qui ont changé; la sortie énumère toutes les méthodes :
## client -> server request (2025-11-25 | 2026-07-28)initialize yes | - <- removed in 2026-07-28logging/setLevel yes | - <- removed in 2026-07-28resources/subscribe yes | - <- removed in 2026-07-28server/discover - | yes <- new in 2026-07-28subscriptions/listen - | yes <- new in 2026-07-28…
## server -> client request (2025-11-25 | 2026-07-28)elicitation/create yes | - <- removed in 2026-07-28roots/list yes | - <- removed in 2026-07-28sampling/createMessage yes | - <- removed in 2026-07-28La même sortie présente les avertissements du SDK. Trois fonctionnalités sont « obsolètes depuis 2026-07-28 (SEP-2577) » : l’échantillonnage, les racines et la journalisation. La liste des fonctionnalités obsolètes de la spécification nomme ces mêmes fonctionnalités. Elle inclut aussi l’enregistrement dynamique des clients et l’ancien transport HTTP+SSE. Le SDK avertit aussi que la progression du client vers le serveur est obsolète. Dans la révision 2026-07-28, seul le serveur envoie la progression.
Description textuelle du diagramme
| Fonctionnalité | 2025-11-25 | 2026-07-28 | support-mcp | Statut |
|---|---|---|---|---|
| Outils, ressources, requêtes | oui | oui | utilise les trois | essentielle |
| Annulation | notification | notification | la limite de temps de l’hôte | essentielle |
| Progression | notification | notification, du serveur au client seulement | non utilisée | optionnelle |
| Élicitation | requête elicitation/create |
résultat input_required, puis nouvelle tentative |
non utilisée | optionnelle |
| Changements de listes, mises à jour de ressources | list_changed, resources/subscribe |
flux subscriptions/listen |
non utilisés | optionnelle |
| Complétion | completion/complete |
completion/complete |
non utilisée | optionnelle |
| Tâches longues | expérimentales, dans les fonctionnalités essentielles | extension io.modelcontextprotocol/tasks |
non utilisées | optionnelle |
| Échantillonnage, racines, journalisation | requêtes, notifications | obsolètes (SEP-2577) | non utilisés | obsolète |
Échange initial initialize, session |
oui | supprimés | acceptés pour les anciens clients | héritée |
| Transport HTTP+SSE | obsolète depuis 2025-03-26 | obsolète | non offert | héritée |
Le SDK fournit une preuve de ce que ce cours exécute. Il n’est pas la spécification elle-même. Avant de compter sur une fonctionnalité, lisez sa page dans la spécification de votre révision.
L’élicitation dans deux générations
Section intitulée « L’élicitation dans deux générations »Voici l’outil de démonstration. Un résolveur remplit le paramètre choice en interrogeant la personne. Le modèle ne choisit jamais le ton :
class ToneChoice(BaseModel): tone: Literal["formal", "friendly"] = Field(description="The tone of the apology")
def ask_tone(ticket_id: str) -> Elicit[ToneChoice]: """The person chooses the tone; the model does not.""" return Elicit(f"Which tone for the apology on {ticket_id}?", ToneChoice)
@mcp.tool()def draft_apology(ticket_id: str, choice: Annotated[ToneChoice, Resolve(ask_tone)]) -> str: """Draft a short apology for a ticket, in the tone the person chooses.""" if choice.tone == "formal": return f"Dear customer, we apologise for the trouble with {ticket_id}." return f"Hi! Sorry about the trouble with {ticket_id}, we are on it."Le client fournit au SDK une fonction de rappel elicitation_callback. Dans un véritable hôte, cette fonction affiche un petit formulaire à la personne. Dans la démonstration, elle répond « formal » (formel), comme le ferait une personne. Avec cette fonction de rappel, le client déclare automatiquement la capacité. L’équipe du cours a exécuté le même appel dans les deux générations à travers scripts/tee.py :
261.2 ms connected: protocol 2026-07-28263.2 ms elicitation: 'Which tone for the apology on T-30002?' … -> the person picks: formal279.9 ms draft_apology -> isError=False: Dear customer, we apologise for the trouble with T-30002.La réponse était identique dans les deux générations. Les messages ne l’étaient pas :
Description textuelle du diagramme
- Échange initial hérité, 2025-11-25 : le client envoie
tools/call. Pendant que l’appel reste ouvert, le serveur envoie sa propre requête,elicitation/create, avec la question et un schéma JSON. Le client répond{"action": "accept", "content": {"tone": "formal"}}. Puis le résultat de l’appel arrive. - Génération actuelle, 2026-07-28 : le client envoie
tools/call. Le serveur répond immédiatement avec un résultat de typeinput_required: la question dansinputRequests, et unrequestStatescellé. Le client interroge la personne et renvoie le mêmetools/call, avecinputResponseset lerequestState. Puis le résultat final arrive.
Pourquoi ce changement? Dans la révision 2026-07-28, il n’y a pas de session, et chaque requête est indépendante. Un serveur qui pose une question pendant un appel a besoin d’une connexion ouverte vers le client. Un résultat qui dit « J’ai besoin d’autres informations, rappelez-moi » n’a besoin de rien de plus. Le serveur ne conserve aucun état entre les deux appels : le requestState scellé le transporte.
Quand support-mcp utiliserait-il l’élicitation? Pour un détail manquant que seule la personne connaît, comme le ton. Jamais pour un secret : le formulaire passe par le client. Et jamais pour approuver une écriture : Approbation des actions à effet garde cette étape hors de l’application d’IA, avec une autre personne.
Progression et tâches longues
Section intitulée « Progression et tâches longues »Le deuxième outil de démonstration, rebuild_index, travaille pendant 0,6 seconde en trois étapes et signale chaque étape. Le client a fourni une fonction de rappel progress_callback; le SDK ajoute alors un progressToken à la requête :
483.6 ms progress: 1/3 step 1 of 3684.6 ms progress: 2/3 step 2 of 3886.8 ms progress: 3/3 step 3 of 3888.8 ms rebuild_index -> index rebuilt: 3 stepsDans les messages transmis, chaque étape est une notifications/progress du serveur, espacée d’environ 200 ms. Elle contient "progressToken": 5, "progress": 1, "total": 3. Le fonctionnement était identique dans les deux générations. La progression indique à la personne que quelque chose se passe. Elle n’arrête pas le travail : pour cela, le client envoie notifications/cancelled, comme l’a montré Résultats et défaillances.
Pour le travail qui prend des minutes ou des heures, il existe des tâches. Le client lance le travail, se déconnecte, puis demande le résultat plus tard. Inspector 2.10.1 déclare l’extension io.modelcontextprotocol/tasks dans ses capacités; vous pouvez la voir dans son initialize enregistré. Dans la révision 2025-11-25, les tâches étaient une partie expérimentale des fonctionnalités essentielles. Dans 2026-07-28, elles sont devenues une extension officielle. Le SDK 2.3.0 les garde donc hors de la table des méthodes essentielles. support-mcp répond en millisecondes, donc il n’a besoin ni de progression ni de tâches. Le cours n’a pas testé les tâches.
Notifications de changement
Section intitulée « Notifications de changement »Dans Tests de contrat et de compatibilité, Inspector, dans la génération actuelle, a envoyé subscriptions/listen juste après la découverte. Il demandait trois types de notifications : changements d’outils, de ressources et de requêtes. Le serveur a répondu avec notifications/subscriptions/acknowledged et a gardé le flux ouvert jusqu’au départ d’Inspector.
Le même serveur déclare des capacités différentes dans les deux générations. À initialize, le SDK 2.3.0 a répondu "listChanged": false pour les outils, les ressources et les requêtes. À server/discover, il a répondu "listChanged": true, et "subscribe": true pour les ressources. Dans la génération actuelle, le SDK gère le flux d’écoute pour chaque serveur. Mais support-mcp ne publie jamais de changement : ses outils sont fixes. Un client qui attend une notification de sa part attend indéfiniment. Interprétez une capacité comme « peut se produire », et non « se produira ».
La génération actuelle ajoute aussi des indications de mise en cache. Les listes et la découverte contiennent ttlMs et cacheScope. Ces valeurs indiquent combien de temps le client peut conserver la réponse et s’il peut la partager entre utilisateurs. support-mcp envoie "ttlMs": 0 et "cacheScope": "private" dans la réponse de découverte. « Private » (privé) convient à ce serveur : sa liste de ressources dépend de la personne qui l’appelle.
Fonctionnalités héritées et obsolètes : indiquez-les
Section intitulée « Fonctionnalités héritées et obsolètes : indiquez-les »Quand vous lisez de l’ancien code ou un ancien tutoriel, indiquez le statut de chaque élément suivant, sans le copier :
- L’échange initial
initializeet les sessions (révision 2025-11-25 et antérieures) : hérités. Le SDK 2.3.0 les accepte encore pour les anciens clients. L’ancien client dans Tests de contrat et de compatibilité l’a montré. - Le transport HTTP+SSE (révision 2024-11-05, points de terminaison
/sseet/messages) : hérité. La spécification le marque comme obsolète depuis 2025-03-26.support-mcpne l’offre pas. - Les noms du SDK 1.x, comme
FastMCP,McpErroret les attributs en camelCase : code hérité. Le SDK 2.x utiliseMCPServer,MCPErroret snake_case. - Les requêtes du serveur
elicitation/create,sampling/createMessageetroots/list: messages hérités. L’élicitation continue d’exister dans la génération actuelle grâce àinput_required. - L’échantillonnage, les racines et la capacité de journalisation : obsolètes depuis 2026-07-28 dans le SDK 2.3.0. Les propres journaux du serveur, présentés dans Limites de ressources et observabilité, vont vers stderr. Ils n’ont jamais utilisé la capacité de journalisation.
Quand utiliser une fonctionnalité optionnelle, et à quel coût
Section intitulée « Quand utiliser une fonctionnalité optionnelle, et à quel coût »Utilisez une fonctionnalité optionnelle seulement si trois conditions sont remplies. Elle résout un véritable problème de vos utilisateurs. Chaque client de votre matrice la déclare, ou vous avez une solution de rechange pour ceux qui ne la déclarent pas. Et vous l’avez testée dans chaque génération que vous prenez en charge. Ajoutez ensuite une ligne pour elle à la liste de vérification de compatibilité.
Chaque fonctionnalité optionnelle coûte un test par génération, et une solution de rechange pour les clients qui ne l’ont pas. Une fonctionnalité obsolète coûte davantage : vous construisez sur quelque chose qui va disparaître. Indiquer son statut ne coûte rien et économise une journée au prochain développeur.
Erreurs courantes
Section intitulée « Erreurs courantes »Erreur courante
Un outil échoue avec l'erreur -32021 avant son exécution
Symptôme : l’appel échoue avec −32021, « Client did not declare the form elicitation capability … » (le client n’a pas déclaré la capacité d’élicitation par formulaire…), et data.requiredCapabilities.
Cause : l’outil a besoin d’une fonctionnalité optionnelle, et le client ne l’a pas déclarée.
Correction : fournissez au client la fonction de rappel, comme elicitation_callback, si votre hôte peut afficher un formulaire. Sinon, concevez l’outil sans cette fonctionnalité : par exemple, faites du ton un argument normal avec une valeur par défaut.
Erreur courante
Un exemple de tutoriel envoie elicitation/create, et rien n'arrive
Symptôme : vous avez copié du code qui envoie une requête du serveur au client. Un client de la génération actuelle n’y répond jamais.
Cause : l’exemple vise la révision 2025-11-25 ou une révision antérieure. Dans 2026-07-28, le SDK 2.3.0 n’envoie aucune requête au client.
Correction : utilisez l’approche de haut niveau du SDK, comme Resolve avec Elicit. Elle choisit automatiquement les bons messages pour chaque génération.
Exercice du module : une liste de vérification de compatibilité pour Harbour Cycles
Section intitulée « Exercice du module : une liste de vérification de compatibilité pour Harbour Cycles »Exemple guidé. L’exemple détaillé de ce module est docs/compatibility.md, avec python -m scripts.compat. Vous avez consigné le contrat du serveur et fixé ses formats d’erreur. Vous avez créé une matrice de clients, de transports et de périodes du protocole, en nommant chaque période. Vous avez indiqué les limites et associé une ligne de journal à chaque refus. Enfin, vous avez classé les fonctionnalités optionnelles.
À vous de jouer. Livrez votre serveur Harbour Cycles de la leçon Examiner le comportement, avec des preuves d’inspection et une liste de vérification de compatibilité versionnée :
- Écrivez
harbour_compat.py. Il consigne les outils et les ressources du serveur dansharbour_contract.json. Il les compare à chaque exécution, commescripts/contract.py. - Dans le même script, connectez le
Clientde la trousse SDK par stdio dans les deux périodes,autoetlegacy. Vérifiez la découverte, un appel valide àget_bike, un échec de validation ("104"), un vélo absent (B-999) et la ressource. - Exécutez Inspector 2.10.1 dans les deux périodes :
tools/list, un appel valide, l’échec de validation etresources/read. - Écrivez
harbour-compatibility.md: les versions fixées, une ligne par client et période, et les éléments optionnels ou non testés.
Afficher une solution détaillée
"""Harbour Cycles: the contract and the compatibility matrix of harbour_server.py."""
import difflibimport jsonimport sysfrom importlib.metadata import versionfrom pathlib import Path
import anyiofrom mcp import Client, StdioServerParameters
import harbour_server
CONTRACT = Path("harbour_contract.json")ERA = {"auto": "current", "legacy": "legacy handshake"}
async def contract() -> str: async with Client(harbour_server.mcp) as c: data = { "tools": [t.model_dump(mode="json", by_alias=True, exclude_none=True) for t in (await c.list_tools()).tools], "resources": [r.model_dump(mode="json", by_alias=True, exclude_none=True) for r in (await c.list_resources()).resources], } return json.dumps(data, indent=2, sort_keys=True) + "\n"
async def row(mode: str) -> dict: params = StdioServerParameters(command=sys.executable, args=["harbour_server.py"]) async with Client(params, mode=mode) as c: out = {"era": f"{ERA[mode]} ({c.protocol_version})"} out["discovery"] = {t.name for t in (await c.list_tools()).tools} == {"get_bike", "list_available"} out["valid_call"] = not (await c.call_tool("get_bike", {"bike_id": "B-104"})).is_error out["validation_failure"] = (await c.call_tool("get_bike", {"bike_id": "104"})).is_error out["not_found"] = (await c.call_tool("get_bike", {"bike_id": "B-999"})).is_error rr = await c.read_resource("terms://harbour/rental-terms") out["resource"] = rr.contents[0].text.startswith("# Rental terms") return out
def main(argv: list[str]) -> int: text = anyio.run(contract) if "--write" in argv: CONTRACT.write_text(text, encoding="utf-8") print(f"Wrote {CONTRACT}") return 0 old = CONTRACT.read_text(encoding="utf-8") if CONTRACT.exists() else "" if old != text: sys.stdout.writelines(difflib.unified_diff(old.splitlines(True), text.splitlines(True), "contract", "server")) return 1 print(f"harbour-bikes matches {CONTRACT}.") print(f"MCP Python SDK {version('mcp')} Client, stdio") checks = ["discovery", "valid_call", "validation_failure", "not_found", "resource"] print(" | ".join(["era", *checks])) ok = True for mode in ("auto", "legacy"): r = anyio.run(row, mode) ok = ok and all(r[c] for c in checks) print(" | ".join([r["era"], *("pass" if r[c] else "FAIL" for c in checks)])) return 0 if ok else 1
if __name__ == "__main__": sys.exit(main(sys.argv[1:]))Voici les exécutions de l’équipe du cours, depuis le dossier du projet, avec harbour_server.py à côté du script. La première exécution affiche tout le contrat sous forme de nouvelles lignes et se termine avec le code 1. Ensuite :
$ python harbour_compat.py --writeWrote harbour_contract.json
$ python harbour_compat.py 2>/dev/nullharbour-bikes matches harbour_contract.json.MCP Python SDK 2.3.0 Client, stdioera | discovery | valid_call | validation_failure | not_found | resourcecurrent (2026-07-28) | pass | pass | pass | pass | passlegacy handshake (2025-11-25) | pass | pass | pass | pass | passInspector, dans les deux périodes (--protocol-era modern après le -- pour la deuxième) :
npx @modelcontextprotocol/inspector@2.10.1 --cli python harbour_server.py -- --method tools/call --tool-name get_bike --tool-arg bike_id=B-104Les deux périodes ont listé get_bike et list_available. L’appel valide et la lecture de ressource se sont terminés avec le code 0. L’échec de validation s’est terminé avec le code 5, tool_is_error (l’outil signale une erreur). La sortie de la période actuelle commençait par "_meta" et "name": "harbour-bikes".
# Harbour Cycles: compatibility checklist
Pinned: MCP specification revision 2026-07-28, MCP Python SDK 2.3.0, Python 3.12. Server `harbour-bikes` 0.1.0 (stdio only).Contract: `harbour_contract.json` (2 tools, 1 resource). Check it after every change: `python harbour_compat.py`.
| Client | Transport | Era (revision) | Discovery | Valid call | Validation failure | Not found | Resource | How tested ||---|---|---|---|---|---|---|---|---|| MCP Python SDK 2.3.0 `Client` (`auto`) | stdio | current (2026-07-28) | pass | pass | pass | pass | pass | `harbour_compat.py` || MCP Python SDK 2.3.0 `Client` (`legacy`) | stdio | legacy handshake (2025-11-25) | pass | pass | pass | pass | pass | `harbour_compat.py` || MCP Inspector 2.10.1 CLI (default) | stdio | legacy handshake (2025-11-25) | pass | pass | pass (exit 5) | — | pass | by hand || MCP Inspector 2.10.1 CLI (`--protocol-era modern`) | stdio | current (2026-07-28) | pass | pass | pass (exit 5) | — | pass | by hand || Older SDKs, desktop hosts, editors | — | — | not tested | | | | | — |
Optional features: none used (no elicitation, progress, subscriptions or completion). Legacy: none offered beyond the handshake that SDK 2.3.0 accepts.Votre solution peut être différente. Vérifiez quatre points. Le contrat est un fichier qu’un test ou un script compare à chaque exécution. Chaque ligne nomme sa période. L’échec de validation compte comme une réussite lorsque le serveur refuse. Enfin, la liste indique les éléments non testés au lieu de les omettre.
Vérification des connaissances
Section intitulée « Vérification des connaissances »Vérifiez votre compréhension
Prédisez le résultat : l'hôte du cours appelle draft_apology sur le serveur de démonstration dans la période actuelle, sans fournir de fonction de rappel d'élicitation. Que se passe-t-il? Comment modifieriez-vous l'outil pour que chaque client de votre matrice puisse l'utiliser?
Afficher la réponse
L’appel échoue avant l’exécution de l’outil, avec l’erreur −32021 : « Client did not declare the form elicitation capability required by resolver ‘main:ask_tone’ ». Cela signifie que le client n’a pas déclaré la capacité d’élicitation par formulaire requise par le résolveur « main:ask_tone ». Les données de l’erreur nomment la capacité manquante : {"requiredCapabilities": {"elicitation": {"form": {}}}}. La même chose se produit dans la période héritée. Pour servir chaque client, faites du ton un argument normal avec une valeur par défaut, comme tone: Literal["formal", "friendly"] = "formal". Vous pouvez aussi proposer l’élicitation uniquement aux clients qui la déclarent, puis tester les deux parcours dans chaque période.
Votre réponse contient-elle les points principaux de la nôtre ?
Connectez-vous et inscrivez-vous au cours pour enregistrer vos réponses. Chaque vérification compte pour le certificat.
Vérifiez votre compréhension
Classez chaque élément comme essentiel, optionnel, obsolète ou hérité pour la révision 2026-07-28 avec la trousse SDK 2.3.0 : (a) notifications/progress du serveur, (b) la négociation initialize, (c) la capacité d'échantillonnage, (d) tools/call, (e) le point de terminaison /sse d'un ancien tutoriel.
Afficher la réponse
(a) Optionnel : un serveur peut signaler la progression lorsque le client envoie un progressToken. La progression du client vers le serveur est obsolète. (b) Hérité : supprimé dans 2026-07-28, mais toujours accepté des anciens clients par la trousse SDK 2.3.0. (c) Obsolète : la trousse SDK affiche l’avertissement « deprecated as of 2026-07-28 (SEP-2577) » (obsolète depuis 2026-07-28). (d) Essentiel. (e) Hérité : le transport HTTP+SSE de la révision 2024-11-05. Sachez le reconnaître, mais ne l’utilisez pas pour vos nouveaux développements.
Votre réponse contient-elle les points principaux de la nôtre ?
Connectez-vous et inscrivez-vous au cours pour enregistrer vos réponses. Chaque vérification compte pour le certificat.
Vérifiez votre compréhension
Vérification de fin de module : livrez le serveur, les preuves d'inspection et une liste de vérification de compatibilité versionnée. Expliquez les capacités testées avec chaque client et ce qui reste optionnel.
Afficher la réponse
Une réponse complète présente, pour chaque partie, des preuves tirées de vos propres exécutions.
- Le serveur et son contrat.
python -m pytest -qaffiche94 passed(94 tests réussis), ou votre script Harbour réussit.python -m scripts.contractafficheThe server matches contract/capabilities.json.(le serveur correspond à contract/capabilities.json.), et le test des formats d’erreur réussit. - Les preuves d’inspection. Inspector 2.10.1 dans les deux périodes : celle par défaut (négociation héritée, 2025-11-25) et
--protocol-era modern(2026-07-28). Dans chacune :tools/list, un appel valide, un échec de validation (code de sortie 5), une lecture de ressource et la requête. La sortie de la période actuelle commence par_meta. - La liste de vérification. Une ligne par client, transport et période, et chaque ligne nomme sa période. Les lignes : SDK 2.3.0 en
autoetlegacy, dans le même processus, par stdio et par HTTP; Inspector dans les deux périodes; l’hôte. Les hôtes de bureau et les trois anciennes révisions de négociation portent la mention « non testé ». - Les capacités testées, par client. Les outils (découverte, appel valide, échec de validation), les ressources (lecture) et la requête, avec chaque client de la matrice. Par HTTP, vérifiez aussi le refus de la requête sans jeton.
- Ce qui reste optionnel. Élicitation, progression, notifications de changement, complétion et tâches : le serveur ne les utilise pas et la matrice ne les inclut pas. Échantillonnage, racines et journalisation : obsolètes, non utilisés. La négociation : héritée, acceptée.
Démontré exige les cinq éléments, avec vos propres sorties, et chaque période nommée. Une matrice sans périodes, ou une liste sans ses lignes « non testé », est partiellement démontrée.
Votre réponse contient-elle les points principaux de la nôtre ?
Connectez-vous et inscrivez-vous au cours pour enregistrer vos réponses. Chaque vérification compte pour le certificat.
Récapitulatif
- Classez chaque fonctionnalité : essentielle, optionnelle (vérifiez d’abord la capacité), obsolète (ne commencez pas à l’utiliser) et héritée (sachez seulement la reconnaître).
- L’élicitation interroge la personne pendant l’appel. Dans 2025-11-25, le serveur envoie
elicitation/create. Dans 2026-07-28, l’appel renvoieinput_required(entrée requise), puis le client appelle de nouveau. Un client sans cette capacité reçoit −32021. - La progression est une notification du serveur; les tâches sont une extension. Les notifications de changement utilisent
subscriptions/listendans la période actuelle. Une capacité signifie « peut se produire ». - L’échantillonnage, les racines et la capacité de journalisation sont obsolètes dans la trousse SDK 2.3.0 pour la révision 2026-07-28.
Résumé du module. Vous avez fixé l’engagement du serveur dans un fichier de contrat et ses formats d’erreur dans un test. Vous avez testé le serveur avec chaque client dans chaque période, y compris un ancien client utilisant la trousse SDK 1.30.0. Vous avez nommé la période dans chaque ligne. Vous avez indiqué les limites et associé à chaque refus une ligne de journal sans secrets. Vous avez suivi une requête sur le réseau et mesuré un appel local. Enfin, vous avez classé les fonctionnalités optionnelles et évolutives. Votre projet correspond à l’instantané end-of-m07 : 94 passed.
Viennent ensuite les études de cas. Vous créez un serveur MCP sur un vrai jeu de données ouvert, ou vous examinez un serveur peu fiable et le corrigez.
Leçon suivante : Un serveur MCP sur un vrai jeu de données ouvert