用 Claude Code、Codex 部署:MCP 設定
把 Agent Lab MCP 接上 Claude Code、Codex、Claude Desktop 或其他 MCP 工具,讓它建立專案、上傳並上線。只需登入一次。
1. 連接 Agent Lab MCP#
依你所用的工具新增連線:Claude Code 和 Codex 在終端機執行指令,Claude Desktop 在設定畫面新增。把 acme 換成你的組織名稱;主控台的「MCP」頁面會顯示已經填好組織名稱的指令與連線名稱 agentlab-<組織>。
claude mcp add --transport http --scope user agentlab-acme https://mcp.agentlab.cresclab.com/mcp在 Claude Desktop(或 claude.ai 網頁版)新增自訂 connector。Team 或 Enterprise 方案要先由組織擁有者在 Organization settings › Connectors 新增(Add › Custom › Web),成員再到 Customize › Connectors 按 Connect,在瀏覽器登入並選組織後,從第 4 步開始。Free 方案只能新增一個自訂 connector。
- 開啟 Customize › Connectors(較舊的版本在 Settings › Connectors),按 + Add › Add custom connector。
- 名稱填
agentlab-acme,網址填https://mcp.agentlab.cresclab.com/mcp,按 Continue;下一個畫面會顯示偵測到的驗證設定,再按一次 Continue。 - Authentication 選 Sign in now,OAuth client 保留 Use Claude's published identity (Recommended)(不要選 Register automatically,Agent Lab 目前不支援),按 Add,在開啟的瀏覽器登入並選組織。
- 開一個新對話,按輸入框左下角的 + › Connectors,把
agentlab-acme打開。 - 在這個對話問「列出我在 Agent Lab 的專案」。Claude 呼叫
sites_list並列出專案,就代表連上了。工具沒出現的話,完全結束 Claude Desktop、重新開啟後再試一次。
Claude Desktop 的一般對話(Chat)讀不到你電腦上的資料夾,可以查狀態、改設定、讓版本上線。要上傳本機專案,請用 Claude Code(終端機,或 Claude Desktop 的 Code 分頁);要從 GitHub 部署,請在主控台連結 repository。
codex mcp add agentlab-acme --url https://mcp.agentlab.cresclab.com/mcp
codex mcp login agentlab-acme也可以寫進 ~/.codex/config.toml,再執行 codex mcp login agentlab-acme:
[mcp_servers.agentlab-acme]
url = "https://mcp.agentlab.cresclab.com/mcp"新增一個 HTTP 類型的 MCP 伺服器,網址填:
https://mcp.agentlab.cresclab.com/mcp用戶端需要支援 OAuth 2.1(PKCE),並用 Client ID Metadata Documents 或動態註冊(dynamic client registration)表明身分,Cursor、VS Code、Windsurf、Gemini CLI、Qwen Code 等都可以。登入會在瀏覽器開啟。只能在設定檔貼固定 header、不做 OAuth 的用戶端目前還連不上。
瀏覽器會打開登入頁,登入並選好組織就連上了。
不需要密碼、權杖或 API 金鑰
授權在瀏覽器完成。這條連線能做的事,不會超過你本人在主控台能做的。
如果像上面那樣,在開啟 Claude Code 之前就加入連線,在 /mcp 登入後工具就能用,不必重新啟動。如果是在已經開著的 Claude Code 對話裡才加入,那個對話的 /mcp 看不到它:請離開後在同一個資料夾執行 claude --continue,對話會接續下去。Claude Desktop 的 connector 只要開新對話並打開它就能用,工具沒出現才需要完全結束、重新開啟 Claude Desktop。Codex 請在開始對話前登入,或登入後開新對話。之後如果工具清單看起來不是最新的,重新連接伺服器就好(Claude Code:/mcp › 該伺服器 › Reconnect),不需要重新登入。
這次登入會一併授權專案、資料庫與快取,每一項都不會超出你在組織裡的角色能做的範圍。工具要求的權限少,拿到的就少。
組織的擁有者、管理員和該資料庫的管理者本來就有 writer 權限,不必另外申請或授權;其他成員才需要 reader 或 writer 權限。請 AI 確認 SQL 後直接呼叫工具,真的被拒絕時才請管理者調整權限。部署的產品需要資料表時,直接用 databases_apply_migration 建表,再用 databases_connect_app 設定專案的連線,不必到主控台手動建表。
2. 請 AI 工具部署#
在專案資料夾裡,請 AI 工具讀部署指南,照著做:
讀 https://app.agentlab.cresclab.com/agent/deploy.md,照著步驟把這個資料夾部署到 Agent Lab 的組織 acme。如果 AI 工具讀不到這個網址,同一份指南也放在 https://agentlab.cresclab.com/agent/deploy.md。接上 Agent Lab MCP 之後,也可以用 docs_read 讀這份文件。
要讓它查這份文件,給它這一頁的 Markdown 網址,或整份文件的目錄 https://agentlab.cresclab.com/docs/zh-tw/llms.txt。MCP 伺服器也有 docs_read 工具,可以讀到同樣的頁面。
想讓它每次都這樣部署,把同一句話放進專案的 AGENTS.md(Codex)或 CLAUDE.md(Claude Code):
要部署時,讀 https://app.agentlab.cresclab.com/agent/deploy.md 並照著做,部署到 Agent Lab 組織 acme。讀不到這個網址時,改讀 https://agentlab.cresclab.com/agent/deploy.md 或呼叫 docs_read。用 ChatGPT 或 Claude 網頁版?
這類工具讀不到你電腦上的檔案。請把程式碼資料夾存成 zip,到主控台的專案頁面上傳,或從 GitHub 部署。
3. AI 工具會怎麼做#
- 找到或建立專案 建立前會先跟你確認網址標籤,因為標籤不能重複使用。
- 上傳 把 zip 直接上傳到平台給的位址,檔案不會經過對話。
- 等候建置 查詢版本狀態,直到成功或失敗。
- 上線前問你 先說明要上線哪一個版本,等你同意。
機敏值還是由你輸入
AI 工具會告訴你去哪裡輸入機敏值,不會要你把它貼進對話。
所有工具見 MCP 工具。程式需要 PostgreSQL、MySQL 或 Redis 時,AI 工具也會一併建立並連上,見資料庫和 Redis 快取。
4. 連線會改動你電腦上的什麼#
連線只會在工具的 MCP 設定裡加一筆伺服器,並存一份登入資訊,其他什麼都不寫。
| 工具 | 加了什麼 | 在哪裡 |
|---|---|---|
| Claude Code | mcpServers 底下一筆 agentlab-acme | ~/.claude.json,在每個資料夾都有效(--scope user,即第 1 步的指令)。不加 --scope 也寫在同一個檔案,但只對目前資料夾有效。--scope project 會在專案裡寫 .mcp.json 會隨 git 分享出去,不建議這樣做。 |
| Claude Code | 登入資訊 | macOS 鑰匙圈;Linux 與 Windows 是 ~/.claude/.credentials.json |
| Codex | 一個 [mcp_servers.agentlab-acme] 區塊 | ~/.codex/config.toml |
| Codex | 登入資訊 | Codex 存放 MCP 登入的地方(依 mcp_oauth_credentials_store 設定,是系統鑰匙圈或檔案) |
| Claude Desktop、claude.ai | 一個自訂 connector | 存在你的 Claude 帳號,不是你電腦上的檔案;不會改動 claude_desktop_config.json |
| 其他用戶端 | 一筆伺服器設定 | 該用戶端的 MCP 設定 |
不會改動的東西
- 你的 skills、斜線指令、hooks、plugins、subagents 和其他 MCP 伺服器。Agent Lab 一樣都不安裝。
settings.json、權限設定和你用的模型。如果你在工具詢問時選了「不要再問」,那是你的工具自己記下的,和其他工具一樣。CLAUDE.md與AGENTS.md。第 2 步那一句是選用的,要不要加由你決定、由你自己加。- 你的電腦上不會安裝或執行任何東西:伺服器在遠端,沒有套件、沒有
npx指令,也沒有背景程式。
它的工具名稱都帶著連線名稱,例如 Claude Code 裡的 mcp__agentlab-acme__sites_list,所以不會取代同名的 skill 或其他伺服器的工具。只有在你請 agent 做 Agent Lab 的事時,它才會用到。
想復原: Claude Code 執行 claude mcp remove --scope user agentlab-acme;若也要刪掉存著的登入資訊,先在 /mcp 選 Clear authentication。Codex 執行 codex mcp remove agentlab-acme。Claude Desktop 在 Customize › Connectors 移除該 connector。要在 Agent Lab 這一端也結束連線,到主控台的「用 AI 工具部署」頁面,在已連接的應用程式裡移除。