CRM数据分析工具

Pipedrive MCP Server是一个为Pipedrive CRM API提供的全面模型上下文协议服务器,支持100种工具,包括94种标准API工具和6种内置分析工具,用于性能报告、损失分析和管道健康检查。

  • by GarethWright
  • JavaScript
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 GarethWright/PipeDrive-MCP-Server

使用说明

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加雷斯·赖特

  • 免费使用、复制、修改和分发 --但衍生品必须在相同的许可证下保持开源。
  • 仅限非商业用途 --您不得将本软件或任何衍生产品用于商业目的。
  • 需署名 --在任何发行中都要归功于原作者。