Pipedrive

快速开始

该技能是一个轻量级透传层，用于连接本地 stdio MCP 服务器。mcporter 每次调用时都会启动该技能的 Python 服务器，在需要时刷新 OAuth 访问令牌，并将新令牌注入服务器环境变量中。

mcporter --config {baseDir}/mcporter.json list maverick-pipedrive --schema

如需结构化输出：

mcporter --config {baseDir}/mcporter.json call --output json maverick-pipedrive. key=value

安全性

执行写入操作（例如创建记录、更新属性、更改交易阶段、标记活动为已完成、创建备注或删除数据）会修改 Pipedrive CRM 中与已连接账户可见的状态。在调用写入类工具前，请务必确认用户具有明确的操作意图——而搜索与读取类工具可在探索过程中自由调用。在假设 ID 前，请先搜索交易、联系人、组织和活动；在更新前，请先读取当前交易阶段、负责人、金额及活动历史记录。

认证

凭证由 scripts/setup.sh（一个轻量级委托脚本，调用 scripts/init-mcporter-oauth.sh）在初始化阶段配置，并存储于 mcporter 的本地密钥库中。初始化钩子要求提供以下凭证环境变量：

• MAVERICK_PIPEDRIVE_MCP_REFRESH_TOKEN
• MAVERICK_PIPEDRIVE_MCP_CLIENT_ID
• MAVERICK_PIPEDRIVE_MCP_CLIENT_SECRET
• MAVERICK_PIPEDRIVE_MCP_ACCESS_TOKEN
• MAVERICK_PIPEDRIVE_MCP_API_BASE

若需支持自动刷新的凭证预置，初始化流程还会在供应方提供了可选过期元数据时读取以下环境变量：

• MAVERICK_PIPEDRIVE_MCP_EXPIRES_AT
• MAVERICK_PIPEDRIVE_MCP_EXPIRES_IN
• MAVERICK_PIPEDRIVE_MCP_REFRESH_TOKEN_EXPIRES_AT

mcporter 会在启动 stdio 服务器前，通过 Pipedrive 的 token endpoint 刷新已过期的访问令牌，并将新令牌注入 MAVERICK_PIPEDRIVE_MCP_ACCESS_TOKEN。若重试后调用仍持续返回认证错误，则 OAuth 授权很可能已被撤销或已过期；此时请重新连接集成。

数据流向

工具调用在本地执行：mcporter 将以子进程方式启动该技能的 Python MCP 服务器，该服务器使用刷新后的 OAuth Bearer Token 转发 Pipedrive API 请求。Pipedrive 将看到每次调用所引用的交易、联系人、组织、活动、销售管道（pipeline）及销售工作流（sales-workflow）等数据。请仅将本技能用于与 Pipedrive 相关的工作；切勿通过这些工具传递无关的敏感内容。

依赖项

• mcporter（github.com/steipete/mcporter）—— 用于调用本地 MCP 服务器的 MCP CLI 工具。若未安装在 PATH 中，将通过 npm install -g --ignore-scripts mcporter 自动安装（参见 frontmatter 中的 install 规范）。该安装规范使用未锁定版本的 mcporter（即 npm 的 latest）；对供应链有严格管控要求的运维人员应覆盖此安装逻辑，显式指定并锁定特定版本。
• uv（docs.astral.sh/uv）—— 根据内联依赖元数据运行 Python 封装器及本地 MCP 服务器。