建置或重複使用 MCP 伺服器

使用元件規劃中的 MCP 伺服器決策來提供遠端託管的工具或資源。 執行中的 MCP 伺服器與外掛程式套件保持分開,因此您必須實作或確認遠端執行階段和支援的目標 Microsoft 體驗連線。

重複使用 MCP 伺服器

建立伺服器之前:

  1. 識別已核准的 MCP 伺服器,該伺服器會公開必要的工具或資源。
  2. 檢閱其工具定義、輸入、輸出、錯誤、註釋和確認行為。
  3. 目標 Microsoft 體驗支援其傳輸、驗證模型和通訊協定功能。
  4. 確認伺服器擁有者、端點、版本、可用性、資料處理、支援和變更程序。
  5. 取得存取權並設定開發或測試連線。
  6. 測試代表探索、驗證、叫用和失敗案例。

參照 MCP 伺服器不會轉移其操作責任。 重複使用之前,請先記錄服務擁有者和支援合約。

建置和操作 MCP 伺服器

當沒有已核准的伺服器符合需求時,請建置新的 MCP 伺服器。

  1. 僅實作元件規劃所需的工具和資源。
  2. 定義清晰的名稱、描述、輸入、輸出、錯誤和安全註釋。
  3. 實作驗證、授權、資料存取和最低權限行為。
  4. 設定主控、網路、密碼、記錄、監視、調整規模和事件回應。
  5. 設定通訊協定行為和文件相容性期望的版本。
  6. 在將伺服器連線到 Microsoft 體驗之前,先獨立測試伺服器。

GitHub Copilot 可以協助處理伺服器程式碼、結構描述、測試和存放庫變更。 它本身不提供 MCP 執行階段、主控、驗證或 Microsoft 365 連線。

連線伺服器

使用所選開發工具和目標體驗所支援的整合。

注意

使用 WIQD 建立參考遠端 MCP 伺服器的外掛程式。 如需透過 Microsoft 365 應用程式資訊清單中的陣列進行agentConnectors手動設定,請參閱為 Microsoft 365 Copilot 外掛程式設定遠端 MCP 伺服器。 此設定與用於宣告式代理程式動作的 MCP 外掛程式資訊清單不同。 支援取決於目標體驗。

開發方法 開始使用
建議 (支援的專業程式碼案例使用 Work IQ 開發工具) 使用 Work IQ 開發工具構建插件;針對代理程式動作,請使用 WIQD 代理程式動作工作流程
使用 Agents Toolkit 的現有宣告式代理程式專案 工具組型 MCP 整合逐步解說
Copilot Studio Microsoft Copilot Studio 文件
互動式 MCP 回應 將 MCP 應用程式新增至宣告式代理程式
使用 Agent 365 CLI 進行 BYO 遠端 MCP 伺服器註冊 在代理程式工具中註冊遠端 MCP 伺服器

重要

Agent 365 CLI BYO MCP 路由處於預覽階段,使用與針對 Microsoft 365 宣告式代理程式封裝之 MCP 外掛程式不同的註冊和管理模型。 記載的支援用戶端為 Copilot Studio、Visual Studio Code、Claude Code 和 GitHub Copilot CLI。 此路由不支援 Microsoft 365 宣告式代理程式。 系統管理員使用代理程式工具來檢閱、核准、同意、封鎖及監視已註冊的伺服器。

Work IQ 開發工具

wiqd plugin add connector此命令會將遠端 MCP 連接器新增至 WIQD 外掛程式套件。 記載的伺服器需求包括:

  • 使用 TLS 1.2 或更新版本的 HTTPS。
  • 使用 JSON-RPC 2.0 的可串流 HTTP 傳輸。
  • tools/list支援 和 tools/call。
  • 在 30 秒內完成的工具呼叫。

針對資訊清單版本 1.29 的 WIQD 架構,其中 mcpToolDescription 為選用。 如果您包含工具描述檔案,請將其相對於 的appPackagewiqd plugin add connector --tool-description <relative-file-path>路徑與所需的連接器選項一起傳遞。 必須以 ZIP 格式包含參照的檔案。 如需目前的 Cowork 探索行為和套件需求,請參閱為 Copilot Cowork 建置外掛程式。

對於 OAuth 或 API 金鑰驗證,請先註冊認證,然後只將其參考識別碼新增至套件。 請勿將用戶端密碼、API 金鑰或權杖放在資訊清單中。 請參閱 WIQD 外掛程式製作參考。

針對 WIQD 外掛程式套件路由, 請在 Microsoft 365 應用程式資訊清單中設定驗證和工具探索。 如果您改為將伺服器作為 MCP 動作新增至宣告式代理程式,請使用代理程式的代理 程式動作驗證 和 動態探索或固定工具。 遵循所選整合的需求,而不是在資訊清單模型之間複製設定。

確認 MCP 功能可正常運作

在下列情況下,MCP 伺服器及其連線已準備好整合:

  • 端點可從開發或測試環境取得。
  • 目標體驗可以探索到所需的工具或資源。
  • 代表性作業會傳回預期的結構化結果。
  • 驗證、授權、同意和權限會如預期般運作。
  • 確認、逾時、不可用服務、無效輸入和部分失敗行為是可以理解的。
  • 記錄和監視提供足夠的資訊來診斷失敗。
  • 記錄伺服器擁有者、版本、端點、主控、相依性、限制和測試證據。

當伺服器在開發期間無法公開連線時,請使用 本機 MCP 和 API 偵錯 。

繼續進行計劃中的任何其他元件。 完成後, 請整合並測試您的元件。