使用说明
Pipedrive MCP服务器
全面的 模型上下文协议(MCP) 服务器 Pipedrive CRM API.暴露 100工具 -94个标准API工具,涵盖所有主要的Pipedrive资源,以及 6个内置分析工具 用于性能报告、损失分析和管道健康状况,因此任何与MCP兼容的AI(Claude、ChatGPT、Codex等)都可以通过对话读取、写入和分析您的CRM数据。
工具参考
优惠信息(9)
| 工具 | 说明 |
|---|---|
pipedrive_list_deals |
列表处理按用户、阶段、状态进行的可选过滤 |
pipedrive_get_deal |
按ID获取单笔交易 |
pipedrive_create_deal |
创建新交易 |
pipedrive_update_deal |
更新现有交易 |
pipedrive_delete_deal |
删除交易 |
pipedrive_search_deals |
跨交易的全文搜索 |
pipedrive_get_deal_activities |
列出交易中的所有活动 |
pipedrive_get_deals_summary |
按管道/阶段汇总总计 |
pipedrive_get_deals_timeline |
交易时间间隔可配置 |
人员/联系人(6)
| 工具 | 说明 |
|---|---|
pipedrive_list_persons |
列出具有可选筛选功能的人员 |
pipedrive_get_person |
通过ID获取一个人 |
pipedrive_create_person |
创建新用户 |
pipedrive_update_person |
更新一个人 |
pipedrive_delete_person |
删除一个人 |
pipedrive_search_persons |
跨人全文搜索 |
pipedrive_get_person_deals |
获取与某人关联的所有交易 |
组织机构(6)
| 工具 | 说明 |
|---|---|
pipedrive_list_organizations |
列出组织 |
pipedrive_get_organization |
按ID获取组织 |
pipedrive_create_organization |
创建新组织 |
pipedrive_update_organization |
更新组织 |
pipedrive_delete_organization |
删除组织 |
pipedrive_search_organizations |
跨组织的全文搜索 |
pipedrive_get_organization_deals |
获取组织的所有交易 |
pipedrive_get_organization_persons |
获取组织中的所有人员 |
活动(5)
| 工具 | 说明 |
|---|---|
pipedrive_list_activities |
列出带有日期/类型筛选的活动 |
pipedrive_get_activity |
按ID获取活动 |
pipedrive_create_activity |
创建新活动 |
pipedrive_update_activity |
更新活动 |
pipedrive_delete_activity |
删除活动 |
线索(6)
| 工具 | 说明 |
|---|---|
pipedrive_list_leads |
列出所有潜在客户 |
pipedrive_get_lead |
通过ID获取线索 |
pipedrive_create_lead |
创建新的潜在客户 |
pipedrive_update_lead |
更新潜在客户 |
pipedrive_delete_lead |
删除潜在客户 |
pipedrive_search_leads |
在潜在客户中进行全文搜索 |
注释(5)
| 工具 | 说明 |
|---|---|
pipedrive_list_notes |
列出带有过滤功能的笔记 |
pipedrive_get_note |
按ID获取备注 |
pipedrive_create_note |
创建与交易/个人/组织链接的注释 |
pipedrive_update_note |
更新注释 |
pipedrive_delete_note |
删除注释 |
产品(6)
| 工具 | 说明 |
|---|---|
pipedrive_list_products |
列出带有筛选功能的产品 |
pipedrive_get_product |
按ID获取产品 |
pipedrive_create_product |
创建新产品 |
pipedrive_update_product |
更新产品 |
pipedrive_delete_product |
删除产品 |
pipedrive_search_products |
跨产品的全文搜索 |
管道(6)
| 工具 | 说明 |
|---|---|
pipedrive_list_pipelines |
列出所有管道 |
pipedrive_get_pipeline |
按ID获取管道 |
pipedrive_create_pipeline |
创建管道 |
pipedrive_update_pipeline |
更新管道 |
pipedrive_delete_pipeline |
删除管道 |
pipedrive_get_pipeline_deals |
达成交易 |
pipedrive_get_pipeline_conversion_statistics |
漏斗转换统计数据 |
pipedrive_get_pipeline_movement_statistics |
交易动态统计 |
阶段(5)
| 工具 | 说明 |
|---|---|
pipedrive_list_stages |
列出所有阶段 |
pipedrive_get_stage |
按ID获取舞台 |
pipedrive_create_stage |
创建舞台 |
pipedrive_update_stage |
更新阶段 |
pipedrive_delete_stage |
删除阶段 |
pipedrive_get_stage_deals |
在某个阶段达成交易 |
用户(3)
| 工具 | 说明 |
|---|---|
pipedrive_list_users |
列出公司中的所有用户 |
pipedrive_get_user |
按ID获取用户 |
pipedrive_get_current_user |
获取经过身份验证的用户 |
项目(5)
| 工具 | 说明 |
|---|---|
pipedrive_list_projects |
列出所有项目 |
pipedrive_get_project |
按ID获取项目 |
pipedrive_create_project |
创建项目 |
pipedrive_update_project |
更新项目 |
pipedrive_delete_project |
删除项目 |
自定义字段(5)
| 工具 | 说明 |
|---|---|
pipedrive_list_deal_fields |
列出所有自定义交易字段 |
pipedrive_create_deal_field |
创建自定义交易字段 |
pipedrive_delete_deal_field |
删除自定义交易字段 |
pipedrive_list_person_fields |
列出所有自定义人员字段 |
pipedrive_create_person_field |
创建自定义人员字段 |
pipedrive_list_organization_fields |
列出所有自定义组织字段 |
Webhooks(3)
| 工具 | 说明 |
|---|---|
pipedrive_list_webhooks |
列出所有已配置的Webhook |
pipedrive_create_webhook |
创建webhook订阅 |
pipedrive_delete_webhook |
删除webhook |
文件(3)
| 工具 | 说明 |
|---|---|
pipedrive_list_files |
列出所有上传的文件 |
pipedrive_get_file |
按ID获取文件元数据 |
pipedrive_delete_file |
删除文件 |
邮件(3)
| 工具 | 说明 |
|---|---|
pipedrive_list_mail_threads |
列出邮件线程 |
pipedrive_get_mail_thread |
按ID获取邮件线程 |
pipedrive_get_mail_thread_messages |
获取一个线程中的所有消息 |
通话记录(2)
| 工具 | 说明 |
|---|---|
pipedrive_list_call_logs |
列出通话记录 |
pipedrive_create_call_log |
记录针对交易/人员的通话 |
搜索和杂项(8)
| 工具 | 说明 |
|---|---|
pipedrive_search |
跨所有实体类型的全局搜索 |
pipedrive_search_leads |
搜索潜在客户 |
pipedrive_list_filters |
列出已保存的筛选器 |
pipedrive_get_filter |
按ID获取筛选器 |
pipedrive_get_recents |
获取最近更改的项目 |
pipedrive_list_activity_types |
列出活动类型定义 |
pipedrive_list_currencies |
列出支持的货币 |
pipedrive_list_goals |
列出目标 |
pipedrive_get_subscription |
获取订阅详细信息 |
pipedrive_create_recurring_subscription |
创建定期订阅 |
分析和报告工具
除了上述94个标准API工具外,服务器还包括 6个内置分析工具 汇总和分析您的Pipedrive数据,以生成可操作的报告。这些工具超越了原始的API访问,它们直接在人工智能对话中获取和处理服务器端到表面的模式、风险和性能洞察数据。
这些工具旨在用于对话。用简单的英语问你的人工智能助手,它会选择正确的工具,运行分析,并呈现结果。
pipedrive_performance_report
生成给定时间段的赢/输绩效报告,其中包含 综合排行榜 该排名从四个维度对代表进行排名:胜率、交易量、收盘速度和平均交易价值。
参数
| 参数 | 类型 | 说明 |
|---|---|---|
period |
daily |
weekly |
offset |
number | 从今天开始的时段(0=当前,1=以前) |
date_from |
string | 自定义开始日期 YYYY-MM-DD |
date_to |
string | 自定义结束日期 YYYY-MM-DD |
pipeline_id |
number | 仅限于特定管道 |
综合评分法
排行榜使用0-100的综合得分来防止任何单一指标占据主导地位:
| 尺寸 | 重量 | 计算方法 |
|---|---|---|
| 赢率 | 30% | 赢得的交易÷总成交额 |
| 交易量 | 25% | 韩元交易相对于表现最佳的交易正常化 |
| 速度 | 20% | 平均收盘天数与团队中位数(更快=更高,上限为1.5倍) |
| 交易价值 | 25% | 平均韩元交易价值与表现最佳者相比正常化 |
这意味着,一个在2笔交易中获胜率为100%的代表不会超过以70%的价格完成60笔交易的人——数量和价值很重要。
示例提示
"Show me this month's performance report"
"How did the team do in Q1 2026?"
"Give me a performance report for January 2026"
"Who had the best performance score last month?"
输出示例
Period: 2026-01-01 → 2026-01-31
Summary
Deals won: 42 Win rate: 58.3%
Deals lost: 30 Revenue won: £284,750
New deals: 118 Avg deal: £6,779
Leaderboard
#1 Alex Chen Score: 74.2 Won: 12 Rate: 100% Avg: £18,400 Speed: 8 days
Win rate: 30/30 Volume: 18/25 Speed: 8/20 Value: 18.2/25
#2 Jordan Mills Score: 61.8 Won: 18 Rate: 72% Avg: £8,200 Speed: 12 days
Win rate: 21.6/30 Volume: 25/25 Speed: 12.3/20 Value: 3/25 (low value deals)
#3 Sam Rivera Score: 49.3 Won: 8 Rate: 66% Avg: £5,100 Speed: 41 days
Win rate: 19.8/30 Volume: 11.1/25 Speed: 6.7/20 Value: 11.8/25
#4 Casey Park Score: 31.1 Won: 4 Rate: 44% Avg: £1,200 Speed: 5 days
Win rate: 13.2/30 Volume: 5.6/25 Speed: 14.5/20 Value: 1.4/25
Won by stage: Stage 6 (38), Stage 8 (4)
pipedrive_loss_analysis
分析损失的交易以确定模式——损失最大的原因,哪些销售代表损失最大,交易处于哪个阶段,以及高价值的损失。
参数
| 参数 | 类型 | 说明 |
|---|---|---|
period |
daily |
weekly |
offset |
number | 从今天开始的时段 |
pipeline_id |
number | 仅限于管道 |
min_value |
number | 仅包括高于此值的交易 |
示例提示
"Why are we losing deals this month?"
"Show me all-time loss reasons"
"What deals over £5,000 did we lose last quarter?"
"Which rep has the most losses and what are the reasons?"
输出示例
Loss Analysis — March 2026
Summary
Total lost: 34 Total lost value: £128,440
No reason logged: 4 (11.8%) ← data quality flag
Top Loss Reasons
Unresponsive 14 (41%) £38,200
Price vs Competitor 7 (21%) £52,100
Job Not Going Ahead 6 (18%) £18,900
Budget Changed 4 (12%) £14,240
Existing Relationship 3 (9%) £5,000
Losses by Rep
Jordan Mills 12 losses — mainly Unresponsive (9)
Casey Park 9 losses — mainly Price (5), Budget (3)
Sam Rivera 8 losses — mainly Job Not Going Ahead (6)
Alex Chen 1 loss — Duplicate Deal
High-Value Losses (top 3)
Westfield Construction — £44,000 — "Price vs Competitor" (Casey Park)
Hartley Group — £28,500 — "Unresponsive" (Jordan Mills)
NovaCivil Ltd — £18,200 — "Job Not Going Ahead" (Sam Rivera)
pipedrive_pipeline_health
评估您的开放管道的风险:过时的交易、逾期的成交日期、缺失的数据以及没有安排下一个活动的交易。
参数
| 参数 | 类型 | 说明 |
|---|---|---|
pipeline_id |
number | 仅限于管道 |
stale_days |
number | 没有活动标记为过时的天数(默认值30) |
limit |
number | 每个风险类别返回的最大交易数(默认值50) |
示例提示
"How healthy is the pipeline?"
"Show me all deals that haven't been touched in 60 days"
"Which deals are past their expected close date?"
"Flag any open deals missing a value or contact"
输出示例
Pipeline Health Report
Summary
Total open deals: 312 Pipeline value: £2,840,000
Weighted value: £1,190,000
Stale (30+ days): 187 (60%) ← attention needed
Past expected close: 41 (13%)
Missing deal value: 78 (25%) ← forecasting risk
No next activity: 142 (46%)
No contact linked: 22 (7%)
Zero activities ever: 54 (17%)
Risk: Most Stale Deals
Northgate Retail — last activity: 94 days ago — £28,000 — Owner: Jordan Mills
Apex Logistics — last activity: 87 days ago — £14,500 — Owner: Casey Park
Redhill Partners — last activity: 71 days ago — £9,200 — Owner: Sam Rivera
... (184 more)
Risk: Past Expected Close
Meridian Build — due 2025-11-30 — 116 days overdue — £42,000
Creston Homes — due 2025-12-15 — 101 days overdue — £18,750
Stale Deals by Owner
Jordan Mills: 68 Casey Park: 51 Sam Rivera: 44 Alex Chen: 24
Deals by Stage
Stage 3: 94 Stage 4: 87 Stage 5: 61 Stage 6: 38 Stage 7: 32
pipedrive_activity_audit
审核整个团队的活动记录质量:处理无活动、逾期任务、缺少通话记录和每个代表的卫生评分。
参数
| 参数 | 类型 | 说明 |
|---|---|---|
pipeline_id |
number | 仅限于管道 |
days_back |
number | 回顾窗口(默认为90天) |
示例提示
"Show me the activity audit for the last 30 days"
"Which reps have overdue activities?"
"Who has the worst logging hygiene?"
"How many open deals have zero activities logged?"
输出示例
Activity Audit — last 90 days
Open deals with no activity ever: 54
Open deals with no completed activity: 78
Overdue activities (not done, past due): 31
Overdue by Owner
Casey Park: 14 Jordan Mills: 9 Sam Rivera: 6 Alex Chen: 2
Activity Type Breakdown (logged in period)
Call: 312 Email: 198 Meeting: 87 Task: 44 Other: 23
Rep Hygiene Scores (higher = cleaner)
Alex Chen 92/100 — 28 open deals, 1 no-activity, 2 overdue
Sam Rivera 71/100 — 44 open deals, 8 no-activity, 6 overdue
Jordan Mills 58/100 — 62 open deals, 18 no-activity, 9 overdue
Casey Park 41/100 — 58 open deals, 27 no-activity, 14 overdue ← needs attention
pipedrive_opportunities_report
出现高潜力的未结交易:接近预期交割日期的大额交易、最近开立的大额交易以及长期未动的交易。
参数
| 参数 | 类型 | 说明 |
|---|---|---|
pipeline_id |
number | 仅限于管道 |
min_value |
number | 要包含的最小交易价值 |
days_to_close |
number | 标记N天内关闭的交易(默认30) |
limit |
number | 每个类别的最大交易量(默认值为20) |
示例提示
"What are our biggest opportunities right now?"
"Show me deals over £10,000 closing in the next 2 weeks"
"Which large deals have been sitting open the longest?"
输出示例
Opportunities Report
Closing Soon (next 30 days, value > £0)
Apex Logistics — £84,000 — due 2026-04-08 — Stage 5 — Jordan Mills
Fenwick Development — £41,500 — due 2026-04-14 — Stage 6 — Alex Chen
Highfields Group — £28,000 — due 2026-04-22 — Stage 4 — Sam Rivera
High-Value Recently Opened (last 30 days)
Carrington Estates — £120,000 — opened 2026-03-18 — Stage 2 — Alex Chen
Bluestone FM — £67,500 — opened 2026-03-24 — Stage 3 — Jordan Mills
Long-Running Large Deals (open > 90 days)
NovaCivil Ltd — £95,000 — open 247 days — last activity: 38 days ago — Casey Park
Harland Group — £52,000 — open 184 days — last activity: 71 days ago — Jordan Mills
pipedrive_comparative_report
并排比较两个时间段:按月、按季度或任何自定义日期范围。
参数
| 参数 | 类型 | 说明 |
|---|---|---|
period |
daily |
weekly |
pipeline_id |
number | 仅限于管道 |
示例提示
"Compare this month to last month"
"How does Q1 2026 compare to Q4 2025?"
"Is the team improving or declining?"
输出示例
Comparative Report — Monthly
February 2026 March 2026 Change
Deals won 44 75 +70.5% ▲
Deals lost 43 26 -39.5% ▲
Win rate 50.6% 74.3% +23.7pp ▲
Revenue won £436,509 £277,513 -36.4% ▼
Revenue lost £378,595 £53,762 -85.8% ▲
New deals opened 143 139 -2.8%
Avg won deal size £9,921 £3,700 -62.7% ▼
Interpretation
Win rate improved sharply but revenue fell — the team is closing more deals
at a lower average value. Consider whether deal qualification criteria have
changed or if high-value opportunities are being deprioritised.
先决条件
- Node.js 18岁或以后
- A. Pipedrive API令牌 --找到你的 设置→ 个人偏好→ API
安装
git clone https://github.com/GarethWright/PipeDrive-MCP-Server.git
cd PipeDrive-MCP-Server
npm install
npm run build
配置
克劳德代码(克劳德桌面/CLI)
使用单个命令添加服务器:
claude mcp add pipedrive \
-e PIPEDRIVE_API_TOKEN=your_api_token_here \
-- node /absolute/path/to/PipeDrive-MCP-Server/dist/index.js
或手动添加到 ~/.claude/settings.json → mcpServers:
{
"mcpServers": {
"pipedrive": {
"command": "node",
"args": ["/absolute/path/to/PipeDrive-MCP-Server/dist/index.js"],
"env": {
"PIPEDRIVE_API_TOKEN": "your_api_token_here"
}
}
}
}
nvm/homebrew用户注意事项: 如果
node不在默认PATH中,请使用二进制文件的完整路径(例如。/opt/homebrew/opt/node@20/bin/node).
ChatGPT(通过OpenAI自定义GPT/函数调用)
ChatGPT本身不支持MCP stdio服务器,但您可以使用MCP-to-HTTP网桥通过HTTP公开此服务器,例如 mcp-proxy:
# Install the proxy
npm install -g mcp-proxy
# Start the HTTP bridge
PIPEDRIVE_API_TOKEN=your_api_token_here \
mcp-proxy --port 3100 node /absolute/path/to/PipeDrive-MCP-Server/dist/index.js
然后添加 http://localhost:3100 作为 自定义操作 GPT配置中的服务器。从正在运行的服务器导出工具模式,以生成OpenAPI规范ChatGPT所需。
对于 OpenAI助手API 使用函数调用,从上面的工具列表中生成函数定义,并将其作为 tools 在您的助理创建呼叫中。
OpenAI Codex(Codex CLI)
Codex CLI 通过MCP的配置文件支持MCP ~/.codex/config.yaml:
mcpServers:
pipedrive:
command: node
args:
- /absolute/path/to/PipeDrive-MCP-Server/dist/index.js
env:
PIPEDRIVE_API_TOKEN: your_api_token_here
保存后重新启动Codex。工具将自动出现在会话中。
nvm/homebrew用户注意事项: 指定到的完整路径
node例如。/opt/homebrew/opt/node@20/bin/node.
Codex GUI(添加MCP服务器表单)
如果您使用的是Codex桌面界面或任何带有图形界面的MCP客户端 添加服务器 表单中,请按如下方式填写字段:
| 字段 | 值 |
|---|---|
| 名字 | Pipedrive |
| 类型 | STDIO |
| 启动命令 | node (或完整路径: /opt/homebrew/opt/node@20/bin/node) |
| 参数 | /absolute/path/to/PipeDrive-MCP-Server/dist/index.js |
| 环境变量 | 密钥: PIPEDRIVE_API_TOKEN /价值:您的API代币 |
| 工作目录 | /absolute/path/to/PipeDrive-MCP-Server |
添加一个参数条目和一个环境变量条目,然后单击 保存.
环境变量
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
PIPEDRIVE_API_TOKEN |
是 | - | 您的Pipedrive API令牌 |
PIPEDRIVE_BASE_URL |
没有 | https://api.pipedrive.com/v1 |
覆盖自托管/EU数据驻留 |
发展
# Watch mode — recompiles on save
npx tsc --watch
# Run directly without building
npx ts-node src/index.ts
许可证
知识共享署名-非商业共享4.0国际版(CC BY-NC-SA 4.0)
版权所有(c)2026加雷斯·赖特
- 免费使用、复制、修改和分发 --但衍生品必须在相同的许可证下保持开源。
- 仅限非商业用途 --您不得将本软件或任何衍生产品用于商业目的。
- 需署名 --在任何发行中都要归功于原作者。