安裝
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，官方說那是另一個無關套件。