Use as experiências dos desenvolvedores para gerenciar servidores MCP

O Microsoft Agent 365 fornece infraestrutura para que desenvolvedores descubram, configurem, testem e governem servidores do Protocolo de Contexto de Modelo (MCP). Use estas experiências para adicionar servidores MCP hospedados pela Microsoft a um agente personalizado, construir um servidor focado em cenários, registrar um servidor remoto existente para governança ou conectar um servidor a um cliente de desenvolvedor.

Para uma introdução às opções disponíveis de servidores MCP, veja Compreender as opções de servidores MCP no Agente 365.

Escolha uma experiência de desenvolvedor

Objetivo	Experiência do desenvolvedor
Adicione servidores MCP hospedados na Microsoft a um agente que você possua e execute	Use o SDK e a CLI do Agent 365 para descobrir servidores, gerar um manifesto de ferramentas, configurar permissões e integrar ferramentas com o orquestrador do agente.
Avalie um servidor MCP antes de integrá-lo ou publicá-lo	Use o Agent 365 CLI para inspecionar os esquemas das ferramentas do servidor e gerar um relatório de qualidade.
Construa um servidor MCP focado em cenários a partir de conectores, APIs Microsoft Graph, APIs personalizadas do Dataverse ou APIs REST	Use o servidor de gerenciamento MCP do Microsoft.
Registre um servidor MCP remoto existente para governança centralizada	Use o Agent 365 CLI para submeter o servidor e depois peça para um administrador revisá-lo no Centro de administração do Microsoft 365.
Conecte um servidor MCP diretamente a um cliente de desenvolvedor ou plataforma de agente	Use o suporte MCP embutido do cliente e as orientações de configuração para esse cliente.

Adicionar servidores MCP a um agente personalizado

O módulo de ferramentas Agent 365 e a CLI fornecem a configuração e integração em tempo de execução para agentes personalizados. O fluxo de trabalho padrão é:

1. Descubra e selecione servidores MCP hospedados pela Microsoft com a CLI do Agente 365.
2. Gerar o ToolingManifest.json arquivo que descreve os servidores selecionados.
3. Aplique as permissões necessárias ao blueprint do agente.
4. Carregue o manifesto e registre as ferramentas com o orquestrador do agente usando o SDK do Agent 365.
5. Teste invocações de ferramentas e revise os dados de rastreamento antes da implantação.

A autenticação pode usar uma identidade de agente ou permissões de usuário delegadas por On-Behalf-Of (OBO), dependendo do agente e do servidor. Para obter diretrizes de implementação, consulte:

• Adicione e gerencie ferramentas.
• Permissões de identidade do Agente 365 e fluxo de runtime.
• Amostras do Agente 365.

Avalie um servidor MCP

Use a CLI do Agent 365 para avaliar um servidor MCP local ou remoto antes de integrá-lo ou publicá-lo. O a365 develop-mcp evaluate comando descobre as ferramentas do servidor, executa verificações determinísticas e pontuadas por IA em seus esquemas, e gera um relatório HTML com melhorias priorizadas.

Para opções de comando e exemplos, veja develop-mcp evaluate. Para o fluxo de trabalho de revisão mais amplo, veja Avaliar servidores MCP.

Construa um servidor MCP focado em cenários

O servidor MCP de gerenciamento MCP da Microsoft é uma plataforma de desenvolvimento com API em primeiro lugar para criar e gerenciar servidores MCP personalizados. Suas ferramentas suportam operações como criação de servidor, adição de ferramentas com conectores ou API, atualização de definições de ferramentas, publicação do servidor e exclusão dele.

Use essa experiência quando quiser compor um conjunto focado de ferramentas a partir de:

• Conectores do Power Platform.
• APIs do Microsoft Graph.
• APIs personalizadas do Dataverse.
• REST APIs

Para o endpoint do servidor, permissões e referência completa da ferramenta, veja referência do servidor MCP de gerenciamento Microsoft MCP.

Registre um servidor MCP próprio

Registre um servidor MCP remoto existente com a CLI do Agente 365 quando o servidor deve estar disponível por meio do control plane do Agente 365. O cadastro cria uma solicitação que um administrador analisa no Centro de administração do Microsoft 365. Após aprovação e consentimento da Microsoft Entra, os clientes suportados podem usar o servidor por meio do Gateway de Ferramentas Agent 365, e as equipes de segurança podem monitorar invocações no Microsoft Defender.

Se as identidades dos agentes para um blueprint não tiverem a permissão do Tools.ListInvoke.All servidor MCP BYO, um Administrador Global pode identificar e conceder acesso com a365 develop-mcp grant-agents-access. Para opções de comando e comportamento de permissões, veja develop-mcp grant-agents-access.

Para comandos de registro, opções de autenticação, etapas de aprovação e clientes atualmente suportados, veja Bring your own (BYO) MCP server no Centro de administração do Microsoft 365.

Conecte servidores MCP a clientes desenvolvedores

Muitas plataformas de agentes e clientes de codificação incluem suporte nativo a MCP. Siga a documentação do servidor e do cliente em vez de duplicar sua autenticação e configuração na sua aplicação:

• Conecte agentes aos servidores MCP no Microsoft Foundry.
• Conecte um servidor MCP existente a um agente do Copilot Studio.
• Conecte a CLI do GitHub Copilot ao Work IQ MCP.
• Adicionar e gerenciar servidores MCP no Visual Studio Code.

O modelo de autenticação do servidor, as permissões, o licenciamento e as ferramentas suportadas ainda se aplicam quando você usa um cliente com suporte MCP embutido. Para publicar um servidor para uso mais amplo pelos clientes, veja a certificação de servidor Microsoft MCP (prévia).