安装
npx -y @ckalima/pipedrive-mcp-server init适合谁
如果你要在 Claude Code 或 Claude Desktop 里直接查询、创建或更新 Pipedrive CRM 数据，这个服务对得上。它是面向本地或自托管场景的 MCP 服务器，认证方式是 Pipedrive API 密钥。
适合已经有 Pipedrive 账号和 API 密钥、并且客户端能跑 STDIO MCP 的人。官方写明目前传输只有 STDIO，没有托管 OAuth。如果你需要远程 HTTP 接入或 OAuth 登录，本页没有可用路径。
包名必须用带作用域的 @ckalima/pipedrive-mcp-server。官方明确：如果旧片段引用了未加作用域的 pipedrive-mcp-server，那是另一个无关包，不要装错。
3 分钟完成第一次尝试
官方推荐路径是引导式安装。前置条件：准备好 Pipedrive API 密钥，客户端选 Claude Code 或 Claude Desktop，传输只能走 STDIO。
在终端执行：
npx -y @ckalima/pipedrive-mcp-server init
按引导把服务器写入客户端配置。需要手动改配置时，命令为 npx，参数为 -y 和 @ckalima/pipedrive-mcp-server，并在环境变量里设置 PIPEDRIVE_API_KEY。不要写入任何示例密钥字符串，也不要使用未加作用域的包名。
第一次把 PIPEDRIVE_MODE 设为 read-only。官方把这一档定义为只读；默认档 safe-write 已包含非破坏性写入，不适合第一次。
然后做一次低风险调用：查询 CRM 数据。官方写明可以从助手里 Query、create、and update CRM data，第一次只做 Query。官方没有给出具体工具名或对象类型；只使用客户端列出的、属于该服务器的查询类工具，不要自行发明未出现的工具名，也不要创建或更新记录。
成功信号：返回 Pipedrive 里已有记录的查询结果，且没有写入。如果当前档位下看不到写入类工具，符合官方所说——档位之外的工具会被隐藏，直接调用也会被拒绝。
使用案例
案例一：只读查询 CRM。把 PIPEDRIVE_MODE 设为 read-only，然后查询已有数据。官方只写到 Query CRM data，没有写可查哪些对象、过滤条件或分页。成功时你应看到现有记录；不要把一次查询当成完整数据导出。
案例二：在默认 safe-write 档创建或更新记录。官方写明默认档是读取加上非破坏性写入，对应 create 和 update。这会改 CRM，调用前先确认你要改的是哪条业务数据。官方没有给出字段清单或示例载荷；只使用客户端展示的创建或更新能力，并在执行前先复述将要写入的内容。删除、转换和其他不可逆写入不在这一档，官方要求 full 档才会放开。
使用边界
PIPEDRIVE_MODE 有 read-only、safe-write（默认）和 full。档位之外的工具既不会出现在工具列表，直接调用也会被拒绝。Deletes、conversions 和其他 irreversible writes 需要 full；第一次不要开这一档。
传输目前仅 STDIO；Streamable HTTP 只是计划中的标志，本页不能当已提供。认证是 Pipedrive API 密钥，没有托管 OAuth。密钥在本地环境变量里，查询和写入都会出网访问 Pipedrive。
官方没有写速率限制，也没有写撤销。写入一旦成功，要靠你在 Pipedrive 里自行改回。包名用错成未加作用域的 pipedrive-mcp-server，官方说那是另一个无关包。