Configurar a autenticação para plug-ins de MCP e API nos agentes

Dica

Recomendado: Comece com o Work IQ Dev Tools para cenários de plug-in e de agente declarativo de código profissional com suporte. Consulte o início rápido do WIQD. As instruções baseadas em kit de ferramentas permanecem disponíveis para projetos e fluxos de trabalho existentes que as exigem. Verifique a capacidade e o suporte à experiência de destino antes de escolher uma ferramenta: O WIQD não tem como alvo agentes de mecanismo personalizados.

Os agentes declarativos no Microsoft 365 Copilot se conectam aos serviços de back-end por meio de plug-ins API ou MCP. Essas integrações de ação conectam o agente a um servidor MCP (Model Context Protocol) ou a uma API descrita por um documento OpenAPI. Configure a autenticação para que o Microsoft 365 Copilot possa obter e enviar as credenciais corretas em nome do usuário conectado.

Observação

Este artigo configura a autenticação em um manifesto de plug-in de API ou MCP para um agente declarativo. Ele não configura o pacote instalável externo. Consulte Plug-ins e ações de agente declarativo para o relacionamento de manifesto.

As orientações de autenticação usam um plug-in MCP como exemplo padrão. O plug-in MCP é a integração do agente com o servidor remoto, não com o servidor em si. As mesmas etapas de configuração se aplicam a plug-ins de API criados a partir de um documento OpenAPI, exceto quando observado em cada artigo.

Esquemas de autenticação com suporte

Escolha o esquema de autenticação que corresponde a como seu servidor MCP ou API protege seus pontos de extremidade:

Esquema de autenticação Plug-ins MCP Plug-ins de API Artigo
SSO (logon único) do Microsoft Entra Com suporte Com suporte Configurar a autenticação SSO do Microsoft Entra
Registro dinâmico de cliente (DCR) Com suporte Sem suporte Configurar o registro de cliente dinâmico
Fluxo de código de autorização OAuth 2.0 Com suporte Com suporte Configurar autenticação OAuth 2.0
Chave de API Sem suporte Com suporte Configurar autenticação de chave de API
Sem autenticação (anônimo) Com suporte Com suporte Configurar sem autenticação (anônimo)

Observação

Esta tabela aborda os plug-ins MCP e API usados como ações de agente declarativo. Um plug-in que faz referência a um servidor MCP remoto por meio agentConnectors do manifesto do aplicativo Microsoft 365 usa uma configuração de autorização diferente. Esse esquema inclui ApiKeyPluginVault, enquanto os plug-ins MCP usados como ações de agente declarativo não dão suporte a chaves de API. Para requisitos de configuração e host, consulte Configurar servidores MCP remotos para plug-ins do Microsoft 365 Copilot.

Como funciona a autenticação de plug-in

Para esquemas que exigem credenciais, uma configuração de autenticação (configuração de autenticação) é um registro armazenado no repositório de tokens do Microsoft Enterprise que contém as credenciais ou os detalhes do cliente necessários para autenticar no servidor MCP ou na API. O acesso anônimo não requer uma configuração de autenticação. Escolha o caminho de configuração compatível para o seu projeto:

  • O Work IQ Dev Tools (recomendado) configura a autenticação quando você adiciona uma ação OpenAPI ou MCP remoto com wiqd agent add action. Para configurar um tipo de autenticação compatível em um manifesto de plug-in existente, use wiqd agent add auth. Siga a orientação WIQD específica do esquema abaixo para obter as opções corretas e conclua o fluxo de trabalho de provisionamento do agente para seu ambiente.
  • O Microsoft 365 Agents Toolkit cria a configuração de autenticação e atualiza o manifesto do plug-in automaticamente à medida que você cria o agente.
  • A habilidade de desenvolvedor do agente declarativo (somente plug-ins do MCP) cria a configuração de autenticação e atualiza o manifesto para você a partir de instruções de linguagem natural.
  • O portal do desenvolvedor do Microsoft Teams permite que você crie a configuração de autenticação manualmente ou gerencie uma que o Agents Toolkit ou a habilidade criou.

Para esquemas autenticados, o manifesto do plug-in faz referência à configuração de autenticação por sua ID no objeto de autenticação de runtime. Em tempo de execução, o Microsoft 365 Copilot usa a configuração de autenticação para obter um token ou chave de API do repositório de tokens e a inclui quando o plug-in chama o servidor MCP ou a API.

Comece com a seção WIQD do esquema de autenticação escolhido. Os mesmos artigos mantêm o Kit de ferramentas, a habilidade do desenvolvedor, o portal e as alternativas manuais quando há suporte.

Observação

Para um pacote de plug-ins que Cowork conecta a um servidor MCP remoto, siga a autenticação no manifesto do aplicativo. As etapas de registro de credenciais compartilhadas não tornam essa configuração intercambiável com a configuração do manifesto do plug-in MCP de um agente. Se o provedor OAuth usar a plataforma de identidade da Microsoft e a conexão precisar de atualização automática de token, inclua offline_access no campo Escopo da configuração do OAuth os escopos delegados específicos da API.