BillingEngine MCP

Crie faturas e clientes e registre pagamentos no BillingEngine a partir de qualquer cliente MCP. As faturas são criadas como rascunhos e nada pode ser excluído.

Documentação

O que você pode fazer

O servidor MCP BillingEngine conecta assistentes de IA, como Claude ou Cursor, à sua conta. Você diz o que precisa, e o assistente faz com seus dados do BillingEngine:

  • Crie uma fatura para o Malermeister Müller no valor de 100 euros.
  • Quais faturas estão vencidas?
  • Müller pagou a fatura 2610030028, registre o pagamento.

Configuração

Você precisa do Node.js 20 ou mais recente, uma conta BillingEngine em um plano pago e sua chave de API em Configurações > API.

Claude Desktop: adicione o servidor em claude_desktop_config.json.

{
  "mcpServers": {
    "billingengine": {
      "command": "npx",
      "args": ["-y", "billingengine-mcp"],
      "env": { "BILLINGENGINE_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Claude Code:

claude mcp add billingengine \
  --env BILLINGENGINE_API_KEY=YOUR_API_KEY \
  -- npx -y billingengine-mcp

Cursor e outros clientes MCP: use o mesmo comando, argumentos e variável de ambiente nas configurações do cliente.

O código-fonte é aberto (licença MIT) no GitHub.

Ferramentas

FerramentaDescrição
find_customersBusca clientes por empresa, nome ou e-mail
create_customerCria um cliente
update_customerAltera um cliente
create_invoiceCria um rascunho de fatura para um cliente
update_invoiceAltera um rascunho de fatura
list_invoicesLista faturas, filtradas por status, cliente, número ou data
get_invoiceRetorna uma fatura com seus itens e status de pagamento
download_invoiceSalva o PDF ou a e-fatura XML de uma fatura no seu computador
record_paymentRegistra um pagamento para faturas enviadas
list_paymentsLista pagamentos, opcionalmente para uma fatura

O que o servidor não faz

  • Ele cria faturas como rascunhos. Nada é enviado aos seus clientes; você revisa e envia cada fatura no BillingEngine.
  • Ele não pode excluir nada.
  • Ele roda no seu computador e fala com o BillingEngine apenas com sua chave de API. Você pode substituir a chave nas suas configurações a qualquer momento; as configurações também mostram quando ela foi usada pela última vez.
  • Novas faturas contam para o máximo mensal de faturas do seu plano, e a API permite 60 solicitações por minuto por chave.