Conectar a CLI do GitHub Copilot ao servidor MCP do Work IQ

Use a CLI do GitHub Copilot como cliente MCP (Protocolo de Contexto de Modelo) para se conectar ao servidor MCP remoto Work IQ. Depois de configurar a conexão, o Copilot pode descobrir as ferramentas MCP do Work IQ, autenticar-se com o Microsoft Entra ID e usá-las para trabalhar com os dados do Microsoft 365 de acordo com as permissões e a política de locatário do usuário conectado.

Este guia de início rápido mostra como configurar a CLI do GitHub Copilot para o ponto de extremidade MCP do Work IQ remoto e verificar se a conexão está funcionando.

Pré-requisitos

Antes de começar, verifique se você tem:

  • Acesso à CLI do GitHub Copilot.
  • Uma conta do Microsoft 365 que possa acessar os dados corporativos que você deseja recuperar.
  • Acesso ao ponto de extremidade do servidor MCP do Work IQ remoto, https://workiq.svc.cloud.microsoft/mcp.

Configurar a CLI do GitHub Copilot

Se você ainda não tiver a CLI do GitHub Copilot instalada, instale-a seguindo as instruções de configuração da CLI do GitHub Copilot em Usar a CLI do GitHub Copilot.

Após a instalação, inicie a CLI do GitHub Copilot no terminal:

copilot

Se você for solicitado a entrar, use o /login comando e siga as instruções:

/login

Instale o plug-in Work IQ

Instale o plug-in Work IQ na CLI do GitHub Copilot. O plug-in configura a integração do Work IQ MCP e disponibiliza as habilidades relacionadas na CLI do Copilot.

  1. Adicione o marketplace de plug-ins do Work IQ. Você só precisa fazer isso uma vez.

    /plugin marketplace add microsoft/work-iq
    
  2. Instale o plug-in Work IQ.

    /plugin install workiq@work-iq
    
  3. Siga as instruções para concluir a instalação.

  4. Reinicie a CLI do GitHub Copilot.

  5. Uma janela pop-up do navegador é exibida e exibe Autorização Bem-sucedida.

Verificar o servidor MCP e as habilidades

Depois de instalar o plug-in, verifique se o servidor MCP do Work IQ e as habilidades estão carregados.

Para gerenciar ou inspecionar servidores MCP configurados, execute:

/mcp

Você vê workiq na lista de plug-ins com o ponto de extremidade do servidor MCP do Work IQ, https://workiq.svc.cloud.microsoft/mcp.

Para gerenciar ou inspecionar as habilidades disponíveis, execute:

/skills

Você vê workiq na lista de habilidades.

Jogue com seus dados do Microsoft 365

Após o servidor MCP do Work IQ e a carga de habilidades, peça à CLI do Copilot para recuperar dados corporativos do Microsoft 365 por meio do Work IQ. A primeira solicitação pode solicitar que você se autentique com o Microsoft Entra ID.

Por exemplo, tente prompts como:

Summarize my upcoming meetings for today.
Find recent messages about the Contoso account.
Retrieve the latest email related to the quarterly business review.

A CLI do Copilot usa o servidor MCP Work IQ para chamar as ferramentas apropriadas. O resultado depende das permissões do usuário conectado ao Microsoft 365, das permissões OAuth do aplicativo e da política de locatário. Se a política ou as permissões bloquearem uma solicitação, revise a solicitação ou entre em contato com o administrador.