Pipe-MCP

Pipedrive MCP サーバー

Pipedrive CRM API と連携するための Model Control Protocol（MCP）サーバー実装です。このサーバーを使うと、Claude は MCP ツール呼び出しを通じて Pipedrive のレコードを作成、読み取り、更新、削除できます。

機能

この MCP サーバーは、以下の Pipedrive 機能を実装しています。

• 人物 - 人物エンティティの作成、読み取り、更新、削除、検索
• 組織 - 組織とそのフォロワーの管理
• 取引 - 取引と取引商品を含む、取引の作成、管理、検索
• リード - リードラベルを含む、リードの作成、管理、検索
• アクティビティ - アクティビティとアクティビティの種類の追跡と管理
• アイテム検索 - Pipedrive エンティティ全体を対象としたグローバル検索とフィールド指定検索

その他の機能：

• 包括的なエラー処理を備えた非同期 API クライアント
• 特定のモジュールを有効化／無効化する機能フラグ
• 保守性を高める垂直スライスアーキテクチャ
• 包括的なテストカバレッジ

Claude Code ですぐに始める

Pipedrive MCP サーバーをすぐに使い始め、claude desktop app にセットアップする最速の方法です。

1. 必要なツールをインストールする

ターミナルまたはコマンドプロンプトを開き、次のコマンドを実行します。

# Install Python's uv package manager (if not already installed)
curl -sSf https://install.python-uv.org/uv | python3 -

uv のインストール方法について詳しくは、Astral の UV インストールドキュメントをご覧ください。

2. コードをダウンロードする

GitHub アカウントは必要ありません！ ターミナルで次のコマンドを実行するだけです。

コードのダウンロード先となるフォルダーを選び、次のコマンドを実行します。

# Clone the repository (download the code)
git clone https://github.com/Wirasm/pipedrive-mcp.git

# Move into the project folder
cd pipedrive-mcp

3. Python の依存関係をインストールする

ターミナルを開き、次のコマンドをそのまま実行します。

# Install all required packages
uv sync

4. Pipedrive の認証情報を設定する

1. プロジェクトフォルダー内の .env.example ファイルを探します
2. ファイルをコピーし、名前を .env に変更します
3. テキストエディターで .env ファイルを開きます
4. プレースホルダーを実際の Pipedrive 情報に置き換えます。

PIPEDRIVE_API_TOKEN=your_api_token
PIPEDRIVE_COMPANY_DOMAIN=your_company_domain

.env ファイルにあるその他の設定はすべて任意で、そのままにしておくことができます。

Pipedrive API トークンを取得するには：

1. Pipedrive アカウントにログインします
2. 右上隅にあるプロフィール写真をクリックします
3. 「Personal preferences」を選択します
4. 「API」タブを開きます
5. トークンをまだお持ちでない場合は、「Generate new token」をクリックします
6. 生成されたトークンをコピーし、.env ファイルに貼り付けます

会社のドメインについて： Pipedrive の URL が https://mycompany.pipedrive.com/pipeline の場合、ドメインは mycompany です。

5. MCP サーバーを Claude Desktop にインストールする

ターミナルを開き、次のコマンドを実行します。

# Install the MCP server
mcp install server.py

これにより、Pipedrive ツールが Claude Desktop に自動的に登録されます。

6. Claude で Pipedrive を使い始める

1. 重要： Claude Desktop アプリをすでに起動している場合は、再起動します
2. Claude Desktop を開きます
3. 新しいチャットを開始すると、Claude が Pipedrive CRM と連携できるようになります！

「最近の取引を見せて」や「次の詳細で新しい連絡先を作成して：...」と Claude に頼んで、使い始めてみましょう。

利用可能な MCP ツール

人物ツール

ツール名	説明
create_person_in_pipedrive	Pipedrive CRM に新しい人物を作成します
get_person_from_pipedrive	ID を指定して特定の人物の詳細を取得します
update_person_in_pipedrive	Pipedrive の既存の人物を更新します
delete_person_from_pipedrive	Pipedrive から人物を削除します
search_persons_in_pipedrive	名前、メールアドレス、電話番号などで人物を検索します

Organization ツール

ツール名	説明
create_organization_in_pipedrive	Pipedrive に新しい組織を作成します
get_organization_from_pipedrive	ID で組織の詳細を取得します
update_organization_in_pipedrive	既存の組織を更新します
delete_organization_from_pipedrive	組織を削除します
list_organizations_in_pipedrive	フィルタリングとページネーションを使用して組織の一覧を取得します
search_organizations_in_pipedrive	名前またはその他の条件で組織を検索します
add_follower_to_organization	ユーザーを組織のフォロワーとして追加します
delete_follower_from_organization	組織のフォロワーを削除します

Deal ツール

ツール名	説明
create_deal_in_pipedrive	新しい取引を作成します
get_deal_from_pipedrive	ID で取引の詳細を取得します
update_deal_in_pipedrive	既存の取引を更新します
delete_deal_in_pipedrive	取引を削除します
list_deals_in_pipedrive	フィルタリングとページネーションを使用して取引の一覧を取得します
search_deals_in_pipedrive	タイトルまたはその他の条件で取引を検索します
add_product_to_deal	取引に製品を追加します
update_deal_product	取引に関連付けられた製品を更新します
delete_product_from_deal	取引から製品を削除します

Lead ツール

ツール名	説明
create_lead_in_pipedrive	新しいリードを作成します
get_lead_from_pipedrive	ID でリードの詳細を取得します
update_lead_in_pipedrive	既存のリードを更新します
delete_lead_in_pipedrive	リードを削除します
list_leads_in_pipedrive	フィルタリングとページネーションを使用してリードの一覧を取得します
search_leads_in_pipedrive	タイトルまたはその他の条件でリードを検索します
get_lead_labels	利用可能なリードラベルを取得します
get_lead_sources	利用可能なリードソースを取得します

項目検索ツール

ツール名	説明
search_items_in_pipedrive	複数の項目タイプを対象に全体検索を行います
search_field_in_pipedrive	指定したエンティティタイプ内で特定のフィールド値を検索します

機能モジュール

このプロジェクトでは垂直スライスアーキテクチャを採用しており、各機能に専用のディレクトリがあります。

• persons/ - Person エンティティの管理
• organizations/ - Organization エンティティの管理
• deals/ - 製品を含む Deal の管理
• leads/ - ラベルを含む Lead の管理
• activities/ - アクティビティの追跡と管理
• item_search/ - エンティティを横断した検索機能
• shared/ - 機能間で使用する共通ユーティリティ

はじめに

前提条件

• Python 3.12+
• uv - 高速な Python パッケージマネージャー
• mcp CLI - Claude の Model Control Protocol ツール
• Docker（任意） - コンテナ化されたデプロイ用

セキュリティに関する注意事項

この MCP サーバーでは、いくつかのセキュリティ対策を実装しています。

• ローカル実行時は、デフォルトで localhost（127.0.0.1）にバインドします
• 適切なエラー処理とログ記録を行います

デプロイ時：

• ローカル開発では、デフォルトのホスト（127.0.0.1）を維持してください
• コンテナにデプロイする場合は、CONTAINER_MODE=true を設定してください

リポジトリをクローンする

git clone [email protected]:Wirasm/pipedrive-mcp.git
cd pipedrive-mcp

環境をセットアップする

1. 仮想環境を作成し、依存関係をインストールします。

uv venv
source .venv/bin/activate  # On Unix/macOS
# OR
.venv\Scripts\activate     # On Windows
uv pip install -e .

2. ルートディレクトリに .env ファイルを作成します。

# API Credentials
PIPEDRIVE_API_TOKEN=your_api_token
PIPEDRIVE_COMPANY_DOMAIN=your_company_domain  # Just the subdomain portion (e.g., "mycompany" from mycompany.pipedrive.com)

# Server Configuration
HOST=127.0.0.1  # Use 127.0.0.1 for local development, 0.0.0.0 only in containers
PORT=8152
TRANSPORT=sse   # "sse" or "stdio"

# Security Settings
CONTAINER_MODE=false
VERIFY_SSL=true  # Set to "false" if you encounter SSL certificate issues (development only)

# Feature Flags (optional)
PIPEDRIVE_FEATURE_PERSONS=true
PIPEDRIVE_FEATURE_DEALS=true
PIPEDRIVE_FEATURE_ORGANIZATIONS=true
PIPEDRIVE_FEATURE_LEADS=true
PIPEDRIVE_FEATURE_ITEM_SEARCH=true
PIPEDRIVE_FEATURE_ACTIVITIES=true

テストを実行する

uv run pytest

Claude Desktop にインストールする

mcp install server.py

ローカルで実行する

uv run server.py

Docker の使用

1. Docker イメージをビルドします：

docker build -t pipedrive-mcp .

2. 環境変数を指定してコンテナーを実行します：

# IMPORTANT: Replace values in quotes with your real Pipedrive credentials
docker run -d -p 8152:8152 \
  -e PIPEDRIVE_API_TOKEN="your-actual-pipedrive-api-token" \
  -e PIPEDRIVE_COMPANY_DOMAIN="your-company-subdomain" \
  -e PORT=8152 \
  -e TRANSPORT=sse \
  -e CONTAINER_MODE=true \
  -e VERIFY_SSL=true \
  --name pipedrive-mcp-server \
  pipedrive-mcp

たとえば、Pipedrive のドメインが mycompany.pipedrive.com の場合は、次のように指定します：

-e PIPEDRIVE_COMPANY_DOMAIN="mycompany"

3. コンテナーが実行中であることを確認し、ログを表示します：

# Check container status
docker ps | grep pipedrive-mcp-server

# View logs
docker logs pipedrive-mcp-server

4. 作業が終わったら、コンテナーを停止して削除します：

docker stop pipedrive-mcp-server
docker rm pipedrive-mcp-server

5. MCP サーバーを使用するように Claude を設定します：

このサーバーを Claude Desktop で使用するには、Claude Desktop の設定で MCP サーバーを登録します：

• サーバー名：Pipedrive MCP
• エンドポイント URL：http://localhost:8152
• 認証：なし

プロジェクト構成

このプロジェクトでは、コードを技術レイヤーではなく機能ごとに整理する、垂直スライスアーキテクチャを採用しています：

pipedrive/
├── api/
│   ├── base_client.py                   # Core HTTP client
│   ├── pipedrive_api_error.py           # API error handling
│   ├── pipedrive_client.py              # Main client facade
│   ├── pipedrive_context.py             # Client lifecycle management
│   ├── features/
│   │   ├── tool_registry.py             # Feature registry system
│   │   ├── tool_decorator.py            # Feature-aware tool decorator
│   │   ├── persons/                     # Person feature module
│   │   │   ├── client/                  # Person API client
│   │   │   ├── models/                  # Person domain models
│   │   │   └── tools/                   # Person MCP tools
│   │   ├── organizations/               # Organization feature module
│   │   ├── deals/                       # Deal feature module
│   │   ├── leads/                       # Lead feature module
│   │   ├── activities/                  # Activity feature module
│   │   ├── item_search/                 # Search feature module
│   │   └── shared/                      # Shared utilities
├── feature_config.py                    # Feature configuration management
└── mcp_instance.py                      # MCP server configuration

開発

開発の詳細については、CLAUDE.md を参照してください。

ライセンス

MIT