Aller au contenu
English

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é.

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.

Étude de casPièce de portfolio

Durée
Environ 2 h 30
S’exécute dans
VS Code, Python 3.12+
Compétences utilisées
  • Formulaires d'enregistrement
  • Niveaux de risque
  • Listes d'autorisation d'outils
  • Lectures et écritures
  • Preuves tirées de sources publiées
  • Inconnues comme constats

Décompressez le projet de départ, ouvrez le dossier dans VS Code et suivez les étapes ci-dessous. Elles commencent par un nouvel environnement virtuel.

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 mainEnviron 150 minutes

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 :

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.

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.

Un flux de haut en bas. Quatre entrées en haut : la demande d'une équipe dans requests.yaml (qui, pourquoi, quel serveur); 1, le registre MCP officiel, 48 606 entrées, CC0, qui indique qui publie un serveur et comment l'exécuter; 2, un deuxième catalogue, celui de Docker, MIT, avec des listes d'outils pour certains serveurs; 3, les pages, la documentation et le code source du fournisseur, lus par une personne. Ces entrées alimentent douze questions, python -m intake answer, avec comme réponse oui, partiellement ou non publié. Puis les outils publiés, chacun marqué lecture, écriture, exécution de tout outil ou inconnu, python -m intake tools. Puis un brouillon d'enregistrement avec un niveau de risque, les outils à autoriser, une décision et les inconnues, python -m intake draft. Puis un losange : une personne examine, modifie et signe. Puis python -m intake check, les vérifications du registre du cours et celles de ce projet. Trois résultats : refuser, l'enregistrement indique pourquoi (rouge); attendre, demander au fournisseur, puis un test d'intégration (ambre en pointillé); enregistrer les lectures seulement, le formulaire et la liste de la passerelle d'outils (bleu).
L'examen, de la demande à la décision. Le code propose; une personne décide et signe.
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

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.

  1. 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 dossier mcp-intake.

  2. 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).

  3. Créez et activez un environnement virtuel, puis installez les paquets :

    Fenêtre de terminal
    python3 -m venv .venv
    source .venv/bin/activate
    python -m pip install -r requirements-dev.txt
  4. Vérifiez les données avec leurs sommes de contrôle, puis exécutez les tests :

    Fenêtre de terminal
    python -m intake verify
    python -m pytest -q
    24 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.

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.

Deux panneaux. À gauche, les vérifications du registre : le responsable de la publication contrôle le nom, com.stripe désigne le domaine stripe.com, par DNS ou HTTP, et io.github.getsentry désigne ce compte GitHub; le paquet appartient au nom, par npm mcpName, une ligne du README PyPI ou une étiquette d'image OCI; l'entrée respecte le format, server.json, avec des limites de taille. À droite, dans des cases rouges en pointillé, ce qui n'est pas vérifié pour vous : les outils disponibles et ceux qui écrivent; les données que les outils renvoient; les autres services ou modèles appelés; les changements d'outils après l'examen; ce que le fournisseur conserve; le code lui-même, puisque l'analyse est laissée à npm, PyPI et aux catalogues.
Ce que le registre vérifie avant d'inscrire un serveur, et ce qu'un enregistrement exige sans que personne l'ait vérifié pour vous.
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.

Avant d’examiner quatre serveurs, voyez ce que le registre peut vous dire sur n’importe quel serveur :

Fenêtre de terminal
python -m intake coverage
Official 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.
Part des 48 606 dernières entrées de la copie fixe qui publient chaque champ. Hébergé : hébergé seulement, sans paquet dont nous pourrions fixer la version. Outils : une liste d'outils dans les notes du responsable de la publication, que le registre ne vérifie pas. Données : aucun champ n'existe.
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 :

Fenêtre de terminal
python -m intake search stripe
147 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 namespaces
Namespaces on a domain with that word: domain stripe.com

147 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 »

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.

L’examen le moins coûteux lit seulement l’entrée du registre. Exécutez-le pour Stripe :

Fenêtre de terminal
python -m intake answer stripe-mcp --sources registry
com.stripe/mcp 0.2.4, from: registry
yes Who publishes it, and is that checked? *
domain stripe.com: the registry checks that the publisher controls it
partly 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 pin
yes 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, data

Trois 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.

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 :

Fenêtre de terminal
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.

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 :

Fenêtre de terminal
python -m intake answer sentry-mcp
io.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 (*): none

Deux 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.

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 :

Fenêtre de terminal
python -m intake lists stripe-mcp
python -m intake lists notion-mcp
catalog 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: 0

Deux 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.

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.

Fenêtre de terminal
python -m intake compare
server registry +catalog +vendor still blocking with all three
stripe-mcp 3 6 7 none
shippo-mcp 3 3 4 tools, data
sentry-mcp 4 4 10 none
notion-mcp 3 6 8 none
all four 13 19 29 (of 48 answers)
Les quatre serveurs examinés, douze questions chacun (48 au total) : les réponses marquées oui avec le registre seul, le catalogue Docker, puis les pages des fournisseurs.
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.

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 :

Fenêtre de terminal
python -m intake tools stripe-mcp
com.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 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édigez la première ébauche :

Fenêtre de terminal
python -m intake draft sentry-mcp --out registrations/sentry-mcp.yaml
Wrote 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 :

Fenêtre de terminal
python -m intake check
sentry-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 :

registrations/sentry-mcp.yaml (the reviewed version, shortened)
risk_tier: medium
data_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: suggests
intake:
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.

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
Fenêtre de terminal
python -m intake check
notion-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-search et notion-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 que notion-ai-search peut être appelé par son nom, même s’il n’apparaît pas dans tools/list. Et notion-connector-search accè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é :

Before the fix (the course project as it was then)
stripe-amira.yaml: complete (high risk, 2 tool(s), decision: register)

Exécutez maintenant la même vérification :

Fenêtre de terminal
python -m intake check --course-only registrations/stripe-amira.yaml
stripe-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 :

Fenêtre de terminal
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.

Fenêtre de terminal
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.

  • 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.
  • 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/mcp compare 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).

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/
  1. Créez un nouveau dépôt Git à partir du dossier de votre projet et poussez-le vers GitHub.
  2. 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édigez notes/<id>.yaml. Ajoutez-le à docs/review.md.
  3. Assurez-vous que python -m pytest -q et python -m intake check ré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é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.

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é.

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.

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