Partilhar via

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

Se você tiver um servidor MCP (Model Context Protocol) já configurado, poderá conectar o servidor MCP ao seu agente.

Há duas maneiras de ligar o seu agente a um servidor MCP no Copilot Studio:

  • Adicionar o servidor MCP no Copilot Studio usando o assistente de integração MCP (recomendado)
  • Criar 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.

Observação

Dado que o transporte SSE foi preterido, o Copilot Studio não suporta mais SSE para MCP após agosto de 2025.

A maneira mais simples de se conectar 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 inclusão MCP aparece.

    Captura de ecrã do assistente de boas-vindas MCP

  5. Preencha os campos obrigatórios Nome do servidor, Descrição do servidor e URL do servidor. Certifique-se de que escreve uma descrição breve, mas clara, do que o seu 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:

  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 de API é uma opção simples quando apenas seu aplicativo (agente) precisa se autenticar com o servidor.
  • 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. Tem 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 cabeçalho apropriado ou a cadeia de caracteres de consulta para a chave da API.

  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 seu servidor MCP no Copilot Studio.

Captura de ecrã do assistente de inclusão do MCP com deteção dinâmica para OAuth 2.0 selecionada

  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 o seu agente obtenha novos acessos e atualize os tokens do ponto final de atualização quando o token de acesso anterior expira.

  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, copie o URL de retorno para adicionar ao registo da sua aplicação junto do seu fornecedor de identidade.

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

  6. Continue a criar uma nova conexão e a 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 final do fornecedor de identidade para onde o seu agente redireciona o utilizador para iniciar sessão e conceder permissões ao seu agente (cartão de consentimento apresentado no chat do agente). O usuário se autentica aqui e, em seguida, o provedor de identidade responde de volta ao agente na URL de retorno de chamada com um código de autorização.
    • Modelo de URL de token: o ponto final onde o agente troca o 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 o seu agente obtenha novos acessos e atualize os tokens do ponto final de atualização quando o token de acesso anterior expira.
    • 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 para adicionar ao registo da sua aplicação junto do seu fornecedor de identidade.

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

  6. Continue para Criar uma nova ligação e adicione o servidor MCP ao seu agente.

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

  1. Na caixa de diálogo Adicionar ferramenta , selecione Criar uma nova conexão para o 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

Você pode criar um conector personalizado no Power Apps manualmente para configurar uma conexão com o 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. É conduzido 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 Continuar para concluir 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.
  • Last updated on