Quando usar
- A sua empresa usa o ChatGPT Business, Enterprise ou Edu e você quer usar a Cloud Humans de dentro dele
- Você precisa saber o que o administrador do ChatGPT tem que fazer para liberar o conector
O MCP Server da Cloud Humans está em Beta, e o suporte completo a MCP do ChatGPT também está em beta do lado da OpenAI. Os nomes dos menus do ChatGPT mudam com frequência: se algum não bater, procure pela opção equivalente.
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
- ChatGPT Business, Enterprise ou Edu, usado no navegador. O conector não funciona no app de celular
- Um administrador ou owner do workspace do ChatGPT, que é quem adiciona e publica o conector
Antes de começar: qual é o seu plano do ChatGPT?
| Plano | Dá para usar? | Quem adiciona |
|---|---|---|
| Business | Sim | Só administradores e owners do workspace |
| Enterprise ou Edu | Sim | Administradores e owners. Eles podem autorizar outras pessoas a criar, mas só eles publicam |
| Pro | Parcial: só ferramentas de consulta | Você mesmo |
| Plus e Free | Não. A OpenAI não lista esses planos para servidor MCP personalizado |
O caminho no Business, Enterprise e Edu tem quatro etapas:
- Aprovação: o time de segurança avalia o conector
- Cadastro e publicação: o administrador adiciona o conector e publica para o workspace, uma única vez
- Conexão individual: cada pessoa faz login com a própria conta Cloud Humans
- Teste
Passo a passo
Etapa 1 — Pedir a aprovação do time de segurança
- Envie ao time de segurança (ou ao administrador do ChatGPT) a mensagem abaixo, ajustando o que estiver entre colchetes:
Olá! Precisamos liberar no ChatGPT [Business/Enterprise] o conector da Cloud Humans,
fornecedora da nossa operação de atendimento (ClaudIA e Cloud Chat).
É um servidor MCP remoto, com login individual por OAuth e as mesmas permissões que
cada pessoa já tem na Cloud Humans. Nada é instalado e não há chave de API.
Endereço: https://mcp.cloudhumans.com/openapi/cloudhumans/mcp
Respostas de segurança: https://cloudchat.cloudhumans.com/hc/cloud-chat/articles/1792005888-mcp-da-cloud-humans-o-que-o-time-de-seguranca-precisa-saber-para-aprovar
Quem vai usar: [nomes ou time]
Para quê: [ex.: manter a base de conhecimento da ClaudIA]
- Junto com a mensagem, mande o artigo MCP da Cloud Humans: o que o time de segurança precisa saber para aprovar
Etapa 2 — O administrador adiciona e publica o conector
Esta etapa é feita uma única vez, por um administrador ou owner do workspace.
-
No ChatGPT, abra Plugins
-
Clique no + e selecione Adicionar servidor MCP personalizado (Add custom MCP server)
-
Em Nome, escreva
Cloud Humans -
Em Conexão (Connection), cole o endereço do servidor:
https://mcp.cloudhumans.com/openapi/cloudhumans/mcp
-
Em Autenticação, escolha OAuth. Não é preciso preencher Client ID nem Client Secret: o servidor da Cloud Humans registra o ChatGPT sozinho
-
Leia o aviso de risco, marque Entendo e quero continuar (I understand and want to continue) e conclua
-
Faça o login da Cloud Humans quando for pedido e aguarde o ChatGPT listar as ferramentas
-
Publique para o workspace em Configurações do workspace (Workspace settings) > Apps > Rascunhos (Drafts) > Publicar (Publish)
Enterprise e Edu: ao publicar, use Configurar ações (Configure Actions) para escolher quais ferramentas ficam ligadas e Configurar acesso (Configure Access) para escolher quais grupos podem usar. Se a empresa quiser um uso só de consulta, desligue aqui as ferramentas que criam ou alteram dados, em especial a de criar campanha.
O ChatGPT congela a lista de ferramentas no momento da publicação. Quando a Cloud Humans lançar ferramentas novas, elas só aparecem depois que o administrador clicar em Atualizar (Refresh) nas configurações do app. Ferramentas novas entram desligadas.
Etapa 3 — Conectar com a sua conta Cloud Humans
Cada pessoa faz esta etapa uma vez, com a própria conta.
-
No ChatGPT, encontre Cloud Humans na sua lista de apps. Ele aparece com a etiqueta custom
-
Clique para conectar
-
Na tela de login da Cloud Humans, entre com o seu e-mail e senha da Cloud Humans
-
O navegador volta sozinho para o ChatGPT com o conector conectado
Etapa 4 — Testar
Abra uma conversa nova, digite @, selecione Cloud Humans e peça:
Liste os conteúdos da minha base de conhecimento na Cloud Humans.
No ChatGPT, o app vale para a mensagem em que você o seleciona. Quando a próxima pergunta precisar buscar dados novos na Cloud Humans, selecione o app com @ de novo.
Problemas comuns
| O que aparece | Causa | O que fazer |
|---|---|---|
| Não vejo a opção de adicionar servidor MCP | Só administradores e owners adicionam | Peça ao administrador (Etapa 1) |
| Não encontro a Cloud Humans nos meus apps | O app ainda não foi publicado, ou o seu grupo não tem acesso (Enterprise) | Confirme com o administrador a Etapa 2 |
| Uma ferramenta que existe na Cloud Humans não aparece | A lista de ferramentas foi congelada na publicação | O administrador clica em Atualizar no app |
| O ChatGPT pede para confirmar uma ação | O ChatGPT pede confirmação antes de ações que alteram dados | É esperado. Confira e confirme |
| O ChatGPT pediu login de novo | Passaram 30 dias desde o login | Conecte de novo (Etapa 3) |
Observações
- As permissões são exatamente as da sua conta Cloud Humans. O conector não amplia nem reduz o que você já podia ver e editar
- Pesquisa aprofundada (deep research) usa o conector só para consulta, e o modo agente não usa conectores personalizados
- Exemplos do que pedir: Utilizando o MCP da Claudia e Como utilizar o MCP do Cloud Chat