Como usar o Cognizy no Claude
Ligue o Cognizy ao Claude Desktop (ou ao Claude Code e ao Cursor) e peça em português: conversas, vendas, tarefas e agenda, com aprovação para o que sai.
3 min de leituraBásicoAtualizado em 12 de novembro de 2026
Onde fica no Cognizy
Videoaula em breve. Por enquanto, siga o passo a passo abaixo.
Com o Cognizy ligado ao Claude, você pergunta pelo chat como estão as conversas, as vendas e a agenda, e pede tarefas, negócios e respostas. A ligação usa o padrão MCP e uma chave de API sua: o Claude só faz o que as permissões da chave deixam, e o que fala com o cliente espera a sua aprovação. Para a configuração completa (Codex, servidor local e todas as ferramentas), veja o guia em help.cognizy.ai/pt/developers/guides/mcp.
Onde fica no Cognizy
Antes de começar
- Só o dono e os administradores criam chaves de API.
- Funciona no Claude Desktop (computador), no Claude Code e no Cursor. O claude.ai no navegador e o ChatGPT ainda não funcionam: os conectores deles pedem login por OAuth, que o servidor do Cognizy ainda não tem.
- No Claude Desktop, o Cognizy roda pelo Node.js: instale a versão LTS em nodejs.org antes de começar.
- A chave dá acesso aos dados da sua empresa: não mande para ninguém nem cole em conversa.
Passo a passo
- Passo 1:
Abra . Em Chaves de API, clique em Nova chave.
- Passo 2:
Dê um Nome que lembre o uso (por exemplo, Claude da empresa) e escolha PRODUÇÃO (LIVE), para o Claude ver os dados de verdade.
- Passo 3:
Em Permissões, marque Ler nos módulos que o Claude vai consultar (conversas, contatos, vendas, agenda…) e Criar e editar só onde ele vai mexer, como Tarefas e Mensagens (mensagem para cliente sempre espera a sua aprovação). Quanto menos permissão, mais seguro.
- Passo 4:
Clique em Nova chave, no fim da janela. A chave (começa com cgz_live_) aparece uma vez só: copie e guarde num lugar seguro.
- Passo 5:
No Claude Desktop, abra o arquivo de configuração, cole o bloco do Cognizy com a sua chave, salve e abra o Claude de novo.
- Passo 6:
Usa o Claude Code ou o Cursor? Eles se ligam direto ao servidor hospedado do Cognizy, com a chave no cabeçalho, sem instalar nada.
- Passo 7:
Agora é só pedir em português. O Claude escolhe as ferramentas do Cognizy, pede licença para usar e responde com os dados da sua empresa.
- Passo 8:
O que fala com o cliente (mandar mensagem, marcar ou cancelar horário, disparar campanha) não sai na hora: vai para Aprovações de IA, nesta mesma tela, e para Para revisar. Confira e aprove ou recuse.
Como saber que deu certo
No Claude, o botão de ferramentas mostra as do Cognizy, e uma pergunta como "quais conversas ficaram sem resposta hoje?" volta com os dados da sua empresa. Em API e webhooks, a chave aparece na lista com o uso do mês.
Se der errado
Quero usar no claude.ai pelo navegador ou no ChatGPT.
Ainda não dá: os conectores deles só aceitam endereço com login por OAuth, e o servidor do Cognizy usa a chave no cabeçalho. Use o Claude Desktop, o Claude Code ou o Cursor.
As ferramentas do Cognizy não aparecem no Claude Desktop.
Confira se o Node.js está instalado, se o arquivo continua um JSON válido (vírgulas e chaves) e se você fechou o Claude por completo antes de abrir de novo.
O Claude diz que não tem permissão para fazer o pedido.
A chave não tem a permissão daquele módulo. Crie outra chave com a permissão certa e troque no arquivo de configuração.
Aparece limite de uso atingido.
Cada chave faz até 60 chamadas por minuto e 1.000 por hora, e a empresa tem uma cota mensal (10.000 no Grátis, 150.000 nos planos pagos). Espere alguns minutos ou peça ao Claude para buscar menos coisas de uma vez.
Pedi para mandar uma mensagem e o cliente não recebeu.
Ela está esperando aprovação em Aprovações de IA. Aprove para sair; os pedidos vencem se ninguém aprovar a tempo.
Próximo passo
Veja o guia completo do MCP (Claude, Codex e Cursor, local ou hospedado) e a lista de todas as ferramentas na área de desenvolvedores.
Para desenvolvedores
Entre com a sua conta Cognizy para salvar o progresso.
Entrar