Examiner des serveurs MCP publics pour les enregistrer
- Étude de cas 3
- 150 min
- Facultative · 1 étude de cas requise pour le certificat
Où nous en sommes
Dans ce cours, nous avons enregistré les agents de Larkfield et les serveurs d'outils que nous avons écrits. Nous connaissions leur code, leurs outils et leurs données. Maintenant, quatre équipes demandent de connecter des serveurs MCP écrits par d'autres entreprises. Les quatre figurent dans le registre MCP officiel. Dans cette étude de cas, nous les examinons uniquement à partir des renseignements publiés. Nous remplissons chaque enregistrement, fixons le niveau de risque et les outils permis, puis notons ce que personne n'a publié.
Étude de cas 3 sur 3 · Gouverner les agents d'IA : passerelles, registres et contrôlesExaminer des serveurs MCP publics pour les enregistrer
1. Pourquoi les agents ont besoin de contrôles de plateforme
2. Demander des capacités, pas des modèles
3. Enregistrer chaque agent
4. La passerelle de modèles
5. Gouverner les outils et les actions
6. Utilisation, preuves et IA fantôme
7. Construire, acheter et déployer
Ce que vous saurez faire
Quatre équipes demandent de connecter des serveurs MCP écrits par d’autres entreprises. Examinez chacun avant son exécution, à partir des renseignements publiés : le registre officiel, un deuxième catalogue et les pages du fournisseur. Remplissez un enregistrement par serveur, avec un niveau de risque, les outils permis et une décision. Ensuite, notez ce qu’aucune source publiée ne vous dit. Cette liste est le résultat le plus utile de l’examen.
Le projet de départ est un petit projet Python, mcp-intake. Il contient une copie fixe du registre et du catalogue, nos notes sur les pages des fournisseurs et les commandes de cette page. Il ne contient aucun enregistrement : vous les rédigez. Le projet terminé contient les quatre formulaires examinés et le rapport d’examen, pour vous aider si vous bloquez. Le code est sous licence MIT. Rien dans cette étude de cas n’exécute un serveur MCP, et rien ne nécessite un compte ou une clé.
Avant de commencerCe qu’il faut savoir et avoir sous la main
Ce que vous devez savoir
Cette étude de cas utilise tout le cours, pour des serveurs que Larkfield n’a pas écrits. Elle s’appuie surtout sur :
- Le formulaire d’enregistrement, ses niveaux de risque et le formulaire détaillé, dans Le contenu d’un enregistrement.
- Les classes de données et la règle interdisant d’envoyer des données de paiement à un modèle, dans Un catalogue de capacités.
- La passerelle d’outils, qui autorise seulement les outils enregistrés et garde sa propre liste de lectures et d’écritures, dans Une passerelle pour les outils.
- Les approbations d’écriture, dans L’autonomie et les approbations sous forme de politiques.
- Les outils MCP, leurs annotations et
tools/list, dans MCP : connecter les applications d’IA aux outils et aux données.
Ce qu’il vous faut sur votre ordinateur
- Python 3.12 ou une version plus récente, et VS Code.
- Environ 30 Mo d’espace disque libre : les paquets (PyYAML, pytest et ruff) et les données (4,3 Mo).
- Une connexion réseau seulement pour installer les paquets et pour une étape facultative qui lit le registre en direct.
Vous n’avez pas besoin du projet de cours ai-estate. Le projet de départ contient une copie inchangée de ses vérifications du registre (estate/registry.py et la configuration qu’elles lisent).
Testé sur macOS (Apple silicon) avec Python 3.12.13. Les commandes Windows (PowerShell) et Linux sont fournies, mais nous ne les avons pas exécutées dans le cadre du cours.
La situation
Section intitulée « La situation »Kwame dirige la plateforme d’IA de Larkfield. Quatre demandes arrivent en une semaine. Elles demandent toutes de connecter un serveur MCP public à la passerelle d’outils :
| Demande | De | Serveur dans le registre | Ce qu’ils veulent |
|---|---|---|---|
stripe-mcp |
Amira (service) | com.stripe/mcp |
Le flux de soutien consulte directement les paiements et les remboursements dans Stripe. |
shippo-mcp |
Amira (service) | com.shippo/shippo-mcp |
Le flux de soutien compare les tarifs et achète des étiquettes de retour. |
sentry-mcp |
Tomás (plateforme) | io.github.getsentry/sentry-mcp |
L’assistant de programmation de l’équipe plateforme lit les erreurs de production. |
notion-mcp |
Mei (données) | com.notion/mcp |
L’assistant documentaire lit les procédures du personnel conservées dans Notion. |
Les demandes et les personnes sont fictives; les serveurs et tout ce qui est publié à leur sujet sont réels.
Tomás ajoute une note à sa demande : « C’est dans le registre MCP officiel, donc ça a été vérifié. On peut simplement les connecter? » La règle de Kwame est celle du cours : sans enregistrement, aucun appel. Et un enregistrement exige des réponses que le serveur d’un tiers doit fournir.
L’objectif. Pour chaque demande, rédigez un enregistrement dans le formulaire du cours, signé par un réviseur. Il contient un niveau de risque, les outils permis et une décision : refuse (refuser), wait (attendre) ou register reads only (enregistrer les lectures seulement). Chaque réponse doit indiquer où elle est publiée. Chaque question sans réponse publiée va sur une liste, qui indique à l’équipe quoi demander ensuite.
Ce que vous allez créer
Section intitulée « Ce que vous allez créer »Description textuelle du diagramme
Quatre entrées alimentent douze questions : la demande, le registre, un deuxième catalogue et les pages du fournisseur. Chaque outil publié est ensuite marqué lecture, écriture, exécution de tout outil ou inconnu. Le code prépare un brouillon d’enregistrement, puis une personne l’examine et le signe. python -m intake check exécute les vérifications. Le résultat est refuser, attendre ou enregistrer les lectures seulement.
Vous travaillez en six parties :
| Partie | Ce que vous faites | Commande |
|---|---|---|
| 1 | Vérifier les données et voir ce que le registre publie | verify, coverage, search |
| 2 | La référence de base : répondre aux douze questions avec le registre seulement | answer --sources registry |
| 3 | Ajouter un deuxième catalogue, puis les pages des fournisseurs | answer, lists |
| 4 | La comparaison équitable : les quatre serveurs, de trois façons | compare |
| 5 | Des réponses à l’enregistrement : outils, niveau, décision, signature | tools, draft, check |
| 6 | Une nouvelle demande, du début à la fin | review, gateway |
Les données
Section intitulée « Les données »Trois sources, chacune avec sa licence :
- Le registre MCP officiel, à
registry.modelcontextprotocol.io, où les développeurs publient les métadonnées de leurs serveurs. Ses conditions d’utilisation, section 10, placent ces métadonnées dans le domaine public (CC0 1.0). Le projet contient une copie fixe de la dernière version des 48 606 entrées, avec seulement les champs lus pendant l’examen. Le registre est en préversion et change chaque heure. La copie fixe garde donc vos résultats identiques à ceux de cette page. - Le catalogue MCP de Docker, un deuxième catalogue indépendant sur GitHub (docker/mcp-registry, MIT). Certaines de ses 328 entrées contiennent une liste d’outils.
- Les pages des fournisseurs : la documentation et, lorsqu’il est public, le code source. Nous avons rédigé de courtes notes dans nos propres mots, avec un lien pour chaque réponse (
data/vendor/*.yaml). Nous avons copié seulement les noms d’outils. Vérifiez les notes avec les pages : les pages changent.
DATASET.md, dans le projet, est la fiche du jeu de données : sources, licences, modifications et limites. Une limite compte avant tout : ce sont uniquement des renseignements publiés. Personne n’a exécuté ces serveurs.
Préparer le projet
Section intitulée « Préparer le projet »-
Téléchargez le projet de départ dans l’encadré en haut de cette page. Décompressez-le dans votre dossier de projets, par exemple
~/projects. Vous obtenez le dossiermcp-intake. -
Dans VS Code, choisissez File > Open Folder (fichier, ouvrir un dossier), puis ouvrez
mcp-intake. Ouvrez ensuite un terminal : Terminal > New Terminal (terminal, nouveau terminal). -
Créez et activez un environnement virtuel, puis installez les paquets :
Fenêtre de terminal python3 -m venv .venvsource .venv/bin/activatepython -m pip install -r requirements-dev.txtFenêtre de terminal python -m venv .venv.venv\Scripts\Activate.ps1python -m pip install -r requirements-dev.txtFenêtre de terminal python3 -m venv .venvsource .venv/bin/activatepython -m pip install -r requirements-dev.txt -
Vérifiez les données avec leurs sommes de contrôle, puis exécutez les tests :
Fenêtre de terminal python -m intake verifypython -m pytest -q24 data files match data/SHA256SUMS. When the registry copy was made: data/registry/FETCHED.................. [100%]17 passed in 0.70s
Si verify nomme un fichier modifié, téléchargez de nouveau le projet de départ. Chaque nombre de cette page vient de ces fichiers précis.
Partie 1 : ce que le registre publie
Section intitulée « Partie 1 : ce que le registre publie »Une inscription n’est pas un examen
Section intitulée « Une inscription n’est pas un examen »Pensez au registre des entreprises d’une ville. Avant qu’un plombier puisse y inscrire une entreprise, la ville vérifie son existence et l’identité de son propriétaire. Cette vérification est utile : personne d’autre ne peut inscrire une entreprise au nom du plombier. Mais la ville ne vérifie pas son travail, les pièces utilisées ou ce qui arrive aux clés que vous lui confiez. Avant de laisser un plombier entrer dans votre bâtiment, vous demandez encore des références, une estimation et une assurance. L’inscription vous dit qui; votre propre examen vous dit quoi.
Le registre MCP fonctionne de la même façon. Sa documentation indique ce qu’il vérifie. Le nom d’un serveur commence par un espace de noms dont le responsable de la publication doit prouver le contrôle. com.stripe désigne le domaine stripe.com, prouvé par DNS ou HTTP; io.github.getsentry désigne le compte GitHub getsentry. Pour un paquet, le registre vérifie que le paquet nomme le serveur. Pour l’analyse de sécurité du code, il s’appuie sur les registres de paquets (npm, PyPI) et les catalogues en aval. Ses conditions indiquent qu’il n’offre aucune garantie sur les serveurs et conseillent d’évaluer chacun avant de l’utiliser.
Description textuelle du diagramme
Le registre vérifie trois choses : le responsable de la publication contrôle le nom, le paquet appartient au nom et l’entrée respecte le format. Personne n’a vérifié six choses pour vous. Ce sont les outils et ceux qui écrivent, leurs données, les autres services ou modèles, les changements ultérieurs, ce que le fournisseur conserve et le code.
Tomás a donc en partie raison. Le registre prouve qui a publié un serveur. Il ne dit pas ce que le serveur peut faire chez Larkfield. C’est le rôle de l’enregistrement. Le formulaire de Le contenu d’un enregistrement exige des réponses que seul le responsable de la publication peut donner.
Examiner toutes les entrées une fois
Section intitulée « Examiner toutes les entrées une fois »Avant d’examiner quatre serveurs, voyez ce que le registre peut vous dire sur n’importe quel serveur :
python -m intake coverageOfficial MCP Registry, latest entries: 48,606 (the fixed copy in data/registry/) names a code repository 33,315 (68.5%) a package to run on our machine 18,511 (38.1%) with an exact version 17,168 (35.3%) with a setting marked secret 6,901 (14.2%) a hosted address 31,888 (65.6%) hosted only (nothing to pin) 29,583 (60.9%) a list of tools (publisher's) 336 (0.7%) namespace is a GitHub account 29,231 (60.1%) status deprecated 617 (1.3%)No entry has a field for: the licence, the data returned, read or write per tool, the data kept.Description textuelle du graphique
Six barres, en proportion des 48,606 entrées. Un dépôt de code : 68.5 %. Un paquet à exécuter sur notre propre machine : 38.1 %. Hébergé seulement, donc aucune version à fixer : 60.9 %. Un paramètre marqué comme secret : 14.2 %. Une liste d’outils, dans les notes du responsable de la publication : 0.7 %. Les données que les outils renvoient : 0 %, car le format des entrées n’a aucun champ pour cela.
Ce que cela nous apprend :
- La plupart des serveurs sont seulement hébergés. Pour six entrées sur dix, le serveur fonctionne sur les machines du fournisseur, sans paquet. La version de l’entrée est une étiquette : rien n’empêche le fournisseur de changer les outils demain.
- Le registre ne liste presque jamais les outils. Seulement 0,7 % des entrées contiennent une liste d’outils, rédigée par le responsable de la publication dans un champ libre. Un enregistrement doit nommer ses outils. Pour presque tous les serveurs, la liste doit donc venir d’ailleurs.
- Le registre ne peut pas du tout répondre à certaines questions. Aucune entrée ne dit quelles données les outils renvoient, quels outils écrivent ou ce que le fournisseur conserve.
Regardez encore une fois, car les noms peuvent tromper. Recherchez un mot :
python -m intake search stripe147 entries mention 'stripe', in 111 namespaces. 33 domain wishpool.app 3 GitHub account CSOAI-ORG 2 GitHub account codespar 2 GitHub account dailyaiagents-cpu 1 domain apithreshold.ai 1 domain augenix.ai 1 domain foodphoto.ai 1 domain kifly.ai ... 103 more namespacesNamespaces on a domain with that word: domain stripe.com147 entrées mentionnent Stripe, et un seul espace de noms correspond au domaine de Stripe. Les autres sont des serveurs écrits par d’autres personnes, pour Stripe ou à son sujet. Examinez donc toujours le nom exact de la demande, com.stripe/mcp, et vérifiez que son espace de noms appartient au fournisseur. Un nom qui semble correct ne suffit pas.
Partie 2 : la référence de base, le registre seulement
Section intitulée « Partie 2 : la référence de base, le registre seulement »Douze questions
Section intitulée « Douze questions »L’enregistrement du serveur d’un tiers exige douze réponses. Chacune correspond à un champ du formulaire ou à une décision à son sujet. Si une des cinq questions marquées d’un * reste sans réponse, aucune décision n’est possible :
| Question | Ce qu’elle remplit |
|---|---|
| Qui le publie, et est-ce vérifié? * | from, et la confiance à accorder au reste |
| Où est son code, et à quelle version? | from, et l’examen du code |
| Sous quelle licence ou quelles conditions? | une question pour le service juridique, notée dans le formulaire |
| Pouvons-nous fixer la version exacte que nous avons examinée? | une condition, ou « examiner de nouveau lors d’un changement » |
| Où fonctionne-t-il : sur notre machine ou celle du fournisseur? * | la configuration de la passerelle d’outils, et la destination des données |
| Quel secret d’authentification lui faut-il? * | le secret d’authentification et ses portées |
| Quels outils possède-t-il? * | tools |
| Quels outils lisent et lesquels écrivent? | tools, autonomy, et la liste de la passerelle |
| Quelles données ses outils renvoient-ils? * | data_classes, risk_tier |
| Quels autres services ou modèles contacte-t-il? | data_classes, et la règle de la passerelle |
| Ses outils peuvent-ils changer sans nouvelle version? | review_date, et une condition |
| Que conserve le fournisseur, et pendant combien de temps? | long_form.data_retention |
Chaque source répond à une question par yes (oui : publié et suffisant pour agir), partly (partiellement : publié, mais insuffisant) ou pas du tout.
Exécuter la référence de base
Section intitulée « Exécuter la référence de base »L’examen le moins coûteux lit seulement l’entrée du registre. Exécutez-le pour Stripe :
python -m intake answer stripe-mcp --sources registrycom.stripe/mcp 0.2.4, from: registryyes Who publishes it, and is that checked? * domain stripe.com: the registry checks that the publisher controls itpartly Where is its code, at which version? https://github.com/stripe/agent-toolkit (no commit or tag in the entry)- Under which licence or terms?yes Can we pin the exact version we reviewed? no: hosted only; the entry's version 0.2.4 is a label, not something we can pinyes Where does it run: our machine or the vendor's? * hosted: https://mcp.stripe.com (streamable-http)- Which credential does it need? *- Which tools does it have? *- Which tools read and which write?- Which data do its tools return? *- Which other services or models does it contact?- Can its tools change without a new version?- What does the vendor keep, and for how long?Answered 3 of 12 (1 partly). Unanswered questions that block a decision (*): credential, tools, dataTrois réponses sur douze. Nous savons que Stripe le publie, qu’il fonctionne sur les machines de Stripe et qu’aucune version ne peut être fixée. Nous ne connaissons pas ses outils, donc le champ tools du formulaire serait une supposition. Même le lien du dépôt est périmé : sur GitHub, stripe/agent-toolkit redirige maintenant vers stripe/ai. La référence de base est rapide, mais elle ne peut pas produire un enregistrement.
Partie 3 : deux sources de plus
Section intitulée « Partie 3 : deux sources de plus »Un deuxième catalogue
Section intitulée « Un deuxième catalogue »Le catalogue de Docker est une deuxième liste indépendante, et certaines entrées contiennent une liste d’outils. Le projet associe une entrée du catalogue à une entrée du registre par adresse ou dépôt, jamais par nom :
python -m intake show stripe-mcp…Catalog entries that match: 2 stripe-remote: the same address (https://mcp.stripe.com) - tool list kept stripe: the same repository (mcp/stripe)Pourquoi pas par nom? Pour Sentry, le catalogue contient une entrée appelée sentry. C’est un autre serveur : un serveur de référence archivé, construit à partir d’un autre dépôt. Le projet l’affiche à part, comme « avec “sentry” dans le nom, mais ce n’est pas ce serveur ». Une association par nom aurait mené à l’examen du mauvais code.
Avec le catalogue, les réponses de Stripe passent de 3 à 6. Le catalogue ajoute le secret d’authentification (OAuth), une liste de 25 outils et un avertissement : la liste d’outils est dynamique.
Les pages des fournisseurs
Section intitulée « Les pages des fournisseurs »Puis la troisième source : ce que chaque fournisseur publie sur son propre serveur. Pour Sentry, c’est son code source à la version exacte nommée par le registre, 0.42.0. Chaque définition d’outil contient son nom, son groupe de compétences, les portées nécessaires et ses annotations MCP. Avec les trois sources, Sentry répond à 10 questions sur 12 :
python -m intake answer sentry-mcpio.github.getsentry/sentry-mcp 0.42.0, from: registry, catalog, vendor…yes Which tools does it have? * 63 tool definitions at tag 0.42.0, each with its skill group and required scopes. Two of them, search_sentry_tools and execute_sentry_tool, find and run any other tool by n……yes Which other services or models does it contact? The AI-powered search tools need an LLM provider (OpenAI, Azure OpenAI, Anthropic or OpenRouter) configured in the server: model calls that do not pass our gateway.…Answered 10 of 12 (2 partly). Unanswered questions that block a decision (*): noneDeux constats qu’aucune entrée du registre ne pouvait révéler. Un outil qui exécute n’importe quel autre outil par son nom rend toute liste d’autorisation inutile. Et trois outils de recherche de Sentry appellent un modèle de langage configuré dans le serveur lui-même. Ces appels de modèle utilisent les données de Larkfield sans jamais passer par sa passerelle de modèles. C’est de l’IA non enregistrée, à l’intérieur d’un outil. Vous avez rencontré le même problème avec le résumé hebdomadaire dans Trouver l’IA non enregistrée.
Quand deux listes publiées divergent
Section intitulée « Quand deux listes publiées divergent »Plus de sources donnent plus de réponses. Donnent-elles les mêmes réponses? Comparez la liste d’outils du catalogue à celle du fournisseur :
python -m intake lists stripe-mcppython -m intake lists notion-mcpcatalog stripe-remote (the same address): 25 tools | vendor: 15 tools | in both: 2 (get_stripe_account_info, search_stripe_documentation)catalog notion-remote (the same address): 8 tools | vendor: 65 tools | in both: 0Deux noms sur 25 correspondent pour Stripe. Pour Notion, aucun ne correspond. Les deux serveurs sont hébergés, et leurs fournisseurs ont changé les outils après la rédaction de la liste du catalogue. La liste du fournisseur l’emporte ici, car c’est lui qui exploite le serveur. Mais même sa page reste une description. La liste décisive est celle que le serveur renvoie à tools/list, que vous obtenez seulement en vous y connectant. C’est un test, et cette étude de cas n’exécute aucun serveur.
Partie 4 : la comparaison équitable
Section intitulée « Partie 4 : la comparaison équitable »Comparez maintenant les trois façons d’examiner les quatre demandes, avec une seule mesure : combien des douze questions ont une réponse publiée (yes seulement, soit « oui »). Les questions, la règle pour yes et les quatre serveurs restent les mêmes.
python -m intake compareserver registry +catalog +vendor still blocking with all threestripe-mcp 3 6 7 noneshippo-mcp 3 3 4 tools, datasentry-mcp 4 4 10 nonenotion-mcp 3 6 8 noneall four 13 19 29 (of 48 answers)Description textuelle du graphique
Trois barres, sur 48 questions : le registre seul répond à 13; avec le catalogue, à 19; avec les pages des fournisseurs, à 29.
La comparaison est-elle équitable? Elle compte les réponses, pas les réponses correctes. Les listes d’outils du catalogue ont augmenté le total, mais la partie 3 a montré qu’elles étaient périmées. Lisez donc cette mesure comme « ce que chaque source nous a permis de remplir ». Les contradictions constituent un deuxième résultat. Shippo reste bloqué avec les trois sources : ni le registre, ni le catalogue, ni les pages de Shippo ne nomment ses outils.
La procédure recommandée : lisez les trois sources, dans cet ordre, et donnez priorité aux pages du fournisseur en cas de désaccord. Le registre seul répond à environ un quart des questions, ce qui ne suffit pas pour enregistrer quoi que ce soit. Même avec les trois sources, 19 des 48 réponses manquent encore. Cette liste constitue aussi un résultat.
Partie 5 : des réponses à un enregistrement
Section intitulée « Partie 5 : des réponses à un enregistrement »Chaque outil : lecture, écriture, exécution libre ou type inconnu
Section intitulée « Chaque outil : lecture, écriture, exécution libre ou type inconnu »Le champ tools du formulaire est la liste d’autorisation qu’applique la passerelle d’outils. Avant de choisir, classez chaque outil publié. Un outil est publié comme outil de lecture ou d’écriture quand son serveur le précise (les annotations de Sentry). Sinon, le projet propose un type selon le premier mot du nom : get, list et search pour la lecture; create, send et transfer pour l’écriture. Il ne fait aucune supposition au-delà de cette règle :
python -m intake tools stripe-mcpcom.stripe/mcp: 15 tools, from the vendor list | read 3, run-any 2, unknown 6, write 4 unknown stripe.stripe_api_search the verb 'api' is not in either list unknown stripe.stripe_api_details the verb 'api' is not in either list run-any stripe.stripe_api_read runs any operation by name: an allowlist cannot narrow it run-any stripe.stripe_api_write runs any operation by name: an allowlist cannot narrow it [moves_money] read stripe.get_stripe_account_info proposed from the verb 'get'… write stripe.send_money proposed from the verb 'send' [moves_money]…Rappelez-vous Une passerelle pour les outils : les annotations sont des indications du serveur, pas des autorisations. La plateforme garde sa propre liste d’outils de lecture et d’écriture. Ici, cette liste part des indications du serveur et des noms, puis une personne la confirme. Un outil à exécution libre, comme stripe_api_write (« toute méthode POST, PATCH, PUT et DELETE »), n’est jamais autorisé. Un seul nom d’outil couvre toutes les méthodes d’écriture parmi les 152 méthodes d’API que la page de Stripe énumère. La passerelle ne voit que ce nom.
Le niveau de risque et la décision
Section intitulée « Le niveau de risque et la décision »Le projet propose un niveau de risque à partir des trois questions du cours. Peut-il modifier de l’argent ou des biens? Voit-il des données personnelles? Une personne décide-t-elle? Deux autres règles s’appliquent au serveur d’un tiers :
- Sans liste d’outils publiée, le risque est élevé. Si vous ignorez ce qu’un serveur peut faire, supposez le pire.
- Les données de paiement dans la réponse d’un outil sont refusées. Un agent place chaque réponse d’outil dans son contexte et envoie ce contexte à un modèle. La règle de Larkfield interdit tout envoi de données de paiement à un modèle.
Prenez ensuite une décision par demande. Refusez quand une règle l’interdit. Attendez quand une question bloquante reste sans réponse, et précisez quoi demander. Sinon, enregistrez seulement les outils de lecture adaptés au but. Excluez tous les outils d’écriture, à exécution libre ou signalés. Une écriture exige une autorisation d’approbation et son propre examen, comme dans L’autonomie et les approbations sous forme de politiques.
Rédiger, examiner, signer : Sentry
Section intitulée « Rédiger, examiner, signer : Sentry »Rédigez la première ébauche :
python -m intake draft sentry-mcp --out registrations/sentry-mcp.yamlWrote registrations/sentry-mcp.yaml: decision 'register reads only' (39 read tool(s) allowed; 24 held back (writes, run-any or flagged tools))Ouvrez registrations/sentry-mcp.yaml. L’ébauche satisfait aux vérifications du cours, mais ce n’est pas encore une décision : review: by et notes sont vides. Elle autorise 39 outils. Vérifiez-la :
python -m intake checksentry-mcp.yaml: 1 problem(s) - [intake] review: a person signs the decision (review.by) and writes why (review.notes)[exit 1]Examinez-la maintenant comme Kwame l’a fait. Le but est de « lire les erreurs de production et les traces de pile ». L’assistant de Tomás a besoin d’environ dix outils pour cela, pas de 39 :
risk_tier: mediumdata_classes: [personal]tools: [sentry.find_organizations, sentry.find_projects, sentry.find_releases, sentry.get_issue_details, sentry.get_event_stacktrace, sentry.get_issue_breadcrumbs, sentry.get_issue_activity, sentry.get_trace_details, sentry.get_span_details, sentry.get_release_details]autonomy: suggestsintake: decision: register reads only run_args: ['--skills=inspect'] conditions: - Run the npm package @sentry/mcp-server at exactly 0.42.0 on our machine (stdio), not the hosted server, which has no version to pin. - Start it with --skills=inspect, and give it a Sentry token with event:read, project:read and org:read only (the README lists write scopes for the full set). - Configure no LLM provider for the server, so its AI-powered search tools stay off; model calls must go through Larkfield's gateway. - Review again before any version change; the tool list on main already differs from 0.42.0.review: by: usr-kwame notes: Medium, not low, because error events and breadcrumbs can hold customer data. Ten read tools, not 39; add a tool only with a reason that fits the purpose.Lisez les choix. Risque moyen, pas faible : les rapports d’erreurs et les traces d’activité peuvent contenir des données de clients. La classe de données est donc personal (personnelles). Le paquet, pas le serveur hébergé : le paquet a une version que nous pouvons fixer; le serveur hébergé n’en a pas. Exclus : l’outil à exécution libre et les trois outils qui appellent un autre modèle. Les outils de relecture, de rapports d’utilisateurs et de pièces jointes sont aussi exclus. Ils renvoient plus de données de clients que le but ne l’exige.
À vous : les trois autres
Section intitulée « À vous : les trois autres »Rédigez, examinez et signez stripe-mcp, shippo-mcp et notion-mcp de la même façon. Avant de commencer, prédisez chaque décision.
Vérifiez votre travail
python -m intake checknotion-mcp.yaml: complete (medium risk, 2 tool(s), decision: register reads only)sentry-mcp.yaml: complete (medium risk, 10 tool(s), decision: register reads only)shippo-mcp.yaml: complete (high risk, 0 tool(s), decision: wait)stripe-mcp.yaml: complete (high risk, 0 tool(s), decision: refuse; the course's registry refuses it too)- Stripe : refuser, risque élevé. Ses outils renvoient des données de paiement, et deux d’entre eux exécutent n’importe quelle méthode d’API. Les remboursements de Larkfield restent dans
orders-mcp, soumis aux autorisations d’approbation du flux de travail du soutien. - Shippo : attendre, risque élevé. Aucune source publiée ne nomme ses outils, donc aucun outil ne peut être autorisé. Demandez à Shippo, puis listez les outils lors d’un test avec un compte de test. Suivez Revue de sécurité d’une intégration MCP.
- Notion : enregistrer seulement les outils de lecture, risque moyen, 2 outils.
notion-searchetnotion-fetch, par une connexion à l’espace de travail qui ne liste que ces deux outils. Deux outils sont volontairement exclus. La page du fournisseur indique quenotion-ai-searchpeut être appelé par son nom, même s’il n’apparaît pas danstools/list. Etnotion-connector-searchaccède à Slack, à Google Drive et aux courriels.
Comparez vos formulaires avec registrations/ dans le projet terminé. Un choix différent d’outils de lecture convient si review.notes en explique la raison.
Erreur courante
Le formulaire passe les vérifications du cours, mais il est quand même incorrect
Symptôme : Amira rédige son propre formulaire Stripe. Il autorise les deux outils d’API, avec autonomy: acts-with-approval et la classe de données payment (paiement). Lors de la première exécution de cette étude de cas, les vérifications du registre du cours l’ont accepté :
stripe-amira.yaml: complete (high risk, 2 tool(s), decision: register)Exécutez maintenant la même vérification :
python -m intake check --course-only registrations/stripe-amira.yamlstripe-amira.yaml: 1 problem(s) - [registry] data class payment: never sent to a model, and a tool's answer goes to the agent's model, so a tool server cannot register it[exit 1]Les vérifications propres au projet trouvent deux autres problèmes :
stripe-amira.yaml: 3 problem(s) - [registry] data class payment: never sent to a model, and a tool's answer goes to the agent's model, so a tool server cannot register it - [intake] tool stripe.stripe_api_read: runs any operation by name, so the allowlist means nothing - [intake] tool stripe.stripe_api_write: runs any operation by name, so the allowlist means nothing[exit 1]Cause : deux causes. D’abord, une lacune que cet examen a trouvée dans le projet du cours, et que le cours a ensuite corrigée. La règle sur les paiements s’appliquait seulement aux agents qui listent des capacités. Un serveur d’outils n’en liste aucune, donc la règle ne s’exécutait jamais. Pourtant, la réponse d’un outil entre dans le contexte de l’agent, puis passe à un modèle. La fonction check_form du registre, présentée dans Le contenu d’un enregistrement, applique maintenant aussi la règle aux serveurs d’outils. Un test le vérifie. Ensuite, le registre vérifie le nom d’un outil, pas ce qu’il fait. Il ne peut pas savoir que stripe_api_read exécute n’importe quelle méthode d’API. Seul un examen de la liste d’outils publiée le révèle.
Correction : gardez les vérifications de l’examen à côté de celles du registre. Une lacune dans vos propres contrôles est un constat. Signalez-la au responsable de la plateforme, avec le formulaire qui la montre, comme cet examen l’a fait.
Partie 6 : de bout en bout, avec une nouvelle demande
Section intitulée « Partie 6 : de bout en bout, avec une nouvelle demande »Vendredi, Sam demande un serveur de plus. Avec le serveur de suivi d’AfterShip, l’assistant du soutien pourrait indiquer à un agent où se trouve le colis d’un client. Faites l’examen complet :
python -m intake review aftership-mcp== com.aftership.mcp/tracking-public 1.0.1 (Tracking & Returns)Request: Let the help-desk assistant tell a support agent where a customer's parcel is.…Answered 3 of 12 (0 partly). Unanswered questions that block a decision (*): credential, tools, data-- Tools: 0 published-- Risk tier: high (no published tool list: treat it as the worst case); data class unknown-- Decision: wait: the published information does not say which credential it needs, which tools it has, which data its tools return-- The course's registry checks on the draft: complete-- Still unknown after the sources we read: Where is its code, at which version?; Under which licence or terms?; …Le registre indique qui le publie (le domaine aftership.com) et où il s’exécute. Nous n’avons trouvé aucune page d’AfterShip sur ce serveur. Les répertoires qui le décrivent ont des conditions peu claires, donc nous ne les utilisons pas. La décision est wait (attendre), et l’examen indique à Sam quoi demander à AfterShip. Les numéros de suivi et les adresses sont des données personnelles. La réponse sur les données est donc la plus importante.
Pour les deux serveurs que vous avez enregistrés, la dernière étape fournit sa liste à la passerelle d’outils.
python -m intake gateway# For config/tools.yaml of the course project: the platform's own list of reads and writes.# 'name' is the server's own tool name where the platform's ID differs; 'url' marks a hosted server.# The course's tool gateway reads neither yet: it starts stdio servers and calls tools by their ID.servers: notion: about: 'Notion MCP (hosted, third-party), registered as notion-mcp (official MCP Registry: com.notion/mcp 1.0.1)' url: https://mcp.notion.com/mcp tools: notion_search: {kind: read, name: notion-search} notion_fetch: {kind: read, name: notion-fetch} sentry: … command: [npx, -y, '@sentry/mcp-server@0.42.0', --skills=inspect] tools: find_organizations: {kind: read}…Deux autres lacunes apparaissent, et elles doivent figurer dans le rapport. Les identifiants d’outils du registre n’ont pas de traits d’union, mais les noms d’outils de Notion en ont. La passerelle a donc besoin d’une correspondance entre notion.notion_search et notion-search. De plus, la passerelle d’outils du cours démarre seulement des serveurs locaux. Un serveur hébergé exige d’abord un transport distant dans la passerelle. Sans ce transport, l’enregistrement de Notion est complet, mais la passerelle ne peut pas le connecter. La prochaine étape revient à la plateforme, pas à Notion.
Constats et limites
Section intitulée « Constats et limites »- Le registre répond à « qui », pas à « quoi ». Les espaces de noms sont vérifiés, et c’est précieux : sur 147 entrées qui mentionnent Stripe, une appartient à Stripe. Mais l’entrée ne décrit ni les outils, ni les données, ni les écritures.
- Les inconnues sont le livrable. Avec les trois sources, 19 des 48 réponses manquaient encore. Un bon examen précise lesquelles et qui doit y répondre.
- Les listes publiées deviennent périmées. Le catalogue et la page du fournisseur avaient 2 noms d’outils Stripe en commun, et aucun pour Notion. Un serveur hébergé n’a pas de version à fixer. Prévoyez donc un examen chaque fois que ses outils changent.
- Certains outils rendent une liste d’autorisation inefficace. Cherchez d’abord les outils à exécution libre, les outils cachés et ceux qui appellent leur propre modèle.
- Limites de cette étude. Seulement des informations publiées, lues à un moment donné. Aucun serveur n’a été exécuté, donc aucune liste d’outils n’est confirmée ici. Aucune description n’a été vérifiée pour y chercher des instructions destinées à un modèle. Les notes sur les fournisseurs reflètent notre lecture de leurs pages, et les demandes sont inventées.
Utilisation responsable
Section intitulée « Utilisation responsable »- Une décision appartient à Larkfield; ce n’est pas un verdict sur un produit. Chaque décision suit les règles propres à Larkfield, comme « aucune donnée de paiement ne va à un modèle » et « aucun outil à exécution libre ». Elle repose sur les faits publiés par chaque fournisseur au moment où la copie figée a été créée. Une autre organisation, ou un examen ultérieur des pages actuelles, pourrait décider autrement. Dites « refusé selon nos règles », jamais « un mauvais serveur ».
- Examinez l’entrée actuelle. La copie figée sert à apprendre. Avant un véritable enregistrement, lisez le registre actuel (
python -m intake fetch com.stripe/mcpcompare une entrée) et les pages actuelles du fournisseur. - Résumez, ajoutez des liens et copiez peu. Les pages des fournisseurs leur appartiennent. Rédigez les notes dans vos propres mots, avec un lien pour chaque réponse, comme le fait
data/vendor/*.yaml. - Les entrées nomment des personnes. Beaucoup d’espaces de noms sont des comptes GitHub personnels. Comptez et lisez les entrées pour examiner les serveurs; ne faites pas de profilage de leurs éditeurs.
- N’exécutez rien que vous n’avez pas examiné. Après cet examen, la prochaine étape est un test dans un environnement jetable avec des comptes de test. Suivez la revue de sécurité du cours MCP. N’utilisez jamais les identifiants de production de Larkfield.
- Aucune affiliation. Dites « données provenant du Official MCP Registry ». Ne dites jamais que vous êtes son partenaire ou qu’il a approuvé votre examen (ses conditions, section 6).
Faites-en un projet de portfolio
Section intitulée « Faites-en un projet de portfolio »Ce projet montre ce qu’une équipe de plateforme ou de sécurité recherche. C’est un examen reproductible de logiciels tiers à partir de preuves. Une personne signe chaque décision, et un programme la vérifie.
Quoi mettre dans le dépôt :
mcp-intake/ README.md what it does, how to run and check it, your decisions table DATASET.md the sources, the licences (CC0, MIT), the changes, the limits LICENSE MIT, for the code requests.yaml your requests (say that they are made up) registrations/ your reviewed forms, each signed in review: by, notes notes/ your own vendor notes, with links docs/review.md the review report: decisions, the comparison, the unknowns, the gaps you found intake/, estate/, config/, tests/- Créez un nouveau dépôt Git à partir du dossier de votre projet et poussez-le vers GitHub.
- Examinez un serveur que cette page n’a pas examiné : choisissez-en un avec
python -m intake search. Ajoutez une demande àrequests.yaml, lisez les pages du fournisseur et rédigeznotes/<id>.yaml. Ajoutez-le àdocs/review.md. - Assurez-vous que
python -m pytest -qetpython -m intake checkréussissent à partir d’un nouveau clone. Indiquez-le dans le README.
En entrevue, présentez-le en deux phrases : « J’ai examiné des serveurs MCP publics pour une plateforme d’agents, seulement à partir de preuves publiées. J’ai rédigé des enregistrements avec des niveaux de risque, des listes d’autorisation d’outils et une décision signée pour chacun. Le résultat le plus utile était la liste des informations qu’aucune source ne publiait, et trois lacunes dans nos propres contrôles. »
Vérification des connaissances
Section intitulée « Vérification des connaissances »Vérifiez votre compréhension
Tomás dit : « Il est dans le registre MCP officiel, donc il a été vérifié. » Qu'a vérifié le registre, et que vous reste-t-il à faire?
Afficher la réponse
Le registre a vérifié que l’éditeur contrôle l’espace de noms : le domaine, par DNS ou HTTP, ou le compte GitHub. Pour un paquet, il a vérifié que le paquet nomme le serveur. Cela prouve qui a publié l’entrée. Il n’a pas vérifié les outils, les données qu’ils renvoient, lesquels écrivent, ni les autres services que le serveur appelle. Il laisse l’analyse du code aux registres de paquets et aux catalogues. Ces réponses servent à remplir l’enregistrement; les trouver est donc le travail du réviseur.
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
Le catalogue Docker liste 25 outils pour le serveur hébergé de Stripe, et la page de Stripe en liste 15. Seulement 2 noms concordent. Quelle liste faut-il mettre dans l'enregistrement, et qu'est-ce qui trancherait?
Afficher la réponse
La liste du fournisseur, car il exploite le serveur hébergé et la liste du catalogue est plus ancienne. Mais une page reste une description. Les outils que le serveur renvoie à tools/list tranchent la question. Vous les voyez seulement en vous connectant, lors d’un test avec un compte de test. Un serveur hébergé n’a pas de version à fixer, donc la liste peut encore changer. Prévoyez un examen lorsqu’elle change, et laissez la passerelle d’outils refuser tout outil non enregistré.
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
L'entrée de Shippo dans le registre, sa documentation et son dépôt ne nomment aucun outil. Amira dit : « Enregistrez-le sans outils pour l'instant, pour qu'on puisse commencer. » Que décidez-vous, et pourquoi?
Afficher la réponse
Attendre. Un enregistrement sans outils n’autorise rien, donc il ne permettrait pas à Amira de commencer. Il donnerait seulement l’apparence d’une décision. Sans liste d’outils publiée, le serveur présente un risque élevé. De plus, ses achats d’étiquettes coûtent de l’argent et expédient des biens. Demandez à Shippo la liste des outils et les conditions relatives aux données. Listez ensuite les outils lors d’un test avec un compte de test Shippo. Enregistrez les outils de lecture, avec chaque écriture soumise à une autorisation d’approbation. D’ici là, les étiquettes de retour restent dans le serveur de commandes.
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
- Le registre prouve qui a publié un serveur; il ne dit pas ce que le serveur peut faire. Sur 147 entrées qui mentionnent Stripe, un espace de noms appartient à Stripe.
- Pour quatre serveurs, le registre seul a répondu à 13 des 48 questions. Le catalogue Docker a porté ce total à 19, et les pages des fournisseurs à 29. Les sources ne s’entendaient pas sur les outils, et la liste du fournisseur a eu priorité.
- Chaque outil a été classé : lecture, écriture, exécution libre ou type inconnu. Les outils à exécution libre, les outils cachés et ceux qui appellent leur propre modèle ont été exclus.
- Les décisions : Stripe est refusé (données de paiement), Shippo attend (aucune liste d’outils). Sentry est enregistré avec 10 outils de lecture et Notion avec 2, chacun avec des conditions et une signature.
- L’examen a trouvé trois lacunes dans les contrôles de la plateforme. La règle sur les paiements ignorait les serveurs d’outils (corrigé depuis dans le projet du cours). Les noms d’outils peuvent contenir des traits d’union, et la passerelle d’outils ne peut pas joindre les serveurs hébergés.
Ensuite, le travail final : placez tout le parc de Larkfield sous gouvernance pendant un mois rejoué. Il comprend une panne, une demande de modification d’association et un agent emballé.
Leçon suivante : Travail final