Referência de servidor MCP do gerenciamento MCP da Microsoft (versão preliminar)

Importante

Esta é uma versão preliminar do recurso.

  • Microsoft libera recursos de visualização antes de um lançamento oficial para que os clientes possam obter acesso antecipado e fornecer comentários.
  • Os recursos de visualização têm funcionalidade restrita e não são destinados ao uso de produção.
  • A Microsoft pode alterar os nomes e os parâmetros das ferramentas MCP em versão prévia. Evite dependências codificadas. A Microsoft mantém suporte a cenários.
  • Os recursos de visualização estão sujeitos a Microsoft termos de uso complementares.

Overview

ID de servidor Nome de exibição Scope
MCPManagement Servidor MCP de gerenciamento da Microsoft McpServers.Management.All

Ferramentas disponíveis

Ferramentas de gerenciamento de servidores MCP

GetMCPServers

Obtém todas as instâncias do servidor MCP no ambiente atual.

Esquema de entrada: nenhum parâmetro necessário

GetMCPServer

Recebe informações detalhadas sobre um servidor MCP específico.

Parâmetros requeridos:

  • mcpServerName (string): O nome único do servidor MCP a ser recuperado

CreateMCPServer

Cria uma nova instância de servidor MCP no ambiente atual.

Parâmetros requeridos:

  • Nomedo do servidor (string): O nome do novo servidor MCP (não deve conter espaços em branco)

Parâmetros opcionais:

  • displayName (string): Nome de exibição opcional para o servidor MCP

  • descrição (string): Descrição opcional do que este servidor é usado

  • escopo (string): Escopo opcional para o servidor MCP

  • audiência (string): Audiência opcional para o servidor MCP

Atualizar MCPServer

Atualiza uma instância existente de servidor MCP.

Parâmetros requeridos:

  • mcpServerName (string): O nome único do servidor MCP a ser atualizado

Parâmetros opcionais:

  • Nome do servidor (string): Nome novo opcional para o servidor MCP

  • descrição (string): Nova descrição opcional para o servidor MCP

DeleteMCPServer

Exclui uma instância de servidor MCP.

Parâmetros requeridos:

  • mcpNomeServidor (string): O nome único do servidor MCP a ser excluído

BlockMCPServer

Bloqueia um servidor MCP publicado.

Parâmetros requeridos:

  • mcpNomeServidor (string): O nome do servidor MCP a ser bloqueado

Gerenciamento de ferramentas

GetTools

Recebe todas as ferramentas em um servidor MCP específico.

Parâmetros requeridos:

  • mcpServerName (string): O nome único do servidor MCP para obter ferramentas

GetTool

Recebe informações detalhadas sobre uma ferramenta específica.

Parâmetros requeridos:

  • mcpServerName (string): O nome único do servidor MCP que contém a ferramenta

  • Nome da ferramenta (string): O nome único da ferramenta a ser recuperada

UpdateTool

Atualiza uma ferramenta existente em um servidor MCP.

Parâmetros requeridos:

  • mcpServerName (string): O nome único do servidor MCP que contém a ferramenta

  • Nome da ferramenta (string): O nome único da ferramenta a ser atualizada

Parâmetros opcionais:

  • Descrição (string): Nova descrição opcional para a ferramenta.

  • inputSchema (string): Esquema JSON opcional que define os parâmetros de entrada da ferramenta

  • customAPIId (string): Identificador de API personalizado opcional para associar a esta ferramenta

  • anotações (string): Anotações JSON opcionais para a ferramenta

DeleteTool

Exclui uma ferramenta de um servidor MCP.

Parâmetros requeridos:

  • mcpServerName (string): O nome único do servidor MCP que contém a ferramenta

  • Nome da ferramenta (string): O nome único da ferramenta a excluir

Ferramentas personalizadas de API

GetCustomAPIs

Recebe todas as APIs personalizadas disponíveis no ambiente atual.

Esquema de entrada: nenhum parâmetro necessário

CreateToolWithCustomAPI

  • Cria uma nova ferramenta com uma API personalizada em um servidor MCP.

Parâmetros requeridos:

  • mcpServerName (cadeia de caracteres): o nome exclusivo do servidor MCP ao qual adicionar a ferramenta.

  • customAPIId (string): O identificador único da API personalizada a ser associada a esta ferramenta

Parâmetros opcionais:

  • toolName (cadeia de caracteres): nome opcional para a ferramenta. Se você não fornecer esse parâmetro, o nome exclusivo da API personalizada será usado.

  • descrição (string): Descrição opcional do que essa ferramenta faz

Ferramentas de mensagens SDK

CreateToolWithSdkMessage

Cria uma nova ferramenta com um sdkMessage em um servidor MCP.

Parâmetros requeridos:

  • mcpServerId (cadeia de caracteres): o identificador exclusivo do servidor MCP ao qual adicionar a ferramenta.

  • sdkMessagepairId (cadeia de caracteres): o identificador exclusivo do sdkMessage associado a essa ferramenta.

Parâmetros opcionais:

  • toolName (cadeia de caracteres): nome opcional para a ferramenta. Se você não fornecer um nome, a ferramenta usará o sdkMessage nome exclusivo.

  • descrição (cadeia de caracteres): descrição opcional do que essa ferramenta faz.

Ferramentas remotas de API

CreateToolWithRemoteAPI

Cria uma nova ferramenta com uma API remota em um servidor MCP.

Parâmetros requeridos:

  • mcpServerName (cadeia de caracteres): o nome exclusivo do servidor MCP ao qual adicionar a ferramenta.

  • remoteApiId (cadeia de caracteres): ID da API remota.

Parâmetros opcionais:

  • toolName (cadeia de caracteres): nome opcional para a ferramenta. Se você não fornecer esse parâmetro, o nome exclusivo da API personalizada será usado.

  • descrição (cadeia de caracteres): descrição opcional do que essa ferramenta faz.

Ferramentas do conector

GetConnectorsAsync

Obtém todos os conectores.

Esquema de entrada: nenhum parâmetro necessário

GetConnectorAsync

Obtém um conector específico.

Parâmetros requeridos:

  • connectorId (string): O nome único do conector a ser recuperado

GetConnectorOperationsAsync

Obtém operações para um conector específico.

Parâmetros requeridos:

  • connectorId (string): O nome único do conector a ser recuperado

CreateToolWithConnector

Cria uma nova ferramenta com um conector em um servidor MCP.

Parâmetros requeridos:

  • Nome da ferramenta (string): Nome da ferramenta

  • mcpServerName (cadeia de caracteres): o nome exclusivo do servidor MCP ao qual adicionar a ferramenta.

  • connectorId (string): O nome do conector a ser associado a essa ferramenta

  • operationId (string): O identificador único da operação do conector a ser associada a esta ferramenta

Parâmetros opcionais:

  • descrição (cadeia de caracteres): descrição opcional do que essa ferramenta faz.

ferramentas de API do Graph

GetGraphApisAsync

Obtém todas as APIs do Microsoft Graph.

Esquema de entrada: nenhum parâmetro necessário

CreateToolWithGraph

Cria uma nova ferramenta com uma operação de API do Graph em um servidor MCP.

Parâmetros requeridos:

  • toolId (cadeia de caracteres): ToolId

  • mcpServerName (cadeia de caracteres): o nome exclusivo do servidor MCP ao qual adicionar a ferramenta.

Parâmetros opcionais:

  • Nome da ferramenta (string): (opcional) O nome a ser definido para a ferramenta

  • descrição (string): (opcional) A descrição a ser definida para a ferramenta

Ferramentas de ambiente do Dataverse

ListDataverseEnvironments

Lista todos os ambientes Dataverse disponíveis.

Esquema de entrada: nenhum parâmetro necessário

ListMCPServersInDataverseEnvironment

Lista todos os servidores MCP em um ambiente Dataverse específico.

Parâmetros requeridos:

  • envId (string): O ID do ambiente para listar servidores MCP.