NuMetric

---

NuMetric.work の POS／ERP／会計プラットフォーム向けの Model Context Protocol サーバーです。ビジネスの最新データを読み取り専用のツールとして提供するため、AI アシスタントは推測ではなく、実際の帳簿に基づいて回答できます。

データの作成、編集、削除は一切行いません。

https://numetric-mcp.virifi.xyz/mcp

質問できること

• 「先月末時点の貸借対照表は？」／「第 2 四半期の損益計算書を見せて。」
• 「現金の持続可能期間と流動比率は？」
• 「支払期限を過ぎた請求書と売掛金の合計を一覧にして。」
• 「今四半期に徴収した売上税と支払った売上税はいくら？」
• 「プロジェクト別に利益を分類して。」
• 「月額プランを契約している顧客と、解約した顧客は？」
• 「請求書 INV-2026-0007 に添付されているドキュメントは？」

インストール

Claude（ウェブ、デスクトップ、Code）

「設定」→ コネクタ → カスタムコネクタを追加 → 次を貼り付けます。

https://numetric-mcp.virifi.xyz/mcp

次に 接続 をクリックし、NuMetric のメールアドレス、パスワード、地域でサインインします。認証が完了すると元の画面に戻ります。

Claude Code（CLI）

claude mcp add --transport http numetric https://numetric-mcp.virifi.xyz/mcp

Cursor／Windsurf／VS Code

{
  "mcpServers": {
    "numetric": {
      "url": "https://numetric-mcp.virifi.xyz/mcp"
    }
  }
}

その他の MCP クライアント

上記の Streamable-HTTP エンドポイントを指定してください。このサーバーは OAuth 2.1 のディスカバリー（RFC 9728／RFC 8414）を通知するため、準拠クライアントではサインインのフローが自動的に開始されます。

要件

• NuMetric.work アカウント（プランは問いません）。
• 地域（例：JO、SA、または Global）。
• OAuth によるリモートサーバー接続に対応した MCP クライアント。

アクセス権限は既存の NuMetric 権限に従います。すでに権限を持っているモジュールのみを参照できます。権限がないツールを使うと、データの代わりに SCOPE_REQUIRED が返されます。

ビジネスの選択

アカウントに複数のビジネスがある場合は、アシスタントにビジネスの一覧表示を依頼してから、いずれかを選択してください（「自分のビジネスを一覧表示して」 → 「Acme Trading を使って」）。選択内容はセッション中保持され、いつでも切り替えられます。ビジネスが 1 つだけのアカウントでは、自動的に選択されます。

ツール

会計の基幹機能（8）

ツール	取得できる内容
list_chart_of_accounts	最新の計算済み残高と分類を含む勘定科目一覧。残高は元帳の符号規則（debit − credit）に従い、各行には magnitude／side／isNormalSide が含まれます
search_transactions	日付、種類、カテゴリ、確認済みステータスによる元帳検索
get_transaction	全仕訳明細を含む 1 件の取引
get_daily_transactions	期間中の総勘定元帳（借方＝貸方）
get_financial_statement	損益計算書、貸借対照表、試算表、キャッシュフロー
get_account_transactions_report	期間中の勘定科目別取引明細
get_audit_trail	各取引を誰がいつ作成または変更したか。日付、カテゴリ、種類、確認済みステータス、作成者、編集者、プロジェクト、金額、フリーテキストで絞り込みできます。NuMetric アカウントで監査証跡の権限が必要です
get_transaction_activity	1 件の取引の変更履歴。各イベントについて、実行者、日時、変更されたフィールドの変更前後の値を確認できます

分析と KPI（3）

| ツール | 返される内容 | | --- | --- | | `get_kpis` | キャッシュランウェイ、流動比率、DSO、DPO、売上集中度、未レビュー件数 | | `get_cash_position` | 各口座の現金および銀行預金残高 | | `get_net_movement` | 暦年における口座ごとの純変動（月別または四半期別）。各口座が期間ごとにどのように変動したかを示し、期末残高ではありません。元帳の符号（`debit − credit`）に基づくため、収益勘定と負債勘定は増加するとマイナス方向に変動します |

売上、売掛金、買掛金（10）

ツール	返される内容
list_invoices	フィルター付きの売上請求書
list_cash_invoices	フィルター付きの現金売上請求書
list_estimates	見積書
get_invoice_status	IDまたは番号を指定した1件の請求書の売掛金ステータス
get_receivables	期限超過の確度を含む売掛金の年齢分析
list_bills	仕入請求書
get_bill_status	1件の仕入請求書の買掛金ステータス
get_payables	未払総額と買掛金の年齢分析。outstanding.outstandingTotalは未払額、agingは年齢分析の対象となる分のみです
list_customers	重複検出機能付きの顧客一覧
list_customer_subscriptions	顧客に販売しているサブスクリプションプラン。各プランの価格と請求頻度、加入者数（有効／停止／解約）、加入者、請求済みの内容を確認できます

税金（2）

ツール	返される内容
get_sales_tax	期間ごとの売上税／VATの概要
get_sales_tax_transactions	取引ごとの税金の詳細

プロジェクト（2）

ツール	返される内容
list_projects	ステータス付きのプロジェクト一覧
get_multi_project_profit_loss	1つまたは複数のプロジェクトの損益

小売・レジレポート（5）

ツール	返される内容
list_cashiers	レジ担当者／スタッフ
get_cashier_sales_invoices	レジ担当者ごとの請求書別売上
get_cashier_sales_items	レジ担当者ごとの商品別売上
get_cashier_attendance	レジ担当者の出勤状況
get_invoice_source_report	請求書の発行元別に集計した売上

在庫（3）

ツール	返される内容
list_products	商品一覧。低在庫の絞り込みを含みます
get_item_summary	商品ごとの在庫カード／変動
get_source_quantity_report	発行元別の数量

固定資産（2）

ツール	返される内容
get_asset_report	固定資産台帳（名称、種類、GL勘定、取得原価、減価償却率）。NuMetricの減価償却スケジュールと照合されます。減価償却合計は、両者の対象資産が一致する場合にのみ報告され、一致しない場合は表示されません（null。ゼロではありません）
get_asset_custody_report	保有者別の資産保管状況

書類（4）

ツール	返される内容
get_storage_overview	書類ストレージの概要
list_documents	請求書、仕入請求書、その他の記録に添付されたファイル
get_document	1件の書類の内容をダウンロード
get_document_bundle	1件の記録に添付されたすべての書類をZIP形式でダウンロード

アカウントおよびセッション（3）

ツール	返される内容
list_businesses	アカウントに登録されている事業者
select_business	作業対象の事業者を選択
get_subscription	利用中のNuMetricプラン（顧客のサブスクリプションではなく、NuMetricへの支払いプラン）とその内容。利用中のプラン、有効な上限、取引数とシート数の残り枠、アカウントへのアクセス権を持つユーザー、利用可能な機能、事業者ごとの機能切り替え、権限で使用できるツールを確認できます

すべてのツールの機械可読スキーマ：mcp-schema.json。

読み取り専用設計

すべてのツールに readOnlyHint: true が設定されています。このサーバーには、支払い、送金、取引、作成、編集、削除を行うツールはありません。制限されているのではなく、存在しません。これは文字どおりの意味です。0.9.0 時点で、書き込み処理のコードは機能フラグの背後に残されたのではなく、デプロイ済みのサーバーから削除されているため、有効にする設定はありません。このヒントに対応するクライアントでは、読み取り専用ツールは呼び出しごとの確認なしで実行されます。

検証済みと要注意

計算されたすべての数値には confidence 値が付与されます。

• 検証済み — 数値は NuMetric の会計エンジンから直接取得され、照合済みです。
• 要注意 — NuMetric が古い可能性または不一致の可能性を示しているか、リアルタイムの読み取りではなくスナップショットです。サブスクリプションの利用権限情報は常に要注意です。NuMetric には再読み込みする方法がないため、接続した時点の情報が反映され、再接続時に更新されます。使用状況の数値は例外として知っておく価値があります。シート数は NuMetric から直接取得しますが、取引件数は台帳から計測され、その算出根拠とともに報告されます。

サーバーは、接続中のアシスタントに対し、要注意の数値を確定情報として提示せず、慎重に表現するよう指示します。Claude は帳簿に記録された内容を報告しますが、自身で会計処理を再計算することはありません。

認証

PKCE（S256）を用いた OAuth 2.1 です。NuMetric の専用ページでサインインすると、認証情報はサーバー側でトークンに交換され、暗号化された保管庫に保持されます。アシスタントが保持するのは、このサーバーに限定された短期間有効のトークンだけです。NuMetric のパスワードや API トークンがアシスタントに渡ることはありません。

事業者の識別情報と地域は認証済み主体に紐付けられ、AI 呼び出し元から渡されることはありません。クライアントのコネクター設定から、いつでも接続を解除できます。

プライバシーとセキュリティ

• 読み取り専用です。金銭を移動したり、データを変更したりできるツールはありません。
• 認証情報が AI クライアントに渡ることはありません。
• 通信中および保存時に暗号化されます。
• すべての読み取りは主体ごとにレート制限され、監査ログに記録されます。

プライバシーポリシーと 利用規約をご覧ください。

トラブルシューティング

メッセージ	意味
NO_BUSINESS_SELECTED	*「list my businesses」*を実行し、事業者を選択してください。
SCOPE_REQUIRED	NuMetric ユーザーにそのモジュールへのアクセス権がありません。アカウント管理者にお問い合わせください。
要注意と表示された数値	確定情報ではなく、未確認の情報として扱ってください。
STATEMENT_UNAVAILABLE	この種類の明細書は、まだアカウントで利用できません。

サポート

アプリ内チャットからhelp.numetric.workにお問い合わせいただくか、通常の NuMetric サポート窓口をご利用ください。

概要

NuMetric の開発元である VIRIFI Technologies Ltd（英国ロンドン、Wenlock Rd 20–22）が開発・運営しています。これはファーストパーティーコネクターです。NuMetric は当社独自のプラットフォームおよびバックエンドです。

このリポジトリには、コネクターの公開マニフェストとドキュメントが含まれています。MITライセンスです。