Pipedrive MCP

Pipedrive + AI - ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini、および MCP に対応するあらゆるエージェント向け

非公式です。Pipedrive API 向けにコミュニティが構築した Claude Code Skill と MCP サーバーです。Pipedrive OÜ との提携、承認、または後援を受けていません。

_{▶ 30 秒のデモを見る - デモデータはシミュレーションです。表示されているコマンドはすべて実際の CLI に存在します。}

Pipedrive の CRUD 全般に加え、ローカルの SQLite パイプラインコピーも利用できます。停滞中の取引、予測、経過日数、重複、担当者ランキングに対応します。すでにお使いの AI で動作します - ChatGPT（Plus/Pro+、このコネクターが再リリースされるまで一時停止中。mcp-install.md を参照）、Claude Desktop、Codex、Claude Code、Claude Cowork、GitHub Copilot - さらにリモート経由で Microsoft 365 Copilot / Copilot Studio と Google Gemini にも対応します。無料のオープンソースで、ノート PC 上で動作します。MSP オーナー向けに構築されています。コードは不要です。

お使いのエージェントで利用できます

セキュリティに関する注意（このコネクターが再リリースされるまで）。 HTTP モード （--transport http）は、localhost 上でも実行しないでください。このビルドにはパスワードがなく、 すべてのネットワークインターフェースでリッスンし、ブラウザーのリバインディング対策が導入される前のものなので、 開いた Web ページから接続される可能性があります。MCP ツールは、 お客様の認証情報を使って変更を加えることもできます。デフォルトの stdio トランスポートを使用してください。 リモートエージェント用にトンネルを設定している場合は、停止してください。修正を準備中です。

MSP オーナーが実際に使っている 6 つのエージェント（セルフサービスで、今すぐ利用可能）：

お使いの AI エージェント	Pipedrive スキルのインストール方法
Claude Desktop	インストーラーを実行してから、Settings > Extensions で pipedrive-mcp を登録します（JSON の編集は不要です）。
ChatGPT（有料プラン）	このコネクターが再リリースされるまで一時停止中です。ChatGPT には HTTP モードが必要ですが、このビルドではパスワードが不要で、すべてのネットワークインターフェースでリッスンし、開いた Web ページから接続できるためです。mcp-install.md のセキュリティに関する注意を参照してください。
Codex CLI	以下のインストール用プロンプトを貼り付けます。
Claude Code	以下のインストール用プロンプトを貼り付けます。
Claude Cowork	以下のインストール用プロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、mcp.json の servers キーの下に pipedrive-mcp を追加してから、Agent モードを選択します。

ChatGPT にはリモート HTTPS サーバーが必要です。つまり、このコネクターの HTTP モードが必要ですが、コネクターが再リリースされるまで一時停止中です。このビルドではパスワードが不要で、すべてのネットワークインターフェースでリッスンし、開いた Web ページから接続できるためです。mcp-install.md のセキュリティに関する注意を参照してください。

Microsoft と Google のスタックについても

多くのユーザーが利用していますが、正直にお伝えすると、これらは先ほどインストールしたローカルバイナリではなく、リモート／エンタープライズ向けの方法です。

エージェント	必要なもの
Microsoft 365 Copilot / Copilot Studio	このコネクターが再公開されるまで一時停止中です。Copilot Studio には HTTP モードが必要ですが、このビルドではそのモードがパスワードなしで、すべてのネットワークインターフェースで待ち受け、開いたウェブページからアクセスできる状態になります。mcp-install.md のセキュリティに関する注意をご覧ください。
Google Gemini	Gemini CLI はローカルで、Claude Code と同様です。Gemini アプリはリモートで、ChatGPT と同じ一時停止中の HTTP モードが必要です。mcp-install.md をご覧ください。

スキルネイティブなエージェント（こちらも対応）： Hermes と OpenClaw は、このスキルの SKILL.md を直接読み込み、さらに MCP にも対応しています。以下のインストール手順をご覧ください。Cursor、Windsurf、Cline、Continue.dev、Zed でも MCP 経由で動作します。各ツールの詳しい接続方法は docs/which-agent.md をご覧ください。

複数のエージェントを使いますか？ 1 つのコマンドで、対応している 51 以上のエージェントすべてにインストールできます：npx skills add Servosity/msp-skills@latest（Node.js が必要です。その後、CLI／MCP バイナリ用のスキル別インストーラーを実行します）。docs/which-agent.md をご覧ください。

60 秒でインストール

Claude Desktop で最速の方法 - ワンクリック .mcpb

Claude Desktop バンドル： .mcpb は macOS（Intel および Apple Silicon）、Windows x64、Linux x64 で起動します。すべてのツールは付属の pipedrive-cli を呼び出します。2026-09-18 以降に公開されたリリースでは、この CLI がバンドルに同梱されています。それ以前のバンドルには MCP サーバーのみが含まれているため、付属の CLI がない場合は、先に以下の Path A または Path B のインストーラーを実行するか、既存のバイナリを PIPEDRIVE_CLI_PATH に設定してください。詳細は #331 をご覧ください。

Pipedrive MCP をダウンロード（.mcpb） - 次に Claude Desktop > Settings > Extensions を開き、ファイルを選択してください。ワンクリックで完了し、JSON もシェルも不要です。（Pipedrive のすべてのリリースはリリースページで確認できます。）

Claude Code プラグインを使いますか？マーケットプレイスを一度追加してからインストールしてください。ディレクトリ一覧の取得は不要で、すぐに使えます。

/plugin marketplace add Servosity/msp-skills
/plugin install pipedrive@msp-skills

Path A - AI エージェントにプロンプトを 1 つ貼り付ける（推奨）

これを Claude Code、Codex CLI、または Claude Cowork にコピーしてください。

このエージェントのワークスペースに、Servosity/msp-skills から Pipedrive Skill と MCP サーバーをインストールしてください。このワークスペースで POSIX シェル（macOS、Linux、WSL、または Bash）を使う場合は、bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/pipedrive/install.sh) を実行してください。Windows PowerShell を使う場合は、iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/pipedrive/install.ps1 | iex を実行してください。その後、README に従って認証し、pipedrive-cli --help を実行して機能を確認してください。

シェルを実行できるエージェントであれば、同じプロンプトを使えます。

Path B - インストーラーを自分で実行する

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/pipedrive/install.ps1 | iex

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/pipedrive/install.sh)

インストーラーは pipedrive-cli（CLI）と pipedrive-mcp（MCP サーバー）の両方を、ユーザーの bin パスに配置します。Claude Code、Codex、Cowork は、このディレクトリ内の SKILL.md を通じてスキルを検出します。

確認：

pipedrive-cli --version

最新バージョンにアップグレードする

インストーラーは常に最新のリリースを取得します。アップグレードするには、もう一度実行してください。

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/pipedrive/install.sh)

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/pipedrive/install.ps1 | iex

Claude Desktop の .mcpb ユーザー：最新の .mcpb（このセクションの冒頭）をダウンロードし、Settings > Extensions で再度選択してください。Claude Code プラグインのユーザー：/plugin update pipedrive@msp-skills。

Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot、または別の MCP クライアントに追加する

インストーラーの実行後、エージェントごとの接続方法については mcp-install.md と docs/which-agent.md を参照してください。各エージェントのセクションがあり、GitHub Copilot の servers キーや、リモートの Microsoft 365 Copilot／Copilot Studio の接続方法も記載されています。Claude Desktop の「設定」>「拡張機能」パネルが最も簡単な方法です。JSON を編集したいユーザー向けの MCP 設定ブロックは、mcp-install.md に記載されています。

Hermes にインストールする

Hermes CLI から：

hermes skills install servosity/msp-skills/skills/pipedrive --force

Hermes のチャットセッション内：

/skills install servosity/msp-skills/skills/pipedrive --force

Hermes は MCP をネイティブにサポートしているため、pipedrive-mcp サーバーも直接使用できます。インストール方法と環境変数は同じです。

OpenClaw にインストールする

OpenClaw エージェントに次の内容を伝えてください（コピーして使用できます）：

https://github.com/servosity/msp-skills/tree/main/skills/pipedrive から pipedrive スキルをインストールしてください。このスキルには、必須の CLI（pipedrive-cli）を openclaw: フロントマターブロック経由でインストールする方法が定義されています。

OpenClaw はまだ一般公開されていません。フロントマターによる接続設定はあらかじめ含まれており、OpenClaw のリリースと同時に有効になります。

認証する

Pipedrive ポータルから、CLI に必要な認証情報を設定します：

PIPEDRIVE_API_KEY=<value> pipedrive-cli doctor

doctor を実行すると、データにアクセスするコマンドを実行する前に認証情報が有効かどうかを確認できます。認証情報が拒否された場合でも終了コードは 0 になるため、スクリプトでは --fail-on error を追加してください。

このスキルでできること

MSP からよく聞かれる質問	コマンド
2週間誰も対応していない商談のうち、金額が大きいものから順に教えてください。	pipedrive-cli stale --quiet-days 14 --agent
今四半期の加重予測と、成約が見込まれる商談を教えてください。	pipedrive-cli forecast --period this-quarter --agent
各ステージの通常の所要期間を超えて滞留している商談を教えてください。	pipedrive-cli aging --agent
次のアクティビティが予定されていない進行中の商談を教えてください。	pipedrive-cli next-activity --missing --agent
過去90日間の受注額で営業担当者を順位付けしてください。	pipedrive-cli leaderboard --by won-value --window 90d --agent
昨日からの変更点と、今日電話すべき相手を教えてください。	pipedrive-cli digest --for-me --agent
過去6か月間に失注した商談と、その理由を教えてください。	pipedrive-cli lost --since 180d --agent
電話をかける前に、連絡先の全体像を教えてください。	pipedrive-cli who "Jane Smith" --agent
オフライン分析用に、パイプライン全体をローカルにコピーしてください。	pipedrive-cli sync --agent

コマンドの詳細については、guide.md を参照してください。AI エージェントの操作上の契約（--agent、--dry-run、変更を加える前に確認すべきタイミング）については、AGENTS.md を参照してください。

このスキルの特長

多くの Pipedrive 連携や MCP サーバーは、質問のたびにライブ API を呼び出します。1件のレコードなら問題ありません。しかし、「すべてのパイプラインにある進行中の商談のうち、動きのないものをリスク金額の大きい順に教えてください」のような質問では、単一の API エンドポイントでは答えられず、大規模な利用には対応できません。

このスキルは、Pipedrive のデータを全文検索機能付きのローカル SQLite ミラーに同期します。集計を必要とする質問は、ローカルでの SQL 結合1回で処理できるため、瞬時に結果が得られ、オフラインでも利用でき、AI には生データではなく回答が渡されます。stale、forecast、leaderboard、who などの複合コマンドは、商談、人物、組織、アクティビティ、ステージをまたいで結合します。これは、ステートレスな API ラッパーでは実現できない処理です。

この課題を解決します

レポート機能は、G2、Capterra、Trustpilot で最も多く寄せられている Pipedrive への不満です（まとめ）。Insights は基本的な機能を備えていますが、月曜日のパイプラインレビューでオーナーが尋ねる、複数のエンティティにまたがる質問――気づかないうちに失注しつつある案件はどれか、加重予測はいくらか、実際に貢献している担当者は誰か、停滞している案件はどれか――に答えるには、データをスプレッドシートにエクスポートして計算し直す必要があります。一方、CRM データは年間およそ 30％劣化するため、活動が一度も記録されていない案件は、すでに見込みがなくなるまで放置されてしまいます。

このスキルを使えば、それぞれの質問に 1 つのコマンドで答えられます。

• stale - N 日間誰も対応していないオープン案件を、リスクにさらされている金額の大きい順に表示します。
• forecast - パイプライン別の加重案件額と、成約が見込まれる案件を表示します。
• aging - 各ステージの標準的な滞留時間を超えて停滞している案件を表示します。
• leaderboard - 期間を指定して、担当者ごとのオープン／成約／失注件数、加重パイプライン、成約金額を表示します。
• who - 連絡先の概要カードを表示します。組織、オープン案件、直近／次回のアクティビティ、最近のメモを確認できます。

詳しい説明は pain-point.md をご覧ください。

よくある質問

ChatGPT で使えますか？

このビルドでは使えません。ChatGPT（Plus、Pro、Team、Business、Enterprise、Education プラン。Free ではまだ Developer Mode を利用できません）が接続できるのは HTTPS 経由のリモート MCP サーバーのみです。そのため、Pipedrive MCP サーバーを HTTP モードで実行する必要があります。このビルドの HTTP モードはパスワードを要求せず、すべてのネットワークインターフェースで待ち受け、開いたウェブページからアクセスできるため、コネクターが再発行されるまでは実行したり、トンネルの背後に置いたりしないでください。その理由については、mcp-install.md のセキュリティに関する注意事項をご覧ください。それまでは、Claude Desktop、Claude Code、または Codex をお使いください。

Codex、Cursor、Windsurf、Cline、Copilot、Gemini でも使えますか？

はい。いずれも MCP に対応しています。複数のツールに対応したインストールコマンドは、上の一覧表と docs/which-agent.md の詳しい説明をご覧ください。

コーディングの知識は必要ですか？

いいえ。推奨するインストール方法は、Claude Code または Codex に 1 文貼り付けるだけです。エージェントが SKILL.md を読み込んでインストールします。代替方法として、OS ごとの 1 行インストーラー（bash または PowerShell）もあります。どちらの方法でもコードを書く必要はありません。Pipedrive の認証情報を一度入力するだけです。

Pipedrive のデータは安全ですか？

データはお使いのマシンから外に出ません。CLI と MCP サーバーはローカルバイナリです。SQLite ミラーはユーザーアカウント配下のディレクトリに保存されます。AI エージェントが参照するのは CLI が返す情報のみで、通常はクエリ結果であり、生の一括データではありません。認証情報は環境変数またはエージェントの設定から読み込まれます。MSP Skills のリポジトリに含められたり、どこかに送信されたりすることはありません。

上位の Pipedrive プランや有料の Insights ティアが必要ですか？

いいえ。API トークンが発行される Pipedrive プランであれば、どれでも使えます。トークンは Settings > Personal preferences > API で確認できます。このスキルは標準の Pipedrive API を使用し、複数のエンティティにまたがる分析（stale、forecast、aging、leaderboard）は同期済みデータを使ってローカルで実行されるため、レポート機能のアドオンは必要ありません。

Pipedrive API のレート制限に達しませんか？

日常的な質問には sync の実行後、ローカルミラーのデータを使って回答するため、API 呼び出しはゼロです。sync 自体もページネーションを適切に行います。--rate-limit と --concurrency を調整し、変更されたデータだけを更新するには --since 24h を使ってください。ローカルデータが不足しているか古くなっている場合にのみ、ライブ API 呼び出しが行われます。

Pipedrive ポータルの代わりになりますか？

いいえ。ポータルと併用するものです。ポータルは引き続き正式な記録システムであり、担当者が毎日使う UI です。このスキルは、Insights では答えられない複数エンティティにまたがる質問に、ターミナルや AI エージェントから答えられるようにします。

費用はいくらですか？

無料です。Apache-2.0 ライセンスで提供されています。費用がかかるのは利用する AI エージェント（Claude、ChatGPT、Codex など）のみで、その料金は当社ではなく AI プロバイダーから請求されます。

安全モデル

ティア	例	推奨されるエージェントポリシー
読み取り	すべての get/list コマンド、分析の集計（stale、forecast、aging、digest、leaderboard、next-activity、lost、who、changes、dupes）、search、export、および sync（ローカルミラーのみ）	許可
書き込み（通常）	deals add、deals update、persons add、organizations update、notes add、activities add、leads add、一括 import ― 合計73個の通常の書き込みコマンド	--dry-run でプレビューしてから、レビュー済みの書き込みを実行
破壊的操作／設定	deals delete、persons delete、organizations delete、その他40個の削除コマンド、および認証情報コマンド（auth set-token、oauth get-tokens、oauth refresh-tokens）	必ず人間が介在

最も強力な制御手段は、Pipedrive の認証情報に付与するスコープです。CLI は、認証情報に許可された操作しか実行できません。制限方法を含む詳細は、governance.md をご覧ください。

ステータス

ベータ版です。Pipedrive API の仕様に対する検証を完了しており、毎週の Build Sessions で、実運用環境のテナントに対して稼働させている MSP とともに検証を進めています。参加登録は compoundingteams.com/build-sessions からどうぞ。

---

標準規格。 オープンな Agent Skills spec（Anthropic、2025年12月、40以上のエージェント）に準拠しています。MCP と互換性があり、Hermes を含む、MCP 対応のあらゆるエージェントで動作します。OpenClaw 対応済み（frontmatter は設定済みで、OpenClaw のリリース待ちです）。

Servosity がメンテナンスしています。Apache-2.0 ライセンスです。CLI Printing Press で構築しました。最終更新日：2026-06-06。