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