Microsoft MCP 管理伺服器參考資料(預覽)

Note

本文說明由標準執行架構驅動的 Agent 或 Agent 流程中所使用的功能。

Important

這是預覽功能。

  • Microsoft 會在正式發行前釋出預覽功能,讓客戶能搶先體驗並提供回饋。
  • 預覽功能功能有限,且不適合生產環境使用。
  • Microsoft 可能會更改預覽版 MCP 工具名稱和參數。 避免硬編碼的相依關係。 Microsoft 維持情境支援。
  • 預覽功能須遵守Microsoft補充使用條款。

概觀

伺服器識別碼 顯示名稱 Scope
MCPManagement Microsoft 管理 MCP 伺服器 McpServers.Management.All

可用工具

MCP 伺服器管理工具

GetMCPServers

取得目前環境中所有 MCP 伺服器實例。

輸入結構:無需參數

GetMCPServer

能獲得特定 MCP 伺服器的詳細資訊。

必要參數:

  • mcpServerName (字串):要擷取之 MCP 伺服器的唯一名稱

CreateMCPServer

在目前環境中建立一個新的 MCP 伺服器實例。

必要參數:

  • serverName (字串):新 MCP 伺服器的名稱(不得包含空白)

選擇性參數:

  • displayName (字串):MCP 伺服器的可選顯示名稱

  • 描述 (字串):該伺服器用途的可選描述

  • scope (字串):MCP 伺服器的可選範圍

  • audience (字串):MCP 伺服器的可選受眾

更新MCPServer

更新現有的 MCP 伺服器實例。

必要參數:

  • mcpServerName (字串):唯一要更新的 MCP 伺服器名稱

選擇性參數:

  • serverName (字串):MCP 伺服器可選的新名稱

  • 描述 (字串):MCP 伺服器的可選新描述

DeleteMCPServer

刪除一個 MCP 伺服器實例。

必要參數:

  • mcpServerName (字串):唯一需要刪除的 MCP 伺服器名稱

BlockMCPServer

封鎖已發佈的 MCP 伺服器。

必要參數:

  • mcpServerName (字串):要封鎖的 MCP 伺服器名稱

工具管理

GetTools

獲取特定 MCP 伺服器中的所有工具。

必要參數:

  • mcpServerName(字串):用於從 MCP 伺服器獲取工具的唯一名稱。

GetTool

能獲得特定工具的詳細資訊。

必要參數:

  • mcpServerName (字串):包含該工具的 MCP 伺服器唯一名稱

  • toolName (字串):要檢索工具的唯一名稱

更新工具

更新 MCP 伺服器中現有的工具。

必要參數:

  • mcpServerName (字串):包含該工具的 MCP 伺服器唯一名稱

  • toolName (字串):唯一要更新的工具名稱

選擇性參數:

  • 描述 (字串):工具的可選新描述

  • inputSchema (字串):可選的 JSON 結構,定義工具的輸入參數

  • customAPIId (字串):可選的自訂 API 識別碼,用於與此工具關聯

  • 註解 (字串):工具可選的 JSON 註解

刪除工具

從 MCP 伺服器刪除一個工具。

必要參數:

  • mcpServerName (字串):包含該工具的 MCP 伺服器唯一名稱

  • toolName (字串):唯一需要刪除的工具名稱

自訂 API 工具

GetCustomAPIs

取得目前環境中所有可用的自訂 API。

輸入結構:無需參數

CreateToolWithCustomAPI(使用自定義API建立工具)

  • 在 MCP 伺服器中建立一個帶有自訂 API 的新工具。

必要參數:

  • mcpServerName (字串):將工具加入的唯一 MCP 伺服器名稱。

  • customAPIId (字串):用於與此工具關聯的自訂 API 唯一識別碼

選擇性參數:

  • toolName (字串):工具的可選名稱。 如果你沒有提供這個參數,就會使用自訂的 API 唯一名稱。

  • 描述(字串):此工具功能的可選描述

SDK 訊息工具

CreateToolWithSdkMessage

在 MCP 伺服器中使用 sdkMessage 建立新工具。

必要參數:

  • mcpServerId (字串):MCP 伺服器唯一識別碼,用於新增工具。

  • sdkMessagepairId (字串):與此工具關聯的唯一識別碼 sdkMessage 。

選擇性參數:

  • toolName (字串):工具的可選名稱。 如果你沒有提供名稱,工具就會使用 sdkMessage 唯一的名稱。

  • 描述 (字串):此工具功能的可選描述。

遠端 API 工具

CreateToolWithRemoteAPI (使用遠端 API 建立工具)

在 MCP 伺服器中建立一個帶有遠端 API 的新工具。

必要參數:

  • mcpServerName (字串):將工具加入的唯一 MCP 伺服器名稱。

  • remoteApiId (字串):遠端 API 的 ID。

選擇性參數:

  • toolName (字串):工具的可選名稱。 如果你沒有提供這個參數,就會使用自訂的 API 唯一名稱。

  • 描述 (字串):此工具功能的可選描述。

連接器工具

GetConnectorsAsync

取得所有連接器。

輸入結構:無需參數

GetConnectorAsync

取得特定連接器。

必要參數:

  • connectorId (字串):要檢索連接器的唯一名稱

GetConnectorOperationsAsync

取得特定連接器的作業。

必要參數:

  • connectorId (字串):要檢索連接器的唯一名稱

創建具有連接器的工具

在 MCP 伺服器中建立一個帶有連接器的新工具。

必要參數:

  • 工具名稱 (字串):工具名稱

  • mcpServerName (字串):將工具加入的唯一 MCP 伺服器名稱。

  • connectorId (字串):與此工具關聯的連接器名稱

  • operationId (字串):連接器操作的唯一識別碼,用於與此工具關聯

選擇性參數:

  • 描述 (字串):此工具功能的可選描述。

圖形 API 工具

GetGraphApisAsync

能取得所有 Microsoft Graph API。

輸入結構:無需參數

CreateToolWithGraph

在 MCP 伺服器上建立一個包含圖形 API 操作的新工具。

必要參數:

  • toolId (字串):ToolID

  • mcpServerName (字串):將工具加入的唯一 MCP 伺服器名稱。

選擇性參數:

  • toolName (字串):(可選)工具要設定的名稱

  • 描述 (字串):(可選)工具要設定的描述

Dataverse 環境工具

ListDataverseEnvironments

列出所有可用的 Dataverse 環境。

輸入結構:無需參數

ListMCPServersInDataverseEnvironment

列出特定 Dataverse 環境中的所有 MCP 伺服器。

必要參數:

  • envId (字串):用來列出 MCP 伺服器的環境 ID。