Salesbuildr MCP

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

非官方。由社区构建的 Claude Code Skill 和 Salesbuildr API MCP 服务。与 Salesbuildr 无关联，未经其认可或赞助。

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

Salesbuildr 的每种资源都可作为脚本化命令使用，另外还提供离线利润率和销售管道分析。可与您现有的 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	如何安装 Salesbuildr 技能
Claude Desktop	运行安装程序，然后在 Settings > Extensions 中注册 salesbuildr-mcp（无需编辑 JSON）。
ChatGPT（付费套餐）	此连接器重新发布前暂停使用：ChatGPT 需要 HTTP 模式，而此版本的该模式无需密码，会监听所有网络接口，并且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，将 salesbuildr-mcp 添加到 mcp.json 的 servers 键下，然后选择 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。

原生支持 Skill 的 Agent（也已介绍）： Hermes 和 OpenClaw 会直接读取此 Skill 的 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，然后运行各 Skill 的安装程序以安装 CLI／MCP 二进制程序）。请参阅 docs/which-agent.md。

60 秒完成安装

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

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

下载 Salesbuildr MCP（.mcpb）——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。点击一次即可完成，无需 JSON 或命令行。（可在发布页面浏览所有 Salesbuildr 版本。）

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

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

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

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

在此 Agent 工作区中安装 Servosity/msp-skills 提供的 Salesbuildr Skill 和 MCP 服务。如果此工作区使用 POSIX shell（macOS、Linux、WSL 或 Bash），请运行 bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/salesbuildr/install.sh)。如果使用 Windows PowerShell，请运行 iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/salesbuildr/install.ps1 | iex。然后按照 README 完成身份验证，并运行 salesbuildr-cli --help 进行探索。

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

安装程序会将 salesbuildr-cli（CLI）和 salesbuildr-mcp（MCP 服务）放入用户的 bin 路径中。Claude Code、Codex 和 Cowork 会从此目录中的 SKILL.md 发现 Skill。

验证：

salesbuildr-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop .mcpb 用户：下载最新的 .mcpb（本节顶部），并在 Settings > Extensions 中重新选择该文件。Claude Code 插件用户：运行 /plugin update salesbuildr@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 的“设置 > 扩展”面板是最简单的方式；偏好编辑 JSON 的用户可在 mcp-install.md 中找到 MCP 配置块。

为 Hermes 安装

在 Hermes CLI 中：

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

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/salesbuildr --force

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

为 OpenClaw 安装

向你的 OpenClaw Agent 发送以下内容（复制即可）：

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

OpenClaw 尚未普遍开放；frontmatter 接入配置已预先附带，并会在 OpenClaw 发布时立即启用。

身份验证

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

SALESBUILDR_API_KEY=<value> SALESBUILDR_TENANT=<value> salesbuildr-cli doctor

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

此技能的功能

MSP 经常提出的问题	命令
哪些已发送或已批准的报价正在超期？涉及多少风险金额？	salesbuildr-cli quote stale --days 14
哪些报价行项目的定价低于我的加价下限？	salesbuildr-cli quote thin --floor 20
我的报价管道各阶段的转化情况如何？按数量和金额分别是多少？	salesbuildr-cli quote funnel
各公司的价格簿价格与主目录相比，哪些出现了偏差？	salesbuildr-cli pricing drift
按负责人、阶段或类别划分，我的赢单率是多少？	salesbuildr-cli opportunity winrate --by owner
按概率加权后的经常性收入预测是多少？	salesbuildr-cli opportunity mrr-forecast
对于某家公司，我从未报价过哪些目录产品？	salesbuildr-cli company whitespace "Acme Managed IT"
哪些记录缺少 PSA 同步所依赖的外部 ID？	salesbuildr-cli reconcile-psa

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

有何不同

大多数 Salesbuildr 集成和 MCP 服务都会将每个问题转发为一次实时 API 调用。查询单条记录时这没问题，但规模一大就行不通了。比如你想知道：“我本季度发送的 80 份报价中，哪些仍未关闭、已超期，而且值得在到期前跟进？”

此技能会将 Salesbuildr 同步到带有全文搜索的本地 SQLite 镜像中。聚合查询会变成一次本地 SQL 联接：即时、离线，而且 AI 看到的是答案，而不是原始数据。quote stale、quote thin 和 company whitespace 等复合命令会跨报价、行项目、产品和价格簿进行联接——无状态 API 封装器无法做到这一点。

它解决的痛点

报价发出后便没了下文。精简型 MSP 没人有时间逐一跟进每份已发送的提案，因此真正有价值的交易会悄悄拖过有效期——这是 r/msp 上反复出现的报价跟进问题。与此同时，利润率一点一点流失：技术人员换上一个按成本价计费的零件，忘了加价，直到季度业务回顾（QBR）时你才发现。各公司的价格表也会逐渐偏离主目录，导致两个客户为同一 SKU 支付不同的价格。

这个技能将这些问题变成一行命令：

• salesbuildr-cli quote stale --days 14 - 列出所有已发送／已批准且超过截止天数的报价，并显示仍有风险的金额。
• salesbuildr-cli quote thin --floor 20 - 在发货前列出所有加价低于底线的未结订单行。
• salesbuildr-cli pricing drift - 列出偏离主目录成本价或售价的各公司价格。
• salesbuildr-cli company whitespace "Acme Managed IT" - 列出从未向某客户报价过的目录产品，也就是你一直打算提出的交叉销售机会。
• salesbuildr-cli reconcile-psa - 列出缺少 Autotask／ConnectWise 同步所需外部 ID 的记录。

有关更完整的说明，请参阅 pain-point.md。

常见问题

这能与 ChatGPT 搭配使用吗？

此版本还不能。ChatGPT（Plus、Pro、Team、Business、Enterprise 和 Education 方案；Free 目前尚未开放 Developer Mode）只能通过 HTTPS 连接远程 MCP 服务，这意味着需要以 HTTP 模式运行 Salesbuildr 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）。这两种方式都不需要编写代码。你只需输入一次 Salesbuildr 凭据。

我的 Salesbuildr 数据安全吗？

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

这会导致 Salesbuildr API 触及速率限制吗？

不会。分析功能读取的是本地 SQLite 镜像，而不是实时 API——你只需执行一次 sync，之后便可离线随意提问，不会再产生任何 API 调用。同步过程会遵守可配置的 --rate-limit，运行频率由你控制。

我需要是 Salesbuildr 客户吗？这会取代我的 PSA 同步吗？

你需要拥有 Salesbuildr 账户、从门户获取 Public API key，以及你的租户子域名。它不会取代 Autotask／ConnectWise 同步——它会读取 Salesbuildr 数据，并标记出缺少同步所依赖外部 ID 的记录（reconcile-psa），以便你补齐缺漏。它绝不会向你的 PSA 写入数据。

费用是多少？

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

安全模型

层级	示例	建议的 Agent 策略
读取	每个 public-get/public-get-list、分析工具（quote stale、quote thin、quote funnel、pricing drift、opportunity velocity/winrate/mrr-forecast、product velocity、company whitespace）、reconcile-psa、search、sql、export 和 sync（仅本地镜像）	允许
写入（常规）	company/contact/product/pricing-book/quote/quote-template 的创建和更新、upsert、opportunity public-win/public-lose/public-upsert、field public-update-values、product inventory、恢复已删除的联系人，以及批量 import——总计 30 条常规写入命令	先使用 --dry-run 预览，再经审核后写入
破坏性操作 / 配置	6 条删除命令（company/contact/product public-delete*），以及本地凭据命令（auth set-token、auth setup、auth logout）	仅允许人工介入

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

状态

Beta 版。已根据 Salesbuildr API 接口进行验证，目前正通过每周的 Build Sessions，与在自有生产租户中实际运行该工具的 MSP 一起进行验证。请通过 compoundingteams.com/build-sessions RSVP。

---

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

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