自訂代理程式的 MCP 連接

MCP (Model Context Protocol) 連接可讓您的自訂代理程式安全地連接至外部應用程式。透過 MCP 連接，您的代理程式可以使用與 Linear、Ramp、Figma 等應用程式的預先設定連接來讀取資訊並採取動作，或者透過設定自訂 MCP 連接來連接至任何應用程式。

提示： MCP 連接僅適用於商業版與企業版。

MCP 連接可讓自訂代理程式透過模型上下文協定（Model Context Protocol）與外部工具和服務互動。MCP 工具適用於所有觸發類型，包括排程執行、基於 Notion 或 Slack 事件的觸發執行，以及來自對話或 @提及的手動執行。

主要功能：

• 預先設定的伺服器：無需任何額外設定，即可快速連接至熱門應用程式。

• 自訂伺服器：使用公開網址連接至任何支援託管 MCP 伺服器的工具。

• 自訂：可針對每個連接切換開啟或關閉工具，並可選擇執行前是否需要確認、自動執行，或永久允許來自伺服器的所有工具。

每個 MCP 連接皆為單一自訂代理程式所獨有，並使用驗證該連接之使用者的憑證。即使連接至相同的服務，連接也不會在代理程式之間共用。

這表示：

• 如果您為代理程式 A 設定了 Figma 連接，代理程式 B 將需要其各自獨立的 Figma 連接。

• 您必須為您設定的每個代理程式登入每個 MCP 伺服器。

• 撤銷一個代理程式中的連接不會影響其他代理程式。

您可以連接至下列應用程式，無需任何額外設定：

• Amplitude

• Attio

• Box

• ClickHouse

• Figma

• GitHub

• HubSpot

• Intercom

• Linear

• Mercury

• Miro

• Mixpanel

• n8n

• Ramp

• Stripe

• Sentry

• Wiz

1. 開啟您自訂代理程式的 設定。

2. 前往 工具與存取權。

3. 點擊 新增連接 → 新增。

4. 選擇一個預先設定的伺服器。

5. 請依照驗證提示來連接您的帳號。

6. 選擇您希望自訂代理程式使用的伺服器工具。這些工具會根據您選擇的伺服器而有所不同。

7. 點擊 連接。

若要連接至不在預先設定清單中的 MCP 伺服器，工作空間管理員必須先開啟此選項。共有兩項獨立設定：一項用於允許自訂 MCP 伺服器，另一項用於決定成員是可以安裝任何連接，還是僅能安裝您核准的連接。

若要允許自訂 MCP 伺服器：

1. 身為工作空間管理員，請前往 設定 → 連接。

2. 在 管理 分頁中，切換開啟 啟用自訂 MCP 伺服器。

若要選擇成員是可以安裝任何連接，還是僅能安裝管理員核准的連接：

1. 身為工作空間管理員，請前往 設定 → 連接。

2. 在 管理 分頁中，找到 管理權限 區段。

3. 在 限制成員可安裝的連接 旁邊，選擇其中一項：

   • 已核准並建議：自動核准 Notion 建議的所有連接。

   • 僅限已核准：手動選取成員可以安裝的每一項連接。

4. 選取 已核准的連接 以檢閱成員可以安裝的項目。

5. 選取 新增已核准連接，然後選取您要允許的項目：

   • 連接：透過名稱或 ID 搜尋連接，並將其新增至已核准列表。

   • 自訂 MCP 伺服器：新增您要允許的特定自訂 MCP 伺服器 URL。

6. 點擊 儲存。

設定完成後，工作空間中的任何人皆可在設定自訂代理程式時連接至已核准的選項。他們將使用自己的憑證進行驗證。

若要將自訂 MCP 新增至自訂代理程式：

1. 開啟自訂代理程式的 設定。

2. 前往 工具與存取權。

3. 點擊 新增連接 → 自訂 MCP 伺服器。

4. 您需要輸入您要連接的工具或提供者所提供的 MCP 伺服器 URL（例如：貴公司的內部工具團隊）。

5. 為連接提供顯示名稱（選填）。

6. 新增任何必要的驗證詳細資訊。

7. 點擊 連接。

自訂 MCP 伺服器可能支援下列一種或兩種登入方式：

• OAuth

• 標頭式驗證

  （例如 API 金鑰或持有人權杖）

部分 OAuth 伺服器不支援 動態用戶端註冊 (DCR)。這表示 Notion 必須先向第三方服務預先註冊用戶端應用程式，OAuth 登入才能運作。如果您要使用的伺服器不支援 DCR，請查看其說明文件，確認是否能改用 API 金鑰或持有人權杖。如果這兩個選項皆無法使用，則該 MCP 伺服器無法與自訂代理程式搭配使用。

您可以在代理程式的 設定 中的 工具與存取權 下，決定自訂代理程式應如何使用 MCP 連接。展開 MCP 連接項目以查看可用工具並決定其執行方式。可以使用旁邊的切換來啟用或停用工具。

讀取和寫入工具

• 讀取工具（例如：搜尋、擷取、列出、檢視）允許自訂代理程式在不對外部系統進行變更的情況下檢索或檢視資訊。

• 寫入工具（例如：建立、更新、刪除、傳送、發佈）會對外部系統中的資料進行變更。預設情況下，這些工具需要確認後，代理程式才會執行該動作。

自動執行或總是詢問

• 自動執行允許工具在無需使用者確認的情況下執行。此設定最適合讀取工具（搜尋、擷取、列出、檢視），因為它們不會修改資料。

• 總是詢問要求使用者在動作執行前核准或取消。這是寫入工具（建立、更新、刪除、傳送）的預設設定，以防止非預期的變更。

• 總是允許會永久核准來自伺服器的所有工具，並移除未來的確認提示。

若要移除 MCP 連接

1. 開啟您代理程式的 設定。

2. 前往 工具與存取權。

3. 找到該 MCP 連接並點擊 解除連接。

4. 點擊 解除連接 以確認。

5. 進行變更後，請務必測試您的代理程式。您可以隨時透過重新驗證來重新連接。

注意： 如果您移除連接，代理程式將無法再存取該服務，且依賴該伺服器的排程執行可能會失敗。一旦您解除連接，代理程式的工作流程可能會中斷。您可以隨時透過重新驗證來重新連接。

MCP 連接會遵守您自訂代理程式上設定的使用者權限等級。以下是每個權限等級對 MCP 連接工具的操作權限。

擁有自訂代理程式全部權限與可以編輯權限的使用者可以：

• 將新的 MCP 連接新增至自訂代理程式。

• 與代理程式對話並使用所有已連接的工具，即使它們在代理程式之外沒有該工具的存取權限。

• 檢視代理程式的活動記錄與 MCP 工具使用情形。

• 移除現有的 MCP 連線。

• 重新連線或更新 MCP 伺服器憑證。

對於他們設定的 MCP 連線，擁有全部權限與可以編輯權限的使用者可以：

• 設定啟用或停用哪些工具，並變更工具執行設定（自動執行與總是詢問）。

提示： 一旦建立 MCP 連接，只有驗證該 MCP 連接的人員可以設定與更新工具設定，即使其他人對該自訂代理程式擁有全部權限或可以編輯權限亦然。代理程式在存取外部服務時，會使用該人員的憑證與權限。

擁有「可以查看與互動」權限的使用者對自訂代理程式可以：

• 與自訂代理程式聊天並使用所有已連接的工具，即使它們在自訂代理程式之外沒有這些工具的存取權限。

• 透過代理程式觸發讀取與寫入動作。

• 在需要確認時核准或取消寫入動作。

• 檢視已連線的 MCP 伺服器（在自訂代理程式設定中）。

擁有「可以查看與互動」權限的使用者無法：

• 新增或移除 MCP 連接。

• 變更已啟用的工具。

• 修改工具執行設定。

• 檢視代理程式的完整活動記錄檔。

提示： 寫入動作（例如建立或更新項目）預設需要確認，以防止非預期的變更。使用者會在代理程式執行動作前，看到顯示該動作內容的（文字）指令。

如果連接後未出現工具：

• 重新整理代理程式設定頁面。

• 檢查 MCP 伺服器是否已成功驗證（尋找綠色勾號或「已連接」狀態）。

• 驗證伺服器是否在線上並傳回工具中繼資料。

• 嘗試重新連接伺服器，或中斷連接後重新加入。

如果自訂代理程式執行失敗並出現 MCP 錯誤：

• 檢查 活動 分頁以查看特定錯誤訊息。

• 驗證您的連接是否仍然有效（權杖可能已過期）。

• 確保該連接在代理程式的設定中仍為啟用狀態。

• 嘗試重新連接 MCP 伺服器以重新整理憑證。

• 更新自訂代理程式的指示，提及您想要使用的伺服器或工具名稱。例如：「使用 Linear MCP 來擷取此 mock 的中繼資料」。