Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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.
O DCR (registro dinâmico de cliente) permite que um plug-in registre um cliente OAuth com seu provedor de identidade automaticamente, sem exigir que você crie manualmente uma ID e um segredo do cliente com antecedência. Em vez de registrar estaticamente um aplicativo OAuth e copiar as credenciais em uma configuração de autenticação, o servidor de autorização emite credenciais de cliente sob demanda após a RFC 7591.
O DCR se baseia no fluxo de código de autorização do OAuth 2.0. Ao contrário do OAuth estático, você não configura um URI de redirecionamento ou credenciais de cliente por conta própria - o armazenamento de token corporativo registra o cliente e lida com esses detalhes nos bastidores. Para obter conceitos gerais do OAuth, consulte Configurar autenticação do OAuth 2.0.
Observação
- O DCR é compatível com plug-ins do MCP (Protocolo de Contexto de Modelo).
- O DCR sem um segredo do cliente ainda não tem suporte. O servidor de autorização deve emitir um segredo do cliente durante o registro.
- O PKCE é habilitado por padrão para DCR.
Aviso
O DCR não está disponível para um servidor MCP protegido pelo Microsoft Entra ID. O Microsoft Entra ID não publica um ponto de extremidade de registro RFC 7591, portanto, não há nada para o armazenamento de tokens Enterprise registrar um cliente. Para um servidor protegido pelo Microsoft Entra ID, registre o cliente OAuth estaticamente. Para obter mais informações, consulte Configurar autenticação OAuth 2.0.
Configure o DCR em duas etapas: confirme os pré-requisitos e crie a configuração de autenticação do DCR.
Etapa 1: confirmar os pré-requisitos
- Seu servidor MCP expõe metadados de recursos protegidos pelo OAuth 2.0 em seu
.well-known/oauth-protected-resourceendpoint (RFC 9728), identificando o servidor de autorização que os protege. - O servidor de autorização publica seus metadados no ponto de extremidade (RFC 8414), incluindo um
registration_endpoint, e dá suporte ao registro de cliente dinâmico (RFC 7591) que emite um segredo do.well-known/oauth-authorization-servercliente. O Microsoft Entra ID não publica esse ponto de extremidade, portanto, um servidor MCP protegido pelo Microsoft Entra ID não pode usar o DCR.
Etapa 2: Criar a configuração de autenticação DCR
A autenticação DCR depende de uma configuração de autenticação (configuração de autenticação) - um registro armazenado no repositório de tokens do Microsoft Enterprise que o Microsoft 365 Copilot usa para obter e atualizar tokens para seu plug-in MCP. Comece com o WIQD para um projeto pró-código compatível; o Kit de ferramentas e os procedimentos de habilidade do desenvolvedor permanecem disponíveis como alternativas.
Observação
O portal do desenvolvedor do Microsoft Teams ainda não dá suporte ao DCR. Use o fluxo de trabalho de ação WIQD MCP ou uma das alternativas automatizadas abaixo.
Usar Ferramentas de Desenvolvimento do Work IQ (recomendado)
Use wiqd agent add action com o ponto de extremidade --mcp-server-url HTTPS do servidor e selecione --mcp-auth-type oauth-dynamic. O servidor e o provedor de autorização devem atender aos requisitos de metadados e segredo do cliente na Etapa 1. O DCR não está disponível para um servidor protegido pelo Microsoft Entra ID.
Siga a orientação do comando de ação MCP do WIQD e conclua o fluxo de trabalho de provisionamento do projeto. O comando existing-manifest wiqd agent add auth não oferece um tipo de autenticação DCR; use a rota de ação MCP para esse esquema.
Usar o Kit de Ferramentas de Agentes do Microsoft 365
Quando você cria um agente com um plug-in MCP no Microsoft 365 Agents Toolkit e seleciona o registro de cliente dinâmico como o tipo de autenticação, nenhuma entrada adicional é necessária. O Agents Toolkit busca os detalhes de registro do ponto de extremidade conhecido do seu servidor MCP, registra um novo cliente no servidor de autorização automaticamente, cria a configuração de autenticação no armazenamento de tokens da empresa e atualiza o objeto de autenticação de tempo de execução no manifesto do plug-in.
Usar a habilidade de desenvolvedor de agente declarativo
A habilidade de desenvolvedor de agente declarativo (declarative-agent-developer) é uma habilidade de agente no Microsoft Work IQ que empacota o conhecimento necessário para criar agentes declarativos. Em vez de executar comandos ou editar manifestos por conta própria, descreva o que deseja para o Copilot ou a GitHub CLI em linguagem natural. A habilidade cria o scaffolds do agente declarativo, adiciona o plug-in MCP e lida com a configuração de autenticação para você. Para DCR, a habilidade registra o cliente, cria a configuração de autenticação no armazenamento de token Enterprise e atualiza o manifesto do plug-in sem etapas manuais.
Dica
Para obter um vídeo passo a passo sobre como usar a habilidade de desenvolvedor de agente declarativo, consulte Criar agentes declarativos com a habilidade de desenvolvedor de agente declarativo.
Manifesto do plug-in
Esta seção mostra a configuração do manifesto do plug-in resultante para referência. O DCR usa o mesmo objeto de autenticação de tempo de execução que o OAuth 2.0: a type propriedade é definida como OAuthPluginVaulte é reference_id definida como a ID de configuração de autenticação.
"auth": {
"type": "OAuthPluginVault",
"reference_id": "auth config ID"
},