Quando usar
- A sua empresa usa o Microsoft 365 Copilot ou o Copilot Studio e você quer usar a Cloud Humans de dentro dele
- Você precisa saber o que o administrador da Microsoft tem que fazer para liberar o conector
Pré-requisitos
- Uma conta Cloud Humans ativa. O login do conector usa o mesmo e-mail e senha da plataforma. Pelo MCP, o login é sempre com e-mail e senha, mesmo que a sua empresa use SSO para entrar no Cloud Chat
- Acesso ao Microsoft Copilot Studio para criar um agente
- Se a sua empresa usa políticas de dados do Power Platform, um administrador que possa liberar conectores personalizados
Sobre este artigo
No Microsoft Copilot, ninguém conecta um servidor MCP direto na conversa. O caminho é:
- Criar um agente no Copilot Studio
- Adicionar a Cloud Humans como ferramenta desse agente
- Publicar o agente no Microsoft 365 Copilot e no Teams
Por isso, quem configura é normalmente o time de TI ou quem já cria agentes no Copilot Studio na sua empresa.
Passo a passo
Etapa 1 — Pedir a aprovação do time de segurança
-
Envie ao time de segurança (ou ao administrador do Microsoft 365) o artigo MCP da Cloud Humans: o que o time de segurança precisa saber para aprovar, junto com o link deste artigo
-
Peça que confirmem duas liberações, se a empresa usar essas políticas:
- Política de dados do Power Platform: o acesso a servidores MCP no Copilot Studio segue as políticas de conectores do Power Platform. Se conectores personalizados estiverem bloqueados, o administrador precisa liberar no Power Platform admin center
- Publicação de agentes: a publicação no Microsoft 365 Copilot pode exigir aprovação no Microsoft 365 admin center
Etapa 2 — Adicionar a Cloud Humans como ferramenta do agente
-
No Copilot Studio, abra o agente (ou crie um novo) e vá até Ferramentas (Tools)
-
Clique em Adicionar uma ferramenta (Add a tool) > Nova ferramenta (New tool) > Model Context Protocol
-
Preencha:
| Campo | Valor |
|---|---|
| Server name | Cloud Humans |
| Server description | Consulta e gerencia a base de conhecimento da ClaudIA e o Cloud Chat da empresa |
| Server URL | https://mcp.cloudhumans.com/openapi/cloudhumans/mcp |
-
Em autenticação, escolha OAuth 2.0 e, no tipo, Descoberta dinâmica (Dynamic discovery). Não é preciso preencher Client ID nem Client Secret
-
Clique em Criar (Create) e depois em Avançar (Next)
-
Em Adicionar ferramenta (Add tool), escolha Criar uma nova conexão (Create a new connection), faça o login da Cloud Humans e clique em Adicionar ao agente (Add to agent)
Na tela de ferramentas do agente, dá para desligar ferramentas específicas da Cloud Humans. Se a empresa quiser um uso só de consulta, desligue as que criam ou alteram dados, em especial a de criar campanha.
A descrição do servidor é usada pelo Copilot para decidir quando chamar a Cloud Humans. Uma descrição clara faz o agente acertar mais.
Etapa 3 — Publicar o agente
-
No Copilot Studio, publique o agente
-
Em Canais (Channels), ative Teams e Microsoft 365 Copilot
-
Se a sua empresa exigir, aguarde a aprovação do administrador no Microsoft 365 admin center
Etapa 4 — Conectar e testar
Cada pessoa faz o próprio login na primeira vez que usa o agente.
-
No Microsoft 365 Copilot ou no Teams, abra o agente
-
Peça:
Liste os conteúdos da minha base de conhecimento na Cloud Humans.
- Na primeira vez, o agente mostra um cartão pedindo para conectar. Entre com o seu e-mail e senha da Cloud Humans
Problemas comuns
| O que aparece | Causa | O que fazer |
|---|---|---|
| Não consigo adicionar a ferramenta MCP | Política de dados do Power Platform bloqueando conectores personalizados | Peça ao administrador para liberar (Etapa 1) |
| O agente não aparece no Microsoft 365 Copilot | O agente não foi publicado no canal, ou aguarda aprovação | Confira a Etapa 3 |
| O agente responde sem usar a Cloud Humans | A descrição do servidor não deixa claro quando usar | Ajuste a Server description |
| O agente pediu login de novo | Passaram 30 dias desde o login | Conecte de novo pelo cartão do agente |
Observações
- As permissões são exatamente as de quem está usando o agente. Cada pessoa faz o próprio login, então o agente não compartilha o acesso de quem o criou
- Exemplos do que pedir: Utilizando o MCP da Claudia e Como utilizar o MCP do Cloud Chat