インストール
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 にある既存レコードの照会結果が返り、書き込みが無いこと。今の帯で書き込み系ツールが見えないなら、公式どおりだ。帯の外のツールは隠され、直接呼び出しも拒否される。
利用ケース
ケース 1: 読み取り専用で CRM を照会する。PIPEDRIVE_MODE を read-only にし、既存データを照会する。公式は Query CRM data までしか書いておらず、対象オブジェクト、フィルタ、ページ分割は書いていない。成功時は既存レコードが見えるはずだ。一度の照会を完全なデータ書き出しと見ない。
ケース 2: 既定の 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 にすると、公式は別の無関係なパッケージだと書く。