Conecte seu agente a um servidor MCP (Model Context Protocol) existente

Se já configurou um servidor Model Context Protocol (MCP), pode ligar o servidor MCP ao seu agente.

Pode ligar o seu agente a um servidor MCP no Copilot Studio de duas formas:

• Adicione o servidor MCP em Copilot Studio usando o assistente de integração MCP (recomendado)
• Crie um conector personalizado para o seu servidor através do Power Apps

Se você ainda não tiver um servidor MCP configurado, consulte Criar um novo servidor MCP para obter informações sobre como começar.

Transportes suportados

No contexto do MCP, os transportes são fundamentais para a comunicação entre cliente e servidor. Os transportes lidam com a mecânica de enviar e receber mensagens. Atualmente, o Copilot Studio suporta o tipo de transporte Streamable.

Opção 1: Usar o assistente de integração MCP (recomendado)

A forma mais simples de se ligar a um servidor MCP existente é diretamente no Copilot Studio, usando o assistente de integração MCP.

Este método tem duas partes:

• Configurar os detalhes básicos do servidor MCP
• Configurar a autenticação com o servidor MCP

Configurar detalhes básicos do servidor

1. Vá para a página Ferramentas do seu agente.

2. Selecione Adicionar uma ferramenta.

3. Selecione Nova ferramenta.

4. Selecione Protocolo de contexto do modelo. O assistente de configuração MCP aparece.

   

5. Preencha os campos obrigatórios Nome do servidor, Descrição do servidor e URL do servidor. Escreve uma descrição breve, mas clara, do que o teu servidor MCP faz. O orquestrador de agente usa essas informações para determinar se deve chamar o seu servidor durante a execução.

6. Selecione o tipo de autenticação para o servidor MCP, se aplicável. Tem três opções:

   • Nenhum
   • Chave de API: Configurar a autenticação de chave de API
   • OAuth 2.0: Configurar autenticação OAuth 2.0

7. Se você selecionou Nenhum, selecione Criar. A caixa de diálogo Adicionar ferramenta é exibida. Pule para Criar uma nova conexão e adicione o servidor MCP ao seu agente.

Configurar a autenticação com o servidor MCP

Se o servidor exigir autenticação, você terá duas opções:

• Chave da API: selecione esta opção se o servidor MCP exigir uma chave da API para autenticação. Uma chave API é uma opção simples de autenticar com o servidor. O utilizador do agente fornece a chave API, e o agente inclui-a nos pedidos ao servidor MCP.
• OAuth 2.0: selecione esta opção se o seu servidor MCP usar OAuth 2.0 para autenticação. O OAuth 2.0 permite que usuários individuais se autentiquem com o servidor e concedam permissões ao seu aplicativo (agente) sem compartilhar suas credenciais.

Se você optar por usar a autenticação, precisará configurar os detalhes da autenticação. As etapas dependem do tipo de autenticação selecionado.

Configurar autenticação de chave de API

1. Selecione a chave de API como o tipo de autenticação. Mais campos aparecem para você configurar a chave da API.

2. Selecione o Tipo de chave de API a ser usado. Tens duas opções:

   • Cabeçalho: Selecione esta opção se o servidor MCP exigir que a chave da API seja enviada no cabeçalho da solicitação.
   • Consulta: Selecione esta opção se o servidor MCP exigir que a chave da API seja enviada como um parâmetro de consulta na URL.

3. Insira o nome do cabeçalho ou parâmetro de consulta onde a chave API deve ser incluída.

4. Selecione Criar. A caixa de diálogo Adicionar ferramenta é exibida. Pule para Criar uma nova conexão e adicione o servidor MCP ao seu agente.

Configurar a autenticação OAuth 2.0

1. Selecione OAuth 2.0 como o tipo de autenticação.

2. Selecione o Tipo de autenticação OAuth 2.0 a ser usado. Tem três opções:

   • Descoberta dinâmica: selecione esta opção se o servidor MCP suportar o registro dinâmico de cliente (DCR) OAuth 2.0 com mecanismo de descoberta. O cliente pode usar um endpoint de descoberta para descobrir automaticamente os endpoints necessários e registrar-se junto ao provedor de identidade.
   • Dinâmico: Selecione esta opção se o servidor MCP suportar DCR OAuth 2.0 dinâmico, mas não suportar o mecanismo de deteção dinâmica. O cliente ainda pode registar-se com o provedor de identidade, mas você precisa fornecer os endpoints necessários manualmente.
   • Manual: Selecione esta opção se o servidor MCP exigir a configuração manual das configurações do OAuth 2.0.

Descoberta dinâmica

Se o servidor MCP suportar o mecanismo de Registro Dinâmico de Cliente (DCR) OAuth 2.0, você poderá usar a opção de descoberta dinâmica. Se suportado, o DCR com descoberta é o método mais simples para configurar a autenticação OAuth 2.0 com o seu servidor MCP no Copilot Studio.

1. Selecione Descoberta dinâmica como o tipo de autenticação OAuth 2.0.

2. Selecione Criar para adicionar o servidor. O cliente usa o endpoint de descoberta para localizar automaticamente os endpoints necessários e registrar-se no provedor de identidade.

3. Selecione Seguinte para continuar. A caixa de diálogo Adicionar ferramenta é exibida.

4. Continue para criar uma nova conexão e adicionar o servidor MCP ao seu agente.

Dynamic

1. Selecione Dinâmico como o tipo de autenticação OAuth 2.0.

2. Preencha os campos obrigatórios:

   • URL de autorização: a URL do servidor do provedor de identidade onde os endpoints de registo e autorização do cliente podem ser acedidos.
   • Modelo de URL de token: o ponto final onde o agente troca um código de autorização (ou token de atualização) por um token de acesso e um token de atualização. O token de acesso permite que o agente use o servidor MCP em nome do usuário. Os tokens de atualização permitem que seu agente obtenha novos acessos e atualize os tokens do ponto de extremidade de atualização quando o token de acesso anterior expirar.

3. Selecione Criar para adicionar o servidor. Dependendo da configuração, um URL de callback pode aparecer. A URL de callback é onde o provedor de identidade responde com o código de autorização após o utilizador iniciar sessão e conceder permissões ao seu agente.

4. Se vir o URL de retorno de chamada, copie-o para adicionar ao registo da sua aplicação junto ao seu fornecedor de identidade.

5. Selecione Seguinte para continuar. A caixa de diálogo Adicionar ferramenta é exibida.

6. Continue para criar uma nova conexão e adicionar o servidor MCP ao seu agente.

Manual

1. Selecione Manual como o tipo OAuth 2.0. Mais campos aparecem para você definir as configurações do OAuth 2.0.

2. Preencha os campos obrigatórios:

   • ID do cliente: o identificador do cliente que o provedor de identidade emite quando você registra seu aplicativo. O ID do cliente permite que o provedor de identidade saiba qual aplicativo está fazendo a solicitação.
   • Segredo do cliente: o segredo do cliente que o provedor de identidade emite quando você registra seu aplicativo. Seu agente envia o segredo do cliente junto com o ID do cliente para provar que seu agente está autorizado a solicitar tokens de acesso para o servidor MCP.
   • URL de autorização: o ponto de extremidade do provedor de identidade para o qual o agente redireciona o utilizador para iniciar sessão e conceder permissões ao agente (cartão de consentimento apresentado no bate-papo do agente). O usuário se autentica aqui e, em seguida, o provedor de identidade responde ao agente com um código de autorização.
   • Modelo de URL de token: o ponto de extremidade em que o agente troca o código de autorização (ou token de atualização) por um token de acesso e token de atualização. O token de acesso permite que o agente use o servidor MCP em nome do usuário. Os tokens de atualização permitem que seu agente obtenha novos acessos e atualize os tokens do ponto de extremidade de atualização quando o token de acesso anterior expirar.
   • URL de atualização: o endpoint para solicitar um novo token de acesso usando um token de renovação (para que o usuário não precise entrar novamente quando o token expirar).
   • Âmbitos (Opcional): as permissões que a sua aplicação solicita, como uma lista separada por espaços.

3. Selecione Criar para adicionar o servidor. Um URL de callback é exibido. A URL de callback é onde o provedor de identidade responde com o código de autorização após o utilizador iniciar sessão e conceder permissões ao seu agente.

4. Copie o URL de retorno de chamada para adicionar ao registro do seu aplicativo com seu provedor de identidade.

5. Selecione Seguinte para continuar. A caixa de diálogo Adicionar ferramenta é exibida.

6. Continue para criar uma nova conexão e adicionar o servidor MCP ao seu agente.

Crie uma nova conexão e adicione o servidor MCP ao seu agente

1. Em Adicionar ferramenta, selecione Criar uma nova ligação para o seu servidor MCP ou usar uma existente.

2. Selecione Adicionar ao agente para concluir a adição do servidor MCP ao seu agente.

Opção 2: Criar um conector MCP personalizado no Power Apps

Pode criar manualmente um conector personalizado no Power Apps para configurar uma ligação ao servidor.

Para executar este procedimento, você precisa de um arquivo de esquema para o seu servidor MCP. O arquivo de esquema é um arquivo YAML de especificação OpenAPI que descreve a API do seu servidor MCP.

Para obter orientação sobre como o ficheiro de especificação deve parecer, confira alguns dos exemplos de esquema de servidor MCP fornecidos.

1. Vá para a página Ferramentas do seu agente.

2. Selecione Adicionar uma ferramenta.

3. Selecione Nova ferramenta.

4. Selecione Conector personalizado. És levado ao Power Apps para criar um novo conector personalizado.

5. Selecione Novo conector personalizado.

6. Selecione Importar arquivo OpenAPI.

7. Navegue até o arquivo de esquema e selecione Importar para importar o arquivo.

8. Selecione Continue para completar a configuração em Power Apps. Você pode ler mais sobre o processo de configuração na documentação do Power Apps em Importar a definição de OpenAPI.

Exemplo de esquema de servidor MCP

Aqui está um arquivo de esquema OpenAPI de exemplo para um servidor MCP usando dados fictícios, no formato YAML. Você precisa preencher os detalhes do seu próprio servidor MCP. Esta amostra usa o tipo de transporte Streamable.

swagger: '2.0'
info:
  title: Contoso
  description: MCP Test Specification, YAML for streamable MCP support in Copilot Studio
  version: 1.0.0
host: contoso.com
basePath: /
schemes:
  - https
paths:
  /mcp:
    post:
      summary: Contoso Lead Management Server
      x-ms-agentic-protocol: mcp-streamable-1.0
      operationId: InvokeMCP
      responses:
        '200':
          description: Success

Editar uma ligação MCP

Para editar o conector MCP ou adicionar parâmetros personalizados:

1. Vá para o portal Power Apps ou Power Automate e selecione Conectores personalizados.
2. Localize o arquivo do conector na lista de conectores e faça as atualizações necessárias usando um dos métodos disponíveis.