BillingEngine API를 통해 AI 클라이언트가 고객 관리, 송장 초안 생성, 송장 목록 조회 및 결제 기록을 수행할 수 있도록 합니다.
다른 이름 billingengine/billingengine-mcp, billingengine-mcp
- 스타
- 0
- Tools
- 10
- 다운로드, 30일
- 841
- 최신 버전
- 0.2.2
- 마지막 커밋
- 2026년 11월 6일
- 라이선스
- MIT
BillingEngine MCP란?
BillingEngine API를 통해 AI 클라이언트가 고객 관리, 송장 초안 생성, 송장 목록 조회 및 결제 기록을 수행할 수 있도록 합니다. 10개 도구를 제공합니다. 예: find_customers, create_customer, update_customer.
프로젝트 README에서 생성된 요약
BillingEngine MCP server 정보
이 서버는 프리랜서와 소규모 사업자가 AI 인터페이스를 통해 고객 기록과 재무 문서를 관리할 수 있게 해줍니다. BillingEngine API에 연결하면 Claude Desktop, Cursor 또는 Claude Code와 같은 클라이언트를 통해 자연어로 인보이싱 소프트웨어와 상호작용할 수 있습니다. 서버는 Node.js 20 이상의 환경에서 로컬 컴퓨터에 실행되며, 작동을 위해 유료 BillingEngine 계정과 유효한 API 키가 필요합니다.
사용자는 find_customers를 통한 고객 검색, 송장 초안 생성, 특정 필터를 사용한 기존 송장 목록 조회 등 다양한 관리 작업을 수행할 수 있습니다. 또한 결제 기록 및 PDF 또는 XML 전자 송장을 다운로드 폴더로 직접 다운로드하는 기능도 제공합니다. 서버는 송장 초안만 생성하므로 고객에게 문서가 자동으로 전송되지 않으며, 사용자가 최종 확정 전 모든 항목을 검토할 수 있습니다. 시스템은 API 키당 분당 60회 요청 제한이 적용됩니다.
활용 사례
- 1새 결제 초안 생성AI에게 특정 고객과 금액에 대한 새로운 송장 초안을 생성하도록 요청합니다.
- 2미결제 금액 추적시스템 조회를 통해 어떤 고객의 송장이 연체되었는지 확인합니다.
- 3수령 금액 기록AI에게 특정 송장 번호에 대한 결제 내용을 기록하도록 명령합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
BillingEngine MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 BillingEngine MCP 설치
$ claude mcp add --env 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' billingengine-mcp -- npx -y billingengine-mcpCursor에 BillingEngine MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"billingengine-mcp": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}VS Code에 BillingEngine MCP 설치
.vscode/mcp.json
{
"servers": {
"billingengine-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}VS Code CLI에 BillingEngine MCP 설치
$ code --add-mcp '{"name":"billingengine-mcp","type":"stdio","command":"npx","args":["-y","billingengine-mcp"],"env":{"BILLINGENGINE_API_KEY":"<YOUR_BILLINGENGINE_API_KEY>"}}'Claude Desktop에 BillingEngine MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"billingengine-mcp": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}Codex에 BillingEngine MCP 설치
$ codex mcp add billingengine-mcp --env 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' -- npx -y billingengine-mcpCodex config.toml에 BillingEngine MCP 설치
~/.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>"
Gemini CLI에 BillingEngine MCP 설치
$ gemini mcp add -s user -e 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' billingengine-mcp npx -- -y billingengine-mcpGemini settings.json에 BillingEngine MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"billingengine-mcp": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}BillingEngine MCP 도구 10
README에서 감지됨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 | — |
구성
BILLINGENGINE_API_KEY필수비밀API key from Settings > API keys in BillingEngine (paid plans only)
| 이름 | 설명 | 유형 |
|---|---|---|
| BILLINGENGINE_API_KEY | API key from Settings > API keys in BillingEngine (paid plans only) | 필수비밀 |
자동 검사
2026년 11월 12일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용검사되지 않음
- 파괴적인 도구에 라벨 표시됨통과
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음통과
README
GitHub에서 보기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 질문
BillingEngine MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' billingengine-mcp -- npx -y billingengine-mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
BillingEngine MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
BillingEngine MCP는 어떤 도구를 제공하나요?
10개 도구를 제공합니다. 예: find_customers, create_customer, update_customer, create_invoice, update_invoice.
이 서버를 사용하여 고객에게 송장을 직접 보낼 수 있나요?
아니요, 송장은 BillingEngine 내에서 사용자가 직접 검토하고 보낼 수 있도록 초안 상태로 생성됩니다.
MCP server를 통해 기록을 삭제할 수 있나요?
아니요, 이 서버는 삭제 작업을 지원하지 않습니다.
API 호출 제한은 어떻게 되나요?
API 키당 분당 60회 요청이 가능합니다.
무료 플랜에서도 이 서버를 사용할 수 있나요?
아니요, API는 무료 플랜에서 사용할 수 없으므로 유료 플랜이 필요합니다.