NuMetric

---

这是适用于 NuMetric.work POS / ERP / 会计平台的 模型上下文协议 服务。它将实时业务数据作为只读工具提供，让 AI 助手依据实际账簿作答，而不是猜测。

它绝不会创建、编辑或删除任何内容。

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

你可以询问的内容

• “上个月末的资产负债表是什么样的？” / “显示第二季度的损益表。”
• “我的现金可维持多久？流动比率是多少？”
• “列出逾期发票并汇总应收账款。”
• “本季度我收取了多少销售税？又缴纳了多少？”
• “按项目细分利润。”
• “哪些客户订阅了我的月度套餐？哪些客户已取消？”
• “发票 INV-2026-0007 附有哪些文档？”

安装

Claude（网页、桌面版、Code）

设置 → 连接器 → 添加自定义连接器 → 粘贴：

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

然后点击连接，使用 NuMetric 邮箱、密码和区域登录。授权后，你会被重定向回来。

Claude Code（命令行）

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”）。所选业务会在本次会话中保持不变，你可以随时切换。单业务账户会自动选中相应业务。

工具

会计核心（8）

工具	返回内容
list_chart_of_accounts	科目表，包含实时计算的余额和分类。余额采用账簿符号（debit − credit）；每行包含 magnitude/side/isNormalSide
search_transactions	按日期、类型、类别和审核状态搜索账簿
get_transaction	一笔交易及其完整日记账分录
get_daily_transactions	某一期间的总日记账（借方 = 贷方）
get_financial_statement	损益表、资产负债表、试算平衡表、现金流量表
get_account_transactions_report	某一期间按账户列出的交易明细
get_audit_trail	每笔交易的创建者或修改者及操作时间，并支持按日期、类别、类型、审核状态、创建者、编辑者、项目、金额和自由文本筛选。需要 NuMetric 账户中的审计追踪权限
get_transaction_activity	一笔交易的变更历史记录——每项事件的操作者、时间，以及字段变更前后的值

分析与关键绩效指标（3）

| 工具 | 返回内容 | | --- | --- | | `get_kpis` | 现金可支撑时间、流动比率、应收账款周转天数、应付账款周转天数、收入集中度、未审核数量 | | `get_cash_position` | 各账户的现金和银行余额 | | `get_net_movement` | 按月或按季度统计一个日历年内各账户的净变动——展示每个账户在各期间之间的变动，而非期末余额。按分类账符号计算（`借方 − 贷方`），因此收入和负债账户增长时会呈负向变动 |

销售、应收账款与应付账款（10）

工具	返回内容
list_invoices	带筛选条件的销售发票
list_cash_invoices	带筛选条件的现金发票
list_estimates	报价 / 估价单
get_invoice_status	按 ID 或编号查询单张发票的应收账款状态
get_receivables	含逾期置信度的应收账款账龄
list_bills	采购账单
get_bill_status	单张账单的应付账款状态
get_payables	应付总额以及应付账款账龄。outstanding.outstandingTotal 是您应付的金额；aging 仅涵盖已计入账龄的部分
list_customers	客户列表，含重复项检测
list_customer_subscriptions	您向客户销售的订阅计划：各计划的价格和计费频率、订阅者数量（有效 / 已暂停 / 已取消）、订阅者名单，以及已开具发票的内容

税务（2）

工具	返回内容
get_sales_tax	某一期间的销售税 / 增值税汇总
get_sales_tax_transactions	每笔交易的税务明细

项目（2）

工具	返回内容
list_projects	含状态的项目列表
get_multi_project_profit_loss	一个或多个项目的损益

零售与收银员报表（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	您的固定资产登记册——名称、类型、总账账户、成本和折旧率——与 NuMetric 的折旧计划进行核对。仅当两者涵盖相同资产时才报告折旧总额；若不一致，则不提供该值（为 null，绝不为零）
get_asset_custody_report	按持有人统计的资产保管情况

文档（4）

工具	返回内容
get_storage_overview	文档存储概览
list_documents	发票、账单及其他记录的附件
get_document	下载单份文档的内容
get_document_bundle	将某条记录的所有文档下载为 ZIP 文件

账户与会话（3）

工具	返回内容
list_businesses	您账户中的企业
select_business	选择要操作的企业
get_subscription	您自己的 NuMetric 计划（即您向 NuMetric 支付的费用，而非客户的订阅），以及计划所含内容：您当前使用的计划、实际限额、剩余交易额度和席位额度、哪些人可以访问账户、可用功能、各企业的功能开关，以及您的权限允许使用哪些工具

所有工具的机器可读架构：mcp-schema.json。

只读设计

每个工具都带有 readOnlyHint: true。此服务中没有付款、转账、交易、创建、编辑或删除工具——既没有被权限控制，也根本不存在。这是字面意义上的：截至 0.9.0，写入代码已从部署的服务中移除，而不是留在代码中由功能标记控制，因此没有任何配置可以启用它。对于遵循此提示的客户端，只读工具无需逐次确认即可运行。

已验证与受保护

每个计算得出的数值都带有 confidence 值：

• 已验证 — 数值直接来自 NuMetric 的会计引擎，且已核对一致。
• 受保护 — NuMetric 标记该数值可能已过时或不平衡，或者它是快照而非实时读取结果。你的订阅权益始终是受保护的：NuMetric 无法重新读取这些信息，因此它们反映的是你连接时的状态，并会在重新连接时刷新。使用情况数据有一个值得了解的例外——席位数量直接来自 NuMetric，而交易数量则根据你的分类账统计，并会注明统计依据。

服务会指示连接的助手对受保护数值采用审慎措辞，而不要将其作为最终结果呈现。Claude 会报告你的账簿所载内容；它不会自行重新计算你的会计数据。

身份验证

使用 OAuth 2.1 和 PKCE（S256）。你会在 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 官方提供：NuMetric 是我们自己的平台和后端。

此代码仓库包含连接器的公开清单和文档。采用 MIT 许可证。