BillingEngine API aracılığıyla AI istemcilerinin müşterileri yönetmesine, taslak faturalar oluşturmasına, faturaları listelemesine ve ödemeleri kaydetmesine olanak tanır.
Ayrıca bilinen adı billingengine/billingengine-mcp, billingengine-mcp
- Yıldızlar
- 0
- Araçlar
- 10
- İndirmeler, 30 gün
- 841
- En son sürüm
- 0.2.2
- Son commit
- 6 Kas 2026
- Lisans
- MIT
BillingEngine MCP nedir?
BillingEngine bir MCP sunucusudur. BillingEngine API aracılığıyla AI istemcilerinin müşterileri yönetmesine, taslak faturalar oluşturmasına, faturaları listelemesine ve ödemeleri kaydetmesine olanak tanır. 10 araç sunar; örneğin find_customers, create_customer, update_customer.
Özet, projenin README dosyasından oluşturuldu
BillingEngine MCP sunucusu hakkında
Bu sunucu, serbest çalışanların ve küçük işletme sahiplerinin müşteri kayıtlarını ve finansal belgeleri bir AI arayüzü üzerinden yönetmesini sağlar. Kullanıcılar, BillingEngine API'sine bağlanarak Claude Desktop, Cursor veya Claude Code gibi istemciler aracılığıyla doğal dil kullanarak faturalandırma yazılımlarıyla etkileşime girebilirler. Sunucu, bilgisayarınızda Node.js 20 veya daha yeni bir sürüm kullanarak yerel olarak çalışır; çalışması için ücretli bir BillingEngine hesabına ve geçerli bir API anahtarına ihtiyaç duyar.
Kullanıcılar, find_customers ile müşteri arama, taslak fatura oluşturma ve belirli filtrelerle mevcut faturaları listeleme gibi çeşitli idari görevleri yerine getirebilirler. Araç seti ayrıca ödemeleri kaydetmeye ve PDF veya XML e-faturaları doğrudan İndirilenler klasörünüze indirmeye de olanak tanır. Sunucu yalnızca taslak faturalar oluşturduğundan, hiçbir belge müşterilere otomatik olarak gönderilmez; bu da her girişi onaylamadan önce inceleyebilmenizi sağlar. Sistem, API anahtarı başına dakikada 60 istek sınırı ile çalışmaktadır.
Neler yapabilirsiniz
- 1Yeni fatura taslakları oluşturunBelirli bir müşteri ve tutar için yeni bir taslak fatura oluşturması için AI'ya talimat verin.
- 2Ödenmemiş ödemeleri takip edinSistemi sorgulayarak hangi müşterilerin vadesi geçmiş faturaları olduğunu tespit edin.
- 3Alınan fonları kaydedinBelirli bir fatura numarasına karşılık bir ödeme kaydetmesi için AI'ya komut verin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
BillingEngine MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleBillingEngine MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' billingengine-mcp -- npx -y billingengine-mcpBillingEngine MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"billingengine-mcp": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}BillingEngine MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"billingengine-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}BillingEngine MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"billingengine-mcp","type":"stdio","command":"npx","args":["-y","billingengine-mcp"],"env":{"BILLINGENGINE_API_KEY":"<YOUR_BILLINGENGINE_API_KEY>"}}'BillingEngine MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"billingengine-mcp": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}BillingEngine MCP'yi Codex içine yükleyin
$ codex mcp add billingengine-mcp --env 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' -- npx -y billingengine-mcpBillingEngine MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.billingengine-mcp] command = "npx" args = ["-y", "billingengine-mcp"] [mcp_servers.billingengine-mcp.env] BILLINGENGINE_API_KEY = "<YOUR_BILLINGENGINE_API_KEY>"
BillingEngine MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' billingengine-mcp npx -- -y billingengine-mcpBillingEngine MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"billingengine-mcp": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}BillingEngine MCP araçları 10
README dosyasından algılandıfind_customerscreate_customerupdate_customercreate_invoiceupdate_invoicelist_invoicesget_invoicedownload_invoicerecord_paymentlist_payments
| find_customers | — | |
| create_customer | — | |
| update_customer | — | |
| create_invoice | — | |
| update_invoice | — | |
| list_invoices | — | |
| get_invoice | — | |
| download_invoice | — | |
| record_payment | — | |
| list_payments | — |
Yapılandırma
BILLINGENGINE_API_KEYGerekliGizliAPI key from Settings > API keys in BillingEngine (paid plans only)
| Ad | Açıklama | Sunucu |
|---|---|---|
| BILLINGENGINE_API_KEY | API key from Settings > API keys in BillingEngine (paid plans only) | GerekliGizli |
Otomatik kontroller
Çalıştırıldı 12 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirGeçti
- Açık kaynak lisansı (OSI)Geçti
- Son bir yıl içinde commit veya sürüm mevcutGeçti
- Paket adı popüler bir pakete yakın değilGeçti
- Uzak uç nokta HTTPS kullanıyorKontrol edilmedi
- Yıkıcı araçlar etiketlenmişGeçti
- Modele yönelik gizli talimat yokGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokGeçti
BillingEngine MCP server
Create customers and invoices, look up open invoices and record payments in BillingEngine by talking to Claude, Cursor or any other MCP client:
"Create an invoice for Acme Painting over 100 euros."
"Which invoices are overdue?"
"Acme paid invoice 2610030028, record the payment."
BillingEngine is invoicing software for freelancers and small businesses with e-invoicing (EN 16931, XRechnung, ZUGFeRD / Factur-X). The server is a thin layer over the BillingEngine API and runs on your computer.
Requirements
- Node.js 20 or newer
- A BillingEngine account on a paid plan. The API is not available in the Free plan.
- Your API key from Settings > API keys in BillingEngine
Setup
Claude Desktop
Add this to 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 and other clients
Use the same command, args and env as above in the MCP settings of your client.
Tools
| Tool | What it does |
|---|---|
find_customers |
Searches customers by company, name, email or identifier of another system |
create_customer |
Creates a customer |
update_customer |
Changes a customer |
create_invoice |
Creates a draft invoice for a customer |
update_invoice |
Changes a draft invoice |
list_invoices |
Lists invoices, filtered by status, type, customer, number, identifier or date |
get_invoice |
Returns one invoice with items, tax breakdown and status |
download_invoice |
Saves the PDF or the XML e-invoice to your Downloads folder |
record_payment |
Records a payment for sent invoices |
list_payments |
Lists payments, optionally for one invoice |
What it does and does not do
- Invoices are created as drafts. Nothing is sent to your customers; you review and send the invoice in BillingEngine. Every result contains a link to open the draft.
- Prices are net or gross, as set in your account; every invoice says which. Amounts in results are decimal strings such as
"119.00". Number, language, texts, VAT treatment and payment terms come from your account settings, exactly as in the invoice form. - Nothing can be deleted through this server.
- New invoices count towards the monthly invoice maximum of your plan.
- The API allows 60 requests per minute per key.
- Your key stays on your computer and is only sent to BillingEngine.
If a key is ever exposed, create a new one under Settings > API keys. The old key stops working immediately. The settings also show when the key was last used.
Configuration
| Variable | Meaning |
|---|---|
BILLINGENGINE_API_KEY |
Your API key (required) |
BILLINGENGINE_URL |
Base URL, defaults to https://www.billingengine.com |
Development
npm install
npm run build
BILLINGENGINE_API_KEY=... node dist/index.js
License
MIT. BillingEngine itself is a commercial service; see billingengine.com.
BillingEngine MCP soruları
BillingEngine MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' billingengine-mcp -- npx -y billingengine-mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
BillingEngine MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
BillingEngine MCP hangi araçları sunar?
10 araç sunar; bunlar arasında find_customers, create_customer, update_customer, create_invoice, update_invoice yer alır.
Bu sunucuyu kullanarak faturaları doğrudan müşterilere gönderebilir miyim?
Hayır, faturalar BillingEngine içinde incelemeniz ve manuel olarak göndermeniz için taslak olarak oluşturulur.
MCP server üzerinden kayıtları silmek mümkün mü?
Hayır, sunucu herhangi bir silme işlemini desteklememektedir.
API hız limitleri nelerdir?
API, API anahtarı başına dakikada 60 isteğe izin verir.
Ücretsiz plan bu sunucuyu destekliyor mu?
Hayır, API ücretsiz planda mevcut olmadığı için ücretli bir planınızın olması gerekir.