連接 ChatGPT 與 companion extension

CoS 的 Settings → Setup 是連接中樞：隧道 (tunnel) 設定、連接狀態與擴充載入都在這裡。連接分成兩半——本機端把 MCP 端點經隧道暴露出去，ChatGPT 端則建立指向該隧道的 custom app；最後再載入觀察 ChatGPT 介面的 companion extension。

OpenAI Secure MCP Tunnel

官方建議路徑，四個步驟：

在 Platform → Tunnels 建立 tunnel，必須是你 ChatGPT 使用的同一個 workspace。
建立一把 Restricted 的 API key，權限需包含 Tunnels: Read 與 Tunnels: Use。
在 CoS 輸入 tunnel ID 與金鑰，按 Connect。
在 ChatGPT 開 Settings → Apps → Advanced settings，啟用 Developer mode，建立一個 type 為 Tunnel 的 custom app，檢視並啟用它的 actions。

release 內建 pinned、經 checksum 驗證的 tunnel-client，不需要另外安裝隧道執行檔。

Core、Desktop 與 Plugins 是各自獨立的 connector，各自有自己的權限邊界與 secret tokenized 的本機路徑；要用哪個 surface 就個別設定。Plugins 走自己的端點，使用 OpenAI Secure Tunnels 時也要建立專屬的 Plugins tunnel。

替代隧道方案

方案	重點
Cloudflare quick tunnel	在 CoS 連接後，把顯示的公開 URL 當成 ChatGPT 的 MCP server URL；隨機路徑是秘密，且重啟後會改變
自有 HTTPS tunnel	轉發到 CoS 顯示的 loopback URL，並保留其 secret path；產生的 URL 當密碼對待

隧道被拒時先檢查：儲存的 tunnel ID、目前選用的 setup profile，以及金鑰是否對該 tunnel具備 Tunnels Read + Use。extension 配對不會替隧道做認證，兩者是不同機制。

ChatGPT 端：custom app

Developer mode 開啟後，在 ChatGPT 建立 custom app 並選擇 Tunnel 類型，指向步驟 1 建立的隧道。Core／Desktop／Plugins 各建一個 app；變更啟用的工具或權限後，記得在 ChatGPT 重新整理對應 app 再開新對話。

載入 companion extension

在 CoS 的 Settings → Setup 按 Open extension folder。
開啟 chrome://extensions。
開啟 Developer mode。
選 Load unpacked，選取剛才開啟的資料夾。

**配對自動完成——沒有配對碼要輸入。**目前的擴充會自動與本機 bridge 配對。

若更新後出現 extension 版本不符：先 reload 未打包的 companion extension，再重新載入 ChatGPT 頁面。這兩步順序固定、缺一不可。

常見連線排查

工具缺少或過期：refresh ChatGPT 中對應的 CoS app；reload 擴充是另一個獨立動作。
UNIDENTIFIED_CALLER：在已配對的瀏覽器中使用該對話，讓擴充能證明請求身分；CoS 不會從作用中的分頁猜測。
供應商用量限制或政策警告：停止受影響的工作流並關閉其 Goal/Loop 自動化，依供應商的重置或申訴流程處理；不要用換帳號、換對話、換模型或換隧道來規避。

下一步

連線完成後，建議先跑一遍第一個連線與探索範例，再回來讀工作區、權限與瀏覽器橋接。