LedgerCrossing for QuickBooks Desktop

LedgerCrossing — QuickBooks Desktop 向け MCP サーバーおよび HTTP API

LedgerCrossing は、QuickBooks Desktop（Pro、Premier、Enterprise）に HTTP/qbXML API と MCP サーバーを提供します。アプリや AI エージェントは、同じマシン、オフィスのネットワーク、または LedgerCrossing Remote を通じたインターネット経由でアクセスできます。

Claude、ChatGPT、Cursor、VS Code など、あらゆる MCP クライアントが、240 件すべての qbXML 操作を網羅する 6 つのツールを利用できます。独自のコードからは POST /api/v1/qbxml を使い、 qbXML を送信すると qbXML が返ってきます。ホストする SOAP サービスも、Web Connector によるポーリングも不要です。

このリポジトリには、ドキュメント、サンプル、MCP Registry のエントリー（server.json）、およびリリースに含まれる Claude Desktop 拡張バンドル（.mcpb）が格納されています。 LedgerCrossing アプリ自体は商用の Windows アプリです。買い切りで、マシンごとのライセンスであり、会社ファイル数に制限はありません。価格は ledgercrossing.com をご覧ください。ソースコードはこのリポジトリにはなく、QuickBooks を実行しているマシンにアプリをインストールしないと、ここにあるものは動作しません。

互換性： LedgerCrossing は、Web リクエストを送信できるあらゆるものと連携できます。現在 Web Connector を通じて同期している市販アプリはベンダーが管理しており、LedgerCrossing はそれらの仕組みを置き換えるものではありません。連携を管理しているのがご自身（または開発者）であれば、切り替えは簡単です。現在送信しているものと同じ qbXML を HTTP POST で送信してください。

QuickBooks Desktop にこれが必要な理由

QuickBooks Desktop にはクラウド API がありません。実行中のマシン上にある COM インターフェース経由でのみ qbXML を受け付けます。Intuit の公式 AI コネクターは QuickBooks Online が対象であり、Desktop は対象外です。LedgerCrossing は QuickBooks と同じマシン上で動作し、ツールから呼び出せるエンドポイントを提供します。

AI クライアントを接続する

AI が QuickBooks のマシンに対してどこで動作するかに応じて、接続方法を選択してください。

クライアント	接続元	方法	必要なもの
Claude Desktop	QuickBooks のマシン	.mcpb バンドル	コピー不要
Claude Desktop	オフィス内の別のマシン	.mcpb バンドル + アドレスと API キー	Settings > Allowed Connections > Local network を有効にする
claude.ai、ChatGPT、Meta Muse	場所を問わず	LedgerCrossing Remote（39 ドル/月）	ユーザーごとのサインイン（OAuth）。Meta Muse には LedgerCrossing 1.15.1 以降が必要
Claude Code、Cursor、VS Code	上記のいずれか	HTTP 設定	MCP URL + API キー（同じマシンまたはオフィス）。Remote 経由でサインイン
Codex、Gemini CLI	QuickBooks のマシンまたはオフィス	クイックスタート	QuickBooks のマシンには不要（stdio）。別のマシンからは MCP URL + API キー

MCP エンドポイントは http://<machine>:8284/mcp（ストリーミング可能な HTTP）です。アプリの Settings > Allowed Connections に、正確なアドレスと API キーが表示されます。

Claude Desktop

1. このリポジトリの 最新リリースから ledgercrossing.mcpb をダウンロードします。
2. Claude Desktop で Settings > Extensions > Advanced settings > Extension Developer > Install Extension… を開き、ファイルを選択します。（Windows では .mcpb にファイルの関連付けがないため、 ダブルクリックしても開けません。）
3. QuickBooks のマシンでは設定をデフォルトのままにします。オフィス内の別のマシンでは、 LedgerCrossing address（例：http://qb-server:8284）を設定し、API key を貼り付けます。

設定ファイルを使う場合は、examples/mcp-configs/claude_desktop_config.json をご覧ください（stdio モード。同じマシンでのみ使用できます）。

Claude Code、Cursor、VS Code

claude mcp add --transport http quickbooks http://localhost:8284/mcp --header "X-Api-Key: YOUR_KEY"

Cursor と VS Code の設定は examples/mcp-configs/ にあります。別の オフィス用コンピューターから接続する場合は、localhost をそのコンピューターの名前に置き換えてください。どこからでも、 claude.ai と同じ方法で、個人ごとのサインインを利用して LedgerCrossing Remote 経由で接続できます（/docs/connect を参照してください）。

次のように尋ねてみましょう： 「支払期限を60日以上過ぎている顧客はどれですか？」

6つのツール

ツール	機能
list_operations	240個の qbXML オペレーションをカテゴリと必要な QuickBooks の最小バージョンとともに一覧表示または検索します
get_operation	1つのオペレーションの完全なフィールドリファレンスです。要素の順序、必須フィールド、最大文字数、列挙値を確認できます
validate_qbxml	QuickBooks に接続せずに、リクエストをカタログに照らして検証します
run_qbxml	QuickBooks Desktop で qbXML を実行し、レスポンスを返します
explain_error	QuickBooks のステータスコードを、エラーの原因と変更すべき内容に置き換えて説明します
get_status	QuickBooks が起動しているか、どの会社ファイルが開いているか、ブリッジが接続されているかを確認します

エージェントは必要な情報を必要に応じて取得する（list_operations → get_operation → validate_qbxml → run_qbxml）ため、カタログの情報がコンテキストにあふれることはありません。

エージェントを接続する前に： エージェントは書き込みを行えます。QuickBooks が動作しているコンピューターとオフィスのネットワークでは、 run_qbxml を使って、HTTP API と同じ権限で請求書や支払いを作成したり、編集したりできます。LedgerCrossing Remote 経由の場合、オーナーが変更を許可するまでは、各ユーザーは読み取り専用で利用を開始します。上限のないクエリはデフォルトで拒否され、 QuickBooks の監査証跡には、登録されたすべての取引が記録されます。信頼できるエージェントを、アクセスさせる会社ファイルに接続してください。

独自のコードから呼び出す

curl -s http://localhost:8284/api/v1/qbxml \
  -H "X-Api-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"qbxml": "<?xml version=\"1.0\"?><?qbxml version=\"13.0\"?><QBXML><QBXMLMsgsRq onError=\"stopOnError\"><CustomerQueryRq><MaxReturned>10</MaxReturned></CustomerQueryRq></QBXMLMsgsRq></QBXML>"}'

examples/ には、Python、Node.js、PowerShell の例と、リクエストを送信する前に検証する方法があります。

エンドポイント	用途
POST /api/v1/qbxml	qbXML リクエストを実行します
POST /api/v1/validate	QuickBooks とのやり取りなしで、qbXML をカタログに照らして検証します
GET /api/v1/docs?search=	オペレーションカタログを検索します
GET /api/v1/docs/{operation}	例：CustomerQuery など、1つのオペレーションのフィールドリファレンスを表示します
GET /api/v1/errors/{code}	QuickBooks のステータスコードを説明します
GET /api/v1/health	稼働状況を確認します
POST /mcp	MCP エンドポイント（ストリーミング可能な HTTP）

どこからでも接続

• 同じコンピューター： http://localhost:8284。
• オフィスのネットワーク： Settings > Allowed Connections > Local network をオンにします。アプリでは最初に API キーが必要で、ファイアウォールルールも独自に管理します。無料です。
• インターネット： LedgerCrossing Remote（月額39ドル）。個人ごとのサインインに対応したマネージド HTTPS リレーで、claude.ai と ChatGPT が必要とするものです（Meta Muse もこの方法で検証済みです）。または、API キーヘッダーを送信できるクライアント向けに、無料ガイドを使って独自のトンネルを構成できます。

必要条件

• QuickBooks Desktop Pro、Premier、または Enterprise が動作する Windows 10 または 11、あるいは Windows Server 2016～2025。
• 会社ファイルを開いた状態（または自動で開ける状態）で QuickBooks が起動していること。これは QuickBooks Desktop の制約です。
• そのコンピューターに LedgerCrossing がインストールされ、ライセンス認証済みであること（Meta Muse には 1.15.1 以降が必要です）。

リンク

• 製品と価格：https://ledgercrossing.com
• MCP クイックスタート：https://ledgercrossing.com/docs/mcp
• Claude を QuickBooks Desktop に接続する方法。すべての選択肢を比較：https://ledgercrossing.com/connect-claude-to-quickbooks-desktop
• claude.ai と ChatGPT のセットアップ：https://ledgercrossing.com/docs/connect
• サポート：[email protected]

ライセンス

このリポジトリ内のドキュメント、サンプル、server.json は MIT ライセンスの下でライセンスされています（ LICENSE を参照）。LedgerCrossing アプリと .mcpb バンドルは商用ソフトウェアであり、 ledgercrossing.com に記載された条件に基づき、マシン単位でライセンスされます。MIT ライセンスの適用対象ではありません。

---

QuickBooks は Intuit Inc. の登録商標です。LedgerCrossing は QuickBooks Desktop 向けの独立した製品であり、Intuit とは提携しておらず、Intuit の推奨を受けていません。クライアント名はそれぞれの所有者に帰属します。