PandaDoc MCP

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

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

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

提供所有 PandaDoc 端点，以及其他 PandaDoc 工具都没有的离线文档流水线——通过本地存储分析停滞交易、账龄、收件人参与度和未结报价金额。可与您已经在使用的 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	如何安装 PandaDoc Skill
Claude Desktop	运行安装程序，然后在 Settings > Extensions 中注册 pandadoc-mcp（无需编辑 JSON）。
ChatGPT（付费方案）	此连接器重新发布前暂停：ChatGPT 需要使用 HTTP 模式，而此版本的该模式不要求密码、会监听所有网络接口，并且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，将 pandadoc-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 应用在远程运行，需要与 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 上启动。每个工具都会调用配套的 pandadoc-cli。自 2026-09-18 起发布的版本会将该 CLI 一并打包；较早的安装包只包含 MCP 服务，因此如果你的安装包缺少配套程序，请先运行下方的路径 A 或路径 B 安装程序（或者将 PANDADOC_CLI_PATH 设置为现有二进制文件的路径）。详情： #331。

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

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

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

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

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

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

这条提示词也适用于任何可以运行 Shell 的 Agent。

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

pandadoc-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop .mcpb 用户：下载最新的 .mcpb（见本节顶部），然后在 Settings > Extensions 中重新选择该文件。Claude Code 插件用户：运行 /plugin update pandadoc@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/pandadoc --force

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/pandadoc --force

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

为 OpenClaw 安装

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

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

OpenClaw 目前尚未普遍开放；frontmatter 接入配置已预先提供，将在 OpenClaw 发布时立即启用。

身份验证

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

PANDADOC_API_KEY=<value> pandadoc-cli doctor

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

此技能的功能

MSP 经常提出的问题	命令
哪些文档已发送但始终未完成？	pandadoc-cli stalled --days 14
未完成的报价中有多少资金？	pandadoc-cli value
整个文档漏斗的情况如何？	pandadoc-cli pipeline
每份文档在当前状态停留了多久？	pandadoc-cli aging
哪些客户一个月内没有签署任何文件？	pandadoc-cli cold-clients --days 30
今天该跟进谁？	pandadoc-cli followup --days 7
哪些收件人会打开并签署文档，哪些会任由文档搁置？	pandadoc-cli engagement
哪些模板确实能促成签约？	pandadoc-cli template-stats
哪些已发送文档未设置自动提醒？	pandadoc-cli reminder-gaps
过去一天有哪些变化？	pandadoc-cli since 24h

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

与众不同之处

大多数 PandaDoc 集成和 MCP 服务都会将每个问题转发为实时 API 调用。对于单条记录来说，这没问题。但到了需要在季度业务回顾时询问“所有未完成文档中，有多少尚未签署、又有多长时间了？”的规模，这种方式就行不通了。

此技能会将 PandaDoc 同步到带有全文搜索的本地 SQLite 镜像中。聚合查询会变成一次本地 SQL 联接：即时、离线，而且 AI 看到的是答案，而不是原始数据。followup、forecast 和 cold-clients 等复合命令会联接文档、收件人和报价定价数据——无状态 API 封装器无法完成这类工作。

解决的痛点

你通过 PandaDoc 发送提案、工作说明书（SOW）和主服务协议（MSA），之后却杳无音信。交易并没有告吹——只是一直搁在那里，尚未签署，也没人通知你。在 r/msp 上，常见的话题总是类似“如何跟进那些始终没人签署的报价？”——业主们交流提醒频率，正是因为提案工具一次只显示一份文档，却从不提示这笔交易停滞了，或你有这么多报价已经三周无人过问。因此，跟进全靠记忆，销售预测也只能靠猜。

• pandadoc-cli stalled --days 14 - 已发送但始终未完成：那些悄然流失的交易。
• pandadoc-cli value - 所有进行中文档中的未结报价总额。
• pandadoc-cli followup --days 7 - 按优先级排序的提醒待办清单，并关联收件人邮箱。
• pandadoc-cli cold-clients --days 30 - 已经沉寂的客户，按距上次签署的天数排序。
• pandadoc-cli forecast - 按健康、老化和停滞层级划分的未结报价总额。

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

常见问题

这能和 ChatGPT 配合使用吗？

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

我的 PandaDoc 数据安全吗？

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

这会触及我的 PandaDoc API 速率限制吗？

日常问题会读取本地镜像，因此不会访问 API。只有 sync、tail 和少数实时命令（例如 reminder-gaps）会直接调用 PandaDoc，CLI 也支持配置 --rate-limit，让你遵守所用计划的限制。

我需要成为 PandaDoc 合作伙伴或客户吗？

你需要拥有自己的 PandaDoc 账户并具备 API 访问权限（PandaDoc 付费计划包含此权限）。该 skill 使用你自己的 PANDADOC_API_KEY 进行身份验证——不要求你成为 Servosity 或 PandaDoc 合作伙伴。

这会取代我的 PandaDoc 门户吗？

不会。你仍然需要在 PandaDoc 中创建、发送和签署文档。它增加了门户中没有展示的跨文档报告和跟进汇总，这样你就可以直接询问 AI，而不必导出电子表格。

费用是多少？

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

安全模型

层级	示例	建议的 Agent 策略
读取	pipeline、stalled、aging、value、engagement、search、documents list	允许
写入（常规）	contacts create、contacts update、documents create、documents send document、documents recipients add-document、templates create	使用 --dry-run 预览，然后执行经过审核的写入操作
凭据 / 破坏性操作	workspaces api-keys create、members token create-member、documents delete、documents bulk-delete、documents recipients delete-document	仅允许人在回路中

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

状态

Beta 版。已根据 PandaDoc API 接口进行验证，目前正与 MSP 合作，在每周 Build Sessions 中对其自有生产租户进行实时验证。请通过 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-06。