MCP Server

HINWEIS: Verfügbar mit Archicad Collaborate oder Archicad Max.

Mit diesem Add-On können Sie Ihr Desktop-KI-Werkzeug wie Claude Desktop oder Cursor mit Archicad verbinden. Durch die Verbindung Ihres AI-Tools mit Archicad können Sie Ihr Archicad-Projekt über den MCP Server mithilfe von AI verwalten und bearbeiten – ähnlich wie mit dem direkt in Archicad integrierten AI Assistant.

Anforderungen

  • Ein Archicad-Abonnement, das die Public MCP Connection unterstützt – z. B. Archicad Collaborate oder Archicad Max.
  • Ein lokales Desktop-KI-Werkzeug, das die Verbindung zu einem lokalen MCP-Server von Drittanbietern unterstützt – Ihr KI-Werkzeug kann Ihnen sagen, ob es das kann.

Allgemeiner Workflow zum Herstellen der Verbindung

Um Archicad mit Ihrem KI-Werkzeug zu verwenden, müssen Sie eine Verbindung anlegen. Ihr KI-Werkzeug führt dies anhand der Informationen durch, die Sie aus Archicad beziehen und dann in Ihrem KI-Werkzeug eintragen. Dies muss pro KI-Werkzeug einmal durchgeführt werden.

  1. In Ihrem KI-Werkzeug können Sie fragen: „Wie verbinde ich dich mit einem lokalen MCP Server? Ich habe eine Befehlszeile und ein Argument aus diesem Programm, um die Verbindung herzustellen.“
  2. Nachdem Ihr KI-Werkzeug Ihnen die Verbindungsmethode mitgeteilt hat, wechseln Sie zu Archicad, um die erforderlichen Informationen zu kopieren.
  3. Öffnen Sie in Archicad den Dialog „Desktop-KI-Werkzeug-Verbindung“ (Menü Optionen):




  1. Kopieren Sie den in diesem Archicad-Dialog angezeigten Text für „Befehlszeile und Argument“.
  2. Kehren Sie zu Ihrem KI-Werkzeug zurück und fügen Sie diesen Text an der von Ihrem KI-Werkzeug genannten Stelle ein.
  3. Möglicherweise muss Ihr KI-Werkzeug den Servertyp kennen. Verwenden Sie in diesem Fall „stdio“.
  4. Ihr KI-Werkzeug stellt die Verbindung anhand der obigen Informationen her.
  5. Unter Umständen ist ein Neustart Ihres KI-Werkzeugs erforderlich.
  6. Sie können die Verbindung überprüfen, indem Sie fragen: „Welche Archicad-Projekte sind derzeit geöffnet?“ Wenn Sie mehrere Projekte geöffnet haben, listet Ihr KI-Werkzeug alle auf.
  7. Sobald die Verbindung hergestellt ist, können Sie passende Archicad-MCP-Prompts eingeben.

Weitere Informationen zu Archicad-MCP-Werkzeugen und Beispiel-Prompts finden Sie unter: Unterstützte MCP-Werkzeuge

Beispielkonfigurationen

Anmerkung: Die folgenden Beispiele waren zum Zeitpunkt der Erstellung korrekt. Die entsprechenden AI-Tools können sich jedoch jederzeit ändern.

Claude Desktop

  1. Öffnen Sie die Konfigurationsdatei über Datei > Einstellungen > Entwickler > Konfiguration bearbeiten. Dadurch wird die Datei „claude_desktop_config.json“ in Ihrem Dateiverzeichnis angezeigt, die Sie in einem Texteditor öffnen.
  2. Fügen Sie im Abschnitt mcpServers command und args ein, die Sie in Archicad durch Klicken auf den Befehl „Desktop-KI-Werkzeug-Verbindung“ erhalten haben.
  3. Sichern Sie die Änderungen an der Konfigurationsdatei und starten Sie die Claude Desktop-App neu. Bitte beachten Sie, dass das Schließen des Hauptfensters von Claude allein die App nicht beendet. Wählen Sie zum Beenden Datei > Beenden.
  4. Starten Sie Claude neu und testen Sie die Verbindung zum MCP Server mit diesem Prompt: „Liste alle laufenden Archicad-Instanzen auf“.

Der Speicherort der Konfigurationsdatei ist plattformspezifisch:

Windows-Beispiel

C:\Users\<Benutzername>\AppData\Local\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json

 "mcpServers": {
    "Archicad Public MCP Server": {
      "command": "C:\\Program Files\\Graphisoft\\Archicad 30\\node.exe",
      "args": [
        "C:\\Users\\<your_user>\\AppData\\Local\\Graphisoft\\MCPServer\\Archicad 30 INT\\mcp-node-app.js"
      ]
    }
  }
macOS-Beispiel

/Users/<Benutzername>/Library/Application Support/Claude/claude_desktop_config.json

  "mcpServers": {
    "Archicad Public MCP Server": {
      "command": "/Applications/Graphisoft/Archicad 30/Archicad 30.app/Contents/Frameworks/node",
      "args": [
        "/Users/<your_user>/Library/Application Support/Graphisoft/MCPServer/Archicad 30 INT/mcp-node-app.js"
      ]
    }
  }

Cursor

  1. Öffnen Sie das Anpassen-Menü und wählen Sie den Reiter MCPs aus.
  2. Klicken Sie auf „Neuer MCP Server“. Dadurch wird die Datei mcp.json geöffnet, in der der Abschnitt servers um command und args erweitert werden sollte, die Sie aus Archicad über den Befehl „Desktop-KI-Werkzeug-Verbindung“ im Menü Optionen erhalten haben.
Windows-Beispiel
{
  "servers": {
    "Archicad Public MCP Server": {
      "type": "stdio",
      "command": "C:\\Program Files\\Graphisoft\\Archicad 30\\node.exe",
      "args": [
        "C:\\Users\\<your_user>\\AppData\\Local\\Graphisoft\\MCPServer\\Archicad 30 INT\\mcp-node-app.js"
      ]
    }
  }
}
macOS-Beispiel
{
  "servers": {
    "Archicad Public MCP Server": {
      "type": "stdio",
      "command": "/Applications/Graphisoft/Archicad 30/Archicad 30.app/Contents/Frameworks/node",
      "args": [
        "/Users/<your_user>/Library/Application Support/Graphisoft/MCPServer/Archicad 30 INT/mcp-node-app.js"
      ]
    }
  }
}

ChatGPT Desktop

  1. Gehen Sie in Ihrer ChatGPT Desktop-App auf Einstellungen > Plugins > Hinzufügen > MCP Server hinzufügen.
  2. Es wird „Benutzerdefinierten MCP-Server hinzufügen“ angezeigt; geben Sie hier Folgendes an:
    1. Name: Archicad Public MCP Server
    2. Typ: STDIO
    3. Befehl zum Starten: Vollständiger Pfad zu node, kopiert aus Ihrem Archicad-Dialog „Desktop-KI-Werkzeug-Verbindung“
    4. Argumente: Vollständiger Pfad zu mcp-node-app.js, kopiert aus Ihrem Archicad-Dialog „Desktop-KI-Werkzeug-Verbindung“
  3. Sichern Sie und starten die ChatGPT Desktop-App neu.
  4. Testen Sie die Verbindung zum MCP Server mit dem Prompt „Liste laufende Archicad-Instanzen auf“.

VS Code

  1. Erstellen Sie eine Datei mcp.json in Ihrem Ordner .vscode mit folgendem Inhalt.
  2. Der Wert für command und args wird aus Ihrem Archicad-Dialog „Desktop-KI-Werkzeug-Verbindung“ übernommen.
  3. Starten Sie diesen MCP Server.
  4. Testen Sie die Verbindung zum MCP Server mit dem Prompt „Liste laufende Archicad-Instanzen auf“.
Windows-Beispiel
{
  "servers": {
    "Archicad Public MCP Server": {
      "type": "stdio",
      "command": "C:\\Program Files\\Graphisoft\\Archicad 30\\node.exe",
      "args": [
        "C:\\Users\\<your_user>\\AppData\\Local\\Graphisoft\\MCPServer\\Archicad 30 INT\\mcp-node-app.js"
      ]
    }
  }
}
macOS-Beispiel
{
  "servers": {
    "Archicad Public MCP Server": {
      "type": "stdio",
      "command": "/Applications/Graphisoft/Archicad 30/Archicad 30.app/Contents/Frameworks/node",
      "args": [
        "/Users/<your_user>/Library/Application Support/Graphisoft/MCPServer/Archicad 30 INT/mcp-node-app.js"
      ]
    }
  }
}