QuoteWerks MCP

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

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

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

适用于 QuoteWerks Web 的类型化报价工具，使用实际列名，可在发送前预览类型化写入操作，并通过本地镜像提供利润率、成交率和销售管道数据。可与您现有的 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	如何安装 QuoteWerks Skill
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 quotewerks-mcp（无需编辑 JSON）。
ChatGPT（付费计划）	此连接器重新发布前暂停使用：ChatGPT 需要 HTTP 模式，而此版本中的该模式会检查令牌，但尚无请求大小或时间限制。参见 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 quotewerks-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

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

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

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

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

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

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

同一条提示词也适用于任何能够运行 shell 的 Agent。

方案 B——自行运行安装程序

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

quotewerks-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop .mcpb 用户：下载最新的 .mcpb（本节顶部），并在 Settings > Extensions 中重新选择该文件。Claude Code 插件用户：/plugin update quotewerks@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 面板是最简单的方式；MCP 配置代码块（适合偏好编辑 JSON 的用户）详见 mcp-install.md。

为 Hermes 安装

在 Hermes CLI 中：

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

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/quotewerks --force

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

为 OpenClaw 安装

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

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

OpenClaw 尚未普遍开放；frontmatter 配置已预先打包，OpenClaw 一经发布便会启用。

身份验证

在 QuoteWerks Web 的 Setup > Options > Zapier and API 中创建 API 密钥（API 要求用户拥有 MasterRights）。只有在希望 Agent 创建或更改文档时，才勾选密钥上的 Allow write access；只读密钥足以完成所有查询和报告。然后：

export QUOTEWERKS_API_KEY=<your-key>
quotewerks-cli doctor

doctor 会检查配置和路径，并通过一次读取请求（GET /api/v1/qw/tables）验证密钥：被拒绝的密钥会显示为 ERROR rejected。无论检查结果如何，它默认都会以 0 退出；在脚本中添加 --fail-on error，即可让检查失败时以非零状态退出。

此技能的用途

MSP 经常提出的问题	命令
Acme 的报价进展如何？	quotewerks-cli docs search --customer "Acme" --type QUOTE
报价 1042 中逐行列出了什么？每行的利润率是多少？	quotewerks-cli docs get "1042"
这份报价中是否有低于成本或利润率低于 10% 的项目？	quotewerks-cli docs lint "1042" --min-margin 10
这些笔记本电脑采用 18% 的利润率后，报价会变成什么样？（预览，不会写入）	quotewerks-cli items reprice "1042" --part 20UES0X100 --margin 18
将去年 3 月的订单复制为一份新报价，并按当前价格添加 12 台笔记本电脑（预览）	quotewerks-cli requote "1042" --qty 20UES0X100=12
哪些未结报价已超过 30 天？我该联系谁跟进？	quotewerks-cli pipeline --older-than 30d
过去 90 天各销售代表的成交率是多少？	quotewerks-cli winrate --by rep --since 90d
哪些未结报价中的成本与产品数据库当前记录不符？	quotewerks-cli cost-drift --threshold 2

pipeline、win-rate、margin、cost-drift 和 changes 报告会读取本地副本：先运行 quotewerks-cli mirror，之后每次需要最新数据时再次运行。写入操作（docs create、items add、items reprice、requote）只会生成预览，除非添加 --confirm。

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

与众不同之处

大多数 QuoteWerks 集成（包括 Zapier 应用）都会为每条记录调用一次实时 API。处理单条记录时这没问题；但规模一大就会失效，例如你想知道“上个季度所有订单按销售代表划分的利润率是多少？经销商提价后，哪些未结报价的利润变薄了？”

此技能会将 QuoteWerks 文档、明细行和产品数据库复制到本地 SQLite 镜像（quotewerks-cli mirror）。汇总查询只需执行一次本地查询：结果即时可得、无需联网，AI 也能直接看到答案，而不是原始数据。cost-drift 会将每条未结报价明细与产品数据库关联起来，margin --by manufacturer 和 winrate 则会汇总所有镜像文档中的标题和明细——这些都是无状态 API 封装无法完成的工作。与一次处理一条记录的原始 REST API 和 Zapier QuoteWerks 应用 相比，此技能还提供了使用 QuoteWerks 实际列名的类型化报价命令，并且在发送任何类型化写入操作前都会先生成预览。

解决的痛点

一位 MSP 客户经理请求 QuoteWerks 提供官方 MCP 服务，并列出了占用大量时间的四项工作：

• 根据邮件创建报价。“再要 12 台和你们 3 月发来的型号相同的笔记本电脑，外加扩展坞”意味着要找到 3 月的文档，再把每一行手动录入新报价。
• 报价状态。“Acme 的报价进展如何？”意味着要停下手头工作，去运行 Document Lookup。
• **重新定价。**分销商成本变动时，有人要打开每份文档并逐行修改。
• **季度业务回顾数据。**毛利率和赢单率意味着每个问题都要编写脚本或生成报告。

同一篇帖子也说明了为什么仅有 Beta REST API 还不够：它只是通用的表格访问接口，因此 AI 必须猜测架构，而猜错后会悄无声息地生成错误报价。这个技能用一条命令处理每项工作：

• quotewerks-cli requote "1042" --qty 20UES0X100=12 - 将 3 月的订单复制到新报价中，更新数量并采用今日的产品数据库价格，然后在创建任何内容之前预览结果。
• quotewerks-cli docs search --customer "Acme" --type QUOTE - 无需离开当前窗口，即可查看报价状态。
• quotewerks-cli cost-drift --threshold 2，然后运行 items reprice - 找出所有成本已变动的未结报价行，显示成本变动前后的毛利率，并在更改任何价格之前提供新旧差异。
• quotewerks-cli margin --by rep --since 90d 和 winrate --by rep - 从本地镜像获取季度业务回顾所需的数据。

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

常见问题

这能与 ChatGPT 搭配使用吗？

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

我的 QuoteWerks 数据安全吗？

你的数据会保留在自己的计算机上。CLI 和 MCP 服务都是本地二进制文件。SQLite 镜像存放在你用户账户下的目录中。AI Agent 只能看到 CLI 返回的内容——通常是查询结果，而非原始批量数据。API 密钥从环境变量、Agent 配置中读取；如果你使用 quotewerks-cli auth set-token 保存了凭据，也可以从 CLI 的凭据文件（权限模式 0600）中读取。MSP Skills 不会将密钥打包到此仓库中，也不会将其传输到任何地方。

这能与 QuoteWerks Desktop 搭配使用吗？

它通过位于 qwwapi.quotewerks.com 的 QuoteWerks Web REST API 支持 QuoteWerks Web，该 API 被 QuoteWerks 标记为 Beta。它不会打开 QuoteWerks Desktop 数据库，也不会使用桌面 COM API。

我需要什么 API 密钥？AI 能更改我的报价吗？

在 QuoteWerks Web 中依次选择 Setup > Options > Zapier and API 创建密钥；API 要求用户拥有 MasterRights。未启用 Allow write access 的密钥可以读取，但不能更改任何内容（QuoteWerks 会对写入请求返回 403）。即使使用启用了写入权限的密钥，docs create、items add、items reprice 和 requote 默认也只会预览，只有添加 --confirm 才会写入。原始的 tables insert、tables update 和 tables delete 命令会立即发送请求，因此除非需要写入，否则请保持密钥为只读。

这会不会给 QuoteWerks API 造成大量请求？

不会。margin、winrate、pipeline、cost-drift 和 changes 会读取 quotewerks-cli mirror 创建的本地副本，因此你可以随意提问，而不会产生额外的 API 调用。mirror 每次请求读取 1,000 行，默认会根据服务端的速率限制响应头控制请求频率。

这与 QuoteWerks Web 自带的 AI Agent 有何不同？

QuoteWerks Web 有自己的 AI Agent，这个技能也可以向它提问（quotewerks-cli agent ask）。这个技能带来的额外能力，是让你直接在日常使用的 AI 中使用这些功能：预览报价创建和重新定价、在报价发出前逐行审核，以及分析所有镜像文档。它是对 QuoteWerks Web 的补充，而非替代。

费用是多少？

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

安全模型

层级	示例	建议的 Agent 策略
读取	docs search、docs get、docs lint、items list、products search、tables 的读取命令（list、rows、row、query、schema、values）、cloud-settings 的读取命令、reports run、identity userinfo、agent ask（以及仅限 CLI 的 import agent，它会将问题的 JSONL 文件发送给同一个 AI Agent），还有镜像报告（margin、pipeline、cost-drift、winrate、changes）；mirror 和 sync 只会写入本地副本	允许
预览后写入	docs create、items add、items reprice、requote：默认都会预览，只有使用 --confirm 和启用了写入权限的密钥才会写入	允许 Agent 预览；由人工批准后，再使用 --confirm 重新运行
原始写入	tables insert 和 tables update（仅限 CLI，绝不会作为 MCP 工具），会立即向密钥有权写入的任何表发送请求	使用 --dry-run 预览，然后由人工审核写入
破坏性操作／凭据	tables delete（仅限 CLI；可删除任何表中的行，包括文档）、auth set-token、auth logout	仅限人工参与

最有效的控制措施是你创建的密钥：关闭 Allow write access，Agent 执行的任何操作都无法更改报价。CLI 只能执行密钥获准执行的操作。完整详情（包括如何限制权限）请参阅 governance.md。

状态

目前处于 Beta 阶段，它调用的 QuoteWerks Web REST API 也同样处于 Beta 阶段。本项目根据供应商发布的 API 规范和文档构建，并使用 API 的本地模拟环境进行了测试；尚未在任何真实的 QuoteWerks Web 租户上运行。我们正通过每周的 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-10-14。