DeepLedger

DeepLedger

QuickBooks 向け AI 経理担当者

DeepLedger は QuickBooks を Grok、ChatGPT、Claude などの AI エージェントに接続し、企業が自然言語を使って請求書、売上請求書、支払い、預金、仕訳などの取引を記録したり、財務レポートを実行したり、売掛金と買掛金を管理したり、月末決算の進捗を追跡したりできるようにします。

このリポジトリでは、DeepLedger を Claude Code、Cursor、Grok Build、Grok Bot 向けのプラグインとして提供しています。インストールして DeepLedger アカウントにサインインし、平易な言葉で簿記を依頼してください。エージェントは経理担当者のように QuickBooks の会社を処理します。支払先を検索し、重複を確認し、適切な取引タイプを選んで記録します。不確かなものは推測せず、人間のレビュアーに引き継ぎます。

QuickBooks Online が正式な帳簿として維持されます。DeepLedger は、貴社が Intuit 独自の OAuth フローを通じて許可した QuickBooks 接続を保持するため、プラグインが Intuit の認証情報を参照することはありません。サインインすれば、DeepLedger ポータルで開けるすべての会社にアクセスできます。

対象ユーザー

• QuickBooks Online で自社の帳簿を管理し、定型的な記帳、勘定科目の分類、レポート作成を任せたい中小企業の経営者や創業者。
• 多数の顧客企業を管理する簿記担当者や CPA 事務所。 1つの接続で会社を切り替えられ、すべての書き込みが同じプロトコルに従います。不確かな項目は、エージェントの判断理由とともにレビューキューに登録されます。
• 月末決算、照合準備、経営レポートを一から作成するのではなく、レビュー用のドラフトとして作成したい財務チーム。

機能

分野	エージェントが行うこと
銀行取引明細	未記録の銀行取引やカード取引を取得し、QuickBooks の支払先履歴に基づいて勘定科目を分類します。明らかなものは記録し、それ以外はレビュータスクを作成します
記録	書き込みの前に ID を検索して重複を確認し、支払い、請求書、売上請求書、顧客からの入金、預金、振替、返金、クレジット、仕訳を記録します
買掛金と売掛金	請求書を入力して未払い残高に対して支払い、顧客に売上請求書を発行して入金を充当し、クレジットを適用して、滞留状況を報告します
照合	銀行取引明細書やカード明細書を帳簿と照合し、照合ワークブックと未処理項目を準備します
月末決算	決算チェックリストを進め、調整仕訳と Close Sheet のドラフトを作成し、承認を得るために一式をレビュアーに引き継ぎます
レポートと分析	損益計算書、貸借対照表、滞留状況、カスタムレポートを実行し、期間を比較して変動の内容を説明します
監査準備	補助明細、証拠インデックス、不足書類のリストを作成します
メモリー	会社ごとの永続的な情報（ポリシー、反復パターン、背景情報）を保持し、今後の処理にレビュアーの修正を適用します
人間によるレビュー	不確かな項目はすべて、エージェントの判断理由を添えたタスクになります。レビュアーの決定はそのまま適用されます

使用方法

1. QuickBooks を接続します。 deepledger.ai で、Settings、QuickBooks、Connect の順に選択します。管理する会社ごとに繰り返します。

2. プラグインをホスト（下記）にインストールし、 ブラウザーが開いたらサインインします。

3. 平易な言葉で依頼します。 bookkeeping スキルは、会計に関する依頼に応じて有効になります。

   Which QuickBooks company is active?
   Process the bank feed.
   Record: paid $500 to Office Depot for office supplies with the company credit card.
   Enter the Acme invoice for $2,400, net 30.
   Reconcile the operating account against the August statement.
   Generate a P&L for last month and compare it to the prior month.
   Close the books for June.
   

4. エージェントがエスカレーションした内容を確認します。 DeepLedger ポータルで Tasks を開き、エージェントが判断に迷った項目を承認、再分類、または却下します。承認したタスクは次回の実行時に記録されます。

プラグイン自体はシンプルな構成です。DeepLedger のホスト型 MCP サーバーへのコネクターと、1つのスキルで構成されています。このスキルは手順を内包せず、依頼の種類ごとにサーバーの getGuide ツールから手順を取得するようエージェントに指示します。そのため、プラグインをリリースしなくてもサーバー上で簿記ガイダンスを更新できます。スラッシュコマンド、エージェント、フック、スクリプトはありません。

前提条件

• deepledger.ai で、QuickBooks Online の会社を少なくとも 1 社接続した DeepLedger アカウント（Settings、QuickBooks、Connect）
• 以下のホストのいずれか

インストール

マーケットプレイスでの公開状況は、各マーケットプレイスの審査状況によって異なります。掲載されるまでは、ホストに応じたローカルインストールを使用してください。

Claude Code

claude plugin marketplace add DeepLedger/deepledger-plugin
claude plugin install deepledger@deepledger-marketplace

ローカル開発：claude --plugin-dir ./deepledger-plugin。

Cursor

Customize、Marketplace の順に開き、DeepLedger を検索して Add を選択します。ローカルインストールの場合は、このリポジトリをクローンして Cursor のローカルプラグインフォルダーにシンボリックリンクを作成し、Cursor を再読み込みします。

git clone https://github.com/DeepLedger/deepledger-plugin.git
mkdir -p ~/.cursor/plugins/local
ln -s "$(pwd)/deepledger-plugin" ~/.cursor/plugins/local/deepledger

Grok Build

DeepLedger は、このリポジトリの特定のコミットに固定されたリモートソースとして、xAI plugin marketplace に掲載されています。Grok Build 内で /plugins を実行して拡張機能モーダルを開く（または /marketplace で閲覧する）と、DeepLedger を選択してインストールできます。Grok Build は .grok-plugin/plugin.json マニフェスト、スキル、.mcp.json を直接読み込みます。Grok が同梱の MCP サーバーに接続できるよう、プラグインを有効にして信頼してください。DeepLedger ツールを初めて呼び出すとブラウザーでのサインインが開き、/mcps で接続状況を確認できます。

マーケットプレイスの承認前にテストする場合は、GitHub から特定のリビジョンを直接インストールしてください。

grok plugin install DeepLedger/deepledger-plugin@<full-commit-sha> --trust

ローカル開発：grok --plugin-dir ./deepledger-plugin。

Grok Bot

Settings、Plugins の順に開き、DeepLedger を検索して Add を選択し、ブラウザーでサインインを完了します。@ を使ってプラグインをタスクに追加し、会計業務を依頼する前に、どの QuickBooks 会社がアクティブか尋ねてください。

サインイン

初回利用時、ホストはサーバーの OAuth 2.1 エンドポイント（PKCE を用いた認可コードフロー、動的クライアント登録）を検出し、ブラウザーでサインインを開きます。DeepLedger アカウントでサインインすると、接続が認可されます。DeepLedger の個人用 API キー（dl_live_...）も、プログラムから利用するクライアントの Bearer トークンとして使用できます。トランスポートは https://mcp.deepledger.ai/mcp 上の Streamable HTTP です。

ネットワークアクセスと認証情報

このプラグインには、スクリプト、バイナリ、フック、シェルコマンドは含まれていません。プラグインのすべての処理は、ホストされた MCP サーバーを介して行われます。唯一の実行時の例外は以下の添付ファイルのアップロードで、サーバーがエージェントに実行させる、シェル用にエスケープされた curl コマンドを返します。アクセスするネットワークエンドポイントは次のとおりです。

エンドポイント	用途
https://mcp.deepledger.ai/mcp	MCP サーバー（Streamable HTTP）。QuickBooks のすべての読み取りと書き込み、ガイド、タスク、メモリー、ドキュメント、レポート。
https://mcp.deepledger.ai/.well-known/oauth-authorization-server、/oauth/register、/oauth/authorize、/oauth/token、/oauth/revoke	OAuth 2.1 の検出、動的クライアント登録、PKCE を用いた認可コードフロー、トークンの更新と取り消し。
https://deepledger.ai	認可中にホストが開くブラウザーのサインインページ。
https://mcp.deepledger.ai/upload-to-qb	ファイル添付のアップロード。documents（操作 upload）は、エージェントがユーザーの選択したローカルファイル 1 件（上限 10 MB）をワンタイムトークンとともにこのパスへ送信するための curl コマンドを返し、サーバーが QuickBooks に転送します。ダウンロードや実行は行いません。

認証情報：DeepLedger アカウント（ブラウザーでの OAuth サインイン、スコープ quickbooks）。ホストが取得したトークンを保存します。プラグインは Intuit の認証情報を参照、保存、送信することはなく、ローカルファイル、環境変数、シークレットも読み取りません。QuickBooks へのアクセス範囲は、サインインしたユーザーが DeepLedger ポータルで開ける会社に限定されます。

スキルの仕組み

bookkeeping スキルは、会計に関するリクエストがあると常に起動します。アクティブな QuickBooks の会社を確認し、リクエストに合ったガイドタイプを指定してサーバーの getGuide ツールを呼び出し、返された手順、安全チェックリスト、よくある間違いに従います。

リクエスト	getGuide タイプ
支払い、請求書、インボイス、顧客からの入金、返金、クレジット、入金、振替、仕訳の記録、銀行フィード項目の分類、買掛金および売掛金の書き込み	transaction_recording
月次締め、調整仕訳、Close Sheet	month_end_closing
明細書の照合、照合差異の説明	reconciliation
レポートの比較、比率、傾向、予算差異	financial_analysis
監査またはレビューのサポート、証憑インデックス、不足書類	audit_preparation
エージェントが応答から解決できないツールの失敗	error_recovery（ツールおよびエラーコードごと）

マスターデータ、エージェントのメモリ、レビュータスク、書類、カスタムレポートは、それぞれのツールの説明に従います。QuickBooks への書き込みはすべて、引き続き transaction_recording プロトコルを経由します。

コネクターが提供するもの

.mcp.json コネクターは、DeepLedger の公式ホスト型 MCP サーバーを指定します。ローカルバイナリはインストールしません。サーバーは26個のツールを公開しており、すべてのツールがアクティブな QuickBooks の会社を操作し、結果にその会社名を記載します。

ツール	機能
qbCompanyProfile	アクティブな QuickBooks の会社を表示、一覧表示、または切り替えます
qbMasterData	勘定科目、仕入先、顧客、商品、クラス、税コードを検索、作成、または更新します
qbFetchTransactions	重複チェック、支払先履歴、未払いの請求書やインボイスのために取引を取得します
qbExpense	その場で支払う購入（カード、ACH、小切手、現金）を記録または更新します
qbBill	後払いの仕入先請求書を記録または更新します
qbPayment	未払いインボイスに顧客からの入金を適用するか、仕入先クレジットを適用して未払い請求書を支払います
qbInvoice	顧客向けインボイスを作成または更新します
qbSalesReceipt	その場で支払われた売上を記録するか、顧客に返金します
qbDeposit	保留中の入金または直接収入の項目をまとめて、銀行預金を記録します
qbTransfer	会社が所有する口座間で資金を移動します
qbCredit	仕入先または顧客のクレジットを記録します
qbJournalEntry	貸借が一致する仕訳を記録します
qbEstimate	見積もりを作成、更新、または変換します
qbRecurringTransaction	定期取引のテンプレートを管理します
qbProject	QuickBooks プロジェクトを一覧表示、作成、更新、終了します
qbCustomization	カスタムフィールドの定義と取引のディメンションを管理します
qbVoidTransaction	インボイス、売上レシート、返金レシート、支払い、または請求書の支払いを無効にします
qbSendEmail	QuickBooks を通じて販売書類を顧客にメールで送信します
qbReports	損益計算書、貸借対照表、売掛金・買掛金の年齢表、その他の QuickBooks レポートを実行します
getGuide	現在の記帳手順またはツールごとのエラー対応ガイドを読み込みます
tasks	エージェントと人間のレビュー担当者の間で共有されるタスクを確認します
agentMemory	会社ごとに保持されるナレッジを読み取り、維持します
bankFeed	未記録の銀行取引を取得し、記録後に処理済みの印を付けます
documents	DeepLedger ストレージまたは QuickBooks の添付ファイルから書類を読み取り、ファイルを QuickBooks のレコードにアップロードします
customReports	名前で保存済みのレポート定義を実行します
closeRun	月次締めとその Close Sheet の進捗を追跡します

安全モデル

すべての QuickBooks への書き込みは、transaction_recording ガイドとツールの説明に記載されたサーバーのプロトコルに従います。

1. 照合：qbMasterData でベンダー、顧客、勘定科目の ID を解決します。
2. 重複チェック：qbFetchTransactions で重複がないことを確認します。
3. 判断：証拠から受取人、カテゴリ、ツール、金額が明らかで、エージェントが確信を持てる場合は、エージェントが記録します。真に不確かな点がある場合に限り、具体的な理由を添えてレビュータスクを作成します。タスクに対するレビュアーの判断は、そのまま適用されます。

正確性を守るための制約は、確信があっても適用されます。未払いの請求書やインボイスがある場合は使用するツールが決まり、仕訳は貸借を一致させる必要があります。無効化の前には必ず取得して確認し、バッチ処理ツールはありません。各書き込みが完全なプロトコルを経るよう、取引はすべて個別に記録されます。ベンダーと顧客のカテゴリは保存済みのマッピングではなく、判断時点の QuickBooks の履歴から推定されるため、QuickBooks でカテゴリを変更すると、次の取引から反映されます。

アーキテクチャ

Plugin (this repo)
  skills/bookkeeping/SKILL.md  One skill: confirm company, pull the matching getGuide procedure, verify
  .grok-plugin/plugin.json     Grok Build manifest
  .claude-plugin/plugin.json   Claude Code manifest
  .mcp.json                    MCP connector for Claude Code and Grok Build
  .cursor-plugin/plugin.json   Cursor and Grok Bot manifest
  mcp.json                     MCP connector for Cursor
    | Streamable HTTP + OAuth 2.1
MCP server (hosted at https://mcp.deepledger.ai/mcp)
  26 tools (19 QuickBooks + 7 platform)
  getGuide procedures, tasks, memory, documents, bank feed, custom reports, close runs

QuickBooks への接続

1. deepledger.ai にログインします
2. ［設定］から［QuickBooks］を開きます
3. ［QuickBooks に接続］をクリックして、アクセスを許可します
4. 接続すると、プラグインはその会社のデータを読み書きできるようになります

データの取り扱いとサポート

• DeepLedger および QuickBooks から返されるデータは、ホストセッション内で処理され、DeepLedger の利用規約とプライバシーポリシーが適用されます。
• 書き込みは稼働中の QuickBooks Online の会社に対して行われます。重大な処理を承認する前に、エージェントが提案した取引を確認してください。無効化は元に戻せません。
• サポート：[email protected]。プラグインに関する問題：GitHub の課題。

バージョンとライセンス

リリース履歴についてはCHANGELOG.mdを参照してください。MIT ライセンスについてはLICENSEを参照してください。