Adicione um servidor Model Context Protocol (MCP) ao seu agente como ferramenta (prévia)

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

O Protocolo de Contexto do Modelo (MCP) é um padrão para expor ferramentas a um agente. Quando você adiciona um servidor MCP ao seu agente, toda ferramenta que o servidor expõe fica disponível para o agente invocar durante uma conversa.

Note

Os recursos deste artigo são usados por agentes ou fluxos de trabalho alimentados pelo GitHub Copilot.

A cobrança por uso se aplica ao uso, criação, teste e avaliação de agentes. Essas ações podem consumir Créditos do Copilot. Saiba mais em Gerenciar os custos de agentes viabilizados pelo GitHub Copilot harness.

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. Consulte Criar um agente.
  • A URL de um servidor MCP que pode ser alcançado pelo Copilot Studio. Se você ainda não tem um, veja Criar um novo servidor Model Context Protocol (MCP).
  • Quaisquer credenciais exigidas pelo servidor (por exemplo, uma chave de API ou um ID de cliente e segredo para um esquema de autenticação suportado).

Adicione um servidor MCP na aba Build

  1. Faça login no Copilot Studio e abra seu agente.

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

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

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

  5. Na página Adicionar servidor MCP , insira 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 do que o servidor faz e quando o agente deve usá-lo.
    • URL do servidor: o endpoint HTTPS do servidor MCP.
    • Autenticação: escolha o método de autenticação que o servidor exige e insira as credenciais ou valores de configuração que esse método precisa.

  6. Selecione Adicionar para conectar.

    O Copilot Studio entra em contato com o servidor MCP, negocia o protocolo handshake e então lista as ferramentas que o servidor expõe.

  7. Revise a lista de ferramentas que aparecem.

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

  8. Selecione Salvar para terminar de adicionar o servidor.

O servidor aparece na lista de Ferramentas do agente na aba Build .

Testar o servidor

Depois de adicionar o servidor, teste antes de publicar o agente.

  1. Selecione a aba Prévia.

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

  3. Examine a resposta do agente. Abra o rastreamento de atividade para verificar qual ferramenta foi invocada, quais argumentos foram passados e o que a ferramenta retornou. Veja Use o rastreamento de atividade para depurar seu agente.

Se o agente não invocar a ferramenta quando você espera, refine o nome da ferramenta, a descrição da ferramenta ou as instruções do agente. Veja Configurar detalhes e instruções do agente.

Gerencie o servidor depois de adicioná-lo

Para remover um servidor MCP ou desligar um temporariamente, use o fluxo padrão de gerenciamento de ferramentas. Veja Gerenciar e excluir ferramentas em um agente.

Se a URL, autenticação ou ferramentas expostas de um servidor mudarem após você adicioná-lo, edite a entrada do servidor na mesma caixa de diálogo Ferramentas para atualizar a conexão e releia a lista de ferramentas.

Limites

  • Cada agente pode se conectar a múltiplos servidores MCP, mas o número total de instâncias de servidor MCP que podem rodar simultaneamente em uma única conversa é limitado. Se você anexar mais servidores MCP do que o limite permite e o agente tentar usar todos no mesmo turno, os servidores excedentes são ignorados e suas ferramentas não ficam disponíveis naquele turno.
  • Mantenha o número de servidores MCP ligados a qualquer agente simples pequeno e remova os servidores que você não usa mais, para que o agente tenha espaço para invocar os servidores que você valoriza.
  • Cada servidor MCP conta contra o número total de ferramentas que um agente pode hospedar.
  • Last updated on