pipedrive-automation について
Composio の Pipedrive ツールキットと Rube MCP を通じて CRM ワークフローを自動化するスキルです。営業プロセスを管理するチーム向けに、取引、連絡先、組織、アクティビティ、メモ、パイプラインの照会を扱います。
主な機能
- 01取引、人物、組織の作成と更新
- 02アクティビティの予定設定と追跡
- 03CRM レコードのメモの追加と管理
- 04パイプライン、ステージ、取引の照会
活用シーン
- 01人物または組織に関連付けた取引の作成
- 02通話、会議、タスクの予定設定
- 03取引や連絡先へのメモの添付
- 04パイプラインやステージ別の取引確認
MCP 対応
Rube MCP を介して Composio の Pipedrive ツールキットを利用します。有効な Pipedrive 接続が必要で、使用前に最新のツールスキーマを取得することが推奨されています。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/pipedrive-automationを入力して読み込まれたか確認します。
詳細
Rube MCP による Pipedrive の自動化
Composio の Pipedrive ツールキットを通じて、案件管理、連絡先と組織の操作、アクティビティのスケジュール設定、メモ、パイプライン／ステージの照会など、Pipedrive CRM のワークフローを自動化します。
ツールキットのドキュメント：composio.dev/toolkits/pipedrive
前提条件
- Rube MCP が接続されていること（RUBE_SEARCH_TOOLS が利用可能）
RUBE_MANAGE_CONNECTIONSを使って、ツールキットpipedriveへの有効な Pipedrive 接続があること- 現在のツールスキーマを取得するため、必ず最初に
RUBE_SEARCH_TOOLSを呼び出してください
セットアップ
Rube MCP の入手：クライアントの設定で https://rube.app/mcp を MCP サーバーとして追加します。API キーは不要です。エンドポイントを追加するだけで利用できます。
RUBE_SEARCH_TOOLSが応答することを確認し、Rube MCP が利用可能であることを確かめます- ツールキット
pipedriveを指定してRUBE_MANAGE_CONNECTIONSを呼び出します - 接続が ACTIVE でない場合は、返された認証リンクに従って Pipedrive OAuth を完了します
- ワークフローを実行する前に、接続ステータスが ACTIVE と表示されることを確認します
主なワークフロー
1. 案件の作成と管理
使用する場面：新しい案件の作成、既存の案件の更新、または営業パイプライン内の案件詳細の確認をユーザーが希望する場合。
ツールの順序：
PIPEDRIVE_SEARCH_ORGANIZATIONS- 案件に関連付ける既存の組織を検索します［任意］PIPEDRIVE_ADD_AN_ORGANIZATION- 見つからない場合は組織を作成します［任意］PIPEDRIVE_SEARCH_PERSONS- 関連付ける既存の連絡先を検索します［任意］PIPEDRIVE_ADD_A_PERSON- 見つからない場合は連絡先を作成します［任意］PIPEDRIVE_GET_ALL_PIPELINES- パイプライン ID を特定します［前提条件］PIPEDRIVE_GET_ALL_STAGES- パイプライン内のステージ ID を特定します［前提条件］PIPEDRIVE_ADD_A_DEAL- タイトル、金額、org_id、person_id、stage_id を指定して案件を作成します［必須］PIPEDRIVE_UPDATE_A_DEAL- 作成後に案件のプロパティを変更します［任意］PIPEDRIVE_ADD_A_PRODUCT_TO_A_DEAL- 明細項目／製品を追加します［任意］
主なパラメーター：
title：案件のタイトル（作成時に必須）value：案件の金額currency：3 文字の ISO 通貨コード（例：「USD」）pipeline_id/stage_id：パイプライン内の配置を示す数値 IDorg_id/person_id：組織および連絡先へのリンクstatus：「open」、「won」、または「lost」expected_close_date：YYYY-MM-DD 形式
注意点：
PIPEDRIVE_ADD_A_DEALで必須なのはtitleのみです。それ以外はすべて任意です- カスタムフィールドはレスポンス内で長いハッシュキーとして表示されます。dealFields エンドポイントを使って対応関係を確認してください
PIPEDRIVE_UPDATE_A_DEALには案件の数値idが必要ですstatusを「lost」に設定する場合は、lost_reasonも指定する必要があります
2. 連絡先（人物と組織）を管理する
使用する場面：Pipedrive で連絡先や会社を作成、更新、検索、または一覧表示したい場合。
ツールの順序：
PIPEDRIVE_SEARCH_PERSONS- 名前、メールアドレス、電話番号で既存の人物を検索します［前提条件］PIPEDRIVE_ADD_A_PERSON- 見つからない場合、新しい連絡先を作成します［必須］PIPEDRIVE_UPDATE_A_PERSON- 既存の連絡先情報を変更します［任意］PIPEDRIVE_GET_DETAILS_OF_A_PERSON- 連絡先の完全なレコードを取得します［任意］PIPEDRIVE_SEARCH_ORGANIZATIONS- 既存の組織を検索します［前提条件］PIPEDRIVE_ADD_AN_ORGANIZATION- 見つからない場合、新しい組織を作成します［必須］PIPEDRIVE_UPDATE_AN_ORGANIZATION- 組織のプロパティを変更します［任意］PIPEDRIVE_GET_DETAILS_OF_AN_ORGANIZATION- 組織の完全なレコードを取得します［任意］
主なパラメーター：
name：人物と組織のどちらを作成する場合も必須ですemail：人物の場合、value、label、primaryフィールドを含むオブジェクトの配列ですphone：人物の場合、value、label、primaryフィールドを含むオブジェクトの配列ですorg_id：人物を組織に関連付けますvisible_to：1 = 所有者のみ、3 = 会社全体term：SEARCH_PERSONS / SEARCH_ORGANIZATIONS の検索語（2 文字以上）
注意点：
PIPEDRIVE_ADD_AN_ORGANIZATIONは既存の組織と自動的に統合される場合があります。response.additional_data.didMergeを確認してください- メールアドレスと電話番号のフィールドは、単なる文字列ではなくオブジェクトの配列です：
[{"value": "[email protected]", "label": "work", "primary": true}] PIPEDRIVE_SEARCH_PERSONSでは*や@などのワイルドカードはサポートされていません。すべてを一覧表示するにはPIPEDRIVE_GET_ALL_PERSONSを使用してくださいPIPEDRIVE_DELETE_A_PERSONまたはPIPEDRIVE_DELETE_AN_ORGANIZATIONによる削除は論理削除です。30 日間保持された後、完全に削除されます
3. アクティビティを予定し、追跡する
使用する場面：案件、連絡先、組織に関連付けられた電話、会議、タスク、その他のアクティビティを作成したい場合。
ツールの順序：
PIPEDRIVE_SEARCH_PERSONSまたはPIPEDRIVE_GET_DETAILS_OF_A_DEAL- 関連付けるエンティティ ID を特定します［前提条件］PIPEDRIVE_ADD_AN_ACTIVITY- 件名、種類、期限を指定してアクティビティを作成します［必須］PIPEDRIVE_UPDATE_AN_ACTIVITY- アクティビティの詳細を変更するか、完了としてマークします［任意］PIPEDRIVE_GET_DETAILS_OF_AN_ACTIVITY- アクティビティのレコードを取得します［任意］PIPEDRIVE_GET_ALL_ACTIVITIES_ASSIGNED_TO_A_PARTICULAR_USER- ユーザーのアクティビティを一覧表示します［任意］
主なパラメーター：
subject：アクティビティのタイトル（必須）type：アクティビティの種類を表すキー文字列（例："call"、"meeting"、"task"、"email"）（必須）due_date：形式 YYYY-MM-DDdue_time：形式 HH:MMduration：形式 HH:MM（例：30 分の場合は "00:30"）deal_id/person_id/org_id：関連するエンティティに関連付けますdone：0 = 未完了、1 = 完了
注意点：
PIPEDRIVE_ADD_AN_ACTIVITYではsubjectとtypeの両方が必須ですtypeはアカウント内の既存の ActivityTypes の key_string と一致する必要がありますdoneはブール値ではなく、整数（0 または 1）です- レスポンスの additional_data には
more_activities_scheduled_in_contextが含まれます
4. メモの追加と管理
使用する場面：ユーザーが取引、人物、組織、リード、またはプロジェクトにメモを添付したい場合。
ツールの順序：
PIPEDRIVE_SEARCH_PERSONSまたはPIPEDRIVE_GET_DETAILS_OF_A_DEAL- エンティティ ID を特定します［前提条件］PIPEDRIVE_ADD_A_NOTE- エンティティに関連付けて、HTML コンテンツを含むメモを作成します［必須］PIPEDRIVE_UPDATE_A_NOTE- メモの内容を変更します［任意］PIPEDRIVE_GET_ALL_NOTES- エンティティで絞り込んでメモを一覧表示します［任意］PIPEDRIVE_GET_ALL_COMMENTS_FOR_A_NOTE- メモへのコメントを取得します［任意］
主なパラメーター：
content：HTML 形式のメモ本文（必須）deal_id/person_id/org_id/lead_id/project_id：少なくとも 1 つのエンティティリンクが必要ですpinned_to_deal_flag/pinned_to_person_flag：一覧表示時にピン留めされたメモを絞り込みます
注意点：
contentは必須で、HTML に対応しています。プレーンテキストも使用できますが、サーバー側でサニタイズされますdeal_id、person_id、org_id、lead_id、project_idのいずれかを指定する必要がありますPIPEDRIVE_GET_ALL_NOTESはデフォルトですべてのエンティティのメモを返します。エンティティ ID パラメーターで絞り込んでください
5. パイプラインとステージの照会
使用する場面：ユーザーが営業パイプライン、ステージ、またはパイプラインやステージ内の取引を確認したい場合。
ツールの順序：
PIPEDRIVE_GET_ALL_PIPELINES- すべてのパイプラインとその ID を一覧表示します［必須］PIPEDRIVE_GET_ONE_PIPELINE- 特定のパイプラインの詳細と取引の概要を取得します［任意］PIPEDRIVE_GET_ALL_STAGES- すべてのステージを一覧表示します。パイプラインでの絞り込みも可能です［必須］PIPEDRIVE_GET_ONE_STAGE- 特定のステージの詳細を取得します［任意］PIPEDRIVE_GET_DEALS_IN_A_PIPELINE- パイプライン内の全ステージにある取引を一覧表示します［任意］PIPEDRIVE_GET_DEALS_IN_A_STAGE- 特定のステージ内の取引を一覧表示します［任意］
主なパラメーター：
id：パイプラインまたはステージの ID（単一項目のエンドポイントで必須）pipeline_id：パイプラインでステージを絞り込みますtotals_convert_currency：換算後の合計額に使用する 3 文字の通貨コード、または"default_currency"get_summary：パイプラインのレスポンスに取引の概要を含めるには、1 に設定します
注意点：
PIPEDRIVE_GET_ALL_PIPELINESはパラメーターを受け取らず、すべてのパイプラインを返しますPIPEDRIVE_GET_ALL_STAGESは、pipeline_idを指定しない限り、すべてのパイプラインのステージを返します- パイプラインの概要に含まれる取引数で
per_stages_convertedが使用されるのは、totals_convert_currencyが設定されている場合のみです
よくあるパターン
ID の特定
操作の前に、表示名を数値 ID に必ず解決してください：
- 組織名 -> org_id：
termパラメーターを指定してPIPEDRIVE_SEARCH_ORGANIZATIONSを使用します - 人物名 -> person_id：
termパラメーターを指定してPIPEDRIVE_SEARCH_PERSONSを使用します - パイプライン名 -> pipeline_id：
PIPEDRIVE_GET_ALL_PIPELINESを使用し、名前で照合します - ステージ名 -> stage_id：
pipeline_idを指定してPIPEDRIVE_GET_ALL_STAGESを使用し、名前で照合します
ページネーション
ほとんどの一覧エンドポイントでは、オフセットベースのページネーションを使用します：
start（オフセット）とlimit（ページサイズ）のパラメーターを使用しますadditional_data.pagination.more_items_in_collectionを確認して、次のページがあるかどうかを判断します- 次のページの
start値にはadditional_data.pagination.next_startを使用します - 一部のエンドポイントではデフォルトの上限が約 500 です。ページ分割を予測可能にするには、明示的に設定してください
既知の注意点
ID 形式
- すべてのエンティティ ID（取引、人物、組織、アクティビティ、パイプライン、ステージ）は数値の整数です
- リード ID は整数ではなく UUID 文字列です
- カスタムフィールドのキーは、長い英数字のハッシュです（例：
"a1b2c3d4e5f6..."）
レート制限
- Pipedrive は企業単位で API レート制限を適用します。一括操作は間隔を空けて実行してください
PIPEDRIVE_GET_ALL_PERSONSとPIPEDRIVE_GET_ALL_ORGANIZATIONSは大規模なデータセットを返すことがあります。必ずページネーションを使用してください
パラメーターに関する注意点
- 人物のメールアドレスと電話番号は、単純な文字列ではなくオブジェクトの配列です
visible_toは数値です。1 = 所有者のみ、3 = 会社全体、5 = 特定のグループ- アクティビティの
doneは整数の0/1であり、真偽値のtrue/falseではありません - 組織の作成時、重複が通知なしで自動的に統合される場合があります。レスポンスの
didMergeを確認してください PIPEDRIVE_SEARCH_PERSONSでは2文字以上が必要で、ワイルドカードはサポートされません
レスポンスの構造
- カスタムフィールドはレスポンス内でハッシュキーとして表示されます。それぞれのFieldsエンドポイントを使って対応付けてください
- ラップされた実行では、レスポンスのデータが
response.data.dataの下にネストされることがよくあります - 検索結果はトップレベルではなく、
response.data.itemsの下にあります
クイックリファレンス
| タスク | ツールのスラッグ | 主なパラメーター |
|---|---|---|
| 取引を作成 | PIPEDRIVE_ADD_A_DEAL | title, value, org_id, stage_id |
| 取引を更新 | PIPEDRIVE_UPDATE_A_DEAL | id, status, value, stage_id |
| 取引の詳細を取得 | PIPEDRIVE_GET_DETAILS_OF_A_DEAL | id |
| 人物を検索 | PIPEDRIVE_SEARCH_PERSONS | term, fields |
| 人物を追加 | PIPEDRIVE_ADD_A_PERSON | name, email, phone, org_id |
| 人物を更新 | PIPEDRIVE_UPDATE_A_PERSON | id, name, email |
| 人物の詳細を取得 | PIPEDRIVE_GET_DETAILS_OF_A_PERSON | id |
| すべての人物を一覧表示 | PIPEDRIVE_GET_ALL_PERSONS | start, limit, filter_id |
| 組織を検索 | PIPEDRIVE_SEARCH_ORGANIZATIONS | term, fields |
| 組織を追加 | PIPEDRIVE_ADD_AN_ORGANIZATION | name, visible_to |
| 組織を更新 | PIPEDRIVE_UPDATE_AN_ORGANIZATION | id, name, address |
| 組織の詳細を取得 | PIPEDRIVE_GET_DETAILS_OF_AN_ORGANIZATION | id |
| アクティビティを追加 | PIPEDRIVE_ADD_AN_ACTIVITY | subject, type, due_date, deal_id |
| アクティビティを更新 | PIPEDRIVE_UPDATE_AN_ACTIVITY | id, done, due_date |
| アクティビティの詳細を取得 | PIPEDRIVE_GET_DETAILS_OF_AN_ACTIVITY | id |
| 特定のユーザーに割り当てられたアクティビティを一覧表示 | PIPEDRIVE_GET_ALL_ACTIVITIES_ASSIGNED_TO_A_PARTICULAR_USER | user_id, start, limit |
| メモを追加 | PIPEDRIVE_ADD_A_NOTE | content, deal_id または person_id |
| メモを一覧表示 | PIPEDRIVE_GET_ALL_NOTES | deal_id, person_id, start, limit |
| パイプラインを一覧表示 | PIPEDRIVE_GET_ALL_PIPELINES | （なし） |
| パイプラインの詳細を取得 | PIPEDRIVE_GET_ONE_PIPELINE | id |
| ステージを一覧表示 | PIPEDRIVE_GET_ALL_STAGES | pipeline_id |
| パイプライン内の取引 | PIPEDRIVE_GET_DEALS_IN_A_PIPELINE | id, stage_id |
| ステージ内の取引 | PIPEDRIVE_GET_DEALS_IN_A_STAGE | id, start, limit |
| 取引に製品を追加 | PIPEDRIVE_ADD_A_PRODUCT_TO_A_DEAL | id, product_id, item_price |
Composio 提供
コメント
Markdown 対応