在 Claude 中安裝 BIMTeki MCP
本篇說明如何讓 Claude 能直接操作 Archicad 裡的 BIMTeki 專案。整個過程分三步：裝連接器、裝技能包、確認連得上。用 ChatGPT／Codex 的人請改看〈03 在 Codex 中安裝 BIMTeki MCP〉。
還不清楚連接器與技能包是什麼、各自負責什麼，請先看〈01 甚麼是 BIMTeki MCP〉。
安裝前請先確認
步驟一：安裝 BIMTeki MCP（連接器）
連接器不需要單獨下載，它就包在 BIMTeki Studio 的安裝檔裡。
幾件值得知道的事：
步驟二：安裝 BIMTeki 技能包
有三種安裝方式，選你平常用的那一個介面做就好，不必三種都做。推薦方式 A：在 Cowork 裝一次，桌機版的 Code 分頁與 Claude Code 終端機都會自動同步拿到。
https://github.com/BIMTeki/bimteki-plugin
裝完之後，在對話框輸入 / 或按 ＋，就會看到所有 BIMTeki 技能。在 Plugins 的 Manage 頁面也能看到這個技能包包含的所有 Skills 與 Connectors。
這裡裝的技能包是綁在你的 claude.ai 帳號上。Claude Code（桌機版的 Code 分頁與終端機）啟動時會自動把它同步下來，不必再裝第二次；在 /plugin 的 Installed 清單裡，它的來源會顯示為 synced。同步在背景進行，若看到「Plugins changed. Run /reload-plugins to activate.」，輸入 /reload-plugins 就會生效。
Code 分頁不用打指令，用點的：
在任何一個資料夾下啟動 claude，然後依序輸入這兩行指令：
/plugin marketplace add BIMTeki/bimteki-plugin /plugin install bimteki@bimteki
安裝過程會問你安裝範圍，請選 User scope，這樣所有專案都能用，不必每個資料夾各裝一次。
若安裝完的摘要顯示 Run /reload-plugins to activate.，就再輸入一次：
/reload-plugins
技能包裡已經內建了連接器的設定，會自動找到步驟一裝好的 BIMTeki MCP。你不需要去設定什麼伺服器位址、不需要執行任何「加入 MCP」的指令，也不需要安裝任何額外的擴充功能。
步驟三：確認裝好了
先讓 Archicad 開著、而且已開啟一個 BIMTeki 專案，否則連接器再正常也沒有東西可以回報。
在 Claude 桌機版的 Cowork 分頁（或 Claude Code）開一個新對話，直接問：
⚠️ 要在對的分頁用
這是最常見的踩雷點。Claude 桌機版有好幾個分頁，BIMTeki 只有在能啟動本機連接器的那幾個才能實際操作 Archicad：
| 在哪裡 | 看得到技能 | 能操作 Archicad |
|---|---|---|
| Claude 桌機版 Cowork 分頁 | ✅ | ✅ |
| Claude 桌機版 Code 分頁／Claude Code | ✅ | ✅ |
| Claude 桌機版 Chat 分頁 | ✅ | ❌ |
在 Chat 分頁一樣叫得出技能、看起來煞有介事，但它連不上 Archicad，最後會回你「找不到 BIMTeki 工具」。這不是安裝失敗，只是分頁用錯了。
步驟四：更新技能包
技能會隨著法規與 BIMTeki 功能持續調整。更新的地方依你當初用哪一種方式安裝而定：
方式 A（Cowork）裝的：在 Cowork 的 Customize → Plugins 中對 BIMTeki 技能包按更新。Code 分頁與終端機會在下次啟動時自動同步到新版。
方式 B（Code 分頁）裝的：＋ → Plugins → Manage plugins，對 BIMTeki 技能包按更新。
方式 C（終端機）裝的：預設不會自動更新，建議手動把自動更新打開：
也可以隨時手動更新：
/plugin marketplace update bimteki
這一點請特別記住，它是很多困惑的根源：
| 更新方式 | |
|---|---|
| 技能包 | 在 Claude 裡一鍵更新（Claude Code 的 /plugin，或桌機版的 Plugins 頁面） |
| BIMTeki MCP 連接器 | 要重新執行最新版 BIMTeki Studio 安裝檔 |
所以兩邊的版本號不一樣是常態，不用擔心。但如果 AI 跟你說「你的 MCP 版本太舊」，或做出來的表格少了合併儲存格、少了框線，那就是技能包更新了、連接器沒跟上——請重跑一次最新版安裝檔，裝完把 Claude 完全關掉再重開。
疑難排解
只要是「AI 看不到 BIMTeki 工具」這一類問題，先跑這一支。它隨 BIMTeki Studio 一起安裝，只讀不寫，不會改動你電腦上的任何東西。
打開 PowerShell，貼上執行：
powershell -NoProfile -ExecutionPolicy Bypass -File "$env:ProgramW6432\BIMTeki Studio\verify-mcp-install.ps1"
它會依序檢查安裝紀錄、檔案是否齊全，然後真的把連接器啟動起來跑一次連線測試，最後告訴你卡在哪一關。
看到紅色 [失敗]，對照下表處理：
| 失敗的項目 | 意思與處理方式 |
|---|---|
| 登錄檔：找不到 | 安裝時沒勾「AI 助理連接器 (BIMTeki MCP)」（舊版叫「Claude AI 連接器」），或安裝檔是加入連接器之前的舊版。請重跑最新版安裝檔 |
| 內嵌 Python／MCP 進入點 不存在 | 檔案不齊，重跑安裝檔 |
| 預編譯檔太少 | 不影響功能，但連接器啟動會變慢。重跑安裝檔可修正 |
| initialize 沒有回應 | 多半是防毒或公司資安軟體把連接器擋掉了。請 IT 把 BIMTeki Studio 安裝資料夾底下 mcp\python\python.exe 加入白名單 |
| stdout 被汙染 | 請把完整輸出寄給我們 |
| 症狀 | 處理方式 |
|---|---|
| 桌機版：Claude 說「找不到 BIMTeki 工具」 | 十之八九是用到 Chat 分頁了。切到 Cowork 分頁再試一次 |
| 桌機版：技能包裝了卻不是最新版、Update 按鈕是灰的 | Claude 手上的清單是舊快取。重開 Claude 桌機版，或把 marketplace 移除後重新加入 |
| 技能沒出現在清單裡 | 執行 /reload-plugins；仍無效就重開 Claude |
| 在 Cowork 裝好了，但 Code 分頁或終端機看不到 | 同步在背景進行，稍等片刻後執行 /reload-plugins；仍無效請確認桌機版與終端機登入的是同一個 claude.ai 帳號 |
| 找不到 /plugin 指令 | Claude Code 版本太舊，請更新到最新版 |
| 檢查腳本全過，但 Claude 仍看不到工具 | 先確認是 Cowork 分頁；再確認技能包為啟用狀態（/plugin → Installed），必要時 /reload-plugins |
| /plugin 的 Errors 分頁顯示連接器啟動失敗 | 跑上面的檢查腳本，依結果處理 |
| Claude 說「無法連線到 Archicad」 | 連接器正常，但 Archicad 那頭沒準備好。確認 Archicad 開著、專案已開啟、BIMTeki 外掛已載入 |
| 表格產生了但數值是空白 | 這不是安裝問題。自動文字要放置到圖紙（Layout）上才會計算出實際值 |
| Claude 說「你的 MCP 版本太舊」，或表格少了合併儲存格／框線 | 技能包更新了、連接器沒有。重跑最新版 BIMTeki Studio 安裝檔，裝完完全關掉再重開 Claude |
| Claude 說「席位已被其他電腦取用」 | 這是浮動許可的正常機制：席位在另一台開著 Archicad 的電腦上。關閉那台電腦的 Archicad，這台幾分鐘內會自動取回席位；詳見〈授權〉系列的「浮動許可」一文 |
| Claude 說「離線寬限已逾期」 | 這台電腦斷網超過寬限時間。確認網路恢復後再試一次即可，不必重開 Archicad |
| 其他授權相關錯誤 | 請聯繫 BIMTeki |
若以上都無法解決，請來信 office@arkiteki.com，並附上：
裝好之後可以做什麼
不需要記任何指令名稱，直接用中文交代就好：
「做地下層容積檢討表」
「這個建照有哪些檢討表可以做？」
「把這份土管做成檢討表」（並把土管 PDF 拖進對話）
「幫我畫容積區域」
如果你已經很清楚要用哪一項功能，也可以直接指定技能：在對話框輸入 / 就會列出清單，技能名稱以 /bimteki: 開頭，例如：
/bimteki:table
不帶任何關鍵字，AI 會列出這個案子目前可以做的所有檢討表讓你挑。全部技能的用途見〈05 SKILL 一覽〉；想看實際操作影片，見〈06 使用案例〉。