MCP 整合：建立、保存與撤銷金鑰

MCP 讓支援此連線方式的外部軟體使用初本的指定功能。「金鑰」是連線憑證；請當成密碼保存，不要放入截圖或貼給其他人。

跟著做：建立個人 MCP 金鑰

開始前準備： 工作空間擁有者已在啟用工具開啟 MCP，您在該工作空間具有所需權限，並有安全保存金鑰的位置。

1. 開啟「使用者設定 → API 整合 → MCP 整合」。
2. 按「建立 MCP API 金鑰」。
3. 在對話框核對「工作空間」，輸入「金鑰名稱」，例如「範例帳務查詢」，最多 100 字。
4. 在「啟用工具」閱讀說明，至少勾選一項需要的工具。更換工作空間會清空工具選取，請重新核對。
5. 按「建立金鑰」。完整金鑰只在此刻的對話框顯示一次。
6. 按「複製金鑰」，存入安全位置，確認保存完整後按「我已安全保存」。
7. 回到清單，核對名稱、工作空間、工具及「使用中」狀態。

完成結果： 個人金鑰已建立。接著依用戶端支援方式連線；建立金鑰不等於已完成外部授權。

表單欄位

欄位	必填／選填	預設值或條件
工作空間	必選	對話框預選第一個可用工作空間。
金鑰名稱	必填	預設「MCP 用戶端」，最多 100 字。
啟用工具	必選	至少一項；更換工作空間會清空選取。
MCP 金鑰	必選	外部授權畫面須選擇有效金鑰。
驗證碼	必填	外部授權畫面輸入六位英文字母或數字。

操作指南

連線到外部軟體

本頁「MCP 端點」是提供給外部軟體的連線網址。將畫面顯示的完整網址填入支援 MCP 的外部軟體，再依該軟體的操作開始連線。

若軟體使用登入授權（OAuth），初本會顯示登入與授權畫面，讓您確認外部軟體可以使用哪些功能。

OAuth 授權流程會選擇既有金鑰，並以一次性驗證碼確認身分；授權畫面不提供新增工具。先在本頁建立符合用途的金鑰，再進入授權。其他連線方式請由導入顧問或系統管理員參考MCP 連線指南。

附件下載與批次操作

附件下載使用 file_download_token_create，須由工作空間政策、個人金鑰與連線明確授權；操作人須有原始憑證檢視權限。設定方式見MCP 管理指南。

支援的資源工具可使用 items 批次輸入，授權仍逐項檢查。批次執行可能部分成功，不能看到整批錯誤便重送所有項目；請核對批次結果。檔案下載憑證仍限單筆。

查看與撤銷金鑰

按「查看工具」檢查該金鑰的工具範圍。停止使用時，在對應列按「撤銷」，閱讀提示再按「確認撤銷」。成功後狀態變成「已撤銷」；使用該金鑰建立的 MCP 連線也會失效。

遺失、複製失敗或沒有可用工作空間

關閉建立視窗後無法再次查看完整金鑰；遺失時撤銷舊金鑰並建立新金鑰。自動複製失敗且視窗仍開著時，手動選取並複製完整值。

沒有可建立金鑰的工作空間時，請擁有者先啟用 MCP。工具清單為空時，核對工作空間政策及自己的權限。建立時必須選工作空間、填名稱並至少選一項工具。

觀念說明

每把金鑰屬於指定工作空間並帶有選定工具。關閉建立視窗後無法再次查看完整金鑰；遺失時須撤銷並重新建立。工具範圍還受工作空間政策及本人權限限制。若只需要停止某筆 OAuth 連線，可到個人授權連線撤銷該筆；要讓金鑰及其連線一併失效則撤銷金鑰。

使用 AI 用戶端時，可接著閱讀 AI Agent 連線教學，完成設定後練習第一次查詢。