｜教學文件｜ BIMTeki MCP

本頁內容

在 ChatGPT 中安裝 BIMTeki MCP

更新於 115 年 10 月 19 日

安裝 BIMTeki MCP（7:10）

影片從安裝檔勾選連接器開始示範，4:41 起是 ChatGPT 桌面版的設定、1:37 起是 Claude 桌面版。

本篇說明如何讓 ChatGPT 桌面版（ChatGPT 模式的「工作」頁籤，或 Codex 模式，Codex CLI 也行）能直接操作 Archicad 裡的 BIMTeki 專案。整個過程分四步：裝連接器、把連接器加進 ChatGPT、裝技能包、確認連得上。用 Claude 的人請改看〈02 在 Claude 中安裝 BIMTeki MCP〉。

還不清楚連接器與技能包是什麼、各自負責什麼，請先看〈01 甚麼是 BIMTeki MCP〉。

小提醒：本篇的操作路徑（選單名稱、按鈕位置、指令寫法）是依撰寫當時的 ChatGPT 桌面版與 Codex 版本整理的。之後若介面或用法有變動，請以 ChatGPT 實際的功能為主。

安裝前請先確認

已安裝 ChatGPT 桌面版（Windows 版從 Microsoft Store 安裝）。它左上角可以切換「ChatGPT」與「Codex」兩種模式，BIMTeki 在兩種模式下都能用，但 ChatGPT 模式要切到上方的「工作」頁籤，一般「對話」不行；網頁版也不行。

已執行最新版 BIMTeki Studio 安裝檔，且授權正常。

目前僅支援 Windows。

使用時 Archicad 要開著、而且已經開啟要檢討的那個專案。

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

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

執行最新版的 BIMTeki Studio 安裝檔。

走到「選擇要安裝的元件」那一步時，確認 「AI 助理連接器 (BIMTeki MCP)」 這一項是打勾的（預設就會勾）。

安裝位置請保持預設，不要改。

一路下一步完成安裝。安裝完成畫面預設勾選「開啟 AI 助理連接器設定說明」，按完成後記事本會打開說明檔，裡面的路徑已依你的安裝位置填好。步驟二會用到它。

幾件值得知道的事：

連接器連執行環境都自帶，你不需要另外安裝 Python 或任何開發工具。

安裝檔不會自動改 Codex 的設定，Codex 那一端要你自己加（步驟二）。

說明檔之後隨時可以在 C:\Program Files\BIMTeki Studio 底下找到，檔名「AI連接器設定說明.txt」。

安裝過程若提示要關閉程式，請先把 ChatGPT 桌面版完全結束再繼續。它關掉視窗後會縮到右下角系統匣，請在系統匣圖示上按右鍵結束。

步驟二：把連接器加進 Codex

連接器裝好了，還要讓 Codex 知道它在哪裡。這一步只需做一次，之後更新 BIMTeki 不必重做。兩種做法選一種；路徑以「AI連接器設定說明.txt」裡的為準，下面寫的是預設安裝位置。

做法一：在 ChatGPT 的設定頁面用點的（推薦）

ChatGPT 桌面版 → 設定 → 左側「整合」底下的 外掛程式 → 切到 MCP 頁籤 → 右上角新增。

填入三個欄位：
• 啟動指令：C:\Program Files\BIMTeki Studio\mcp\python\python.exe
• 引數：C:\Program Files\BIMTeki Studio\mcp\server\main.py
• 環境變數：新增兩筆，PYTHONUTF8 填 1、PYTHONDONTWRITEBYTECODE 填 1
• 若有「類型」選項，選 標準輸入／輸出

按儲存，然後把 ChatGPT 桌面版完全關閉再重開：在系統匣圖示上按右鍵結束，只關視窗不算。

$ChatGPT 桌面版的設定視窗，左側選單停在「整合 → 外掛程式」，右側頁面標題為「外掛程式：管理外掛程式、技能與 MCP」，頁籤切在「MCP」。表單標題為「更新 Bimteki MCP」，啟動指令欄填 C:\Program Files\BIMTeki Studio\mcp\python\python.exe，引數欄填 C:\Program Files\BIMTeki Studio\mcp\server\main.py，環境變數有 PYTHONUTF8＝1 與 PYTHONDONTWRITEBYTECODE＝1 兩列，下方還有環境變數透傳與工作目錄欄位，右下角為「儲存」按鈕$

做法二：自己手動改設定檔

用記事本開啟使用者資料夾底下的 .codex\config.toml（通常是 C:\Users\<你的帳號>\.codex\config.toml；沒有這個檔就自己新建一個）。

在檔案最後面加上下面這幾行：

[mcp_servers.bimteki]
command = 'C:\Program Files\BIMTeki Studio\mcp\python\python.exe'
args = ['C:\Program Files\BIMTeki Studio\mcp\server\main.py']
startup_timeout_sec = 30

[mcp_servers.bimteki.env]
PYTHONUTF8 = "1"
PYTHONDONTWRITEBYTECODE = "1"

存檔，把 ChatGPT 桌面版完全關閉再重開。

怎麼確認加好了

ChatGPT 桌面版：設定 → 外掛程式 → MCP 頁籤，清單裡會有 bimteki。

Codex 模式或 Codex CLI：在對話框輸入 /mcp，清單裡會有 bimteki。

步驟三：安裝 BIMTeki 技能包

要做兩件事：把 BIMTeki 的技能包「市集」加進 Codex，再從市集安裝技能包。加市集有兩種方式，選一種做即可；桌面版與 Codex CLI 共用同一套設定，在任一邊加好，另一邊就有了。

方式 A：在桌面版用點的（推薦）

切到 Codex 模式 → 左側 外掛程式。

點搜尋框旁的 頁面操作 選單 → 新增市集。

在來源欄填入：

BIMTeki/bimteki-plugin

其他欄位維持預設，按 新增市集。看到「bimteki 市集已新增」就完成了。

回到外掛程式清單，找到「BIMTeki 建照檢討」（通常在個人分頁，或直接用搜尋框找），按＋安裝。

完全關閉 ChatGPT 桌面版再重開（系統匣圖示按右鍵結束）。

在 Codex 中安裝 BIMTeki Plugin（0:47）

方式 B：用終端機指令

打開 PowerShell，輸入這一行（ChatGPT 桌面版裝好後就有 codex 這個指令）：

codex plugin marketplace add BIMTeki/bimteki-plugin

回到 ChatGPT 桌面版，切到 Codex 模式 → 左側 外掛程式，找到「BIMTeki 建照檢討」，按＋安裝。（用 Codex CLI 的人，在對話裡輸入 /plugins 也能安裝。）

完全關閉 ChatGPT 桌面版再重開。

步驟四：確認裝好了

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

在 ChatGPT 桌面版開一個新對話。ChatGPT 模式要把上方的「對話／工作」切到工作；Codex 模式會要你選一個資料夾，任選即可，建議建一個空的專用資料夾，例如「文件\BIMTeki工作」，BIMTeki 不會讀那個資料夾的內容。

直接問：

這樣問 Claude

「BIMTeki 連上了嗎？」或「這個建照有哪些檢討表可以做？」

AI 若能回報你目前 Archicad 中開啟的專案狀況（案型、樓層、基地資料等），代表兩邊都通了。

AI 若說「找不到 BIMTeki 工具」或「無法連線到 Archicad」，請看最後的〈疑難排解〉。

⚠️ 要在對的模式用

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

在哪裡	看得到技能	能操作 Archicad
ChatGPT 桌面版 ChatGPT 模式的「工作」頁籤	✅	✅
ChatGPT 桌面版 Codex 模式	✅	✅
Codex CLI	✅	✅
ChatGPT 桌面版 ChatGPT 模式的「對話」頁籤	❌	❌
ChatGPT 網頁版、手機版	❌	❌

ChatGPT 模式的新對話畫面上方有「對話／工作」兩個頁籤，只有「工作」能啟動本機連接器，開新對話時記得先切過去。網頁版與手機版碰不到你的電腦，連不上 Archicad，請用 ChatGPT 桌面版。

ChatGPT 桌面版 ChatGPT 模式的新對話畫面，上方有「對話」與「工作」兩個頁籤，紅框標出「工作」；中央為「我們要處理什麼？」輸入框，下方有選擇專案、檔案、外掛程式三個按鈕

步驟五：更新技能包

技能會隨著法規與 BIMTeki 功能持續調整。更新分兩層：先讓市集拿到新版清單，再更新技能包本身。

桌面版：外掛程式 → 管理 → 市集頁籤，對 bimteki 市集按升級，再回到外掛程式清單對「BIMTeki 建照檢討」按更新。

終端機：

codex plugin marketplace upgrade bimteki

改過之後記得完全重開 ChatGPT 桌面版。

技能包與連接器是「分開更新」的

	更新方式
技能包	在 ChatGPT 的外掛程式頁面一鍵更新（見上方）
BIMTeki MCP 連接器	要重新執行最新版 BIMTeki Studio 安裝檔

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

疑難排解

第一步：先跑檢查腳本，不要自己猜

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

打開 PowerShell，貼上執行：

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

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

看到 「全部通過」 ＝這台電腦的連接器沒問題，問題出在 ChatGPT 那一端，請看下一節。

最後一行會印出 MCP 版本，回報問題時請一併附上。

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

失敗的項目	意思與處理方式
登錄檔：找不到	安裝時沒勾「AI 助理連接器 (BIMTeki MCP)」。請重跑最新版安裝檔
內嵌 Python／MCP 進入點不存在	檔案不齊，重跑安裝檔
預編譯檔太少	不影響功能，但連接器啟動會變慢。重跑安裝檔可修正
initialize 沒有回應	多半是防毒或公司資安軟體把連接器擋掉了。請 IT 把 BIMTeki Studio 安裝資料夾底下 mcp\python\python.exe 加入白名單
stdout 被汙染	請把完整輸出寄給我們

ChatGPT／Codex 端的常見狀況

症狀	處理方式
MCP 清單（設定 → 外掛程式 → MCP 頁籤，或 Codex 的 /mcp）裡沒有 bimteki	還沒做步驟二，或改完設定沒有完全重開 ChatGPT 桌面版（要在系統匣圖示上按右鍵結束）。重做一次步驟二。不想自己填也可以在 PowerShell 執行下面這行，由腳本代為寫入：powershell -NoProfile -ExecutionPolicy Bypass -File "$env:ProgramW6432\BIMTeki Studio\codex-connector.ps1" -McpPath "$env:ProgramW6432\BIMTeki Studio\mcp"
技能包頁面看得到技能，但看不到連接器	正常。技能包頁面不會顯示連接器，以 /mcp 或設定 → 外掛程式 → MCP 頁籤為準
桌面版「新增市集」顯示「無法新增市集」	確認來源拼的是 BIMTeki/bimteki-plugin、電腦連得上 GitHub；仍失敗就改用方式 B 的終端機指令加入
市集加好了，但外掛程式清單裡找不到「BIMTeki 建照檢討」	到管理 → 市集對 bimteki 市集按升級重新整理清單；仍沒有就完全重開 ChatGPT 桌面版
bimteki 顯示啟動失敗或逾時	多半是防毒第一次掃描連接器花太久，關掉對話再開一次新對話即可；持續發生請 IT 把 BIMTeki Studio 安裝資料夾底下 mcp\python\python.exe 加入白名單
對話一開始就說「本機執行核心無法啟動」	對話開在 Codex 不信任的資料夾（例如 Program Files 底下的程式專案）。換一個普通資料夾開新對話
ChatGPT 模式看不到 BIMTeki	確認新對話上方切到「工作」頁籤，一般「對話」連不到本機連接器
網頁版或手機版看不到 BIMTeki	網頁版與手機版碰不到你的電腦。請改用 ChatGPT 桌面版
技能沒出現	到外掛程式頁面確認 BIMTeki 建照檢討為啟用狀態；改過設定後要完全重開 ChatGPT 桌面版
ChatGPT 說「無法連線到 Archicad」	連接器正常，但 Archicad 那頭沒準備好。確認 Archicad 開著、專案已開啟、BIMTeki 外掛已載入
表格產生了但數值是空白	這不是安裝問題。自動文字要放置到圖紙（Layout）上才會計算出實際值
ChatGPT 說「你的 MCP 版本太舊」，或表格少了合併儲存格／框線	技能包更新了、連接器沒有。重跑最新版 BIMTeki Studio 安裝檔，裝完完全關掉再重開 ChatGPT
ChatGPT 說「席位已被其他電腦取用」	這是浮動許可的正常機制：席位在另一台開著 Archicad 的電腦上。關閉那台電腦的 Archicad，這台幾分鐘內會自動取回席位；詳見〈授權〉系列的「浮動許可」一文
ChatGPT 說「離線寬限已逾期」	這台電腦斷網超過寬限時間。確認網路恢復後再試一次即可，不必重開 Archicad
其他授權相關錯誤	請聯繫 BIMTeki

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

檢查腳本的完整輸出

ChatGPT 顯示的錯誤訊息

你的 Archicad 版本

裝好之後可以做什麼

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

這樣問 Claude

「幫我做這案的面積總表」
「做地下層容積檢討表」
「這個建照有哪些檢討表可以做？」
「把這份土管做成檢討表」（並把土管 PDF 拖進對話）
「幫我畫容積區域」

如果你已經很清楚要用哪一項功能，也可以直接指定技能。Codex 用錢字號 $bimteki: 開頭；ChatGPT 模式的「工作」對話框則可以打 @ 從清單選「BIMTeki 建照檢討」，再用中文說要做什麼。例如：

$bimteki:table

不帶任何關鍵字，AI 會列出這個案子目前可以做的所有檢討表讓你挑。全部技能的用途見〈05 SKILL 一覽〉；想看實際操作影片，見〈06 使用案例〉（影片以 Claude 示範，Codex 的流程相同，只是指定技能的寫法從 / 改成 $）。

這篇有幫助嗎？