Conectar um aplicativo assistente ao Kluvan

O proprietário deve ativar primeiro o consentimento global em Configurações de IA. Isso é separado do acesso do assistente e dos escopos da chave. Desativar toda a IA também bloqueia pedidos externos; revogar a chave não recupera dados já enviados.

Se você usa um aplicativo assistente compatível com MCP (Model Context Protocol), como Claude, ChatGPT ou outro cliente MCP, pode permitir que ele leia seus valores do Kluvan e perguntar "como foram as vendas desta semana?" ou "o que está acabando?". O assistente é seu: você paga ao fornecedor dele, e o Kluvan não cobra por pergunta. Ele só pode ler.

Antes de começar

• Somente o proprietário pode ativar o recurso e criar chaves.
• Esta conexão é nova. Segue o padrão MCP, mas ainda não foi testada com todos os aplicativos assistentes. Se o seu não conectar, escreva ao suporte.
• O aplicativo Claude para computador exige Node.js instalado nesse computador.

Passos

1. Abra Configurações e a página de acesso do assistente (o endereço termina em /settings/ai).
2. Marque a opção que permite o acesso e a frase abaixo dela; pressione Salvar.
3. Em Nova chave, digite um Nome que reconheça, por exemplo "Meu ChatGPT".
4. Marque o que esta chave pode ver: Relatórios, Estoque, Produtos, Clientes, Agendamentos, Equipe ou os registros de um aplicativo como Serviços e manutenção ou Locações. Desmarque o que não for necessário.
5. Se quiser, escolha Somente esta filial e um Último dia (opcional).
6. Pressione Criar a chave e depois Copiar. A chave só aparece esta vez.
7. Abra o cartão do seu assistente (Aplicativo Claude para computador, Claude na web (claude.ai), ChatGPT ou Qualquer outro cliente MCP). Ele já está preenchido com seu endereço e a nova chave.
8. Siga os passos do cartão no aplicativo assistente, cole o que o cartão mostra e salve.
9. No assistente, faça uma primeira pergunta, por exemplo: "Usando minhas ferramentas do Kluvan, o que está acabando?".

O que cada marcação permite

• Relatórios: valores de vendas, comparações e mais vendidos. Estoque: quantidades, estoque baixo, datas de validade. Produtos: nomes, preços, códigos de barras.
• Clientes: nomes, telefones e valores devidos. São dados pessoais, então a opção fica desativada por padrão. Sem ela, um cliente aparece como oculto.
• Agendamentos e Equipe só funcionam quando esses aplicativos estão ativados.
• Registros de aplicativos (Serviços e manutenção, Suporte ao cliente, Formulários, Automações, Produção e montagem, Locações, Análises, Atacado) também exigem a marcação Clientes, pois os registros podem conter dados pessoais, e o aplicativo deve estar ativado.

Bom saber

• Somente leitura: nenhum assistente pode vender, reembolsar, receber pagamentos, alterar configurações ou excluir algo por esta conexão.
• Limites por chave: 60 chamadas por minuto e 2.000 por dia. Uma lista para em 50 registros; o aplicativo é orientado a fazer uma pergunta mais específica. Você pode manter até 10 chaves.
• Proteção contra abuso: uma chave que pede 20 vezes em uma hora algo não permitido por suas marcações fica Pausada. Toda chamada é recusada, o proprietário recebe um alerta (quando os alertas do proprietário estão ativados), e o evento aparece em Equipe → Atividade. Confira o que foi pedido ao aplicativo e escolha Retomar ou Revogar a chave.
• O endereço que contém sua chave é a própria chave. Nunca o cole em um local público. Revogar interrompe seu uso imediatamente; a chave também deixa de funcionar no último dia ou quando o proprietário que a criou não está mais ativo.
• As chaves não podem ter o acesso ampliado. Para permitir mais, crie outra e revogue a antiga.
• A lista de atividade no fim da página mostra as últimas 50 chamadas: quando, qual chave, o que foi solicitado, quantas linhas e se houve resposta ou recusa. As perguntas em si não são guardadas.
• Desativar o acesso recusa todas as chaves até você reativá-lo.
• Para seu próprio software que também grava registros, use a API do desenvolvedor.