Crescendo Lab 文件
正體中文
註冊開始用

用 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-<組織>。

bash
claude mcp add --transport http --scope user agentlab-acme https://mcp.agentlab.cresclab.com/mcp

瀏覽器會打開登入頁,登入並選好組織就連上了。

不需要密碼、權杖或 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 工具讀部署指南,照著做:

prompt
讀 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):

text
要部署時,讀 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 工具會怎麼做#

  1. 找到或建立專案 建立前會先跟你確認網址標籤,因為標籤不能重複使用。
  2. 上傳 把 zip 直接上傳到平台給的位址,檔案不會經過對話。
  3. 等候建置 查詢版本狀態,直到成功或失敗。
  4. 上線前問你 先說明要上線哪一個版本,等你同意。

機敏值還是由你輸入

AI 工具會告訴你去哪裡輸入機敏值,不會要你把它貼進對話。

所有工具見 MCP 工具。程式需要 PostgreSQL、MySQL 或 Redis 時,AI 工具也會一併建立並連上,見資料庫和 Redis 快取。

4. 連線會改動你電腦上的什麼#

連線只會在工具的 MCP 設定裡加一筆伺服器,並存一份登入資訊,其他什麼都不寫。

工具加了什麼在哪裡
Claude CodemcpServers 底下一筆 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 工具部署」頁面,在已連接的應用程式裡移除。