Onexur Manager MCP

Onexur Manager MCP

Claude や ChatGPT などの AI アシスタントを、Manager 会計インスタンスに接続する MCP（Model Context Protocol）サーバーです。Manager のデータと操作を、スコープが設定された一連のツールとして公開します。デフォルトでは読み取り専用で、レポート作成、診断、照合のツールをすぐに利用できます。すべての書き込み機能には、明示的な設定が必要です。

このプロジェクトは、manager-mcp 0.2.6 からのフォークとして始まりました。以下の帰属表示をご覧ください。

1. プロジェクトの説明

Onexur Manager MCP を使うと、AI アシスタントは自由形式の API 呼び出しではなく、構造化されたツールインターフェースを通じて、Manager 会計インスタンスを読み取り、明示的に許可された場合は操作できます。サーバーは階層化された権限モデルを適用するため、読み取りアクセスと書き込みアクセスはそれぞれ個別に有効化し、削除アクセスもさらに個別に有効化する必要があります。

一般的な用途：

• 残高の説明、未払い請求書の検索、または勘定の動きの要約をアシスタントに依頼します。
• スクリプトを作成せずに、照合や診断チェック（重複取引、未割り当ての支払い、参照先が無効な請求書、仮勘定の候補など）を実行します。
• Manager の元帳から、過去の日付時点の試算表、損益計算書、または経過日数別残高を再構築します。これは公式レポートではなく、再構築データであることが明確に表示されます。
• 特定の取引タイプに対する修正を提案し、確認後に適用します。直接書き込むのではなく、必ず明示的に提案してから適用する手順を使用します。

Manager を変更する機能は、デフォルトでは登録されません。すべての書き込み要求は、スコープを確認する前に恒久的な拒否リストとの照合も行われます（設定を参照）。

2. インストール

パッケージ名は mcp-manager.io、Python モジュール名は manager_mcp、コマンド名は manager-mcp と manager-mcp-dev です。Python 3.10 以降と uv が必要です。

最初のリリースが PyPI に公開されるまでは、クローンから実行してください：

git clone https://github.com/onexurOSS/mcp-manager.io.git
cd mcp-manager.io
uv sync
uv run manager-mcp

公開後は、クローンする必要はありません：

uvx --from mcp-manager.io manager-mcp

サーバーは stdio 経由で MCP を使用します。クライアントから利用するには、上記のいずれかのコマンドを Manager 接続情報を環境変数として設定して実行するよう、クライアントを構成してください。例：

{
  "mcpServers": {
    "manager": {
      "command": "uvx",
      "args": ["--from", "mcp-manager.io", "manager-mcp"],
      "env": {
        "MANAGER_API_URL": "http://127.0.0.1:55667/api2",
        "MANAGER_API_KEY": "your-access-token"
      }
    }
  }
}

このリポジトリにあるクライアント統合：

• mcpb/ には、Claude Desktop 拡張バンドル用のマニフェストがあります。ビルド済みバンドルはコミットされていません。このマニフェストは、公開後に利用できる mcp-manager.io パッケージを uv 経由で実行します。
• .cursor-plugin/plugin.json は Cursor プラグインのマニフェストです。
• .cursor/mcp.json や .vscode/mcp.json のエントリーなど、その他のクライアントについては、上記のパターンを使用してください。

ChatGPT Apps にはホストされた HTTP エンドポイントが必要です。このパッケージが対応しているのは stdio のみです。

3. 設定

1つのプロセスは1つの Manager インスタンスと通信し、環境変数で設定します。

変数	用途
MANAGER_API_URL	Manager API のベース URL です。必要に応じて /api2 を含めます。必須です。
MANAGER_API_KEY	Manager Settings で作成するアクセストークンです。X-API-KEY として送信されます。必須です。
MANAGER_MCP_WRITE_SCOPES	カンマ区切りの書き込みスコープです。デフォルトは空です。
MANAGER_MCP_DELETE_SCOPES	カンマ区切りの削除スコープです。デフォルトは空で、書き込みスコープから暗黙的に許可されることはありません。
MANAGER_MCP_AUDIT_LOG_PATH	修正の書き込みを JSON 行形式（変更前と変更後の状態）で記録する場所です。デフォルトは ~/.manager_mcp/audit_log.jsonl です。
MANAGER_MCP_DEV_SUPERVISOR	1 に設定すると、ソースファイルの変更時にサーバーを自動的に再起動します。開発用途のみです。

以前の MANAGER_MCP_ALLOW_WRITES、ALLOW_WRITES、MANAGER_MCP_WRITES 変数は、上記の2つのスコープ変数を案内するエラーとともに拒否されます。

API キーをコミットしないでください。MCP クライアントの環境変数、または非公開の env ファイルに保管してください。

トランスポート

stdio がデフォルトであり、レジストリから起動される（uvx）プロセスが使用する唯一のトランスポートです。HTTP は追加で利用できるオプトイン方式で、ローカルの stdio パイプ経由だけでなく、ネットワーク経由でもこのサーバーにアクセスする必要があるセルフホスト型デプロイ向けです。

変数	用途
MANAGER_MCP_TRANSPORT	stdio（デフォルト）または http です。
MANAGER_MCP_HTTP_HOST	HTTP モードでのバインド先ホストです。未設定の場合はループバック（127.0.0.1）がデフォルトです。
MANAGER_MCP_HTTP_PORT	HTTP モードでのバインド先ポートです。未設定の場合は 8000 がデフォルトです。
MANAGER_MCP_HTTP_AUTH_TOKEN	任意のベアラートークンです。設定すると、HTTP リクエストにはすべて、一致する Authorization: Bearer <token> ヘッダーが必要です。ない場合は、ツールに到達する前に 401 で拒否されます。

HTTP モードで公開されるツール、スコープ／ポリシーの適用、プロセスごとに Manager インスタンスを1つだけ扱うモデルは、stdio モードとまったく同じです。変わるのはトランスポートだけです。マルチテナント機能や、1プロセスで複数の Manager インスタンスを扱う機能は追加されません。これらは、このサーバーの前段に別途ゲートウェイサービスを設置して対応してください。

セキュリティに関する注意： MANAGER_MCP_HTTP_AUTH_TOKEN はプロセス全体で共有される1つのシークレットで、トランスポート層で検証されます。呼び出し元ごとの ID でも OAuth でもなく、実際の認証境界の代わりにもなりません。未設定の場合、HTTP モードにはトランスポート層の認証が一切ありません。設定されたホストとポートに接続できるクライアントであれば、このプロセスが公開するすべてのツールを呼び出せます。適用されるのは上記のスコープ／拒否リストポリシーだけです（このポリシーは何ができるかを制御するものであり、誰が接続できるかを制御するものではありません）。この構成が安全なのは、ネットワーク上の配置（ループバックへのバインド、プライベート Docker ネットワーク、VPN、または実際の認証を行うゲートウェイ／リバースプロキシ）が、唯一のアクセス制御として確実に機能する場合に限られます。HTTP モードでトークンを設定せずに起動した場合、サーバーは何も通知せずに動作するのではなく、起動時に標準エラー出力へ警告を表示します。このサーバーは実際の帳簿データを公開する可能性があり（設定されたスコープによっては、そのデータへの書き込み／削除アクセスも許可されるため）、運用担当者にはトークンを設定すること、サーバーをゲートウェイの背後に配置すること、またはその両方を強く推奨します。

権限スコープ

有効なスコープは、quotes、orders、parties、items、sales、purchases、banking、payroll、ledgerに加えて、各ドメインのすべての作成および更新（または削除）ツールを有効にするためのエスケープハッチであるrawです。日々の記帳を始める際の推奨スコープはbanking,sales,partiesです。

スコープを設定しない場合、読み取り専用ツールが30個登録されます。スコープを有効にすると、そのドメインのツールのみが登録されます。スコープは追加方式で相互に独立しており、未知のスコープ名は起動時に拒否されます。書き込みおよび削除のすべてのスコープを有効にすると、最大126個のツールが登録されます。

Manager に変更を加えるすべてのリクエストは、最初にポリシーチェックを通過します。アクセストークン、勘定科目表、税コード、為替レート、開始残高、銀行照合、カスタムフィールド、メール設定、顧客ポータルなどのパスへのリクエストは、有効なスコープにかかわらず、常に拒否されます。

4. ツールの説明

読み取りツール（デフォルトで登録、合計30個）

• 検出と生データへのアクセス：list_resources、list_records、get_record、get_fixed_asset、get_server_info（サーバーの識別情報、プロセス、Git の状態、登録済みツール、有効なスコープ）。
• 従来のレポート用ショートカット：aged_receivables、aged_payables、bank_balances、trial_balance、profit_and_loss、balance_sheet、tax_summary。これらは Manager の現在の状態または生データのフィードを返すもので、完成したレポートではありません（レポートの制限事項を参照）。
• レポートレイヤー（reporting.py）：manager_report_catalogue、get_report_definition、ledger_transactions、reconstructed_trial_balance、reconstructed_profit_and_loss、reconstructed_aged_receivables、reconstructed_aged_payables。
• 診断（diagnostics.py）：find_records、find_broken_invoice_references、find_unallocated_transactions、find_duplicate_transactions、verify_invoice_balance、account_ledger、bank_activity、find_suspense_candidate_accounts、general_ledger_summary。
• 照合（reconciliation.py）：reconcile_period。
• list_incomplete_reconstructions（corrections.py）：開始したものの完了していない請求書の再構築処理を、ローカル監査ログのみから取得します。

書き込みツール（対応するスコープが有効な場合のみ登録）

• タスクツール（task_tools.py）：issue_sales_invoice、issue_purchase_invoice、record_customer_payment、record_supplier_payment、record_expense、transfer_between_accounts、post_journal_entryなど、意図に沿った形で構成されています。これらが推奨される書き込み方法です。
• 有効な各スコープに対応するリソースごとのcreate_*およびupdate_*ツールと、有効な削除スコープに対応するdelete_*ツール。create_fixed_assetとupdate_fixed_asset（fixed_assets.py）にはledgerスコープが必要です。
• 修正（corrections.py）：propose_correctionとapply_correction、仕入および売上請求書用のpropose_*_reconstructionとapply_*_reconstruction、reallocate_payment_lineとreallocate_receipt_line、および通常のvoid_documentツールより推奨されるsnapshot_and_void。ここにあるツールは、提案後に別途適用手順を実行しない限り書き込みを行いません。また、各修正の書き込みは監査ログに記録されます。

登録済みのすべてのツールの説明とスキーマは MCP クライアントから確認でき、get_server_infoで有効なツールを確認できます。

5. レポートに関する制限事項

Manager の API は、完成したレポートを返しません。レポート表示用のルートはアプリケーション専用で、API キーに対して HTTP 401 を返します。また、このプロジェクトはこれらのルートを呼び出したり、模倣したりしません。レポート用ツールは、API が実際に返すデータを使用し、返す内容を明示します。詳しいガイドはdocs/reporting.mdをご覧ください。

• 再構成データが正式な情報として扱われることはありません。 reconstructed_trial_balance、reconstructed_profit_and_loss、reconstructed_aged_receivables、reconstructed_aged_payables は、Manager の勘定科目レベルの元帳から、このサーバーが計算します。それぞれの結果には、authoritative: false と official_manager_report: false に加え、データソース、計算方法、基準日、元帳の完全性が含まれます。再構成した数値が Manager の数値と一致しても、正式なレポートになるわけではありません。
• 再構成した売掛金・買掛金の年齢分析は、Manager の結果と異なる場合があります。 ここでの年齢分析では取引日を使用し、入金は古いものから順に適用します。一方、Manager は支払期日と実際の消し込みを使用するため、各期間の内訳が異なる場合があります。取引先ごとの合計は、統制勘定の合計とのみ照合されます。
• 現在の状態を示すツールは日付を受け付けません。 aged_receivables、aged_payables、bank_balances、tax_summary は、今日時点の残高を表示します。日付や期間を渡すとリクエストを拒否し、過去の日付に対して今日の数値を返すことはありません。
• 元帳の日付はこのサーバーで絞り込みます。 Manager は /transactions の元帳フィードで日付パラメーターを無視するため、サーバーが元帳全体を取得して、それ自体で絞り込みます。結果が通知なく切り詰められることはありません。ページ分けされた結果には合計と次の位置が含まれ、フィードにはデータが完全かどうかが示されます。
• API から取得できないもの： Manager 独自のグループおよび小計のレイアウト、過去時点の請求書の支払期日と消し込み、VAT 申告書、完成したレポート出力。

精度が重要な場合、たとえば VAT や税務申告では、どのレポート用ツールも Manager 独自のレポートの代わりとして扱わないでください。

6. ライセンス

Onexur Manager MCP は、GNU Affero General Public License v3.0 以降（AGPL-3.0-or-later）の下で配布されています。

このプロジェクトには、manager-mcp 0.2.6 の素材が含まれており、引き続き MIT License の下でライセンスされています。その素材を本プロジェクトの配布物に含めても、上流由来の部分に関する既存の MIT の権利および著作権が移転または消滅することはありません。それらの権利は受領者に対して引き続き有効です。帰属表示の全文はNOTICEをご覧ください。また、このリポジトリのどの部分が上流由来（MIT）で、どの部分が Xalterra Ltd（Onexur の商号で営業）が独自に作成したもの（AGPL-3.0-or-later）かについては、ファイル単位の内訳をPROVENANCE.jsonでご確認ください。

AGPL の義務を負うことなく Xalterra Ltd が所有する Onexur のコードを使用できる商用ライセンスも用意されています。条件については [email protected] までお問い合わせください。

AGPL-3.0-or-later の全文はLICENSE-AGPLに、MIT License の全文はLICENSE-MITに収録されています。

7. 帰属表示

このプロジェクトには、MIT License の下で公開された manager-mcp 0.2.6 の素材が含まれています。著作権は (c) 2026 manager-mcp contributors に帰属します。

このリポジトリのどの部分が上流由来で、どの部分が Xalterra Ltd（Onexur の商号で事業を展開）が独自に作成したものかを、ファイル単位で詳しくまとめた内容は、PROVENANCE.json で管理されています。人が読みやすい形式の概要は、PROVENANCE_SUMMARY.md にあります。過去の上流リリースノート（バージョン 0.1.0 から 0.2.6 まで）は、docs/upstream-history.md に変更を加えずに保存されています。現在のリリースノートは CHANGELOG.md にあります。

MIT License の全文は LICENSE-MIT に掲載されています。帰属表示の全文は NOTICE をご覧ください。

8. 商標に関する免責事項

「Manager」および関連するロゴは、それぞれの所有者の商標です。このプロジェクトは、独立したサードパーティによる統合であり、Manager またはその発行元とは提携関係になく、承認や後援も受けていません。このプロジェクトには、Manager のブランド表示、ロゴ、または独自の API 説明資料は含まれていません。

---

貢献

CONTRIBUTING.md と CLA.md をご覧ください。PROVENANCE.json で上流由来と特定されているファイルへの貢献は、引き続き上流の MIT license の適用対象となります。Onexur 独自のファイルへの貢献には、プロジェクトの Contributor License Agreement（バージョン 1.0）が適用されます。この契約は、CONTRIBUTING.md に記載のとおり、プルリクエストにコメントを投稿することで受諾したものとみなされます。

関連資料

• docs/reporting.md：報告および権限に関するガイド
• CHANGELOG.md：現在のリリースノート
• docs/upstream-history.md：過去の上流リリースノート
• PROVENANCE.json および PROVENANCE_SUMMARY.md：ファイル単位のライセンス来歴
• SECURITY.md：脆弱性開示ポリシー