MCP 串接與安全

Model Context Protocol（MCP）是一套連線 AI 應用程式與外部系統的開放協議。相容用戶端可以透過 MCP Server 取得上下文、呼叫工具或使用預定義提示，而不必為每一種資料源個別設計串接協議。

MCP 如何工作

一個 MCP Host 可以連線多個 MCP Server，並為每個 Server 建立獨立的 MCP Client。

MCP 分為資料層和傳輸層：資料層定義 JSON-RPC 訊息、能力發現和 Primitives；傳輸層負責訊息如何在本機程序或網路之間傳遞。用戶端通常會封裝這些協議細節，串接時應優先使用用戶端提供的 MCP 設定入口。

Server 可以提供什麼

MCP Server 主要暴露三類 Primitives：

Server 會聲明自己支援的能力，用戶端再發現可用的 Tools、Resources 和 Prompts。Server 提供某項能力不代表用戶端一定會啟用；最終行為還取決於 Host 的版本、權限策略和使用者選擇。

選擇傳輸方式

目前 MCP 規範定義了 stdio 和 Streamable HTTP 兩種標準傳輸。

對於 stdio，Server 的 stdout 只能輸出 MCP 訊息，記錄應寫入 stderr。出現連線失敗時，可以檢查用戶端捕獲的 stderr 記錄，但不要把包含憑證的完整記錄傳送給第三方。

目前 Streamable HTTP 使用單一 POST Endpoint，不需要個別設定 GET 或舊式 HTTP+SSE 地址。驗證方式由 Server 決定；如果 Server 提供 OAuth 流程，應優先按照其授權頁面完成驗證，而不是把長期憑證直接寫入共享設定。

理解設定結構

不同用戶端的欄位名稱和設定位置並不完全相同。下面只展示常見結構，不能直接執行；請使用 Server 發佈者提供的真實命令、參數、URL 和驗證方式替換所有預留位置。

{
  "mcpServers": {
    "replace-with-server-name": {
      "command": "/absolute/path/to/server-command",
      "args": [
        "--replace-with-required-argument"
      ],
      "env": {
        "SERVICE_API_KEY": "replace-with-client-supported-secret-reference"
      }
    }
  }
}

安全串接步驟

權限審查清單

對於遠端 Server，只連線可信 HTTPS 地址並按其驗證流程授權。對於本機 Server，優先使用絕對命令路徑、隔離目錄和一般使用者權限，不要為了方便直接使用管理員權限執行。

常見問題

持續使用建議

• 定期複查已連線的 Server、版本、Tool 清單和授權範圍；
• 為不同 Server 使用獨立、可撤銷、最小權限的憑證；
• 保持人工確認，尤其是刪除、寫入、付款、訊息傳送和正式環境系統操作；
• 不把未知 Resource 或 Tool 結果中的指令當作可信系統指令；
• 記錄、截圖和錯誤報告必須移除 Key、Token、客戶資料和敏感路徑；
• 停止使用 Server 時，從用戶端移除設定並撤銷相關憑證。

需要為模型用戶端設定 AGTCloud 時，請從 CC-Switch 整合教學開始，或在左側“第三方整合”目錄中選擇具體工具；需要理解模型端點和請求欄位時，請檢視 API Reference。MCP 的協議細節和版本變化請以 MCP 官方文件為準。