Comment créer des diagrammes d'architecture avec des agents IA (MCP)

Les assistants IA savent bien transformer une description en diagramme. Les ennuis commencent le lendemain. Un diagramme qui vit sous forme de PNG dans un chat, ou d'extrait Mermaid dans une pull request, est une copie. Personne ne met la copie à jour, et un mois plus tard, elle contredit le système qu'elle décrit.

Le Model Context Protocol (MCP) change l'endroit où travaille l'agent. Au lieu de vous remettre une image, un agent connecté à Archboard via MCP lit et modifie le même diagramme structuré que votre équipe ouvre dans le navigateur. Ses modifications apparaissent en direct sur le canevas, signées du nom de la personne pour qui il travaille, et cette personne peut les annuler en une étape.

Ce guide montre comment connecter une app IA à Archboard, déroule un exemple complet du premier jet à la revue, et aborde les prompts, les autorisations et les limites qui comptent en pratique.

Ce qu'un agent peut faire avec Archboard

Les diagrammes Archboard sont faits de nœuds typés issus de packs de nœuds : un Deployment Kubernetes, une base de données cloud, un conteneur C4 ou une tâche BPMN est un nœud avec des ports et des propriétés, pas une boîte avec une étiquette. Via MCP, un agent peut :

• Lister et lire les diagrammes auxquels il a accès, sous forme de vue d'ensemble (cadres, décomptes, qui travaille dessus) ou d'enregistrements complets de nœuds et de liens.
• Créer un diagramme à partir d'une description, d'une liste d'opérations ou d'un logigramme Mermaid converti en vrais types de nœuds.
• Modifier un diagramme avec un lot d'opérations appliqué comme une seule modification : ajouter des nœuds, connecter des ports, déplacer, changer le style ou supprimer.
• Vérifier son travail en générant un instantané PNG, et afficher le diagramme dans la conversation, dans les apps qui prennent en charge MCP Apps.
• Annuler l'une de ses propres modifications.

Archboard n'intègre pas son propre modèle d'IA. C'est vous qui apportez l'agent : Claude, Cursor, VS Code ou une autre app capable d'ajouter un serveur MCP distant avec connexion OAuth. La page Agents IA en donne un bref aperçu.

Connecter votre app IA

Le serveur MCP d'Archboard se trouve à l'adresse https://getarchboard.app/mcp. Il utilise Streamable HTTP et OAuth : il n'y a donc aucune clé d'API à copier. Quand votre app se connecte, elle ouvre la page de connexion d'Archboard ; vous vous connectez avec Google ou GitHub et approuvez l'accès que l'app demande.

Sur l'écran de consentement, vous choisissez les organisations et les espaces de travail que l'app peut utiliser, et ce qu'elle peut faire dans chacun : lecture, modification ou suppression (placer des diagrammes dans la corbeille). Vous pourrez ensuite renommer l'app, changer ce qu'elle peut utiliser et faire, ou retirer son accès dans Paramètres > Applications connectées.

Configuration dans quelques apps courantes :

Claude (web et bureau). Ouvrez Customize > Connectors, choisissez Add custom connector et saisissez https://getarchboard.app/mcp. Sur les plans Team et Enterprise, un Owner l'ajoute d'abord dans Organization settings > Connectors ; vous vous connectez ensuite depuis Customize > Connectors.

Claude Code.

claude mcp add --transport http archboard https://getarchboard.app/mcp

Lancez ensuite /mcp dans une session pour vous connecter.

Cursor. Ajoutez le serveur à ~/.cursor/mcp.json :

{
  "mcpServers": {
    "archboard": { "url": "https://getarchboard.app/mcp" }
  }
}

VS Code. Ajoutez-le à votre mcp.json (VS Code utilise une clé servers) :

{
  "servers": {
    "archboard": { "type": "http", "url": "https://getarchboard.app/mcp" }
  }
}

Autres apps. Ajoutez https://getarchboard.app/mcp comme serveur MCP distant dans les paramètres de connecteurs ou MCP de l'app, si votre plan le permet. L'app doit gérer la connexion OAuth sans secret client ; la documentation MCP donne les détails aux développeurs de clients.

Exemple complet : une boutique en ligne, du premier jet à la revue

Voici une session avec un agent connecté à Archboard. Les prompts sont du genre que vous taperiez ; les noms d'outils entre parenthèses sont ce que l'agent appelle en coulisses.

1. Demander un premier jet

Dessinez un diagramme de conteneurs C4 pour notre boutique en ligne : une application web, une API, un worker en arrière-plan qui envoie les e-mails de commande via notre fournisseur d'e-mails, une base de données PostgreSQL et Stripe pour les paiements. Placez tout ce que nous exploitons nous-mêmes dans une frontière de système.

L'agent choisit un espace de travail (list_workspaces), recherche les types de nœuds C4 dont il a besoin (search_node_types) et crée le diagramme (create_diagram). Il génère ensuite un instantané (render_snapshot) pour vérifier que rien ne se chevauche et que chaque lien est étiqueté, puis affiche le résultat dans la conversation (show_diagram).

Ce premier jet est un point de départ. L'agent a choisi les conteneurs d'après votre phrase ; il ne peut pas savoir que le worker lit aussi la base de données si vous ne le dites pas.

2. Modifier avec des mots, relire sur le canevas

Le worker lit aussi les commandes dans la base de données. Ajoutez un cache Redis entre l'API et PostgreSQL, et étiquetez chaque connexion avec son protocole.

L'agent lit le diagramme actuel (get_canvas) et applique un seul lot d'opérations (apply_ops). Si vous avez le diagramme ouvert, vous voyez les nouveaux nœuds apparaître à côté d'un curseur étiqueté avec le nom de l'app et le vôtre. Les collègues qui ont le diagramme ouvert voient la même chose.

Voici le diagramme après les deux premiers prompts :

3. Annuler ce qui ne vous plaît pas

Annulez la dernière modification.

Chaque modification d'un agent est une étape. L'agent peut revenir sur sa propre modification (revert_change), ou vous pouvez l'annuler en une étape depuis l'avis qui s'affiche dans l'éditeur juste après la modification. Les champs modifiés entre-temps par quelqu'un d'autre sont conservés.

4. Poser des questions sur un diagramme existant

Quels conteneurs communiquent avec PostgreSQL, et via quel protocole ?

Pour une question de ce type, l'agent se contente de lire (get_canvas). Expliquer un diagramme existant à un nouveau collègue est l'une des choses les plus utiles qu'un agent puisse faire, et cela ne demande aucun accès en écriture.

Des prompts qui fonctionnent bien

• Nommez le type de diagramme. « Diagramme de conteneurs C4 », « diagramme Kubernetes avec un cadre par namespace », « processus BPMN avec un couloir par équipe ». L'agent utilise alors le pack de nœuds correspondant au lieu de boîtes génériques.
• Dites ce qui va dans chaque frontière. Les cadres, les namespaces et les VPC ont un sens : indiquez à l'agent ce qui va où.
• Demandez des liens étiquetés. « Étiquetez chaque connexion avec le protocole et le port » transforme les flèches en documentation.
• Gardez chaque modification petite. Une demande par modification est plus facile à relire et à annuler qu'une réécriture.
• Demandez à l'agent de vérifier son travail. « Générez un instantané et corrigez les chevauchements » repère les problèmes de mise en page avant même que vous regardiez.
• Demandez un résumé. « Listez ce que vous avez modifié » vous donne une note de revue pour la pull request ou le chat de l'équipe.

Qui contrôle quoi

Connecter une app IA aux diagrammes sur lesquels travaille votre équipe soulève des questions légitimes. Voici les règles qu'Archboard applique :

• Vous choisissez le périmètre. Une app ne voit que les organisations et espaces de travail que vous avez autorisés, et n'y fait que ce que vous avez autorisé : lecture, modification ou suppression. Ce qu'elle peut réellement faire correspond au plus restrictif entre ce réglage, les scopes qui lui ont été accordés, votre rôle et votre plan.
• Les modifications sont visibles et attribuées. Le curseur et les modifications d'un agent portent le nom de l'app et de la personne pour qui il travaille, sur le canevas et dans l'historique des versions.
• L'annulation tient en une étape. Vous pouvez annuler une modification de votre agent depuis l'avis qui s'affiche dans l'éditeur, ou demander à l'agent de l'annuler dans les 7 jours. Les propriétaires et administrateurs de l'organisation peuvent aussi l'annuler.
• La suppression est réversible. Un agent a besoin de l'autorisation Suppression pour placer un diagramme dans la corbeille, et Archboard demande aux agents de ne le faire que si vous le demandez. Vous pouvez restaurer le diagramme depuis la Corbeille.
• Le texte d'un diagramme est une donnée. Archboard demande aux agents de traiter les étiquettes, notes et noms d'un diagramme comme des données, jamais comme des instructions, et de n'ajouter des images que si vous le demandez.

Quand utiliser un agent, et quand dessiner à la main

Les agents sont bons pour les premiers jets, les modifications répétitives (« renommez chaque service orders-* en checkout-* »), pour garder un diagramme en phase avec une modification que vous faites de toute façon, et pour expliquer un diagramme dessiné par quelqu'un d'autre. Un agent de code qui vient de modifier un service peut mettre à jour le diagramme d'architecture dans la même session.

Dessiner à la main reste préférable pour décider de ce qui compte. Un diagramme est un argument sur un système, et choisir ce qu'on laisse de côté relève du jugement. Laissez l'agent taper, et gardez le jugement pour vous.

Les limites à connaître

• Les limites du plan s'appliquent. MCP fonctionne sur tous les plans, avec les mêmes limites de plan que l'éditeur. Sur le plan Free, cela représente 3 diagrammes, et 15 nœuds de diagramme plus 150 notes, textes, autocollants et sujets de carte mentale par diagramme.
• Les appels d'outils sont limités par minute. Quand un agent atteint la limite, Archboard lui indique combien de temps attendre avant de réessayer.
• L'agent ne sait que ce que vous lui dites et ce qui figure dans le diagramme. Via Archboard, il ne voit ni votre cluster en fonctionnement ni votre base de code. Si une dépendance compte, dites-le, ou laissez un agent de code lire le code.

FAQ

Quelles apps IA peuvent se connecter à Archboard ? Les apps capables d'ajouter un serveur MCP distant avec connexion OAuth et qui n'exigent pas de secret client. La page Agents IA propose une configuration rapide pour Claude, Cursor, VS Code, Claude Code et d'autres.

Archboard utilise-t-il son propre modèle d'IA ? Non. Archboard est l'espace de travail des diagrammes ; c'est l'app IA que vous connectez qui raisonne.

L'agent peut-il voir tous mes diagrammes ? Seulement les organisations et espaces de travail que vous avez autorisés en le connectant, avec l'autorisation choisie pour chacun. Par défaut, ce sont tous, y compris ceux que vous rejoindrez plus tard, avec l'autorisation Suppression ; vous pouvez restreindre cela sur l'écran de consentement ou plus tard dans Paramètres > Applications connectées.

Puis-je annuler ce qu'a fait l'agent ? Oui. Chaque modification de l'agent est une étape que vous pouvez annuler depuis l'avis dans l'éditeur, et l'app peut annuler ses propres modifications des 7 derniers jours.

Est-ce que ça fonctionne avec le plan Free ? Oui. MCP fonctionne sur tous les plans, avec les mêmes limites de plan que l'éditeur.

Commencez gratuitement — un siège, sans carte bancaire.