Integrações

Assistente de IA (MCP)

Conecte sua conta Clientbase ao Claude, ao ChatGPT ou a outro assistente compatível e consulte suas cobranças conversando: “quanto recebi este mês”, “quem está em atraso”, “cria uma cobrança de R$ 500 para o João”.

Conectar

O endereço do servidor é este. Não existe token para colar: você entra na Clientbase e autoriza, como faria num “Entrar com o Google”.

https://api.clientbase.com.br/mcp

No Claude Code, pela linha de comando:

claude mcp add --transport http clientbase https://api.clientbase.com.br/mcp

No Claude Desktop ou no ChatGPT, procure a seção de conectores ou servidores MCP nas configurações e informe o endereço acima. Na primeira chamada o assistente abre o navegador para você entrar e autorizar.

O recurso precisa estar habilitado para a sua conta. A liberação está em fase gradual: se a autorização não for concluída, é porque a sua conta ainda não tem o acesso habilitado.

O que o assistente consegue fazer

Cada item abaixo é uma ferramenta que o assistente pode usar. Você não precisa decorar nenhum nome, apenas pedir o que quer em português. Toda ferramenta enxerga somente os dados da sua empresa.

Consultar

Leitura. Nunca alteram nada na conta.

Listar clientes

Lista os clientes da empresa, com filtros opcionais. Retorna no máximo 50 registros por vez; para totais maiores, refine os filtros.

Ver cliente

Retorna os dados de um cliente específico da empresa.

Listar cobranças

Lista as cobranças (faturas) da empresa, com filtros opcionais. Use para responder sobre inadimplência, recebimentos e faturas em aberto.

Ver cobrança

Retorna os dados de uma cobrança específica.

Diagnosticar cobrança

Explica a situação de uma cobrança: pagamentos por forma, juros, multa e desconto, motivo de cancelamento, tentativas no cartão com o motivo da recusa, envios ao cliente, notas fiscais e anotações. Do cartão aparecem só a bandeira e o final.

Listar recorrências

Lista as recorrências (assinaturas) da empresa. Uma recorrência gera cobranças periodicamente.

Diagnosticar recorrência

Explica a situação de uma recorrência: o cartão vinculado e o histórico de trocas, as últimas cobranças geradas com a situação de cada uma e as tentativas no cartão com o motivo da recusa. Útil quando o cliente diz que cadastrou o cartão e deu erro, ou que a recorrência não cobrou.

Listar produtos

Lista os produtos e serviços cadastrados pela empresa, junto com os links de contratação de cada um.

Analisar

Agregam no servidor, para perguntas que envolvem muitos registros.

Resumo financeiro

Resumo financeiro da empresa em um período: quanto foi recebido, quanto há a receber, quanto está vencido e qual o saldo disponível para saque.

Analisar faturamento

Analisa o faturamento da empresa, somando no servidor. Responde a perguntas que não cabem numa listagem: evolução mês a mês, quais clientes mais pagaram, qual meio de pagamento predomina.

Cadastrar

Escrita reversível, sem aviso a ninguém.

Cadastrar cliente

Cadastra um novo cliente na empresa. Informe pelo menos o nome e o CPF/CNPJ. Não dispara nenhuma notificação ao cliente: apenas cria o cadastro, que pode ser editado depois no painel.

Ações sensíveis

Pedem confirmação em duas etapas. Veja a seção abaixo.

Criar cobrança

Cria uma cobrança avulsa para um cliente já cadastrado, com boleto e/ou pix. A cobrança é emitida na hora e o seu cliente recebe a notificação automaticamente.

Cancelar cobrança

Cancela uma cobrança. É irreversível, e o cancelamento pode se propagar para o boleto ou o pix já emitido.

Registrar pagamento

Registra o pagamento manual de uma cobrança (baixa manual). Use quando o cliente pagou por fora, em dinheiro, transferência ou pix direto na conta.

Cancelar recorrência

Cancela uma recorrência (assinatura). Ela para de gerar novas cobranças e não pode ser reativada por aqui. As cobranças já emitidas continuam válidas.

Tudo o mais

Dão acesso às 109 operações documentadas da API, por busca.

Buscar operações

Busca operações disponíveis na Clientbase por palavra-chave.

Detalhar operação

Mostra os detalhes de uma operação encontrada em search_operations: o que faz, quais parâmetros aceita e se exige confirmação do usuário.

Executar operação

Executa uma operação da Clientbase encontrada em search_operations.

Ações sensíveis pedem confirmação

Quatro ferramentas mexem em dinheiro ou avisam o seu cliente: criar cobrança, cancelar cobrança, registrar pagamento e cancelar recorrência. Elas nunca são executadas em uma única chamada.

  1. Na primeira chamada, o servidor devolve uma prévia do que vai acontecer (cliente, valor, vencimento) e um código de confirmação. Nada é executado.
  2. Somente na segunda chamada, acompanhada desse código, a ação é executada.

O código vale por 5 minutos, serve uma única vez e está amarrado àquela operação específica: um código emitido para cancelar a cobrança A não cancela a cobrança B. Há também um limite de 5 ações destrutivas a cada 10 minutos, que restringe o impacto de uma sequência de chamadas incorretas.

Leia a prévia antes de confirmar. O código garante que a ação executada é exatamente a que foi confirmada, mas não avalia se ela é adequada. Uma cobrança criada é emitida imediatamente, e a notificação é enviada ao seu cliente no mesmo momento.

Além das ferramentas: as operações da API

As ferramentas acima cobrem o dia a dia. Para o resto (contas a pagar, contratos, grupos de clientes, campos personalizados, links de pagamento, NFSe) o assistente tem acesso às 109 operações documentadas da API Clientbase, por busca: ele procura pelo que precisa, confere os parâmetros e executa. As mesmas regras de confirmação valem para as operações delicadas.

A referência completa dessas operações é a documentação da API REST.

Segurança e privacidade

O queComo funciona
Isolamento Toda consulta é feita a partir da sua conta. Não há como o assistente alcançar dados de outra empresa.
Autorização A autorização é feita na Clientbase, no mesmo padrão de um acesso por conta Google. O assistente nunca tem acesso à sua senha.
Dados do cliente CPF/CNPJ e contatos vão completos, como na API REST. São dados da sua própria base, e você autorizou a conexão.
Auditoria Cada chamada é registrada: ferramenta, argumentos, duração e resultado. O conteúdo das respostas não é armazenado.
Revogar Remova o conector no seu assistente. A autorização também pode ser encerrada a qualquer momento pela sua conta.

Confira as respostas do assistente. Um assistente de IA interpreta texto, e parte desse texto vem de fora (nome de cliente, descrição de cobrança), o que pode levar a interpretações incorretas. Para conferência contábil ou fiscal, use sempre o painel como fonte oficial.