SUNAGO Matrix

SUNAGO Matrix MCP 服务

将 Claude、Cursor、VS Code 或任何 MCP 客户端连接到您咨询公司的项目数据。

面向 SUNAGO Matrix 的远程 Model Context Protocol 服务。SUNAGO Matrix 是为咨询和工程公司打造的专业服务自动化平台。它以 105 个工具提供项目、CRM、任务、工时表、费用、资源规划、人力资源和报告，让您可以询问 AI 助手有关自家业务的问题，而不必导出电子表格。

https://sunago-matrix.com/mcp

无需安装、无需 API 密钥，也无需 npm 包。这是一个托管的远程服务：将客户端指向该 URL，登录后，每次调用都会以您的身份、在您自己的权限范围内运行。

端点	https://sunago-matrix.com/mcp
传输方式	Streamable HTTP
身份验证	OAuth 2.1，通过 RFC 9728 受保护资源元数据发现
工具	105 个（31 个只读，74 个可写入）
提示词	4 个
注册表名称	com.sunago-matrix/matrix
产品页面	AI 项目管理

---

快速开始

Claude Code

claude mcp add --transport http sunago-matrix https://sunago-matrix.com/mcp

然后在会话中运行 /mcp，并完成浏览器登录。

Claude（网页端和桌面端） - 添加一个指向 https://sunago-matrix.com/mcp 的自定义连接器。

Cursor - .cursor/mcp.json：

{
  "mcpServers": {
    "sunago-matrix": {
      "url": "https://sunago-matrix.com/mcp"
    }
  }
}

VS Code - .vscode/mcp.json：

{
  "servers": {
    "sunago-matrix": {
      "type": "http",
      "url": "https://sunago-matrix.com/mcp"
    }
  }
}

完整说明（包括故障排查）请参阅 QUICKSTART.md。可直接使用的配置文件位于 examples/。

连接后，请让助手调用 whoami。它会告知您当前以哪个身份登录以及持有哪些权限，从而确认连接状态，并告诉助手它可以尝试执行哪些操作。

---

您可以向它提出的问题

• 目前哪些项目超出预算了？超出了多少？
• 为周二的 Novo Nordisk 集成项目记录 6 小时，设为不可计费。
• 未来三周内，谁的资源分配超过 100%？
• 我的销售管道中有哪些项目一个月没有进展？
• 哪些固定费用里程碑已到期但仍未标记为已开票？
• 为 Aarhus 部署添加一项风险：客户的测试环境尚未就绪。

服务内置了 4 个命名提示词，因此客户端可以直接提供这些提示词，无需用户知道工具名称：哪些事项在等我处理、项目状态、记录工时和可开票项目。

以下两项便利功能值得了解：

• 既可以使用名称，也可以使用 ID。 引用参数既接受名称，也接受 UUID；每个工具运行时都会由封装层解析。您可以说“Novo Nordisk”或同事的姓名；如果匹配到多个记录，工具会返回所有候选项，而不会擅自猜测。
• 列表始终会分页。 每个列表响应都包含 pagination.total 和 has_more，因此，如果助手只统计一页内容，系统会提示它统计有误。

---

工具

产品中共有 105 个工具。完整参考文档及各工具所需的权限： TOOLS.md。

区域	工具数量	涵盖内容
项目	39	项目、团队、材料、外部服务、风险、预算、计费方案、开票设置
CRM	20	潜在客户、联系人、交易、跟进
时间与费用	13	工时记录、审批、自付费用
任务	8	项目任务及其依赖关系
资源规划	4	在一段时间内将人员分配到各个项目
HR	4	员工和工作区自有角色
备注	4	在潜在客户、交易、联系人或任务上添加 @ 提及备注
通知	4	你自己的通知，以及发送给同事的消息
合同	3	附加到交易和项目的合同
提案	1	提案文档，按设计设为只读
报告	1	已完成的报告，而非原始行数据
回收站	1	已删除的记录，保留 30 天
身份	1	你是谁，以及你可以查看哪些内容
元数据	2	按关键词查找工具，或按名称调用工具

---

它可以访问的内容

在将助手连接到存储项目财务数据的系统之前，值得先读一读。完整模型见 PERMISSIONS.md；其基本规则如下：

它以你的身份运行。 每次调用都会携带你自己的已验证会话令牌，并以你的身份在行级安全机制下访问数据库。服务中没有任何服务角色密钥，也不存在管理权限绕过，因此连接无法访问你不属于其中的工作区。

你现有的权限仍然有效。 每个工具都会检查与 Matrix 界面相同的功能权限；如果拒绝操作，会指出缺少的权限，让你知道需要向管理员申请什么权限。

删除方式并不统一，文档会明确说明。 5 种删除属于软删除：在回收站中保留 30 天，且仅限管理员操作。13 种删除会永久生效，其中 10 种在人工提供精确的确认短语之前不会执行。总共有 12 个工具仅限工作区管理员使用。

财务数据有单独的权限门槛。 4 个工具通过 finance.view 读取财务数据；4 个工具通过 finance.create 或 finance.edit 写入数据。没有工具可以开具或发送发票，也没有工具可以记录付款。没有工具可以读取或写入年薪、税前时薪、国家身份证号码或任何银行或银行卡信息。

两项能力比其他工具权限更进一步；相关内容已写入文档，而非留待用户自行发现： 利用率报告和成本修复工具会按姓名返回员工的薪资推算时薪成本，供已拥有 reports.view 或 time.approve 权限的调用者查看；hr_update_employee 则可以通过 hr.edit 授予或移除工作区管理员权限。这两项能力所依据的权限，与用户在 Matrix 界面中已有的权限相同。

所有操作都有记录。 每次写入都会留下审计记录，其中包含工具、调用者以及服务器解析出的参数；所有 105 个工具都通过同一个包装器运行，由该包装器写入记录。每位用户每分钟最多可写入 120 次。读取既不记录，也不受限。

---

关于 SUNAGO Matrix

SUNAGO Matrix 是专为咨询和工程公司打造的 专业服务自动化软件：在一个系统中管理销售管道、提案及其数字签名、资源计划、项目、项目工时、费用，以及相关报告。

它与同类产品的不同之处，在于成本核算方式。大多数系统通过用年薪除以名义工作年数来计算小时成本。Matrix 则根据产能、休假时间和员工实际达到的利用率来计算成本，并将该费率用于产品中的所有利润率和预测。这就是为什么 MCP 服务能够回答“这个项目赚钱吗”，而不仅仅是“记录了多少工时”。

• 项目成本跟踪 - 实际每小时成本、实时利润率、完工预测
• 资源规划 - 跨顾问的产能和分配
• 工时表软件 - 可计费和不可计费工时及审批
• 咨询公司 CRM - 销售管道、提案和合同
• 云端项目管理 - 预算、阶段、里程碑、依赖关系
• KPI 报告 - 利用率、收入实现率和公司级 KPI
• 定价 - 一个套餐，包含所有模块，提供 14 天免费试用

不构建助手？此外还提供 REST API、webhook 和 Zapier 集成。

---

文档

QUICKSTART.md	连接各个客户端、首次调用、故障排除
TOOLS.md	全部 105 个工具及各自所需的权限
PERMISSIONS.md	完整的授权模型
CHANGELOG.md	工具接口的变更
server.json	MCP Registry 元数据
examples/	可复制的配置文件

如何确保内容准确

此仓库中所有可计数的内容都不是手工编写的。data/tools.json 根据服务自身的工具定义以及每个处理程序执行操作前运行的权限检查生成，TOOLS.md 则由此渲染而成。文字描述也经过核查：data/verified-claims.json 列出此处以及 sunago-matrix.com/ai-project-management 上的每一条事实陈述，并分别附上服务源代码中能够证明该陈述的文件和匹配模式。未经核查的陈述不会发布。

之所以这样做，是因为早期版本的这些页面中有六条陈述与代码不符。数字是自动生成的，没有问题；句子是手工编写的，却不准确。

问题反馈

对于文档或工具接口方面的问题，请在此处提交 issue。对于涉及你自己的工作区数据的问题，或疑似安全问题，请发送邮件至 [email protected]，不要公开提交。

许可证

MIT。此处的文档和配置示例均可免费复制和改编。 SUNAGO Matrix 本身是一项商业服务，此许可证不授予使用该服务或 SUNAGO 名称及标记的权利。