Pipedrive MCP

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

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

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

完整支持 Pipedrive 的 CRUD 操作，并提供本地 SQLite 销售管道副本：过期商机、预测、老化情况、重复项、销售代表排行榜。可与您已经在使用的 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	如何安装 Pipedrive skill
Claude Desktop	运行安装程序，然后在 Settings > Extensions 中注册 pipedrive-mcp（无需编辑 JSON）。
ChatGPT（付费套餐）	在此连接器重新发布前暂停使用：ChatGPT 需要 HTTP 模式，而此版本的该模式无需密码，会监听所有网络接口，并且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全说明。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 pipedrive-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 应用在远程运行，需要与 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，然后为 CLI／MCP 二进制文件运行各自的安装程序）。请参阅 docs/which-agent.md。

60 秒内完成安装

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

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

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

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

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

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

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

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

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

Path B——自行运行安装程序

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

pipedrive-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/pipedrive --force

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

为 OpenClaw 安装

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

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

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

身份验证

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

PIPEDRIVE_API_KEY=<value> pipedrive-cli doctor

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

此技能的功能

你的 MSP 经常提出的问题	命令
哪些未结交易已有两周无人跟进？按金额从高到低排列。	pipedrive-cli stale --quiet-days 14 --agent
本季度的加权预测是多少？预计有哪些交易会成交？	pipedrive-cli forecast --period this-quarter --agent
哪些交易停留在某个阶段的时间超过了该阶段的通常时长？	pipedrive-cli aging --agent
哪些未结交易尚未安排下一项活动？	pipedrive-cli next-activity --missing --agent
按过去 90 天的赢单金额为销售代表排名。	pipedrive-cli leaderboard --by won-value --window 90d --agent
从昨天到现在有哪些变化？我今天该联系谁？	pipedrive-cli digest --for-me --agent
过去六个月有哪些交易未能成交？原因是什么？	pipedrive-cli lost --since 180d --agent
通话前，给我一份联系人的完整情况。	pipedrive-cli who "Jane Smith" --agent
将我的整个销售管道拉取到本地副本，以便离线分析。	pipedrive-cli sync --agent

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

与众不同之处

大多数 Pipedrive 集成和 MCP 服务都会将每个问题转发为实时 API 调用。查询单条记录时，这样做没问题。但遇到大规模查询时就行不通了，例如“所有销售管道中，哪些未结交易已经无人跟进？按风险金额排序”——没有任何单个 API 端点能回答这个问题。

此技能会将 Pipedrive 同步到带有全文搜索的本地 SQLite 镜像中。聚合查询只需执行一次本地 SQL 联接：即时、离线，而且 AI 看到的是答案，而非原始数据。stale、forecast、leaderboard 和 who 等复合命令会联接交易、联系人、组织、活动和阶段的数据——这是无状态 API 封装器无法做到的。

它解决的痛点

在 G2、Capterra 和 Trustpilot 上，报表是 Pipedrive 最常被提及的投诉（汇总）。Insights 涵盖了基础需求，但负责人在周一的销售管道评审中会问到跨实体问题——哪些交易正悄无声息地失去进展、加权预测是多少、哪些销售代表真正有所贡献、哪些交易陷入停滞——这意味着要先导出到电子表格，再重新计算。同时，CRM 数据每年大约会有 30% 变得过时，因此，如果没人记录过活动，交易就会一直搁在那里，直到它彻底冷却。

此技能只需各运行一条命令，即可回答这些问题：

• stale - 列出 N 天内无人跟进的未结交易，并按风险金额排序。
• forecast - 按销售管道显示加权交易金额，以及预期成交金额。
• aging - 列出在某个阶段停留时间超过其典型停留时长的交易。
• leaderboard - 按销售代表显示指定时间范围内的未结、已赢单、已丢单交易、加权销售管道和赢单金额。
• who - 显示联系人的信息卡片：组织、未结交易、最近/下一项活动、近期备注。

更多背景说明，请参阅 pain-point.md。

常见问题

这能与 ChatGPT 配合使用吗？

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

我的 Pipedrive 数据安全吗？

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

这需要更高级的 Pipedrive 套餐或付费的 Insights 层级吗？

不需要。任何提供 API 令牌的 Pipedrive 套餐都可以使用——在 Settings > Personal preferences > API 中查找。此技能调用标准 Pipedrive API，而跨实体分析（stale、forecast、aging、leaderboard）会在本地基于已同步的数据运行，因此不受报表附加功能限制。

这会耗尽我的 Pipedrive API 速率限制吗？

日常问题在 sync 后会从本地镜像中获取答案，因此不会产生任何 API 调用。sync 本身会以适当的方式分页——可调整 --rate-limit 和 --concurrency，并使用 --since 24h 仅刷新有变动的数据；只有在本地数据缺失或过时的情况下才会进行实时调用。

这会取代 Pipedrive 门户吗？

不会——它是对门户的补充。门户仍是你的事实来源系统，也是销售代表日常使用的界面；此技能则在终端或 AI Agent 中补充 Insights 无法回答的跨实体问题。

费用是多少？

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

安全模型

层级	示例	建议的 Agent 策略
读取	每个 get/list 命令、分析汇总（stale、forecast、aging、digest、leaderboard、next-activity、lost、who、changes、dupes）、search、export 和 sync（仅本地镜像）	允许
写入（常规）	deals add、deals update、persons add、organizations update、notes add、activities add、leads add 和批量 import——总计 73 个常规写入命令	使用 --dry-run 预览，然后执行经审核的写入
破坏性操作／配置	deals delete、persons delete、organizations delete 和其他 40 个删除命令，以及凭据命令（auth set-token、oauth get-tokens、oauth refresh-tokens）	仅限人工参与

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

状态

Beta 版。已根据 Pipedrive 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-06。