在 Claude 中安裝 BIMTeki MCP

安裝前請先確認

步驟一：安裝 BIMTeki MCP（連接器）

連接器不需要單獨下載，它就包在 BIMTeki Studio 的安裝檔裡。

幾件值得知道的事：

步驟二：把連接器加進 Claude

連接器裝好了，還要讓 Claude 知道它在哪裡。這一步只需做一次，之後更新 BIMTeki 不必重做。Claude 桌機版與 Claude Code 各有自己的設定，你用哪一個就加哪一個；兩個都用就兩邊都加。路徑以「AI連接器設定說明.txt」裡的為準，下面寫的是預設安裝位置。

{
  "mcpServers": {
    "bimteki": {
      "command": "C:\\Program Files\\BIMTeki Studio\\mcp\\python\\python.exe",
      "args": ["C:\\Program Files\\BIMTeki Studio\\mcp\\server\\main.py"],
      "env": { "PYTHONUTF8": "1", "PYTHONDONTWRITEBYTECODE": "1" }
    }
  }
}

打開 PowerShell，貼上執行這一行，之後重新啟動 Claude Code 即可：

claude mcp add bimteki -s user -e PYTHONUTF8=1 -e PYTHONDONTWRITEBYTECODE=1 -- "C:\Program Files\BIMTeki Studio\mcp\python\python.exe" "C:\Program Files\BIMTeki Studio\mcp\server\main.py"

步驟三：安裝 BIMTeki 技能包

有三種安裝方式，選你平常用的那一個介面做就好，不必三種都做。推薦方式 A：在 Claude 桌機版裝一次，Code 分頁與 Claude Code 終端機都會自動同步拿到。

https://github.com/BIMTeki/bimteki-plugin

裝完之後，在對話框輸入 / 或按 ＋，就會看到所有 BIMTeki 技能。

這裡裝的技能包是綁在你的 claude.ai 帳號上，Claude Code（桌機版的 Code 分頁與終端機）啟動時會自動同步下來，不必再裝第二次。同步在背景進行，若看到「Plugins changed. Run /reload-plugins to activate.」，輸入 /reload-plugins 就會生效。

在任何一個資料夾下啟動 claude，然後依序輸入這兩行指令：

/plugin marketplace add BIMTeki/bimteki-plugin
/plugin install bimteki@bimteki

安裝範圍請選 User scope，這樣所有專案都能用。若摘要顯示 Run /reload-plugins to activate.，就再輸入一次 /reload-plugins。

步驟四：確認裝好了

先讓 Archicad 開著、而且已開啟一個 BIMTeki 專案，否則連接器再正常也沒有東西可以回報。

在 Claude 桌機版（或 Claude Code）開一個新對話，直接問：

⚠️ 要在對的地方用

這是最常見的踩雷點。Claude 有好幾種使用方式，BIMTeki 只有在能啟動本機連接器的那幾種才能實際操作 Archicad：

Claude 網頁版與手機版一樣叫得出技能，但它們碰不到你的電腦、連不上 Archicad，最後會回你「找不到 BIMTeki 工具」。這不是安裝失敗，只是用錯地方了。

步驟五：更新技能包

技能會隨著法規與 BIMTeki 功能持續調整。更新的地方依你當初用哪一種方式安裝而定：

/plugin marketplace update bimteki

所以兩邊的版本號不一樣是常態，不用擔心。但如果 AI 跟你說「你的 MCP 版本太舊」，或做出來的表格少了合併儲存格、少了框線，那就是技能包更新了、連接器沒跟上——請重跑一次最新版安裝檔，裝完把 Claude 完全關掉再重開。

疑難排解

只要是「AI 看不到 BIMTeki 工具」這一類問題，先跑這一支。它隨 BIMTeki Studio 一起安裝，只讀不寫，不會改動你電腦上的任何東西。

打開 PowerShell，貼上執行：

powershell -NoProfile -ExecutionPolicy Bypass -File "$env:ProgramW6432\BIMTeki Studio\verify-mcp-install.ps1"

它會依序檢查安裝紀錄、檔案是否齊全，然後真的把連接器啟動起來跑一次連線測試，最後告訴你卡在哪一關。

看到紅色 [失敗]，對照下表處理：

powershell -NoProfile -ExecutionPolicy Bypass -File "$env:ProgramW6432\BIMTeki Studio\claude-connector.ps1" -McpPath "$env:ProgramW6432\BIMTeki Studio\mcp"

若以上都無法解決，請來信 office@arkiteki.com，並附上：

裝好之後可以做什麼

不需要記任何指令名稱，直接用中文交代就好：

如果你已經很清楚要用哪一項功能，也可以直接指定技能：在對話框輸入 / 就會列出清單，技能名稱以 /bimteki: 開頭，例如：

/bimteki:table

不帶任何關鍵字，AI 會列出這個案子目前可以做的所有檢討表讓你挑。全部技能的用途見〈05 SKILL 一覽〉；想看實際操作影片，見〈06 使用案例〉。