Como conectar o MCP Server da Cloud Humans no Claude

Quando usar

• Você quer usar o Claude conectado à Cloud Humans para gerenciar a base de conhecimento da ClaudIA, testar respostas e configurar o Cloud Chat conversando
• A sua empresa usa o Claude Team ou Enterprise e o conector precisa ser aprovado pelo time de segurança antes de alguém conseguir usar

Pré-requisitos

• Uma conta Cloud Humans ativa. O login do conector usa o mesmo e-mail e senha que você já usa na plataforma. Pelo MCP, o login é sempre com e-mail e senha, mesmo que a sua empresa use SSO para entrar no Cloud Chat
• Um plano do Claude que aceite conectores personalizados (veja a tabela abaixo)
• Nenhum token ou chave de API. Não é preciso gerar, pedir à Cloud Humans nem colar credencial em lugar nenhum: a autorização acontece na tela de login

Sobre este artigo

O MCP Server da Cloud Humans é o endereço que dá ao Claude acesso às ferramentas da Cloud Humans. Depois de conectado, você conversa normalmente e o Claude consegue consultar e alterar o que você já pode consultar e alterar na plataforma.

O endereço do servidor é:

https://mcp.cloudhumans.com/openapi/cloudhumans/mcp

Este artigo trata de conectar o Claude à Cloud Humans. Se o que você procura é o caminho inverso, conectar os agentes da ClaudIA a servidores MCP externos, veja Como configurar servidores MCP para os agentes da ClaudIA.

Antes de começar: qual é o seu plano do Claude?

O caminho muda conforme o plano. Para descobrir o seu, abra o Claude e clique no seu nome no canto inferior esquerdo.

O caminho completo para Team e Enterprise tem quatro etapas, e só a primeira depende de outra área:

1. Aprovação: o time de segurança avalia e aprova o conector
2. Cadastro na organização: o Owner adiciona o conector uma única vez para toda a empresa
3. Conexão individual: cada pessoa conecta com a própria conta Cloud Humans
4. Teste

Passo a passo

Etapa 1 — Pedir a aprovação do time de segurança (Team e Enterprise)

1. Copie a mensagem abaixo, ajuste o que estiver entre colchetes e envie para o time de segurança (ou para o Owner do Claude na sua empresa)

Olá! Precisamos liberar no Claude [Team/Enterprise] o conector da Cloud Humans,
fornecedora da nossa operação de atendimento (ClaudIA e Cloud Chat).

O que é: um conector personalizado (servidor MCP remoto) operado pela Cloud Humans.
Endereço: https://mcp.cloudhumans.com/openapi/cloudhumans/mcp

Pontos para a avaliação:
- Nada é instalado nas máquinas e não é preciso abrir regra de firewall do nosso lado.
- Autenticação por OAuth, com login individual na Cloud Humans. Não existe chave de API
  nem segredo compartilhado.
- Cada pessoa conecta com a própria conta e tem exatamente as mesmas permissões que já
  tem na plataforma da Cloud Humans. O conector não amplia acesso.
- A sessão vale 30 dias a partir do login. Depois disso, é preciso fazer login de novo.
- O Owner pode remover o conector da organização a qualquer momento, cortando o acesso
  de todos.

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
Passo a passo no Claude:
https://cloudchat.cloudhumans.com/hc/cloud-chat/articles/1787004926-como-conectar-o-mcp-server-da-cloud-humans-no-claude

Quem vai usar: [nomes ou time]
Para quê: [ex.: manter a base de conhecimento da ClaudIA e testar respostas]

2. Junto com a mensagem, mande o artigo MCP da Cloud Humans: o que o time de segurança precisa saber para aprovar. Ele responde o que costuma ser perguntado nessa avaliação
3. Com a aprovação, siga para a Etapa 2A (feita pelo Owner)

Etapa 2A — O Owner adiciona o conector na organização (Team e Enterprise)

Esta etapa é feita uma única vez, pelo Owner, e vale para toda a empresa.

1. No Claude, abra Configurações da organização (Organization settings) > Conectores (Connectors)

2. Clique em Adicionar (Add), passe o mouse em Personalizado (Custom) e selecione Web

3. Em Nome, escreva Cloud Humans

4. Em URL, cole o endereço do servidor:

https://mcp.cloudhumans.com/openapi/cloudhumans/mcp

5. Clique em Continuar (Continue) e revise a autenticação

6. Não preencha OAuth Client ID nem OAuth Client Secret. O servidor da Cloud Humans registra o Claude sozinho, então esses campos ficam em branco

7. Clique em Adicionar (Add)

Etapa 2B — Adicionar o conector você mesmo (Pro, Max e Free)

1. No Claude, abra Personalizar (Customize) > Conectores (Connectors)

2. Clique em + Adicionar e depois em Adicionar conector personalizado (Add custom connector)

3. Em Nome, escreva Cloud Humans

4. Em URL, cole o endereço do servidor:

https://mcp.cloudhumans.com/openapi/cloudhumans/mcp

5. Deixe OAuth Client ID e OAuth Client Secret em branco e clique em Adicionar (Add)

Etapa 3 — Conectar com a sua conta Cloud Humans (todos os planos)

Cada pessoa que vai usar faz esta etapa uma vez, com a própria conta.

1. No Claude, abra Personalizar (Customize) > Conectores (Connectors)

2. Encontre Cloud Humans na lista. Em Team e Enterprise, ele aparece com a etiqueta Personalizado (Custom)

3. Clique em Conectar (Connect)

4. Vai abrir uma tela de login da Cloud Humans. Entre com o seu e-mail e senha da Cloud Humans, os mesmos da plataforma

5. Depois do login, o navegador volta sozinho para o Claude e o conector aparece como conectado

Etapa 4 — Testar

Abra uma conversa nova e peça algo simples, como:

Liste os conteúdos da minha base de conhecimento na Cloud Humans.

Se o Claude responder com os seus conteúdos, está tudo certo. Para ideias do que pedir, veja Utilizando o MCP da Claudia e Como utilizar o MCP do Cloud Chat.

Perguntas do time de segurança

As respostas sobre autenticação, permissões, alteração de dados, revogação e destino dos dados estão reunidas em MCP da Cloud Humans: o que o time de segurança precisa saber para aprovar. É esse o link para mandar ao time de segurança.

Problemas comuns

Observações

• Usa outro assistente? Veja ChatGPT, Gemini Enterprise e Microsoft Copilot. Em clientes como Cursor, VS Code e Claude Code, o endereço e o login são os mesmos
• Uma aprovação vale para todos. Em Team e Enterprise, o Owner adiciona o conector uma vez. Quem entrar depois na empresa só precisa fazer a Etapa 3