PolyAccounts synthetic accounting demo について
PolyAccounts synthetic accounting demo は、架空の会社データで残高と元帳証拠を示す、MCP クライアント向けの会計デモです。アカウント、API キー、ネットワーク接続は不要で、ツールは読み取り専用です。
主な機能
- 01読み取り専用の会計ツール4種
- 02正確な金額と元帳証拠
- 03架空会社データを同梱
- 04アカウントや API キー不要
- 05オフライン動作、ファイル書き込みなし
活用シーン
- 01合成データで費用変動を確認
- 02会計レポートと仕訳を照合
- 03実企業への接続前に評価
MCP 対応
MCPB 拡張機能と stdio デモサーバーとして、対応する MCP クライアントから利用できます。読み取り専用ツール4種とレビュー用プロンプト2種を公開し、ネットワーク通信は行いません。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
PolyAccounts エージェントキット
AI エージェントと連携する企業の会計。
企業を接続する前に、正確な残高と追跡可能な元帳の証拠を確認してください。 このリポジトリには、公開コネクターコードと架空のデモデータのみが含まれています。
| 接続 | 機能 | 必要なもの |
|---|---|---|
| サンドボックス | エージェント自身が作成する、勘定科目表の初期セット、2か月分の取引、7日間有効なフルアクセス認証情報を備えた合成企業 | npx -y --package=https://github.com/andrewblount/polyaccounts-agent-kit/releases/download/v1.2.2/polyaccounts-mcp-1.2.2.tgz polyaccounts-mcp を実行してから、create_sandbox を呼び出します |
| リモート MCP | OAuth 2.1 を使用する https://polyaccounts.com/mcp のストリーマブル HTTP | リモート MCP に対応するクライアント(Claude、ChatGPT、Cursor など)。管理者が一度承認します |
| ホスト型コネクター(stdio) | 企業単位の全件読み取り、作成、更新、論理削除、文書化された会計ワークフロー | Node.js 20 以降と Settings の認証情報、またはサンドボックス |
| 合成デモ | 4つの読み取り専用ツール、2つのレビュー用プロンプト、架空の企業 | Node.js 20 以降、または MCPB 対応のデスクトップクライアント |
npx -y --package=https://github.com/andrewblount/polyaccounts-agent-kit/releases/download/v1.2.2/polyaccounts-mcp-1.2.2.tgz polyaccounts-mcp # full connector. with no credential, call create_sandbox
npx -y --package=https://github.com/andrewblount/polyaccounts-agent-kit/releases/download/v1.2.2/polyaccounts-mcp-1.2.2.tgz polyaccounts-demo # read-only synthetic demo
PolyAccounts は早期アクセス版です。サンドボックスまたは承認済みのワークスペースで、合成データを使用して評価してください。このリリースは、実際の顧客の帳簿や法定会計には使用しないでください。読み取りは課金対象ではありません。制限とクォータ:https://polyaccounts.com/limits。
ワークフロー
workflows/ にある、再利用可能でモデルに依存しない手順です。経費レビュー、財務レビュー、法律事務所向けの案件請求サイクル、月末締め、信託口座の三者間照合が含まれます。
デモをインストールする
polyaccounts-demo.mcpb をダウンロードし、MCPB 対応クライアントで開いてください。Claude Desktop の場合は、Settings、Extensions、Advanced settings、Install Extension の順に選択します。インストール前に拡張機能を確認してください。インストール後は、アカウント、データベース、API キー、ネットワーク接続は不要です。
stdio クライアントでは、以下の固定バージョンの設定を使用してください。
{
"mcpServers": {
"polyaccounts-demo": {
"command": "npx",
"args": [
"--yes",
"--package=https://github.com/andrewblount/polyaccounts-agent-kit/releases/download/v1.2.2/polyaccounts-mcp-1.2.2.tgz",
"polyaccounts-demo"
]
}
}
}
npx を直接起動できない Windows クライアントでは、パッケージを一度インストールしてから、demo.mjs の絶対パスを指定して node を設定できます。クライアントによって設定方法は異なります。
役立つ質問をする
今月、経費にどのような変化がありましたか?仕訳を表示してください。
合成企業は Juniper Studio です。基準日は August 31, 2026 です。 「今月」は常に、今日の日付にかかわらず、7月と比較した8月を指します。 経費は USD 1200.0000 から USD 1850.0000 に増加し、変化額は USD 650.0000 です。 ソフトウェアの費用は500.0000、手数料は150.0000です。ワークスペースの費用に変化はありません。
accounting_context、expense_changes、ledger_entries を使用してください。各カテゴリには安定した証拠 ID が含まれています。
profit_loss には、仕訳の借方と貸方の両方が含まれています。
このフィクスチャでは正確な整数演算を使用し、10進数を文字列として返します。
モデルや外部サービスを使わずに、動作するサンプルを実行してください。
git clone https://github.com/andrewblount/polyaccounts-agent-kit.git
cd polyaccounts-agent-kit
npm run example
npm test
このサンプルは実際の MCP stdio プロセスを起動し、レポートを取得して、接続を通じて7件すべての経費仕訳を検証します。証拠 ID が欠けている場合、または予想される変化額が照合できない場合は失敗します。ブラウザーで証拠を確認する。
会計データへのフルアクセスで接続する
ホスト型コネクターは、polyaccounts-hosted.mcpb をダウンロードしてください。承認済みのワークスペースで、管理者が Settings を開き、 For AI agents を選択して、会社の認証情報を発行します。これを拡張機能の機密設定フィールドに入力してください。クライアントは、その会社の会計データを読み書きできます。
または、付属のスタンドアロンブリッジを、保護されたトークンファイルとともに実行してください。
{
"mcpServers": {
"polyaccounts": {
"command": "node",
"args": ["/absolute/path/polyaccounts-mcp.mjs"],
"env": {
"POLYACCOUNTS_TOKEN_FILE": "/absolute/path/agent-token"
}
}
}
}
認証情報をプロンプト、ログ、スクリーンショット、ソース管理、問題報告に含めないでください。 オペレーティングシステムのファイル権限またはシークレットマネージャーを使用してください。ホスト型ブリッジは、設定された HTTPS API とのみ通信し、リダイレクトを拒否します。認証情報は失効させることができます。
まず accounting_context を使用して、会社を確認してください。操作を実行する前に、ツールと操作スキーマを確認してください。
レコードの更新にはリビジョンが使用されます。書き込みのたびに、安定した冪等性キーと永続的なレシートが使用されます。結果が不確かな場合は、別の操作を試す前に照合する必要があります。論理削除を行っても履歴は保持されます。承認、期間、支払いの各コントロールは引き続き適用されます。支払いを記録しても、銀行資金は移動しません。
デモ専用の expense_changes ツールは、ホスト型カタログには含まれていません。ホスト型の経費レビューでは、両方の期間とすべての台帳ページを取得し、正確な値を集計してください。丸められた表示金額を合計したり、根拠なく事業上の要因を推測したりしないでください。
プライバシーポリシー
デモは同梱のフィクスチャのみを読み取り、ネットワーク通信を行わず、ファイルも書き込みません。 ホスト型コネクターは、リクエストされた会計操作を会社の API に送信し、結果を選択したクライアントに返します。そのクライアントまたはモデルプロバイダーが、独自の規約に基づいて結果を処理する場合があります。PolyAccounts のプライバシーポリシーをご確認ください。 サポートの問題報告には、合成された例のみを含めてください。認証情報またはセキュリティに関する問題は、公開 GitHub issue ではなく、[email protected] に非公開で報告してください。
デモは会計入力データや利用データを保存せず、テレメトリもありません。フィクスチャはインストール時に同梱されています。MCP クライアントは、独自の設定に従って会話を保持する場合があります。ホスト型サービスは、プライバシーポリシーに基づいて会社のレコードと書き込みレシートを保持します。プライバシーに関するリクエストは、[email protected] までお問い合わせください。
このキットは MIT ライセンスで提供されています。ライセンスの対象はこのリポジトリであり、ホスト型サービスは対象外です。 ディレクトリへの掲載と推奨は保証されません。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。