Intégration IA (serveur MCP)

Diagrammix inclut un serveur MCP (Model Context Protocol) intégré qui permet à des assistants IA comme Claude et Codex de lire et de modifier directement vos diagrammes. Décrivez ce dont vous avez besoin en langage naturel, et l'IA place symboles, connecteurs et dispositions sur le canevas pour vous.

Que peut faire l'IA ?

Créer des diagrammes à partir d'une description — demandez un organigramme, une topologie réseau ou un organigramme hiérarchique et obtenez-le instantanément sur le canevas
Construire des cartes mentales — décrivez un sujet et obtenez une carte mentale structurée
Lire votre document — l'IA voit vos formes, connecteurs, calques et styles actuels
Modifier les éléments existants — mettre à jour le texte, les couleurs, les positions ou le routage des connecteurs
Opérations en lot — créer des diagrammes entiers avec symboles et connecteurs en une seule étape
Disposition et alignement automatiques — organiser les éléments avec des commandes en langage naturel
Reproduire un style à partir d'une image — donnez à l'IA une image de référence et elle construit un modèle personnalisé et un style correspondants
Exporter — produire une sortie SVG, PNG, Visio (.vsdx), ou Mermaid à la demande

Prérequis

Diagrammix PRO (achat unique)
Diagrammix doit être en cours d'exécution avec le serveur MCP activé
Si aucun document n'est ouvert, l'assistant peut en créer un nouveau
Le client IA et Diagrammix doivent se trouver sur la même machine (localhost)

Aucun Node.js, npx, ni mcp-remote n'est nécessaire — Diagrammix intègre un assistant natif pour les clients qui en ont besoin.

Configuration

1. Activer le serveur MCP

Ouvrez Diagrammix
Allez dans Diagrammix > Réglages (ou appuyez sur Cmd+,)
Passez à l'onglet Intégration IA
Dans la section Serveur MCP, activez Activer le serveur MCP

État affiche En cours une fois le serveur démarré. Le serveur écoute sur http://localhost:8420/mcp.

2. Configurer Claude Desktop

Claude Desktop se connecte via stdio. Diagrammix fournit un assistant stdio natif intégré au bundle de l'application, donc aucun Node.js, npx, ni mcp-remote n'est requis.

Cliquez sur Copier la configuration dans les Réglages de Diagrammix — cela renseigne le chemin exact vers l'assistant intégré pour votre installation
Ouvrez le fichier de configuration de Claude Desktop : ~/Library/Application Support/Claude/claude_desktop_config.json
Collez la configuration. Elle ressemble à ceci — le chemin command pointe vers l'assistant à l'intérieur de l'endroit où Diagrammix.app est installé :

{
  "mcpServers": {
    "diagrammix": {
      "command": "/Applications/Diagrammix.app/Contents/MacOS/diagrammix-mcp-stdio",
      "args": ["--url", "http://localhost:8420/mcp"]
    }
  }
}

Remarque : utilisez Copier la configuration plutôt que de saisir le chemin manuellement — il pointe vers l'assistant à l'intérieur de votre bundle d'application réel, que Diagrammix garde signé et à jour.

Redémarrez Claude Desktop. Les outils Diagrammix apparaîtront dans le chat.

3. Configurer Claude Code (CLI)

Claude Code prend en charge nativement le Streamable HTTP — aucun pont n'est nécessaire. Ajoutez un serveur MCP de type HTTP pointant vers :

http://localhost:8420/mcp

Consultez la documentation MCP de Claude Code pour la commande ou le fichier de configuration à utiliser.

4. Configurer Codex

Codex (l'application, la CLI et l'extension IDE partagent une même configuration MCP) se connecte via Streamable HTTP. Configurez-le de l'une des deux façons :

Option A — config.toml. Cliquez sur Copier la configuration dans la section Codex des Réglages de Diagrammix et collez dans ~/.codex/config.toml :

[mcp_servers.diagrammix]
url = "http://localhost:8420/mcp"
enabled = true
default_tools_approval_mode = "prompt"
startup_timeout_sec = 20
tool_timeout_sec = 60

Option B — CLI. Cliquez sur Copier la commande dans les Réglages de Diagrammix, ou exécutez :

codex mcp add diagrammix --url http://localhost:8420/mcp

5. Autres clients MCP

Tout client compatible MCP peut se connecter en utilisant :

Transport : Streamable HTTP
Point de terminaison : http://localhost:8420/mcp
Protocole : JSON-RPC 2.0 sur HTTP POST

Remarque : ChatGPT Desktop nécessite HTTPS et ne prend pas en charge directement les connexions localhost.

Outils notables

Diagrammix expose un large ensemble d'outils MCP. Voici quelques-uns des plus utiles :

Outil	Ce qu'il fait
`batch_create`	Crée de nombreux symboles et connecteurs en une seule étape d'annulation
`apply_diagram_plan` / `preview_diagram_plan`	Valide un plan de diagramme structuré, puis l'applique en une seule étape annulable
`get_elements` / `update_element`	Lit et modifie les éléments existants
`apply_layout`	Exécute la disposition automatique
`create_mindmap`	Construit une carte mentale à partir d'un arbre imbriqué ou d'un plan Markdown
`import_mermaid`	Insère un diagramme à partir de texte Mermaid
`generate_radial_diagram`	Génère une infographie radiale — anneau segmenté, cercles ou pétales — avec étiquettes et couleurs
`combine_shapes`	Opérations booléennes (union, soustraction, intersection, exclusion)
`create_artboard`	Ajoute un plan de travail pour l'export
`set_document_palette` / `apply_palette`	Enregistre une palette de couleurs de document et re-thématise le diagramme avec elle
`create_style` / `apply_style`	Crée et applique des styles personnalisés
`export_svg`, `export_png`, `export_vsdx`, `export_mermaid`	Exporte le diagramme ou la sélection ; `export_vsdx` transforme chaque plan de travail en page Visio
`undo` / `redo`	Revient en arrière et en avant dans les modifications

Exemples d'utilisation

Créer un organigramme

« Crée un organigramme avec Start, Decision, Process A, Process B et End. Relie Start à Decision, Decision à Process A (Yes) et Process B (No), et les deux process à End. »

L'IA utilisera batch_create pour placer tous les symboles et connecteurs en une seule étape d'annulation.

Modifier un diagramme existant

« Change la couleur de remplissage de tous les rectangles en bleu et mets le texte en gras. »

L'IA lit vos éléments avec get_elements, puis met à jour chacun avec update_element.

Disposition automatique

« Applique une disposition de haut en bas avec un espacement de 60 px entre les rangées. »

L'IA appelle apply_layout avec la direction et l'espacement souhaités.

Reproduire un style à partir d'une image

« Voici une capture d'écran du style de diagramme de notre marque. Recrée ces formes et couleurs comme un modèle personnalisé et un style que je peux réutiliser. »

Donnez à l'assistant une image de référence et il peut générer des formes et des pointes de flèche SVG correspondantes, les assembler en un modèle personnalisé et définir un style personnalisé correspondant. Il utilise des outils comme create_custom_template, add_custom_shape, add_custom_arrowhead, et create_style, de sorte que le résultat est un pack réutilisable — pas un dessin ponctuel.

Astuces

Partez d'une description — plus vous êtes précis, meilleur sera le résultat
Itérez — demandez à l'IA d'ajuster les couleurs, les étiquettes ou la disposition après la création initiale
Annulez librement — toutes les modifications de l'IA prennent en charge l'annulation avec Cmd+Z
Utilisez des symboles de notation — demandez à l'IA d'utiliser des packs de notation spécifiques pour un style cohérent
Le traitement par lot est préférable — pour de nouveaux diagrammes, l'IA crée tout en une seule étape afin que l'annulation revienne sur le tout