Criar ou reutilizar servidores MCP

Use a decisão do servidor MCP do plano do componente para fornecer ferramentas ou recursos hospedados remotamente. O servidor MCP em execução permanece separado do pacote de plug-ins, portanto, você deve implementar ou confirmar o tempo de execução remoto e a conexão com suporte com a experiência de destino da Microsoft.

Reutilizar um servidor MCP

Antes de criar um servidor:

  1. Identifique um servidor MCP aprovado que exponha as ferramentas ou recursos necessários.
  2. Revise suas definições de ferramenta, entradas, saídas, erros, anotações e comportamento de confirmação.
  3. Confirme se os recursos de transporte, modelo de autenticação e protocolo são compatíveis com a experiência de destino da Microsoft.
  4. Confirme o proprietário do servidor, o ponto de extremidade, a versão, a disponibilidade, o tratamento de dados, o suporte e o processo de alteração.
  5. Obtenha acesso e configure a conexão de desenvolvimento ou teste.
  6. Teste cenários representativos de descoberta, autenticação, invocação e falha.

Fazer referência a um servidor MCP não transfere a responsabilidade por operá-lo. Registre o proprietário do serviço e o contrato de suporte antes de reutilizá-lo.

Criar e operar um servidor MCP

Crie um novo servidor MCP quando nenhum servidor aprovado atender ao requisito.

  1. Implemente apenas as ferramentas e os recursos exigidos pelo plano de componente.
  2. Defina nomes, descrições, entradas, saídas, erros e anotações de segurança claros.
  3. Implemente autenticação, autorização, acesso a dados e comportamento com privilégios mínimos.
  4. Configure hospedagem, rede, segredos, registro em log, monitoramento, dimensionamento e resposta a incidentes.
  5. Versão do comportamento do protocolo e expectativas de compatibilidade de documentos.
  6. Teste o servidor de forma independente antes de conectá-lo a uma experiência da Microsoft.

O GitHub Copilot pode ajudar com o código do servidor, esquemas, testes e alterações no repositório. Ele não fornece o tempo de execução, a hospedagem, a autenticação ou a conexão do Microsoft 365 do MCP por si só.

Conectar o servidor

Use a integração compatível com a ferramenta de desenvolvimento selecionada e a experiência de destino.

Observação

Use o WIQD para criar um plug-in que faça referência a um servidor MCP remoto. Para obter a configuração manual por meio da agentConnectors matriz no manifesto do aplicativo Microsoft 365, confira Configurar servidores MCP remotos para plug-ins do Microsoft 365 Copilot. Essa configuração difere do manifesto do plug-in MCP usado para ações de agente declarativo. O suporte depende da experiência de destino.

Abordagem de desenvolvimento Comece com
Ferramentas de desenvolvimento do Work IQ (recomendado para cenários de código profissional com suporte) Crie um plugin com o Work IQ Dev Tools; para uma ação do agente, use o fluxo de trabalho de ação do agente WIQD
Projeto de agente declarativo existente usando o Agents Toolkit Passo a passo da integração do MCP baseada em kit de ferramentas
Copilot Studio Documentação do Microsoft Copilot Studio
Resposta MCP interativa Adicionar aplicativos MCP a agentes declarativos
Registro do servidor MCP remoto BYO com a CLI do Agent 365 Registrar um servidor MCP remoto em Ferramentas de Agente

Importante

A rota MCP do Agent 365 CLI BYO está em visualização e usa um modelo separado de registro e administração de um plug-in MCP empacotado para um agente declarativo do Microsoft 365. Os clientes com suporte documentados são o Copilot Studio, o Visual Studio Code, o Claude Code e o CLI do GitHub Copilot. Os agentes declarativos do Microsoft 365 não têm suporte por essa rota. Os administradores usam as Ferramentas do Agente para revisar, aprovar, consentir, bloquear e monitorar o servidor registrado.

Ferramentas de desenvolvimento do Work IQ

O wiqd plugin add connector comando adiciona um conector MCP remoto a um pacote de plug-ins WIQD. Os requisitos de servidor documentados incluem:

  • HTTPS com TLS 1.2 ou posterior.
  • Transporte HTTP transmitido usando JSON-RPC 2.0.
  • Suporte para tools/list e tools/call.
  • Chamadas de ferramenta que são concluídas em menos de 30 segundos.

Scaffolds WIQD contra a versão 1.29 do manifesto, onde mcpToolDescription é opcional. Se você incluir um arquivo de descrição da ferramenta, passe seu caminho relativo a appPackage com wiqd plugin add connector --tool-description <relative-file-path> ao lado das opções de conector necessárias. O arquivo referenciado deve ser incluído no ZIP. Para obter o comportamento atual da descoberta do Cowork e os requisitos de pacote, consulte Criar plug-ins para o Copilot Cowork.

Para autenticação de OAuth ou chave de API, registre a credencial primeiro e adicione apenas seu identificador de referência ao pacote. Não coloque segredos do cliente, chaves de API ou tokens no manifesto. Consulte a referência de criação do plugin WIQD.

Para a rota do pacote de plug-in WIQD, configure a autenticação e a descoberta de ferramentas no manifesto do aplicativo Microsoft 365. Se, em vez disso, você adicionar o servidor como uma ação MCP a um agente declarativo, use a autenticação de ação do agente e a descoberta dinâmica ou ferramentas fixadas para o agente. Siga os requisitos da integração selecionada em vez de copiar a configuração entre os modelos de manifesto.

Confirme se o recurso MCP está funcionando

O servidor MCP e sua conexão estão prontos para integração quando:

  • O ponto de extremidade está disponível no ambiente de desenvolvimento ou teste.
  • As ferramentas ou recursos necessários podem ser descobertos pela experiência de destino.
  • As operações representativas retornam os resultados estruturados esperados.
  • A autenticação, a autorização, o consentimento e as permissões funcionam conforme o esperado.
  • O comportamento de confirmação, tempo limite, serviço indisponível, entrada inválida e falha parcial é compreensível.
  • Logs e monitoramento fornecem informações suficientes para diagnosticar falhas.
  • O proprietário do servidor, a versão, o ponto de extremidade, a hospedagem, as dependências, as limitações e as evidências de teste são registrados.

Use o MCP local e a depuração de API quando o servidor não estiver acessível publicamente durante o desenvolvimento.

Continue com outros componentes do plano. Quando estiverem concluídos, integre e teste seus componentes.