Integração com IA (Servidor MCP)

O Diagrammix inclui um servidor MCP (Model Context Protocol) integrado que permite que assistentes de IA como Claude e Codex leiam e modifiquem seus diagramas diretamente. Descreva o que você precisa em linguagem natural, e a IA posiciona símbolos, conectores e layouts na tela para você.

O que a IA Pode Fazer?

• Criar diagramas a partir de uma descrição — peça um fluxograma, uma topologia de rede ou um organograma e obtenha-o instantaneamente na tela
• Construir mapas mentais — descreva um tema e obtenha um mapa mental estruturado
• Ler seu documento — a IA vê suas formas, conectores, camadas e estilos atuais
• Modificar elementos existentes — atualize texto, cores, posições ou roteamento de conectores
• Operações em lote — crie diagramas inteiros com símbolos e conectores em uma única etapa
• Layout automático e alinhamento — organize elementos com comandos em linguagem natural
• Replicar uma aparência a partir de uma imagem — entregue à IA uma imagem de referência e ela constrói um modelo e estilo personalizados correspondentes
• Exportar — produza saída em SVG, PNG, Visio (.vsdx) ou Mermaid sob demanda

Requisitos

• Diagrammix PRO (compra única)
• O Diagrammix precisa estar em execução com o servidor MCP ativado
• Se nenhum documento estiver aberto, o assistente pode criar um novo
• O cliente de IA e o Diagrammix precisam estar na mesma máquina (localhost)

Não é necessário Node.js, npx ou mcp-remote — o Diagrammix já inclui um auxiliar nativo para os clientes que exigem isso.

Configuração

1. Ativar o Servidor MCP

1. Abra o Diagrammix
2. Vá para Diagrammix > Configurações (ou pressione Cmd+,)
3. Mude para a aba Integração de IA
4. Na seção Servidor MCP, ative Habilitar servidor MCP

Status mostra Em execução assim que o servidor estiver ativo. O servidor escuta em http://localhost:8420/mcp.

2. Configurar o Claude Desktop

O Claude Desktop se conecta via stdio. O Diagrammix inclui um auxiliar nativo de stdio dentro do pacote do aplicativo, então nenhum Node.js, npx ou mcp-remote é necessário.

1. Clique em Copiar configuração nas Configurações do Diagrammix — isso preenche o caminho exato para o auxiliar incluído na sua instalação
2. Abra o arquivo de configuração do Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
3. Cole a configuração. Ela se parece com isto — o caminho command aponta para o auxiliar dentro de onde quer que o Diagrammix.app esteja instalado:

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

Nota: Use Copiar configuração em vez de digitar o caminho manualmente — ele aponta para o auxiliar dentro do pacote real do seu aplicativo, que o Diagrammix mantém assinado e atualizado.

4. Reinicie o Claude Desktop. As ferramentas do Diagrammix aparecerão no chat.

3. Configurar o Claude Code (CLI)

O Claude Code suporta HTTP Streamable nativamente — sem necessidade de ponte. Adicione um servidor MCP do tipo HTTP apontando para:

http://localhost:8420/mcp

Veja a documentação de MCP do Claude Code para o comando ou arquivo de configuração a usar.

4. Configurar o Codex

O Codex (app, CLI e extensão de IDE compartilham uma configuração MCP) se conecta via HTTP Streamable. Configure-o de uma das duas formas:

Opção A — config.toml. Clique em Copiar configuração na seção Codex das Configurações do Diagrammix e cole em ~/.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

Opção B — CLI. Clique em Copiar comando nas Configurações do Diagrammix, ou execute:

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

5. Outros Clientes MCP

Qualquer cliente compatível com MCP pode se conectar usando:

• Transporte: HTTP Streamable
• Endpoint: http://localhost:8420/mcp
• Protocolo: JSON-RPC 2.0 sobre HTTP POST

Nota: O ChatGPT Desktop exige HTTPS e não suporta conexões diretas via localhost.

Ferramentas Notáveis

O Diagrammix expõe um grande conjunto de ferramentas MCP. Algumas das mais úteis:

Exemplos de Uso

Criar um Fluxograma

"Crie um fluxograma com Início, Decisão, Processo A, Processo B e Fim. Conecte Início a Decisão, Decisão a Processo A (Sim) e Processo B (Não), e ambos os processos a Fim."

A IA usará batch_create para posicionar todos os símbolos e conectores em uma única etapa de desfazer.

Modificar um Diagrama Existente

"Mude a cor de preenchimento de todos os retângulos para azul e deixe o texto em negrito."

A IA lê seus elementos com get_elements e depois atualiza cada um com update_element.

Layout Automático

"Aplique um layout de cima para baixo com espaçamento de 60px entre as linhas."

A IA chama apply_layout com a direção e o espaçamento que você preferir.

Replicar uma Aparência a Partir de uma Imagem

"Aqui está uma captura de tela do estilo de diagrama da nossa marca. Recrie essas formas e cores como um modelo e estilo personalizados que eu possa reutilizar."

Entregue ao assistente uma imagem de referência e ele pode gerar formas e pontas de seta SVG correspondentes, montá-las em um modelo personalizado e definir um estilo personalizado correspondente. Ele usa ferramentas como create_custom_template, add_custom_shape, add_custom_arrowhead e create_style, então o resultado é um pacote reutilizável — não um desenho pontual.

Dicas

• Comece com uma descrição — quanto mais específico você for, melhor será o resultado
• Itere — peça à IA para ajustar cores, rótulos ou layout após a criação inicial
• Desfaça livremente — todas as alterações da IA suportam desfazer com Cmd+Z
• Use símbolos de notação — peça à IA para usar pacotes de notação específicos para uma estilização consistente
• Lote é melhor — para novos diagramas, a IA cria tudo em uma única etapa, então desfazer reverte tudo de uma vez