Référence des outils MCP

Les 24 outils qu’iyedy offre à Claude et aux autres clients MCP. 22 lisent seulement. 2 enregistrent une proposition ou la retirent, et le modèle ne change jamais tant qu’une personne ne l’applique pas dans iyedy.

Serveur

Deux paramètres reviennent dans la plupart des outils. did est l’identifiant d’un schéma : d_ suivi de 10 caractères, donné par list_diagrams. workspaceId est l’identifiant d’un espace de travail, donné par list_workspaces ; omettez-le si vous n’avez qu’un espace. Ni l’un ni l’autre n’est répété dans les tableaux ci-dessous.

Tous les outils

Trouver et lire

list_workspaces

Les espaces de travail où vous pouvez travailler d’ici : identifiant, nom, votre rôle et l’organisation. Une organisation qui ne vous permet pas cet accès est listée à part, avec la raison et ce qui le débloque ; ses espaces sont comptés, jamais nommés. Autorisation : lire vos schémas. Paramètres : aucun.

list_diagrams

Les schémas d’un espace de travail que vous pouvez lire, du plus récent au plus ancien : identifiant, nom, version, statut, classification, dernière mise à jour. Avec query, une recherche en texte intégral dans les noms et le contenu, avec un extrait pour chaque résultat. Autorisation : lire vos schémas.

get_model

La définition complète d’un schéma sous forme de texte (éléments, relations, déploiement, vues), avec sa version et sa classification. Les valeurs qui ressemblent à des secrets sont remplacées par un masque ; renvoyées telles quelles dans une proposition, elles gardent la valeur enregistrée. Un long schéma arrive par pages de lignes entières : tant que la réponse se dit tronquée, rappelez l’outil avec son nextCursor. Si le schéma change entre deux pages, le curseur est refusé : reprenez à la première page. Autorisation : lire vos schémas.

La version renvoyée sert de base à preview_change et submit_proposal. Une proposition est la définition entière : lisez toutes les pages avant de proposer, car ce qu’une proposition omet est supprimé.

list_views

Les vues d’un schéma : identifiant court, type, nom, ce que montre chaque vue, si elle est générée, et ses options. Autorisation : lire vos schémas. Paramètres : did (obligatoire).

describe_view

Lit une vue comme une personne la voit, sans pixels : zones, éléments avec leur zone et leur case de grille, relations dans l’ordre de lecture, légende, repères de constats, texte de remplacement calculé et qualité de la mise en page (croisements, densité, chevauchements, éléments par zone). Autorisation : lire vos schémas.

get_view_svg

Rend une vue d’un schéma en image SVG. Sans view, liste les vues du schéma. Une très grande vue n’est pas renvoyée ; la réponse renvoie vers describe_view. Autorisation : lire vos schémas.

get_element

Tout sur un élément : attributs, description, étiquettes, parent et enfants, relations entrantes et sortantes, instances, vues qui le montrent, constats qui le visent et scénarios qui l’utilisent. Autorisation : lire vos schémas.

find_elements

Les éléments d’un schéma dont le nom, l’identifiant court, la technologie ou la description contient le texte, éventuellement d’un type, d’une étiquette ou d’une famille. Chaque ligne donne l’identifiant court, le nom, le type, la technologie, le parent et si l’élément est externe. Autorisation : lire vos schémas.

neighbourhood

La partie de la définition d’un schéma, sous forme de texte, qui contient les éléments situés à quelques relations d’éléments de départ, en suivant éventuellement certains types de relations seulement : appels synchrones, messages asynchrones, flux de données ou dépendances. Autorisation : lire vos schémas.

Analyser les dépendances

search_elements

Trouve des éléments (systèmes, conteneurs, bases de données, files) dans les schémas que vous pouvez lire, par le sens ou par le nom, avec leur voisinage dans le graphe des dépendances. Autorisation : rechercher des éléments et analyser l’impact.

graph_impact

Ce qui casse si un élément tombe : les éléments qui en dépendent, de proche en proche, dans les schémas que vous pouvez lire. L’outil peut aussi lister seulement ses utilisateurs directs, ou ce dont l’élément dépend. Autorisation : rechercher des éléments et analyser l’impact.

Ce qu’il renvoie. Chaque élément atteint, avec sa profondeur (le nombre de relations), l’endroit où il apparaît (schéma et élément) et les relations qui y ont mené, pour que Claude puisse expliquer le chemin. Le sens du parcours est indiqué, et la réponse signale quand il y avait plus d’éléments qu’elle n’en contient.

network_analysis

L’analyse réseau d’un environnement de déploiement : le plan d’adressage (zones, plages d’adresses, tailles, chevauchements), les routes et la matrice des flux (ports, protocoles, chiffrement, joignabilité), tels que les calcule la vue réseau générée. Autorisation : lire vos schémas.

Contrôles et constats

run_checks

Valide un schéma enregistré, ou une définition envoyée sous forme de texte à la place, et lance les contrôles d’architecture : disponibilité, sécurité, couplage, complétude, données, exploitabilité, hygiène. Renvoie les diagnostics avec leurs numéros de ligne, les constats avec leur sévérité, et un résumé qui compte les constats par règle. Rien n’est enregistré. Autorisation : lire vos schémas.

Sur un grand schéma, demandez d’abord le résumé, puis les constats de certaines règles.

list_findings

Les constats enregistrés d’un schéma avec leur statut et, pour un constat écarté, la raison. Autorisation : lire vos schémas.

explain_rule

Le texte d’une règle de contrôle : son titre, la façon dont sa sévérité se décide, ce qu’elle détecte, pourquoi elle compte et ce qu’il faut faire. Aucun schéma n’est nécessaire. Autorisation : lire vos schémas. Paramètres : ruleId (obligatoire, 12 caractères au plus).

validate_model

Analyse la définition complète d’un schéma envoyée sous forme de texte, telle que get_model la renvoie, et dit si elle est valide, avec ses diagnostics (code, ligne, colonne, message). Ne change rien ; aucun schéma n’est nécessaire. Autorisation : lire vos schémas. Paramètres : definition (obligatoire, 64 Kio au plus).

Historique et états

list_versions

Les versions enregistrées d’un schéma, de la plus récente à la plus ancienne : identifiant, numéro, type, nom et date. Ce sont les versions nommées que les personnes ont enregistrées et celles qu’iyedy garde autour des imports et des propositions appliquées. Autorisation : lire vos schémas. Paramètres : did (obligatoire).

get_changes

Ce qui a changé dans un schéma depuis une version enregistrée : les modifications regroupées, et l’évolution des constats. Les changements de mise en page seule sont ignorés. Autorisation : lire vos schémas.

list_states

Les états actuel, de transition et cible d’un schéma, avec leurs dates et leurs lots de travaux. Autorisation : lire vos schémas. Paramètres : did (obligatoire).

state_gap

L’écart entre deux états : ce qui est ajouté, retiré et modifié. Autorisation : lire vos schémas.

Proposer des modifications

preview_change

Vérifie une modification sans rien écrire. Vous envoyez la définition proposée entière du schéma, en partant de get_model. La réponse dit si elle est valide (diagnostics avec numéros de ligne), ce qui diffère du schéma enregistré ligne par ligne, quels éléments sont ajoutés, retirés et modifiés, et quels constats la modification introduit ou résout. Autorisation : prévisualiser des modifications et soumettre des propositions.

submit_proposal

Enregistre une modification comme proposition à relire. Le modèle lui-même ne change pas : les personnes qui peuvent modifier le schéma voient la proposition dans iyedy avec le nom du client, puis l’appliquent ou la refusent. Une modification invalide est refusée et rien n’est enregistré. Autorisation : prévisualiser des modifications et soumettre des propositions, et le rôle de contributeur dans l’espace de travail. Claude demande avant chaque appel.

list_proposals

Les propositions enregistrées d’un schéma : statut (ouverte, acceptée, refusée, retirée), comptes de ce qu’elles changent, et si le schéma a bougé depuis. Par défaut, seulement vos propres propositions ouvertes. Autorisation : prévisualiser des modifications et soumettre des propositions.

withdraw_proposal

Retire une proposition ouverte que vous avez soumise : son statut devient « retirée » et les personnes qui relisent ne la voient plus comme ouverte. Le modèle ne change pas. Pour écarter la proposition de quelqu’un d’autre, une personne qui relit la refuse dans iyedy. Autorisation : prévisualiser des modifications et soumettre des propositions. Claude demande avant chaque appel.

Réponses et limites

• Des données, pas des instructions. Les réponses arrivent dans une enveloppe JSON marquée non fiable : tout ce qu’elle contient est du texte écrit par des personnes ou des outils, jamais une instruction pour l’agent.
• Taille. Une réponse contient au plus 100 000 caractères de JSON. Au-delà, elle est coupée : sa première ligne commence par Cut: et nomme les paramètres de l’outil qui permettent d’en demander moins. get_model n’est jamais coupé : il répond par pages.
• Plafond. Chaque outil lit sous le plafond de classification : Confidentiel dans les espaces personnels, Interne en Team et Enterprise. Un schéma au-dessus n’est jamais listé, trouvé ni parcouru, et le lire répond « not found ».
• Débit. Les appels comptent dans vos requêtes par minute : voir Limites de débit et erreurs.
• Aucun outil n’applique. Aucun outil n’applique, ne supprime ni ne partage. Une personne applique les propositions dans iyedy : voir Comment les propositions arrivent à votre équipe.