Quando usar
- Você quer que um agente especialista consulte ou registre informações em outro sistema da empresa, como agenda, CRM, e-mail ou planilha.
- Você quer, por exemplo, que a ClaudIA veja horários livres e marque reuniões no Google Calendar durante o atendimento.
- Você precisa de um app que não tem ferramenta pronta na ClaudIA e não quer configurar um servidor MCP próprio.
Veja quais apps estão disponíveis hoje em Apps disponíveis em Integrações.
Pré-requisitos
- A aba Integrações precisa estar liberada para o seu projeto. Ela é ativada pelo time da Cloud Humans: se você não vê a aba, peça ao seu ponto de contato.
- Para conectar, reconectar ou desconectar um app, é preciso ser administrador da empresa. Os demais usuários podem liberar ações dos apps já conectados para os especialistas.
- Uma conta no app que você vai conectar (por exemplo, a conta Google da agenda do time).
A autorização é feita pelo parceiro de integrações da Cloud Humans. Cada conexão vale para todos os projetos da empresa. Quando o app pede uma chave de API, ela vai direto para o parceiro e não fica salva na ClaudIA.
Passo a passo
Etapa 1 — Abrir a aba Integrações
Acesse ClaudIA → Ferramentas e clique na aba Integrações, ao lado de Ferramentas. Ali ficam os apps conectados e o status de cada um.
Etapa 2 — Conectar um app
- Clique em Adicionar integração.
- Busque o app pelo nome ou pelo que ele faz, ou navegue pelas categorias (CRM, Agenda, E-mail, Helpdesk, Financeiro e outras).
- Clique em Conectar. A maioria dos apps abre o login numa janela à parte; alguns pedem uma chave de API.
- Conclua o login e autorize o acesso. O card do app aparece como Conectado.
A lista completa de apps, com data, está em Apps disponíveis em Integrações.
Se o navegador bloquear a janela de login, permita popups para o CloudChat e clique em Conectar de novo.
Etapa 3 — Liberar ações para os especialistas
- No card do app conectado, clique em Liberar para especialistas.
- Escolha o especialista na lista.
- Em Adicionar ação, busque e adicione as ações que ele pode usar. Cada ação mostra se é de Leitura (só consulta) ou Escrita (cria ou altera dados no app).
- Clique em Salvar alterações.
Você também pode escolher as ações de integração ao criar ou editar um especialista, na etapa Ferramentas.
Etapa 4 — Testar e publicar
As ações entram no rascunho do especialista. Teste no Testar (Playground) da tela de Agentes e, quando estiver tudo certo, clique em Publicar para valer nas conversas.
Observações
- Libere só as ações que o especialista realmente precisa e prefira ações de Leitura quando possível. Ações de Escrita criam ou alteram dados de verdade no app conectado.
- Se a autorização expirar ou for revogada no app, o card mostra Precisa reconectar e as ações em uso ficam pausadas até um administrador reconectar.
- Desconectar um app vale para todos os projetos da empresa: os especialistas param de usar as ações dele na hora, inclusive nas conversas em produção.
- Para apps que não estão no catálogo, continue usando os Servidores MCP da ClaudIA.