公共 MCP 連接

Notice: 適用於 Archicad Collaborate 或 Archicad Max。

此功能允許您將 Claude Desktop 或 Cursor 等桌面 AI 工具連接到 Archicad。通過將 AI 工具連接到 Archicad,您的 AI 工具能夠通過 MCP 服務器管理和編輯 Archicad 專案——類似於 AI Assistant在 Archicad 中原生運行的方式。

需求

  • 支持公共 MCP 連接的 Archicad 訂閱方案——例如 Archicad Collaborate 或 Archicad Max。
  • 支持連接到本地第三方 MCP 服務器的本地桌面 AI 工具——您的 AI 工具將能夠確認這一點。

建立連接的一般工作流程

要建立 Archicad 與 AI 工具之間的連接,您需要建立連接。您的 AI 工具將利用您從 Archicad 獲取並隨後提供給該 AI 工具的訊息來完成此操作。每個 AI 工具僅需執行一次此操作。

  1. 在您的 AI 工具中,您可以詢問:“你能告訴我如何連接本地 MCP 服務器嗎?我從該應用程序獲得了用於建立此連接的命令行和參數。”
  2. 在您的 AI 工具告知您連接方法後,切換到 Archicad 收集必要的訊息。
  3. 在 Archicad 中,開啟“桌面 AI 工具連接”對話框(“選項”選單):




  1. 複製此 Archicad 對話框中顯示的“命令行和參數”文字。
  2. 返回您的 AI 工具,並將此文字貼上到 AI 工具建議的位置(通常在聊天界面本身內)。
  3. 您的 AI 工具可能需要了解服務器類型。如果是這樣,請使用“stdio”。
  4. 您的 AI 工具將使用上述訊息建立連接。
  5. 可能需要重啟您的 AI 工具。
  6. 您可以通過詢問以下內容來驗證連接:“當前開啟了哪些 Archicad 專案?”如果您開啟了多個專案,您的 AI 工具將列出所有專案。
  7. 連接後,您就可以開始輸入相關的 Archicad MCP 提示。

要了解有關 Archicad MCP 工具和示例提示的更多訊息,請參閱:支持的 MCP 工具

示例配置

註: 以下示例在撰寫本文時是正確的,但相關 AI 工具可能會隨時發生變化。

Claude 桌面版

  1. 通過“檔案”>“設定”>“開發者”>“編輯配置”開啟配置檔案。它將指向您的 claude_desktop_config.json 檔案,應在文字編輯器中開啟該檔案。
  2. 使用通過點擊Desktop AI Tool Connection命令從 Archicad 獲取的command和args來擴展 mcpServers 部分。
  3. 儲存對配置檔案的更改並重啟 Claude 桌面應用。請注意,關閉 Claude 主視窗並不會退出該應用程序。要退出,請使用“檔案”>“退出”。
  4. 重啟 Claude 並使用以下提示測試 MCP 服務器連接:“Tell me running Archicad instances”。

配置檔案的位置因計算機而異;以下是一個示例:

Windows 示例

C:\Users\<your_user>\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 示例

/Users/<your_user>/Library/Application Support/Claude-3p/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"
      ]
    }
  }

游標

  1. 轉到自定義選單,選擇 MCPs 選項卡。
  2. 點擊“新建 MCP 服務器”。它將開啟 mcp.json 檔案,其中應在 Archicad“選項”選單中點擊“桌面 AI 工具連接”命令獲取 command 和 args,並用其擴展 servers 部分。
Windows 示例
{
  "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 示例
{
  "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 桌面版

  1. 在 ChatGPT 桌面應用中,轉到“設定”>“外掛程式”>“添加”>“添加 MCP 服務器”。
  2. 它將顯示“連接到自定義 MCP”,在此處指定:
    1. 名稱:Archicad Public MCP Server
    2. 類型:STDIO
    3. 啟動命令:node 的完整路徑,從 Archicad“桌面 AI 工具連接”對話框中複製
    4. 參數:mcp-node-app.js 的完整路徑,從 Archicad“桌面 AI 工具連接”對話框中複製
  3. 儲存並重啟 ChatGPT 桌面應用。
  4. 使用“Tell me running Archicad instances”提示測試 MCP 服務器連接。

VS Code

  1. 在 .vscode 檔案夾中建立一個包含以下內容的 mcp.json 檔案。
  2. command 和 args 的值從 Archicad“桌面 AI 工具連接”對話框中獲取。
  3. 啟動此 mcp 服務器。
  4. 使用“Tell me running Archicad instances”提示測試 MCP 服務器連接。
Windows 示例
{
  "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 示例
{
  "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"
      ]
    }
  }
}