安裝與啟動 CatDesk

CatDesk 是一個開源工具，讓你把 ChatGPT 網頁版當成本地編碼代理 (coding agent) 使用。它在本機跑一個 MCP 伺服器 (Model Context Protocol Server)，再透過 ngrok 隧道 (tunnel) 暴露給 ChatGPT 的 Custom Connector。本文說明安裝、首次啟動流程，以及該注意的事項。

警告：CatDesk 權限很大，理論上可以清除整顆硬碟。官方強烈建議在 VM 或容器 (container，DevContainer 是好選擇) 內執行。

安裝

用 npm 全域安裝即可，需求為 ChatGPT Plus（或以上）訂閱：

npm install -g catdesk

啟動

安裝完成後，在任何終端機目錄下執行：

catdesk

CatDesk 不需要在專案目錄內啟動，它會在首次啟動時透過引導流程完成所有設定。

首次啟動流程

1. 選擇執行模式

啟動後會先出現模式選擇畫面，三選一：

Control Computer：只控制電腦（檔案與指令）
Control Browser：只控制瀏覽器
Both：兩者都要

2. 選擇瀏覽器（若啟用瀏覽器控制）

若選了 Control Browser 或 Both，需選擇一個支援的 Chromium 瀏覽器。macOS 上 CatDesk 會偵測 /Applications 與 ~/Applications 中的標準瀏覽器 app bundle，也支援 PATH 上的執行檔。

3. 輸入 ngrok 憑證

首次啟動時，CatDesk 會詢問兩項資訊：

ngrok authtoken
ngrok static domain（靜態網域，例如 my-app.ngrok-free.dev）

兩者都可以在 ngrok dashboard 取得。輸入後會存進 ~/.catdesk/config.toml，之後啟動自動重用，不用再填。

4. 等待 TUI 顯示 MCP Server URL

設定完成後，TUI (Terminal User Interface) 會顯示完整的 MCP Server URL，格式如下：

https://xxxx.ngrok-free.dev/Ab3kL9xQ2pTm7VhC/mcp

這串 URL 是 ChatGPT Connector 連線的入口。複製下來，下一步設定 Connector 時會用到。

安全提醒：不要把 MCP Server URL 給任何人。拿到 URL 的人就能存取你的電腦。

選用：安裝 ripgrep

CatDesk 的 search 工具會依序嘗試 rg（ripgrep）、grep，最後退回內建掃描器。ripgrep 不是必要依賴，但裝了搜尋效能最好：

# macOS
brew install ripgrep

# Windows (winget)
winget install BurntSushi.ripgrep.MSVC

下一步

TUI 顯示 MCP Server URL 後，就可以打開 ChatGPT 進行 Custom Connector 設定。完整步驟請見下一篇：ChatGPT Custom Connector 連接設定。