公共 MCP 連接
此功能允許您將 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 工具僅需執行一次此操作。
- 在您的 AI 工具中,您可以詢問:“你能告訴我如何連接本地 MCP 服務器嗎?我從該應用程序獲得了用於建立此連接的命令行和參數。”
- 在您的 AI 工具告知您連接方法後,切換到 Archicad 收集必要的訊息。
- 在 Archicad 中,開啟“桌面 AI 工具連接”對話框(“選項”選單):


- 複製此 Archicad 對話框中顯示的“命令行和參數”文字。
- 返回您的 AI 工具,並將此文字貼上到 AI 工具建議的位置(通常在聊天界面本身內)。
- 您的 AI 工具可能需要了解服務器類型。如果是這樣,請使用“stdio”。
- 您的 AI 工具將使用上述訊息建立連接。
- 可能需要重啟您的 AI 工具。
- 您可以通過詢問以下內容來驗證連接:“當前開啟了哪些 Archicad 專案?”如果您開啟了多個專案,您的 AI 工具將列出所有專案。
- 連接後,您就可以開始輸入相關的 Archicad MCP 提示。
要了解有關 Archicad MCP 工具和示例提示的更多訊息,請參閱:支持的 MCP 工具
示例配置
註: 以下示例在撰寫本文時是正確的,但相關 AI 工具可能會隨時發生變化。
Claude 桌面版
- 通過“檔案”>“設定”>“開發者”>“編輯配置”開啟配置檔案。它將指向您的 claude_desktop_config.json 檔案,應在文字編輯器中開啟該檔案。
- 使用通過點擊Desktop AI Tool Connection命令從 Archicad 獲取的command和args來擴展 mcpServers 部分。
- 儲存對配置檔案的更改並重啟 Claude 桌面應用。請注意,關閉 Claude 主視窗並不會退出該應用程序。要退出,請使用“檔案”>“退出”。
- 重啟 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"
]
}
}游標
- 轉到自定義選單,選擇 MCPs 選項卡。
- 點擊“新建 MCP 服務器”。它將開啟 mcp.json 檔案,其中應在 Archicad“選項”選單中點擊“桌面 AI 工具連接”命令獲取 command 和 args,並用其擴展 servers 部分。
{
"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 桌面版
VS Code
- 在 .vscode 檔案夾中建立一個包含以下內容的 mcp.json 檔案。
- command 和 args 的值從 Archicad“桌面 AI 工具連接”對話框中獲取。
- 啟動此 mcp 服務器。
- 使用“Tell me running Archicad instances”提示測試 MCP 服務器連接。
{
"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"
]
}
}
}