基本原則
外掛程式的工具可以存取使用者資料、呼叫第三方 API,以及執行寫入操作。請以正式環境軟體的標準來開發及維護每個 MCP 伺服器和使用者介面元件。
- 最小權限: 只要求必要的授權範圍、儲存空間存取權和網路權限。
- 使用者明確同意: 連結帳號或授予寫入權限時,請確保使用者清楚知道自己正在做什麼。執行破壞性操作前,請使用主機提供的確認提示。
- 縱深防禦: 假設伺服器一定會收到提示注入攻擊和惡意輸入。檢查每一筆輸入,並保留稽核記錄。
資料處理
- 結構化內容: 只納入處理目前提示詞所需的資料。避免在元件屬性中嵌入機密值或權杖。
- 儲存: 決定使用者資料的保留期限,並公布保留政策。依使用者的刪除要求移除資料。
- 日誌: 寫入日誌前,先遮蔽個人識別資訊(PII)。保留關聯 ID 以便偵錯。除非確有必要,否則請避免儲存提示詞原文。
提示注入與寫入操作
自訂 MCP 伺服器可提供完整的 MCP 存取權,包括使用寫入工具的權限。請採取以下措施降低風險。
- 定期檢視工具說明,清楚標示使用限制以避免誤用,例如「請勿使用此工具刪除記錄」。
- 即使輸入由模型提供,也要在伺服器端驗證每一筆輸入。
- 執行無法復原的操作前,要求人工確認。
將測試提示注入時最有效的提示詞分享給 QA 團隊,讓團隊能及早找出防護弱點。
網路存取
小工具在隔離的 iframe 中執行,並受嚴格的內容安全政策(CSP)約束。小工具無法存取需要特殊權限的瀏覽器 API,例如 window.alert、window.prompt、window.confirm 或 navigator.clipboard。標準的 fetch 請求受 CSP 管控。預設無法使用巢狀框架。如需使用,請在資源的 CSP 中繼資料(例如 _meta.ui.csp.frameDomains)中明確指定允許的來源。外掛程式可以嵌入其 MCP 伺服器所屬可註冊網域下的網頁,包括既有的編輯器和管理介面。關於網域所有權、必須提供的理由及審查要求,請參閱 iframe 政策。
小工具的 CSP 會限制 iframe 可以載入哪些目的地。嵌入的網頁使用自己的 CSP。小工具的 connectDomains 和 resourceDomains 允許清單不會限制該網頁內發出的網路請求。請明確指定允許的 iframe 來源,並將嵌入的網頁及其功能納入安全審查。
伺服器端程式碼的網路存取僅受代管環境限制。對外發送請求時,請遵循一般最佳實務,包括驗證 TLS、設定重試機制和逾時期限。
身分驗證與授權
- 整合外部帳號時,請使用 OAuth 2.1 授權碼流程。若授權伺服器支援用戶端 ID 中繼資料文件(CIMD),且外掛程式開發者選用此方式,請優先採用 CIMD。公開用戶端交換權杖時,請使用
none。若授權伺服器要求驗證用戶端身分,請使用private_key_jwt。若外掛程式開發者選用動態用戶端註冊(DCR),或無法使用 CIMD,則須支援 DCR。 - 每次呼叫工具時,都要驗證授權範圍,並確保操作未超出該範圍。若權杖已過期或格式錯誤,請回傳
401回應。 - 使用內建身分機制時,請避免儲存長期有效的機密值,改用系統提供的驗證上下文。
上線與維運準備
- 上線前進行安全審查,尤其是處理受法規管制的資料時。
- 監控流量是否出現異常模式,並設定警示,以便在錯誤反覆發生或驗證嘗試失敗時收到通知。
- 及時為第三方相依套件、程式庫和建置工具套用修補程式,以降低供應鏈風險。
安全性與隱私是使用者信任的基礎。從規劃、實作到部署,每個階段都應將兩者納入工作流程,避免事後才補做。