整合
把遠端 MCP server 註冊成連接器、接上帳戶，再加到助理身上，助理就能在對話中查詢或操作外部服務，每次呼叫都要有人核准。
整合在做什麼#
整合把外部服務的 MCP server 接進工作區，讓 Agent Lab 可以查詢或操作你在其他系統裡的資料，例如 Notion 頁面或 GitHub issue。連接器和帳戶由整個工作區統一管理。把連接器加到助理身上，助理就能在對話中呼叫它的工具。
在 Agent Lab 裡，一個外部 MCP server 叫做 連接器。整個流程分成四步：
- 新增連接器 到側邊欄的「整合」，從「常用服務」挑一個，或自己填 MCP server 的網址。
- 測試 確認 Agent Lab 連得上這台 server，並看看它提供哪些工具。
- 連接帳戶 需要驗證的服務，要先交出 token，或登入授權。
- 加到助理 在助理頁面選這個連接器，勾選助理可以呼叫的工具。
助理在對話中想呼叫連接器的工具時，會先停下來，等有人核准才執行，詳見對話中的授權與核准。
誰可以做什麼#
| 動作 | 工作區擁有者、管理員 | 一般成員 |
|---|---|---|
| 查看連接器與狀態、按「測試」、「檢視工具」 | 可以 | 可以 |
| 新增連接器（「新增自訂連接器」） | 可以 | 不行 |
| 把工具「擔保為唯讀」 | 可以 | 不行 |
| 用「只有我」範圍連接自己的帳戶 | 可以 | 可以 |
| 用「整個工作區共用」範圍連接帳戶 | 可以 | 不行 |
| 中斷自己的連線 | 可以 | 可以 |
| 中斷工作區共用的連線 | 可以 | 不行 |
| 核准會寫入資料、或還沒擔保為唯讀的工具呼叫 | 可以 | 不行 |
| 核准已擔保為唯讀的工具呼叫 | 可以 | 可以 |
一般成員打開「新增自訂連接器」時，會看到「只有工作區擁有者與管理員可以修改這裡，你可以查看。」，請找擁有者或管理員協助。
把連接器加到助理需要有編輯該助理的權限。已發布、分享給整個工作區的助理，要由能發布它的人（擁有者、管理員，或團隊助理的團隊管理者）來加。權限的細節請看助理。
新增連接器#
到「整合」的「連接器」分頁。
從常用服務挑選
頁面下方的「常用服務」列出常見服務的 MCP server，例如 GitHub、Notion、Linear、Sentry、Atlassian（Jira 與 Confluence）、Asana、Figma、Intercom、Webflow、monday.com、Airtable、GitLab、Wix、Supabase、Vercel、Shopify Storefront、Stripe、PayPal、Zapier、Postman、Hugging Face、Cloudflare Docs、DeepWiki 和 Context7。每張卡片會標出這個服務的驗證方式。
選「使用」，Agent Lab 會幫你把名稱、網址、驗證方式和描述填進下方的「新增自訂連接器」表單。卡片只負責預填，這時還沒有加進工作區。服務有時會更換網址，送出前請對照該服務的官方文件確認。已經加過的服務，卡片會顯示「已加入」。
Zapier
Zapier 的卡片會串到你在 Zapier 設定好的動作，讓助理透過 Zapier 使用數千個應用程式。它用「登入授權（OAuth）」驗證。
Shopify Storefront 的網址要把 your-store 換成你商店的網域。
自己填寫
任何透過 HTTPS 提供服務的遠端 MCP server 都可以加進來，包括你自己架設的。在「新增自訂連接器」填寫：
| 欄位 | 說明 |
|---|---|
| 「名稱」 | 在主控台和助理頁面上顯示的名字。 |
| 「Server 網址（https）」 | MCP server 的完整網址，必須是 https://。 |
| 「驗證方式」 | 連到這台 server 要用的驗證方式，見下表。 |
| 「描述(選填)」 | 說明這個連接器的用途。 |
選「註冊」完成。連接器加進來後，就會出現在「連接器」清單裡。
「驗證方式」有四種：
| 驗證方式 | 適用情況 | 連接時要提供 |
|---|---|---|
| 「不需要（公開）」 | 公開的 server，不需要帳號 | 不用連接，加到助理就能用 |
| 「API token」 | server 用固定的 token 驗證 | 「Bearer token」 |
| 「OAuth 用戶端憑證」 | server 用 OAuth client credentials 驗證 | 「用戶端 ID」和「用戶端密鑰」 |
| 「登入授權（OAuth）」 | 要到服務的網站登入並同意授權 | 到服務的頁面登入，不用在 Agent Lab 輸入密碼 |
目前無法在主控台刪除或停用已加入的連接器。不再使用時，請中斷連線，並把它從助理身上移除。
測試與檢視工具#
「連接器」清單的每一列都有三個動作：
- 「測試」：Agent Lab 會連到 server 讀取工具清單，並告訴你找到幾個工具，以及其中幾個由 server 標示為唯讀。Agent Lab 也會定期在背景自動測試。
- 「檢視工具」：列出這個連接器的每一個工具，以及它的風險標示。
- 「連接」：開啟連接帳戶的表單，見連接帳戶。驗證方式是「不需要（公開）」的連接器沒有這個按鈕。
「狀態」欄會顯示「可用」、「無法使用」或「尚未測試」。擁有者和管理員還會在下方看到上次失敗的原因。一台 server 最多收錄 200 個工具，超過的部分會在狀態下方註明。
把工具擔保為唯讀
在「檢視工具」裡，每個工具旁會有兩個標籤：
- server 自己的說法：「Server 標示：唯讀」、「Server 標示：會修改資料」或「Server 未標示」。這只是參考，不會改變任何規則。
- 工作區的判斷：「你已擔保：唯讀」或「你尚未確認」。
在你確認工具只會讀取資料之前，Agent Lab 會把它當成可能修改資料的工具，助理呼叫時只有擁有者和管理員能核准。擁有者或管理員確認某個工具真的只會讀資料後，可以選「擔保為唯讀」，之後一般成員也能核准它的呼叫；想收回時選「撤回」。
連接帳戶#
需要驗證的連接器，要先連接帳戶，助理才能用它。在「連接器」清單選「連接」：
- 選擇「範圍」（只有擁有者和管理員會看到這個選項；一般成員一律是「只有我」）： - 「整個工作區共用」：工作區保管一份憑證。助理使用時，是以這份憑證的身分執行，而不是提問的人。所有使用這個助理的人，都能存取這份憑證能存取的一切。 - 「只有我」：你自己的憑證。助理只會在你提問時用它，看到的就是你看得到的。
- 共用範圍可以填「身份名稱(選填)」，例如「唯讀查詢」，用來區分同一個服務的多份共用憑證（像是唯讀和讀寫各一份）。
- 依驗證方式提供憑證： - 「API token」：填「Bearer token」，選「送出憑證」。 - 「OAuth 用戶端憑證」：填「用戶端 ID」和「用戶端密鑰」，選「送出憑證」。 - 「登入授權（OAuth）」：選「前往授權」，到服務的網站登入並同意，完成後會回到 Agent Lab。
如果服務支援裝置代碼，也可以改選「使用裝置代碼連接」：畫面會顯示一組代碼，選「開啟提供者頁面」並輸入代碼，授權完成後回來選「我已授權，檢查」。
憑證加密保存，只在工具真正執行的時候取用。
連接完成後，帳戶會出現在「已連線帳戶」區塊，列出連接器、「範圍」和狀態。範圍下方會說明這條連線的權限：
- 「以每位成員的身分執行，憑證會過期。」或「以每位成員自己的金鑰執行，金鑰不會過期。」：每個人只會讀到自己帳號能讀的資料。
- 「以工作區身分執行，而不是提問者。所有使用者都能存取它能存取的一切。」：權限區隔要靠服務那一端自己設定。
讓助理使用連接器#
連接器加進工作區後，還要加到助理身上，助理才會用它。
打開助理頁面，在「動作（進階）」步驟找到「已連接的系統」（私人助理是「你的連接器」）：
- 選擇連接器 在「選擇連接器」選單挑一個連接器。
- 勾選工具 在「這個助理可以呼叫的工具」點選要開放的工具，至少選一個。只開放助理真正需要的工具。
- 選擇使用的身分 需要驗證的連接器會多一個「使用的身分」選單，見下方說明。
- 加入 選「加到這個助理」。
「使用的身分」決定助理用誰的憑證：
- 「各成員自己的憑證」（不釘選）：每個人提問時，助理用那個人用「只有我」連接的帳戶。還沒連接的人提問時，助理就用不到這個連接器的工具，對話中會提示對方接上自己的帳號（見對話中的授權與核准）。
- 釘選共用身分：選一份「整個工作區共用」的憑證，助理對所有人都用這同一個身分。助理只有在釘選時，才會用到工作區共用的憑證。私人助理只有擁有者和管理員可以釘選共用身分。
已加入的連接器會列出它的身分模式（例如「各成員自己的帳號」或「固定一個共用身分」）、權限說明，以及開放的工具。要拿掉時選「移除」。
清單裡沒有可選的連接器時，會看到「沒有可加入的連接器。先到「整合」頁註冊，再回來加到這個助理。」。助理的其他設定請看助理。
對話中的授權與核准#
還沒接上自己的帳號
助理用到一個你還沒連接的服務時，對話中會出現「這個助理可以接到一個你還沒連接的服務」。在你接上之前，助理會在不用這些工具的情況下回答。接法看這個服務怎麼驗證：
- 用 token 連接的服務：選「接上我的帳號」，在「你的存取憑證」貼上你的 token，再選「授權」，對話就會帶著工具繼續。
- 其他服務（例如「登入授權（OAuth）」）：提示上不會有 token 欄位，而是「到「整合」連接」。點下去會打開「整合」頁，這個連接器的連接表單已經展開，範圍預設「只有我」。連好之後回到這段對話，再送一次訊息。
這類服務只能從「整合」連接，平台不接受替它們直接存 token。
核准工具呼叫
助理每次想呼叫連接器的工具，都會先停下來，顯示「助理想執行一個動作」，列出它要送出的內容和風險標示：
| 標示 | 意思 | 誰可以核准 |
|---|---|---|
| 「唯讀」 | 工作區已把這個工具擔保為唯讀 | 工作區任何成員 |
| 「會寫入外部系統」 | 這個工具會修改資料 | 擁有者、管理員 |
| 「未宣告風險，視同可破壞」 | 工作區還沒擔保，Agent Lab 當成可能修改資料來處理 | 擁有者、管理員 |
看過內容後選「核准並執行」或「拒絕」。沒有核准權限的成員只會看到「拒絕」，卡片上寫著「只有工作區擁有者或管理員能核准這個動作。請他們在這裡核准，或由你拒絕。」。連接器的工具不會自動執行，每次都要有人核准。對話的其他操作請看對話。
中斷連線#
在「已連線帳戶」找到那一列，選「中斷」。一般成員只能中斷自己「只有我」的連線；工作區共用的連線由擁有者或管理員中斷。中斷後狀態會變成「已中斷」，助理就不能再用這份憑證。
狀態顯示「需要重新登入」時，表示授權已失效，請在「連接器」清單再選一次「連接」。
只想讓某個助理不再使用某個連接器，到助理頁面的「已連接的系統」選「移除」就好，不用中斷整個工作區的連線。
排除問題#
- 「無法新增連接器，請檢查名稱與 https 網址。」：名稱和網址都要填，網址必須以
https://開頭。 - 測試失敗：server 可能連不上，或憑證權限不足。擁有者和管理員可以在「狀態」下方看到 server 回傳的原因。
- 登入授權失敗：「登入授權（OAuth）」需要 server 支援 OAuth 動態用戶端註冊。不支援時，請改用「API token」或「OAuth 用戶端憑證」重新加一個連接器。
- 「無法啟動裝置代碼流程，提供者可能不支援。」：改用「前往授權」。
- 助理沒有用到連接器的工具：確認連接器已加到這個助理，而且勾選了需要的工具；不釘選時，提問的人要先用「只有我」連接自己的帳戶。
- 「還不知道這個連接器有哪些工具。請先到「整合」頁確認它的健康狀態。」：先到「整合」選「測試」，讀到工具後再回來加。