Adicione um servidor Model Context Protocol (MCP) ao seu agente como ferramenta (pré-visualização)

[Este artigo é uma documentação de pré-lançamento e está sujeito a alterações.]

O Protocolo de Contexto de Modelo (MCP) é um padrão para expor ferramentas a um agente. Quando adiciona um servidor MCP ao seu agente, todas as ferramentas que o servidor expõe ficam disponíveis para o agente invocar durante uma conversa.

Use este tutorial quando quiser adicionar um servidor MCP a um agente na nova experiência. Para uma visão geral dos tipos de ferramentas na nova experiência, veja Ferramentas disponíveis para agentes.

Pré-requisitos

• Um agente criado na nova experiência. Veja Criar um agente.
• O URL de um servidor MCP acessível a partir do Copilot Studio. Se ainda não tiver um, consulte Criar um novo servidor Model Context Protocol (MCP).
• Quaisquer credenciais exigidas pelo servidor (por exemplo, uma chave API ou um ID de cliente e segredo para um esquema de autenticação suportado).

Adicione um servidor MCP a partir do separador Build

1. Inicie sessão no Copilot Studio e abra o seu agente.

2. Na barra de navegação do agente, selecione o separador Build .

3. No painel de componentes à direita, selecione Ferramentas.

4. No diálogo Adicionar uma ferramenta , selecione Adicionar ao lado da barra de pesquisa e depois selecione Protocolo de Contexto de Modelo (MCP).

5. Na página Adicionar servidor MCP , introduza os seguintes detalhes:

   • Nome: um nome curto e descritivo que ajuda o agente a decidir quando usar as ferramentas deste servidor. Este é o nome que o agente vê.
   • Descrição: um resumo de uma ou duas frases sobre o que o servidor faz e quando o agente deve usá-lo.
   • URL do servidor: o endpoint HTTPS do servidor MCP.
   • Autenticação: escolher o método de autenticação que o servidor necessita e inserir as credenciais ou valores de configuração que esse método necessita.

6. Selecionar Adicionar para ligar.

   O Copilot Studio contacta o servidor MCP, negocia o handshake do protocolo e depois lista as ferramentas que o servidor expõe.

7. Veja a lista de ferramentas que aparecem.

   Para cada ferramenta, verifique o nome e a descrição. Se uma ferramenta não tiver uma descrição clara, as respostas dos agentes que envolvem a ferramenta são menos fiáveis. Pede ao autor do servidor MCP para melhorar a descrição antes de confiares na ferramenta em produção.

8. Selecione Guardar para terminar de adicionar o servidor.

O servidor aparece na lista Ferramentas do agente, no separador Compilação.

Testa o servidor

Depois de adicionares o servidor, testa-o antes de publicares o agente.

1. Selecione o separador Pré-visualização .

2. Faça uma pergunta ao agente que exija uma das ferramentas do servidor.

3. Revise a resposta do agente. Abra o rastreio de atividade para verificar qual ferramenta foi invocada, que argumentos foram passados e o que a ferramenta devolveu. Veja : Use o rastreio de atividade para depurar o seu agente.

Se o agente não invocar a ferramenta quando esperas, refina o nome da ferramenta, a descrição da ferramenta ou as instruções do agente. Consulte Configurar detalhes e instruções do agente.

Gerir o servidor depois de o adicionar

Para remover um servidor MCP ou desligar um temporariamente, use o fluxo padrão de gestão de ferramentas. Veja Gerenciar e eliminar ferramentas num agente.

Se o URL, autenticação ou ferramentas expostas de um servidor mudarem depois de o adicionar, edite a entrada do servidor na mesma caixa de diálogo Ferramentas para atualizar a ligação e leia novamente a lista de ferramentas.

Limits

• Cada agente pode ligar-se a múltiplos servidores MCP, mas o número total de instâncias de servidor MCP que podem correr simultaneamente numa única conversa é limitado. Se adicionares mais servidores MCP do que o limite máximo permite e o agente tentar usá-los todos na mesma interação, os servidores adicionais são ignorados e as respetivas ferramentas não ficam disponíveis nessa interação.
• Mantenha pequeno o número de servidores MCP ligados a qualquer agente individual e remova os servidores que já não usa, para que o agente tenha espaço para invocar os servidores que lhe interessam.
• Cada servidor MCP conta contra o número total de ferramentas que um agente pode alojar.

Informações relacionadas

• Visão geral das ferramentas para agentes
• Ferramentas disponíveis para agentes
• Adicionar uma ferramenta a um agente
• Gerir e eliminar ferramentas num agente
• Criar um novo servidor Model Context Protocol (MCP)
• Protocolo de Contexto de Modelo (MCP) na visão geral do Copilot Studio