BillingEngine

BillingEngine MCP サーバー

Claude、Cursor、またはその他の MCP クライアントに話しかけて、BillingEngine で顧客や請求書を作成したり、未払いの請求書を検索したり、支払いを記録したりできます。

「Acme Painting に 100 ユーロを超える請求書を作成して。」

「期限を過ぎた請求書はどれ？」

「Acme が請求書 2610030028 の代金を支払ったので、支払いを記録して。」

BillingEngine は、電子請求書（EN 16931、XRechnung、ZUGFeRD / Factur-X）に対応した、フリーランサーや小規模事業者向けの請求書ソフトウェアです。このサーバーは BillingEngine API の薄いレイヤーとして、コンピューター上で動作します。

必要条件

• Node.js 20 以降
• 有料プランの BillingEngine アカウント。Free プランでは API を利用できません。
• BillingEngine の Settings > API keys から取得した API キー

セットアップ

Claude Desktop

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 およびその他のクライアント

クライアントの MCP 設定で、上記と同じ command、args、env を使用します。

ツール

ツール	機能
find_customers	会社名、名前、メールアドレス、または別システムの識別子で顧客を検索します
create_customer	顧客を作成します
update_customer	顧客情報を変更します
create_invoice	顧客の下書き請求書を作成します
update_invoice	下書き請求書を変更します
list_invoices	ステータス、種類、顧客、番号、識別子、または日付で絞り込んで請求書を一覧表示します
get_invoice	品目、税額の内訳、ステータスを含む請求書を返します
download_invoice	PDF または XML 電子請求書を Downloads フォルダーに保存します
record_payment	送付済み請求書の支払いを記録します
list_payments	必要に応じて特定の請求書に絞り込み、支払いを一覧表示します

できること・できないこと

• 請求書は下書きとして作成されます。顧客に送信されることはありません。BillingEngine で請求書を確認して送信してください。すべての結果に、下書きを開くためのリンクが含まれます。
• 価格はアカウントで設定したとおり、税抜きまたは税込みになります。各請求書にはその旨が記載されます。結果の金額は "119.00" のような小数文字列です。番号、言語、テキスト、VAT の扱い、支払い条件は、請求書フォームと同じくアカウント設定に従います。
• このサーバーから削除することはできません。
• 新しい請求書は、プランの月間請求書上限に加算されます。
• API キーごとに、API へのリクエストは 1 分あたり 60 回までです。
• キーはコンピューター上に保持され、BillingEngine にのみ送信されます。

キーが漏えいした場合は、Settings > API keys で新しいキーを作成してください。古いキーは直ちに無効になります。設定画面では、キーが最後に使用された日時も確認できます。

設定

変数	説明
BILLINGENGINE_API_KEY	API キー（必須）
BILLINGENGINE_URL	ベース URL。既定値は https://www.billingengine.com です

開発

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

ライセンス

MIT。BillingEngine 自体は商用サービスです。詳しくは billingengine.com をご覧ください。