Portées
Les quatre portées des jetons iyedy, les routes et outils MCP que chacune ouvre, et comment portées et rôles se combinent à chaque requête.
Sur cette page
| Portée | Ouvre | MCP | Rôle nécessaire pour agir |
|---|---|---|---|
cartouche.read |
la lecture des schémas, vues, versions, la recherche, les contrôles | oui | lecteur |
cartouche.graph |
impact, dépendants, dépendances, recherche d’éléments dans plusieurs schémas | oui | lecteur |
cartouche.propose |
prévisualisations et propositions | oui | contributeur |
cartouche.write |
le remplacement de la définition d’un schéma | jamais | contributeur |
Tout jeton, quelles que soient ses portées, peut appeler GET /v1/token.
Comment une requête est vérifiée
À chaque requête avec jeton, dans cet ordre :
- Le jeton. Absent, mal formé, expiré, révoqué, hors des adresses permises, ou bloqué par la politique de l’organisation :
401 unauthenticated, avec la raison. - L’endroit. Un chemin qui nomme une autre organisation, un autre compte ou, pour un jeton lié à un espace de travail, un autre espace :
404 not_found, la même réponse que pour un identifiant qui n’existe pas. - La route. Une route hors de l’API publique :
403 permission_denied, raisontoken_not_accepted. Un jeton ne crée jamais de jetons, n’administre pas, n’ouvre pas la connexion en direct, ne lance pas l’Assistant et n’exporte pas une bibliothèque. - La portée. Une portée manquante :
403 permission_denied, raisoninsufficient_scope, avec la portée dansrequired. - Le rôle. La route vérifie ensuite votre rôle, ou celui du compte de service, comme pour tout le monde : schémas restreints, partages, corbeille, conservations légales et verrous s’appliquent.
cartouche.read
Lit l’espace de travail et ses schémas.
Route (sous /v1/t/{tenantId}/w/{workspaceId}) |
Ce qu’elle fait |
|---|---|
GET /me |
vous dans cet espace : rôle, limites, ce que vous pouvez faire |
GET /diagrams, GET /diagrams/{did} |
les schémas que vous pouvez lire, le résumé d’un schéma |
GET /diagrams/{did}/versions |
les versions enregistrées |
GET /diagrams/{did}/layouts |
les mises en page des vues |
GET /diagrams/{did}/source |
la définition du schéma sous forme de texte |
GET /diagrams/{did}/views, GET /diagrams/{did}/views/{view} |
les vues, et une vue dans un format |
GET /search |
la recherche dans les noms et le contenu |
POST /checks |
validation et contrôles d’architecture ; rien n’est enregistré |
POST /tools/{tool} |
l’un des outils de lecture que partage le serveur MCP |
Elle ouvre aussi l’adresse MCP de l’organisation, POST /v1/t/{tenantId}/mcp, quand l’organisation autorise les clients MCP.
cartouche.graph
Suit les relations dans les schémas que vous pouvez lire.
Route (sous /v1/t/{tenantId}/w/{workspaceId}) |
Ce qu’elle fait |
|---|---|
GET /graph/impact |
ce qui dépend d’un élément, de proche en proche |
GET /graph/dependents |
ce qui l’utilise directement |
GET /graph/dependencies |
ce dont il dépend |
GET /graph/search |
des éléments par le sens ou le nom, avec leurs voisins |
cartouche.propose
Prépare des modifications qu’une personne relit. Avec le rôle de lecteur, elle ne prévisualise ni n’enregistre rien.
Route (sous /v1/t/{tenantId}/w/{workspaceId}) |
Ce qu’elle fait |
|---|---|
POST /diagrams/{did}/preview |
ce que ferait une modification ; rien n’est enregistré |
POST /diagrams/{did}/proposals |
enregistre une proposition |
GET /diagrams/{did}/proposals, GET /diagrams/{did}/proposals/{pid} |
les propositions et une proposition |
POST /diagrams/{did}/proposals/{pid}/withdraw |
retire une de vos propositions ouvertes |
Décider d’une proposition n’est jamais ouvert à un jeton : une personne l’applique ou la refuse dans l’app. Voir Proposer une modification par l’API.
cartouche.write
Route (sous /v1/t/{tenantId}/w/{workspaceId}) |
Ce qu’elle fait |
|---|---|
PUT /diagrams/{did}/source |
enregistre une nouvelle définition du schéma, comme nouvelle version de son historique |
La nouvelle définition est d’abord vérifiée : une définition invalide est refusée et rien n’est enregistré. Par MCP, cette portée n’est jamais honorée : Claude et les clients MCP proposent, ils n’écrivent jamais.
Sur la page d’accès
Quand Claude se connecte, les trois portées MCP apparaissent en mots simples sur la page d’accès : voir Connexion, autorisations et déconnexion.
Cette page vous a-t-elle aidé ?Réponse anonyme, comptée seulement si vous avez accepté la mesure.
Qu’est-ce qui n’a pas marché ?
N’écrivez pas de données personnelles.