管理連接器（管理員）

組織管理員在「MaiGPT 連接器」頁為組織啟用連接器、設定 Service Account 認證與 contextData 允許清單、查看與撤銷成員授權、處理成員的啟用申請，以及新增組織私有的 MCP 伺服器。

成員要在 MaiGPT 使用 Notion、Google Drive 這類連接器，必須先由組織啟用，成員才能各自授權使用（成員端操作見 連接器）。本頁給組織管理員：在 MaiGPT 連接器 頁決定組織開放哪些連接器、處理成員送來的申請，並接入公司自己的 MCP 伺服器。

誰可以使用

• 角色需要 MaiGPT 連接器管理權限，左側選單才會出現 MaiGPT 連接器。組織擁有者預設具備。

• 成員使用連接器只需要 MaiGPT 權限，不需要管理權限。

• 撤銷成員的授權只有組織擁有者能操作。

權限設定方式見 角色權限管理。

進入方式

從左側選單點 MaiGPT 連接器。清單列出平台提供與組織自訂的所有連接器：

欄位	說明
連接器名稱	有成員申請時，名稱旁會出現「N 位成員申請」標籤，滑鼠移上去可看申請者 Email
來源	系統內建（平台提供）或 組織自訂（你們新增的私有 MCP 伺服器）
認證類型	OAuth 2.0（成員各自授權）、Service Account（全組織共用一組認證）或 No Auth（無認證）
工具類別	對話中工具卡片的顯示分類；啟用後才能設定，選了立即儲存
啟用	是否為組織開放
已授權成員	已完成授權的成員數，旁邊的編輯圖示可查看名單
操作	Service Account 連接器的認證設定；組織自訂連接器的編輯與刪除

從「工具」頁進入

組織自訂的連接器另有一個入口：AI 功能 → 工具，頁內第二欄切到 管理連接器。頁首說明是「管理組織自訂的 MCP 連接器。連接器會同步至 MaiGPT 連接器，並可在其中選擇是否啟用。」清單只列組織自訂的連接器（不含系統內建），欄位為 連接器、MCP 伺服器網址、驗證方式、工具類別、建立時間 與 操作（編輯、刪除），右上角有 新增連接器 與 重新整理。這裡與本頁清單修改的是同一份資料；啟用／停用與成員授權仍在本頁操作。

為組織啟用連接器

打開該列的 啟用 開關，看到 已成功啟用連接器 即完成。啟用後成員端的狀態依認證類型不同：

認證類型	啟用時	成員端
OAuth 2.0	直接啟用	每位成員各自點 授權，用自己的帳號登入該服務
Service Account	先跳出 Service Account 認證 視窗，填入認證標頭後建立；按取消則開關還原	不需授權，所有人共用管理員填的認證；認證標頭空白時顯示 需管理員設定
No Auth（無認證）	直接啟用	不需授權即可使用

關閉開關（已成功停用連接器）後，成員就無法再於對話中使用它；已授權成員的授權仍保留，重新啟用即可恢復。

開放給角色

系統內建的連接器啟用後，還受角色的 MaiGPT 使用權限限制：成員的角色要在 連接器 卡片勾「全部」或勾選這個連接器，才看得到授權按鈕；否則成員端顯示 角色未開放。組織自訂的連接器不受角色限制。設定方式見 MaiGPT 角色使用權限。

處理成員的申請

成員在 管理我的連接器 看到不能用的連接器時，可以送出申請。系統會寄 Email 通知組織擁有者與具備 MaiGPT 連接器管理權限的人，並在本頁上方顯示「有 N 個連接器待處理成員的啟用申請」。

成員看到的狀態	成員按的按鈕	你要做的事
組織未啟用	申請啟用	在本頁打開該連接器的 啟用 開關
角色未開放	向管理員申請	連接器已啟用，請到申請者所屬角色的 MaiGPT 使用權限勾選這個連接器，或把申請者加入已開放的角色

完成後申請會自動消解，申請者會在 通知中心 收到 連接器已啟用。本頁沒有逐筆拒絕的按鈕；不打算開放時，請直接告知申請者。

查看與撤銷成員授權

點 已授權成員 欄的編輯圖示，開啟名單。每位成員顯示 授權時間、Token 過期時間 與狀態（有效、已過期、永久有效）。

成員離職或不應再存取時，組織擁有者可按 撤銷授權；撤銷後該成員要重新授權才能再用。撤銷只適用 OAuth 2.0 連接器。尚未啟用過的連接器沒有名單，會提示「此連接器尚未建立，請先啟用」。

設定 Service Account 認證

Service Account 連接器啟用後，操作 欄會出現設定圖示（連接器認證設定）。

• 認證標頭：JSON 物件，例如 {"Authorization": "Bearer your-token"}。已設定的標頭只顯示遮蔽後的值；欄位留空會保留現有標頭，填寫則整組覆蓋。

• 標頭值可以用 可用的情境變數，每次對話自動代入：{{contact_id}}（聯絡人 ID）、{{source_id}}（來源 ID）、{{contact_name}}（聯絡人名稱）、{{conversation_id}}（對話 ID）、{{inbox_id}}（收件匣 ID）、{{organization_id}}（組織 ID）。

contextData 允許清單

Agent 嵌入在你們的網站時，網站可以用 contextData 帶入自己的資料（例如會員編號），再寫進認證標頭：

1. 在網站的對話視窗嵌入設定中，把資料放進 contextData（做法見技術手冊〈注入頁面 Context〉）。

2. 在 允許的 contextData Keys 填入名稱，格式為 JSON 字串陣列，例如 ["patientToken"]；最多 20 個，每個名稱限英文、數字與底線、1 至 64 個字元。

3. 在認證標頭的值寫 {{context_data.patientToken}}。

規則：三處名稱必須逐字相同並區分大小寫；沒列在允許清單的名稱一律取不到值；該次對話沒有值時，那一條標頭不會送出；只支援單層名稱，不支援 a.b。

新增私有 MCP 伺服器

公司自建或第三方的 MCP 伺服器不在清單中時，可以新增為組織私有的連接器，只有你們組織看得到。在本頁新增的伺服器使用 OAuth 2.0 認證。

1. 按右上角 新增連接器。

2. 填寫 名稱（英文字母、數字、底線、連字符）與 伺服器 URL（必須是 https://）；顯示名稱、描述、工具類別、Logo（PNG、JPG、GIF、WebP、SVG，2 MB 以內）可選填。

3. 授權伺服器無法自動偵測時，再填 OAuth 伺服器 URL、Resource Identifier、OAuth Client ID、OAuth Client Secret。各欄位說明見 MCP 工具設定。

4. 按 確認。系統會先測試能否連上伺服器，失敗時顯示錯誤原因（或 連線測試失敗），不會建立；成功時顯示 已成功新增伺服器，連接器自動啟用，來源標示為 組織自訂。

同一批組織自訂連接器也會出現在 工具 頁的 管理連接器，兩邊修改的是同一份資料。

編輯與刪除

• 編輯：會影響所有使用相同 MCP 伺服器網址的工具。變更 伺服器 URL 會讓這些工具對不上而失去授權，請謹慎修改。

• 刪除：成員與聯絡人對這個連接器的授權會一併移除。若有工具使用這個連接器，確認視窗會列出受影響的工具與將被撤銷的授權數，按 一併刪除 會連同這些工具一起刪除。

常見問題

已經啟用了，成員仍看不到授權按鈕？

請成員打開 管理我的連接器 看狀態。顯示 角色未開放 時，到成員角色的 MaiGPT 使用權限開放這個連接器，見 開放給角色。

成員端顯示「需管理員設定」？

這是 Service Account 連接器還沒有認證標頭。點該列的設定圖示填入 認證標頭 並儲存，成員即可使用。

撤銷授權時出現錯誤？

「僅組織擁有者可以撤銷成員授權」代表你不是組織擁有者；「只能撤銷 OAuth 類型連接器的授權」代表這個連接器不是成員各自授權的類型。

頁面上方的申請提示一直沒消失？

若該連接器早已啟用，申請者遇到的是角色限制。打開開關無法消解這類申請，請改到申請者的角色開放這個連接器。

延伸閱讀

• 連接器（成員端）

• MaiGPT 角色使用權限

• MCP 工具設定

• 通知中心