用 API 金鑰或 OAuth 建立自訂 AI 連接器

自訂連接器讓組織管理員可以註冊未在內建目錄中的 HTTPS API，或在啟用時註冊 Streamable HTTP MCP 伺服器。它定義了網路邊界與驗證方式，但不會自動為智能體產生完整的 API 參考。

誰負責設定

定義會在組織內共用。成員憑證僅限於該成員及組織範圍內使用。

開啟 連接器 → 自訂 並選擇 新增連接器。
選擇 HTTP API 並輸入顯示名稱。
新增一個或多個 HTTPS 前綴，每行一個。請求必須符合已設定的前綴，連接器才能授權。
若 API 需要驗證，請新增驗證方式：
- API 驗證：輸入標頭名稱及包含 {{secret}} 的標頭範本，例如 Authorization 和 Bearer {{secret}}。
- OAuth 2.0：輸入授權 URL、權杖 URL、client ID、client secret、scopes 及權杖端點驗證方式。請將表單中顯示的精確重新導向 URL 向服務提供者註冊。
建立連接器。需要使用的成員各自選擇連接並提供自己的密鑰或完成 OAuth。
授權所需的智能體及權限。

變更現有 OAuth 定義或其 client 憑證會中斷目前的 OAuth 連線。成員需於變更後重新連接。

若你的工作區在連接器類型中出現 MCP，請輸入 HTTPS Streamable HTTP MCP 端點，並在同一表單中設定 API 或 OAuth 驗證。若選單中未提供 MCP，表示該工作區未啟用。

自訂連接器提供安全的網路存取與憑證注入。建立表單不會上傳或自動發現 OpenAPI 文件。請在請求中提供智能體端點、方法、參數及預期回應，或將該流程記錄於工作流程並附上 API 參考檔案。

請以已知端點的狹義唯讀請求驗證新連接器。由於許多 API 沒有有意義的根端點，因此沒有通用的 測試連線 請求。

問題	檢查
新增連接器無法使用	只有組織管理員可建立或編輯連接器定義。
智能體無法看到連接器	請為目前成員連接，然後授權該智能體。
請求在到達 API 前被阻擋	請確認請求 URL 以已設定的 HTTPS 前綴開頭。
API 回傳 401 或 403	重新連接成員憑證並確認上游金鑰或 OAuth 範圍。
OAuth 回傳重新導向錯誤	註冊連接器表單中顯示的精確重新導向 URL，並確認授權及權杖 URL。
智能體猜錯端點或 payload	請將 API 流程寫入工作流程並附上相關參考，而非僅依賴連接器名稱。