Integrazione IA (Server MCP)

Diagrammix include un server MCP (Model Context Protocol) integrato che permette agli assistenti IA come Claude e Codex di leggere e modificare i tuoi diagrammi direttamente. Descrivi ciò di cui hai bisogno in linguaggio naturale, e l'IA posiziona simboli, connettori e layout sulla tela per te.

Cosa può fare l'IA?

• Creare diagrammi da una descrizione — chiedi un diagramma di flusso, una topologia di rete o un organigramma e ottienilo istantaneamente sulla tela
• Costruire mappe mentali — descrivi un argomento e ottieni una mappa mentale strutturata
• Leggere il tuo documento — l'IA vede le tue forme, connettori, livelli e stili attuali
• Modificare elementi esistenti — aggiorna testo, colori, posizioni o instradamento dei connettori
• Operazioni in batch — crea interi diagrammi con simboli e connettori in un solo passaggio
• Layout automatico e allineamento — organizza gli elementi con comandi in linguaggio naturale
• Replicare un aspetto da un'immagine — fornisci all'IA un'immagine di riferimento e costruirà un modello e uno stile personalizzati corrispondenti
• Esportare — produci output SVG, PNG, Visio (.vsdx) o Mermaid su richiesta

Requisiti

• Diagrammix PRO (acquisto una tantum)
• Diagrammix deve essere in esecuzione con il server MCP abilitato
• Se non è aperto nessun documento, l'assistente può crearne uno nuovo
• Il client IA e Diagrammix devono trovarsi sulla stessa macchina (localhost)

Non è necessario Node.js, npx, o mcp-remote — Diagrammix include un helper nativo per i client che lo richiedono.

Configurazione

1. Abilitare il server MCP

1. Apri Diagrammix
2. Vai su Diagrammix > Impostazioni (o premi Cmd+,)
3. Passa alla scheda Integrazione IA
4. Nella sezione Server MCP, attiva Abilita server MCP

Stato mostra In esecuzione una volta che il server è attivo. Il server è in ascolto su http://localhost:8420/mcp.

2. Configurare Claude Desktop

Claude Desktop si collega tramite stdio. Diagrammix include un helper stdio nativo all'interno del bundle dell'app, quindi non è richiesto Node.js, npx, o mcp-remote.

1. Fai clic su Copia configurazione nelle Impostazioni di Diagrammix — questo compila il percorso esatto dell'helper incluso per la tua installazione
2. Apri il file di configurazione di Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
3. Incolla la configurazione. Ha questo aspetto — il percorso command punta all'helper all'interno di dove è installato Diagrammix.app:

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

Nota: Usa Copia configurazione invece di digitare il percorso a mano — punta all'helper all'interno del bundle effettivo della tua app, che Diagrammix mantiene firmato e aggiornato.

4. Riavvia Claude Desktop. Gli strumenti Diagrammix appariranno nella chat.

3. Configurare Claude Code (CLI)

Claude Code supporta nativamente Streamable HTTP — non serve alcun bridge. Aggiungi un server MCP di tipo HTTP che punti a:

http://localhost:8420/mcp

Consulta la documentazione MCP di Claude Code per il comando o il file di configurazione da usare.

4. Configurare Codex

Codex (app, CLI ed estensione IDE condividono un'unica configurazione MCP) si collega tramite Streamable HTTP. Configuralo in uno dei due modi:

Opzione A — config.toml. Fai clic su Copia configurazione nella sezione Codex delle Impostazioni di Diagrammix e incolla in ~/.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

Opzione B — CLI. Fai clic su Copia comando nelle Impostazioni di Diagrammix, oppure esegui:

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

5. Altri client MCP

Qualsiasi client compatibile con MCP può connettersi usando:

• Trasporto: Streamable HTTP
• Endpoint: http://localhost:8420/mcp
• Protocollo: JSON-RPC 2.0 su HTTP POST

Nota: ChatGPT Desktop richiede HTTPS e non supporta direttamente le connessioni localhost.

Strumenti principali

Diagrammix espone un ampio set di strumenti MCP. Alcuni dei più utili:

Esempi d'uso

Creare un diagramma di flusso

"Crea un diagramma di flusso con Inizio, Decisione, Processo A, Processo B e Fine. Collega Inizio a Decisione, Decisione a Processo A (Sì) e Processo B (No), ed entrambi i processi a Fine."

L'IA userà batch_create per posizionare tutti i simboli e i connettori in un unico passaggio di annullamento.

Modificare un diagramma esistente

"Cambia il colore di riempimento di tutti i rettangoli in blu e rendi il testo in grassetto."

L'IA legge i tuoi elementi con get_elements, poi aggiorna ciascuno con update_element.

Layout automatico

"Applica un layout dall'alto verso il basso con una spaziatura di 60px tra le righe."

L'IA chiama apply_layout con la direzione e la spaziatura preferite.

Replicare un aspetto da un'immagine

"Ecco uno screenshot dello stile dei diagrammi del nostro brand. Ricrea queste forme e colori come modello e stile personalizzati che posso riutilizzare."

Fornisci all'assistente un'immagine di riferimento e potrà generare forme e punte di freccia SVG corrispondenti, assemblarle in un modello personalizzato, e definire uno stile personalizzato corrispondente. Usa strumenti come create_custom_template, add_custom_shape, add_custom_arrowhead e create_style, quindi il risultato è un pacchetto riutilizzabile — non un disegno usa e getta.

Suggerimenti

• Inizia con una descrizione — più sei specifico, migliore sarà il risultato
• Itera — chiedi all'IA di regolare colori, etichette o layout dopo la creazione iniziale
• Annulla liberamente — tutte le modifiche dell'IA supportano l'annullamento con Cmd+Z
• Usa i simboli di notazione — chiedi all'IA di usare pacchetti di notazione specifici per uno stile coerente
• Il batch è meglio — per i nuovi diagrammi, l'IA crea tutto in un solo passaggio così l'annullamento ripristina tutto