Syncro MCP

Syncro + AI - 适用于 ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini，以及任何支持 MCP 的 Agent

非官方。由社区构建的 Claude Code Skill 和 Syncro API MCP 服务。与 Servably, Inc. 无关联，也未获其认可或赞助。

_{▶ 观看 30 秒演示 - 演示数据为模拟数据；展示的每条命令都存在于真实 CLI 中。}

在终端中使用所有 Syncro PSA 和 RMM 工作流，还能使用本地数据库、离线搜索和其他 Syncro 工具都不具备的跨实体报告。可与您已在使用的 AI 配合使用 - ChatGPT（Plus/Pro+，在此连接器重新发布前暂停；详见 mcp-install.md）、Claude Desktop、Codex、Claude Code、Claude Cowork 和 GitHub Copilot - 也可通过远程方式使用 Microsoft 365 Copilot / Copilot Studio 和 Google Gemini。免费、开源，可在笔记本电脑上运行。专为 MSP 所有者打造。无需编写代码。

适用于您的 Agent

安全说明（此连接器重新发布前）。 请勿运行 HTTP 模式 （--transport http），即使是在 localhost 上也不行。此版本没有密码， 会监听所有网络接口，并且早于浏览器重绑定防护机制， 因此您打开的网页可以访问它。MCP 工具也可以使用 您的凭据进行更改。请使用默认的 stdio 传输方式。如果您为远程 Agent 设置了隧道，请将其关闭。修复即将推出。

MSP 所有者实际使用的六种 Agent（可自行安装，即刻可用）：

您的 AI Agent	如何安装 Syncro Skill
Claude Desktop	运行安装程序，然后在 Settings > Extensions 中注册 syncro-mcp（无需编辑 JSON）。
ChatGPT（付费计划）	在此连接器重新发布前暂停：ChatGPT 需要 HTTP 模式，而此版本的该模式不要求密码、会监听所有网络接口，并且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全说明。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 syncro-mcp，然后选择 Agent 模式。

ChatGPT 需要远程 HTTPS 服务，因此需要使用此连接器的 HTTP 模式；在连接器重新发布前，该模式将暂停使用：此版本的该模式不要求密码、会监听所有网络接口，并且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全说明。

Microsoft 和 Google 技术栈也适用

安装基础庞大，但先如实说明：这属于远程 / 企业路径，而不是你刚安装的本地二进制文件。

Agent	所需操作
Microsoft 365 Copilot / Copilot Studio	暂停使用，直到我们重新发布此连接器：Copilot Studio 需要 HTTP 模式，而在此构建中，该模式无需密码，会监听所有网络接口，并且可以被你打开的网页访问。请参阅 mcp-install.md 中的安全说明。
Google Gemini	Gemini CLI 在本地运行——和 Claude Code 一样。Gemini app 在远程运行，需要使用与 ChatGPT 相同的已暂停 HTTP 模式。请参阅 mcp-install.md。

原生支持技能的 Agent（也包含在内）： Hermes 和 OpenClaw 可直接读取此技能的 SKILL.md，也支持 MCP——请参阅下方的安装部分。也可通过 MCP 与 Cursor、Windsurf、Cline、Continue.dev 和 Zed 搭配使用。各工具的完整接入说明：docs/which-agent.md。

要运行多个 Agent？ 只需一条命令，即可在全部 51 个以上受支持的 Agent 中安装：npx skills add Servosity/msp-skills@latest（需要 Node.js，然后运行各技能的安装程序来安装 CLI / MCP 二进制文件）。请参阅 docs/which-agent.md。

60 秒内完成安装

Claude Desktop 最快捷的方式——一键安装 .mcpb

Claude Desktop 安装包： .mcpb 可在 macOS（Intel 和 Apple Silicon）、Windows x64 和 Linux x64 上启动。每个工具都会通过 Shell 调用配套的 syncro-cli。从 2026-09-18 起发布的版本会在安装包中附带该 CLI；更早的安装包仅包含 MCP 服务，因此如果你的安装包缺少配套程序，请先运行下方的路径 A 或路径 B 安装程序（或者将 SYNCRO_CLI_PATH 设置为现有二进制文件的路径）。详情请见：#331。

下载 Syncro MCP（.mcpb）——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。一键完成，无需 JSON 或 Shell。（在 releases page 浏览所有 Syncro 版本。）

更喜欢 Claude Code 插件？添加一次软件源，然后安装——无需列出目录即可立即使用：

/plugin marketplace add Servosity/msp-skills
/plugin install syncro@msp-skills

路径 A——向 AI Agent 粘贴一条提示词（推荐）

将以下内容复制到 Claude Code、Codex CLI 或 Claude Cowork 中：

在此 Agent 工作区中安装 Servosity/msp-skills 的 Syncro 技能和 MCP 服务。如果此工作区使用 POSIX Shell（macOS、Linux、WSL 或 Bash），请运行 bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/syncro/install.sh)。如果使用 Windows PowerShell，请运行 iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/syncro/install.ps1 | iex。然后按照 README 进行身份验证，并运行 syncro-cli --help 以了解用法。

任何能够运行 Shell 的 Agent 都可以使用同一条提示词。

路径 B——自行运行安装程序

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/syncro/install.ps1 | iex

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/syncro/install.sh)

安装程序会将 syncro-cli（CLI）和 syncro-mcp（MCP 服务）都放入用户的 bin 路径。Claude Code、Codex 和 Cowork 会通过此目录中的 SKILL.md 发现该技能。

验证：

syncro-cli --version

升级到最新版本

安装程序始终获取当前版本——重新运行即可升级：

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/syncro/install.sh)

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/syncro/install.ps1 | iex

Claude Desktop .mcpb 用户：下载最新的 .mcpb（位于本节顶部），然后在 Settings > Extensions 中重新选择。Claude Code 插件用户：/plugin update syncro@msp-skills。

添加到 Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot 或其他 MCP 客户端

安装程序运行后，请参阅 mcp-install.md 和 docs/which-agent.md，了解各 Agent 的接入方式——每个 Agent 各有一个章节，其中包括 GitHub Copilot 的 servers 键，以及远程 Microsoft 365 Copilot / Copilot Studio 的接入路径。Claude Desktop 的 Settings > Extensions 面板是最简单的接入方式；对于偏好编辑 JSON 的用户，mcp-install.md 中记录了 MCP 配置代码块。

为 Hermes 安装

在 Hermes CLI 中：

hermes skills install servosity/msp-skills/skills/syncro --force

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/syncro --force

Hermes 原生支持 MCP，因此也可以直接使用 syncro-mcp 服务——安装方式相同，环境变量也相同。

为 OpenClaw 安装

告诉你的 OpenClaw Agent（复制以下内容）：

从 https://github.com/servosity/msp-skills/tree/main/skills/syncro 安装 syncro 技能。该技能会说明如何通过 openclaw: frontmatter 块安装其所需的 CLI（syncro-cli）。

OpenClaw 尚未普遍开放；frontmatter 接入配置已预先提供，OpenClaw 一经发布便会立即启用。

身份验证

设置 CLI 所需的凭据（从你的 Syncro 门户获取）：

SYNCRO_API_KEY=<value> SYNCRO_SUBDOMAIN=<value> syncro-cli doctor

运行任何会触及数据的操作前，doctor 会确认凭据是否有效。即使凭据被拒绝，它也会以 0 退出，因此脚本应添加 --fail-on error。

此技能的功能

用自然语言提问；你的 Agent 会运行相应命令。下表中的每个结果都来自 Syncro 数据的本地镜像，因此答案涵盖所有客户，并能在几秒内返回。

MSP 常问的问题	命令
哪些客户记录了工时，却从未开具发票？	syncro-cli billing uninvoiced
哪些已关闭工单包含可计费工时，却从未开具发票？	syncro-cli billing drift
我们的未付款 AR 账龄如何（0-30/30-60/60-90/90+）？	syncro-cli billing ar-aging
按客户计算，我们每个劳动小时的收入是多少？	syncro-cli customers margin
哪些未结工单因近期没有活动而开始搁置？	syncro-cli tickets aging
哪些资产缺少最多的关键补丁？	syncro-cli assets patch-gaps
哪些客户产生的 RMM 警报噪声最多？	syncro-cli alerts noise
哪些 RMM 警报没有生成工单？	syncro-cli alerts orphans
给我一张针对单个客户的跨实体信息卡。	syncro-cli customers profile 12345

完整命令参考：guide.md。有关 AI Agent 操作约定（--agent、--dry-run，以及何时应在修改数据前确认），请参阅 AGENTS.md。

有何不同

大多数 Syncro 集成和 MCP 服务都会将每个问题代理为一次实时 API 调用。查询单条记录时这没问题；但在规模扩大后就行不通了——比如你要问“上个季度我们在所有 47 个客户那里记录了多少可计费工时，却从未开具发票”。

此技能会将 Syncro 同步到带有全文搜索的本地 SQLite 镜像中。汇总类问题只需执行一次本地 SQL 联接：即时、离线，而且 AI 看到的是答案，而不是原始数据。billing uninvoiced、customers margin 和 customers profile 等复合命令会跨所有客户联接计时器条目、工单、发票、资产和 RMM 警报——这是无状态 API 封装器无法做到的。

它解决的痛点

MSP 因计费错误损失的收入约占 10%，行业分析指出，工时追踪不准确是最大的单一来源——工单上记录的人工工时悄然未被计入发票（DeskDay，《Revenue Leakage in Mid-Market MSPs》；rev.io，《Where MSPs Are Losing Money on Billing》）。Syncro 有工时记录和发票，但其门户从不按客户对已记录但未开票的工时进行排序，因此直到一个季度后，收入流失才会显现。

这个技能将这一收入流失问题，以及所有者反复提出的其他问题，都变成一条命令：

• syncro-cli billing uninvoiced - 按客户排序的已记录但未开票人工工时
• syncro-cli billing drift - 已关闭且有可计费工时、但从未开票的工单
• syncro-cli billing ar-aging - 按账龄分组的未付款发票，最严重的排在前面
• syncro-cli tickets aging - 长时间没有近期活动、正在过期的开放工单
• syncro-cli assets patch-gaps - 所有客户中缺少关键补丁的资产，按情况排序

更详细的说明请参阅 pain-point.md。

常见问题

这能与 ChatGPT 配合使用吗？

当前版本不行。ChatGPT（Plus、Pro、Team、Business、Enterprise 和 Education 计划；Free 计划尚未开放 Developer Mode）只能通过 HTTPS 连接远程 MCP 服务，这意味着必须以 HTTP 模式运行 Syncro MCP 服务。在当前版本中，HTTP 模式不要求密码、会监听所有网络接口，且可被你打开的网页访问，因此在重新生成连接器之前，请勿运行该模式或将其置于隧道之后；原因请见 mcp-install.md 中的安全说明。在此之前，请使用 Claude Desktop、Claude Code 或 Codex。

这能与 Codex、Cursor、Windsurf、Cline、Copilot 或 Gemini 配合使用吗？

可以——它们都支持 MCP。跨工具安装命令见上方的矩阵，深入说明请参阅 docs/which-agent.md。

我需要懂编程吗？

不需要。建议的安装方式是在 Claude Code 或 Codex 中粘贴一句话——你的 Agent 会读取 SKILL.md 并完成安装。备用方式是按操作系统使用一行安装命令（bash 或 PowerShell）。两种方式都不需要编写代码。你只需输入一次 Syncro 凭据。

我的 Syncro 数据安全吗？

你的数据保留在自己的设备上。CLI 和 MCP 服务都是本地二进制程序。SQLite 镜像存放在你用户账户下的目录中。AI Agent 只能看到 CLI 返回的内容——通常是查询结果，而不是原始批量数据。凭据从你的环境或 Agent 配置中读取；MSP Skills 不会将其打包进此仓库，也不会将其传输到任何地方。

这会触及 Syncro API 速率限制吗？

日常问题从本地 SQLite 镜像读取，而非实时 API，因此完全不会消耗速率限额。只有 sync 和明确指定的实时读取会调用 Syncro；CLI 还提供 --rate-limit 标志和响应缓存，以避免造成不必要的负担。

我需要成为 Syncro 合作伙伴或使用特定套餐吗？

不需要。你需要一个 Syncro 账户，以及从自己的门户（Admin 区域）获取的 API 令牌。它会以你的身份，针对你的子域名进行身份验证，并遵循该令牌的权限范围——无需加入合作伙伴计划或使用特殊级别的套餐。

它会取代我的 Syncro 门户吗？

不会。它会读取你的 Syncro 账户，处理跨客户问题和批量分析，而这些操作在门户中很繁琐。你仍然可以照常在 Syncro 中处理工单、计费和 RMM；它是用于快速回答所有者反复提出问题的捷径。

费用是多少？

免费。采用 Apache-2.0 许可证。你只需为所用的 AI Agent（Claude、ChatGPT、Codex 等）付费，费用由 AI 提供商收取，而非我们。

安全模型

层级	示例	推荐的 Agent 策略
读取	billing uninvoiced、billing ar-aging、customers margin、tickets aging、assets patch-gaps、alerts noise、customers profile，以及所有 list / get / search / export 命令	允许
写入（常规）	tickets create、tickets comment create、tickets update、invoices create、customers update、appointments create	使用 --dry-run 预览，然后执行经过审核的写入操作
破坏性操作 / 配置	tickets delete、invoices delete、customers delete、contracts delete 以及其他 delete 命令	仅限人工参与

最重要的控制措施是授予 Syncro 凭据的权限范围——CLI 只能执行凭据允许的操作。完整详情（包括如何限制权限）请参阅 governance.md。

状态

测试版。已根据 Syncro API 功能范围进行验证，目前正在每周 Build Sessions 中，与 MSP 合作，在其生产租户上进行实际验证。请在 compoundingteams.com/build-sessions 登记参加。

---

标准。 符合开放的 Agent Skills 规范（Anthropic，2025 年 12 月；支持 40 多种 Agent）。兼容 MCP——可与任何支持 MCP 的 Agent 配合使用，包括 Hermes。已为 OpenClaw 做好准备（frontmatter 已预先配置，等待 OpenClaw 发布）。

由 Servosity 维护。采用 Apache-2.0 许可。使用 CLI Printing Press 构建。上次更新：2026-06-06。