Integracja z AI (serwer MCP)

Diagrammix zawiera wbudowany serwer MCP (Model Context Protocol), który pozwala asystentom AI takim jak Claude i Codex bezpośrednio odczytywać i modyfikować Twoje diagramy. Opisz czego potrzebujesz w prostym języku, a AI umieści symbole, łączniki i układy na obszarze roboczym za Ciebie.

Co potrafi AI?

Tworzenie diagramów z opisu — poproś o schemat blokowy, topologię sieci lub schemat organizacyjny i natychmiast otrzymaj go na obszarze roboczym
Odczyt dokumentu — AI widzi Twoje bieżące kształty, łączniki, warstwy i style
Modyfikacja istniejących elementów — aktualizuj tekst, kolory, pozycje lub trasowanie łączników
Operacje wsadowe — twórz całe diagramy z symbolami i łącznikami w jednym kroku
Automatyczny układ i wyrównanie — organizuj elementy za pomocą poleceń w języku naturalnym
Eksport — generuj wyjście SVG na żądanie

Wymagania

Diagrammix PRO (jednorazowy zakup)
Diagrammix musi być uruchomiony z włączonym serwerem MCP
Co najmniej jeden dokument diagramu musi być otwarty
Klient AI i Diagrammix muszą być na tej samej maszynie (localhost)
Node.js 18+ wymagany dla Claude Desktop (dla mostka mcp-remote)

Konfiguracja

1. Włącz serwer MCP

Otwórz Diagrammix
Przejdź do Diagrammix > Settings (lub naciśnij Cmd+,)
Przejdź do karty AI Integration
Włącz Enable AI Integration (MCP Server)

Serwer uruchamia się na http://localhost:8420/mcp.

2. Skonfiguruj Claude Desktop

Claude Desktop używa transportu stdio, więc wymaga mostka mcp-remote (Node.js 18+).

Kliknij Copy Config w ustawieniach Diagrammix, aby skopiować konfigurację do schowka
Otwórz plik konfiguracyjny Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
Wklej konfigurację lub dodaj ręcznie:

{
  "mcpServers": {
    "diagrammix": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:8420/mcp"]
    }
  }
}

Uwaga: Jeśli używasz nvm, przycisk Copy Config wykrywa Twoją instalację Node.js i generuje konfigurację z pełną ścieżką do npx i prawidłową zmienną środowiskową PATH.

Uruchom ponownie Claude Desktop. Narzędzia Diagrammix pojawią się w czacie.

3. Skonfiguruj Claude Code (CLI)

Dodaj do pliku .mcp.json projektu lub globalnie w ~/.claude/mcp.json:

{
  "mcpServers": {
    "diagrammix": {
      "type": "url",
      "url": "http://localhost:8420/mcp"
    }
  }
}

Claude Code obsługuje natywnie Streamable HTTP — mostek nie jest potrzebny.

4. Skonfiguruj Codex

Otwórz ustawienia Codex > MCP servers
Kliknij Connect to a custom MCP
Ustaw Name na Diagrammix
Wybierz kartę Streamable HTTP
Wprowadź URL: http://localhost:8420/mcp
Kliknij Save

5. Inni klienci MCP

Dowolny klient kompatybilny z MCP może się połączyć używając:

Transport: Streamable HTTP
Endpoint: http://localhost:8420/mcp
Protokół: JSON-RPC 2.0 przez HTTP POST

Uwaga: ChatGPT Desktop wymaga HTTPS i nie obsługuje bezpośrednio połączeń localhost.

Przykłady użycia

Utwórz schemat blokowy

„Utwórz schemat blokowy z elementami Start, Decyzja, Proces A, Proces B i Koniec. Połącz Start z Decyzją, Decyzję z Procesem A (Tak) i Procesem B (Nie), oraz oba procesy z Końcem."

AI użyje batch_create do umieszczenia wszystkich symboli i łączników w jednym kroku cofania.

Modyfikuj istniejący diagram

„Zmień kolor wypełnienia wszystkich prostokątów na niebieski i pogrub tekst."

AI odczyta Twoje elementy za pomocą get_elements, a następnie zaktualizuje każdy z nich za pomocą update_element.

Automatyczny układ

„Zastosuj układ od góry do dołu z odstępem 60px między wierszami."

AI wywoła apply_layout z preferowanym kierunkiem i odstępami.

Wskazówki

Zacznij od opisu — im bardziej szczegółowy jesteś, tym lepszy wynik
Iteruj — poproś AI o dostosowanie kolorów, etykiet lub układu po początkowym utworzeniu
Cofaj swobodnie — wszystkie zmiany AI obsługują cofanie za pomocą Cmd+Z
Używaj symboli notacji — poproś AI o użycie konkretnych pakietów notacji dla spójnego stylu
Tryb wsadowy jest lepszy — dla nowych diagramów AI tworzy wszystko w jednym kroku, więc cofanie przywraca całość