Criar um plug-in para um agente declarativo de um servidor MCP

Este guia mostra como integrar seu serviço a um agente declarativo do Microsoft 365 Copilot adicionando um servidor MCP como um plug-in usando o Kit de Ferramentas de Agentes do Microsoft 365. Seguindo estas etapas, você habilita o acesso conversacional e alimentado por IA aos seus serviços expostos ao MCP para usuários empresariais.

Este passo a passo usa o servidor GitHub MCP como exemplo. O servidor MCP do GitHub é um servidor MCP remoto, fornecido e mantido pelo GitHub, que expõe ferramentas para trabalhar com repositórios, problemas, solicitações de pull e outros recursos do GitHub. Você o usa aqui para criar um agente que pode pesquisar repositórios e usuários do GitHub a partir de prompts de linguagem natural. Você pode seguir as mesmas etapas com seu próprio servidor MCP.

Crie e use o plug-in em quatro etapas: criar um cliente OAuth para autenticação, criar o agente, publicar e fazer sideload do agente e usar o agente.

Pré-requisitos

Antes de começar, verifique se você tem os seguintes pré-requisitos:

• Requisitos especificados em Requisitos para opções de extensibilidade do Copilot
• Visual Studio Code
• Microsoft 365 Agents Toolkit versão 6.12.0 ou posterior

Para concluir o exemplo do GitHub neste passo a passo, você também precisa de uma conta do GitHub. Uma conta do GitHub não é necessária para criar um plug-in do seu próprio servidor MCP.

Etapa 1: Criar um cliente OAuth para autenticação

O servidor GitHub MCP exige que cada usuário faça login antes de retornar dados, portanto, o plug-in precisa de um cliente OAuth. Neste guia, use o OAuth (com registro estático). Quando você cria o agente e seleciona esse tipo de autenticação, o Agents Toolkit solicita imediatamente esses valores, portanto, crie o cliente primeiro. Em seguida, o Copilot usa o registro para obter um token de acesso em nome do usuário conectado sempre que o agente chama o servidor MCP.

Para criar um cliente OAuth:

1. Acesse no https://github.com/settings/developers seu navegador. Selecione Aplicativos >OAuthNovo Aplicativo OAuth.

2. Adicione um nome e uma URL da página inicial para seu aplicativo e defina https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect como a URL de retorno de chamada de autorização. Selecione Registrar aplicativo.

3. Depois que o aplicativo for criado, selecione Gerar um novo segredo do cliente. Copie o segredo e o ID do cliente a serem inseridos ao criar o agente.

Etapa 2: Criar o agente

Para criar o agente:

1. Abra o Visual Studio Code e selecione o ícone do Microsoft 365 Agents Toolkit na Barra de Atividades.

2. Selecione Criar um novo agente/aplicativo no painel de tarefas Kit de ferramentas para agentes.

   

3. Selecione o Agente Declarativo.

4. Selecione Adicionar uma Ação e, em seguida, selecione Iniciar com um Servidor MCP.

5. Insira a URL https://api.githubcopilot.com/mcp/do servidor GitHub MCP.

   

6. Selecione o tipo de autenticação. Para este exercício, selecione OAuth (com registro estático).

   

7. Quando solicitado, insira a ID do cliente do aplicativo OAuth que você registrou e insira o segredo do cliente.

8. Quando os escopos forem solicitados, pressione Enter para continuar.

9. Escolha um local para o projeto de agente.

10. Insira um nome para o agente.

Depois de concluir essas etapas, o Agents Toolkit gera os arquivos necessários para o agente e abre uma nova janela do Visual Studio Code com o projeto do agente carregado.

O Agents Toolkit configura o manifesto do plug-in gerado (ai-plugin.json) para descoberta dinâmica de ferramentas, para que o agente resolva as ferramentas do servidor MCP, incluindo qualquer uma que retorne widgets de interface do usuário (aplicativos MCP), em tempo de execução, e você não adicione ferramentas manualmente. Para fixar um conjunto fixo e coletado de ferramentas, consulte Configurar ferramentas fixadas com o Agents Toolkit.

Etapa 3: Publicar e fazer sideload do agente

Para publicar e fazer sideload do agente:

1. No painel Contas do Kit de Ferramentas de Agentes , selecione Entrar no Microsoft 365. (Se você já estiver conectado, vá para a próxima etapa).

2. Confirme se o Upload de aplicativo personalizado habilitado e o Acesso ao Copilot habilitado são exibidos em sua conta do Microsoft 365. Caso contrário, marque com o administrador da sua organização. Consulte Requisitos para opções de extensibilidade do Copilot para obter detalhes.

3. No painel Ciclo de Vida , selecione Provisionar.

4. Leia a mensagem na caixa de diálogo e selecione Confirmar para continuar.

5. Aguarde até que o kit de ferramentas informe que o provisionamento foi concluído.

Etapa 4: usar o agente

Para usar o agente:

1. No navegador, vá para https://m365.cloud.microsoft/chat.

2. Na seção Agentes da barra lateral, localize seu agente. Ele está listado como o nome que você deu na Etapa 2: Criar o agente, com dev anexado no final. Selecione o agente.

3. Peça ao agente para localizar um repositório ou usuário. Por exemplo, can you find a repo for kiota?.

4. Quando solicitado, selecione Sign in to {agent-name}. Na janela pop-up, entre com sua conta do GitHub e autorize o agente.

5. Quando a janela pop-up fecha, o agente retorna uma resposta.

   

6. Se a ferramenta que o agente chama retornar um widget de interface do usuário (aplicativo MCP), confirme se o agente renderiza o widget embutido na resposta. Para obter mais informações, consulte Adicionar aplicativos MCP a agentes declarativos no Microsoft 365 Copilot.

Conteúdo relacionado

• Adicionar aplicativos MCP a agentes declarativos no Microsoft 365 Copilot