📦 Pipedrive mcp

Pipedrive Quick 启动

Always invoke through bash {baseDir}/scripts/invoke.sh — never call mcporter directly. The wr应用er 种子s the OAuth vault from the env-supplied 令牌s when needed, then calls mcporter.

bash {baseDir}/scripts/invoke.sh 列出 maverick-pipedrive --模式

For structured 输出 (also surfaces transport errors as JSON envelopes — workaround for mcporter #153):

bash {baseDir}/scripts/invoke.sh call --输出 json maverick-pipedrive.工具_NAME key=value | jq '.结果.content'

Safety

Write operations that 创建 records, 更新 properties, change deal stages, mark activities done, 创建 notes, or 删除 data modify Pipedrive CRM 状态 visible to the connected account. Confirm clear user intent before invoking write 工具s — 搜索 and read 工具s are safe to call freely while exploring. 搜索 deals, people, organizations, and activities before assuming IDs, and read current deal stage, owner, value, and activity 历史 before updating.

Authentication

令牌s are provisioned and rotated automatically. If a call returns HTTP 401 that doesn't 恢复 within a few seconds, the OAuth grant has been revoked — re-授权 the integration to refresh 凭证s.

Data flow

工具 calls travel to Pipedrive's hosted MCP 服务 at https://mcp.pipedrive.com/mcp over HTTPS, 认证d via OAuth. Pipedrive sees the deal, person, organization, activity, 流水线, and sales-工作流 data referenced by each call. Use this 技能 for Pipedrive-related work only; do not pass unrelated sensitive content through these 工具s.

Dependencies mcporter (github.com/steipete/mcporter) — MCP 命令行工具 used to invoke Pipedrive's hosted MCP server. Auto-安装ed via npm 安装 -g --ignore-scripts mcporter if missing on PATH (see 安装 spec in frontmatter). The 安装 spec uses unpinned mcporter (npm latest); operators with strict supply-chAIn controls should override the 安装 to pin a specific version (e.g. mcporter@). jq (stedolan.github.io/jq) — JSON 处理器 used by the vault 初始化r. 系统 dependency; 安装 via your OS package 管理器 (apt 安装 jq, brew 安装 jq, etc.). flock (part of util-linux) — file locking used to 序列化 concurrent vault writes. AvAIlable by default on Linux; on macOS 安装 via brew 安装 flock. shasum (Perl, ships with Digest::SHA) — computes the SHA-256 哈希es used to derive the mcporter vault key and the provisioned-令牌 marker. Pre安装ed on macOS and on Debian/Ubuntu (incl. the 部署ed cloudflare/sandbox Ubuntu 22.04 image); on minimal Linux images 安装 perl-Digest-SHA. The script invokes shasum -a 256 rather than GNU sha256sum so it 运行s on stock macOS without coreutils.