Listar clientes
Lista os clientes da empresa, com filtros opcionais. Retorna no máximo 50 registros por vez; para totais maiores, refine os filtros.
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”.
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.
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.
Leitura. Nunca alteram nada na conta.
Lista os clientes da empresa, com filtros opcionais. Retorna no máximo 50 registros por vez; para totais maiores, refine os filtros.
Retorna os dados de um cliente específico da empresa.
Lista as cobranças (faturas) da empresa, com filtros opcionais. Use para responder sobre inadimplência, recebimentos e faturas em aberto.
Retorna os dados de uma cobrança específica.
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.
Lista as recorrências (assinaturas) da empresa. Uma recorrência gera cobranças periodicamente.
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.
Lista os produtos e serviços cadastrados pela empresa, junto com os links de contratação de cada um.
Agregam no servidor, para perguntas que envolvem muitos registros.
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.
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.
Escrita reversível, sem aviso a ninguém.
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.
Pedem confirmação em duas etapas. Veja a seção abaixo.
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.
Cancela uma cobrança. É irreversível, e o cancelamento pode se propagar para o boleto ou o pix já emitido.
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.
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.
Dão acesso às 109 operações documentadas da API, por busca.
Busca operações disponíveis na Clientbase por palavra-chave.
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.
Executa uma operação da Clientbase encontrada em search_operations.
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.
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.
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.
| O que | Como 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.