BillingEngine MCP

Crie faturas e clientes e registre pagamentos no BillingEngine a partir do Claude, Cursor e qualquer cliente MCP.

Documentação

Servidor MCP BillingEngine

Crie clientes e faturas, consulte faturas em aberto e registre pagamentos no BillingEngine conversando com Claude, Cursor ou qualquer outro cliente MCP:

"Crie uma fatura para a Acme Painting de 100 euros."

"Quais faturas estão vencidas?"

"A Acme pagou a fatura 2610030028, registre o pagamento."

O BillingEngine é um software de faturamento para freelancers e pequenas empresas com fatura eletrônica (EN 16931, XRechnung, ZUGFeRD / Factur-X). O servidor é uma camada fina sobre a API do BillingEngine e roda no seu computador.

Requisitos

Node.js 20 ou mais recente
Uma conta BillingEngine em um plano pago. A API não está disponível no plano gratuito.
Sua chave de API em Configurações > API no BillingEngine

Configuração

Claude Desktop

Adicione isto ao 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

Use os mesmos command, args e env acima nas configurações de MCP do seu cliente.

Ferramentas

Ferramenta	O que faz
`find_customers`	Pesquisa clientes por empresa, nome ou e-mail
`create_customer`	Cria um cliente
`update_customer`	Altera um cliente
`create_invoice`	Cria uma fatura rascunho para um cliente
`update_invoice`	Altera uma fatura rascunho
`list_invoices`	Lista faturas, filtradas por status, cliente, número ou data
`get_invoice`	Retorna uma fatura com itens e status de pagamento
`download_invoice`	Salva o PDF ou o XML da fatura eletrônica na sua pasta de Downloads
`record_payment`	Registra um pagamento para faturas enviadas
`list_payments`	Lista pagamentos, opcionalmente para uma fatura

O que faz e o que não faz

As faturas são criadas como rascunhos. Nada é enviado aos seus clientes; você revisa e envia a fatura no BillingEngine. Cada resultado contém um link para abrir o rascunho.
Os preços são líquidos. Número, idioma, textos, tratamento de IVA e condições de pagamento vêm das configurações da sua conta, exatamente como no formulário de fatura.
Nada pode ser excluído por meio deste servidor.
Novas faturas contam para o máximo mensal de faturas do seu plano.
A API permite 60 solicitações por minuto por chave.
Sua chave permanece no seu computador e é enviada apenas ao BillingEngine.

Se uma chave for exposta, gere uma nova em Configurações > API. A chave antiga para de funcionar imediatamente. As configurações também mostram quando a chave foi usada pela última vez.

Configuração

Variável	Significado
`BILLINGENGINE_API_KEY`	Sua chave de API (obrigatória)
`BILLINGENGINE_URL`	URL base, padrão é `https://www.billingengine.com`

Desenvolvimento

npm install
npm run build
BILLINGENGINE_API_KEY=... node dist/index.js

Licença

MIT. O BillingEngine em si é um serviço comercial; consulte billingengine.com.