mcpField
P
pipedrive-automation

pipedrive-automation

github.com/davepoonマーケティング・グロース3.7k120 回インストール1 日前に更新
リポジトリ

pipedrive-automation について

Composio の Pipedrive ツールキットを使い、CRM ワークフローを自動化するスキルです。営業や CRM 管理向けに、取引、連絡先、アクティビティ、メモ、パイプラインの照会を Rube MCP 経由で行います。

主な機能

  1. 01取引の作成と更新
  2. 02連絡先と組織の検索・管理
  3. 03アクティビティの予定と追跡
  4. 04CRM メモの追加と管理
  5. 05パイプライン、ステージ、取引の照会

活用シーン

  1. 01連絡先や組織に関連付けた取引の作成
  2. 02CRM の連絡先レコードの検索や更新
  3. 03通話、会議、タスクの予定設定
  4. 04パイプラインやステージ別の取引確認

MCP 対応

Rube MCP 経由で Composio の Pipedrive ツールキットにアクセスします。Pipedrive の有効な接続と、RUBE_SEARCH_TOOLS によるツールスキーマの取得が必要です。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/davepoon/buildwithclaude --skill pipedrive-automation

インストール後、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 キーは不要です。エンドポイントを追加するだけで利用できます。

  1. RUBE_SEARCH_TOOLS が応答することを確認し、Rube MCP が利用可能であることを確かめます
  2. ツールキット pipedrive を指定して RUBE_MANAGE_CONNECTIONS を呼び出します
  3. 接続が ACTIVE でない場合は、返された認証リンクに従って Pipedrive OAuth を完了します
  4. ワークフローを実行する前に、接続ステータスが ACTIVE と表示されることを確認します

主なワークフロー

1. 案件の作成と管理

使用する場面：新しい案件の作成、既存の案件の更新、または営業パイプライン内の案件詳細の確認をユーザーが希望する場合。

ツールの順序：

  1. PIPEDRIVE_SEARCH_ORGANIZATIONS - 案件に関連付ける既存の組織を検索します［任意］
  2. PIPEDRIVE_ADD_AN_ORGANIZATION - 見つからない場合は組織を作成します［任意］
  3. PIPEDRIVE_SEARCH_PERSONS - 関連付ける既存の連絡先を検索します［任意］
  4. PIPEDRIVE_ADD_A_PERSON - 見つからない場合は連絡先を作成します［任意］
  5. PIPEDRIVE_GET_ALL_PIPELINES - パイプライン ID を特定します［前提条件］
  6. PIPEDRIVE_GET_ALL_STAGES - パイプライン内のステージ ID を特定します［前提条件］
  7. PIPEDRIVE_ADD_A_DEAL - タイトル、金額、org_id、person_id、stage_id を指定して案件を作成します［必須］
  8. PIPEDRIVE_UPDATE_A_DEAL - 作成後に案件のプロパティを変更します［任意］
  9. PIPEDRIVE_ADD_A_PRODUCT_TO_A_DEAL - 明細項目／製品を追加します［任意］

主なパラメーター：

  • title：案件のタイトル（作成時に必須）
  • value：案件の金額
  • currency：3 文字の ISO 通貨コード（例：「USD」）
  • pipeline_id / stage_id：パイプライン内の配置を示す数値 ID
  • org_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 で連絡先や会社を作成、更新、検索、または一覧表示したい場合。

ツールの順序：

  1. PIPEDRIVE_SEARCH_PERSONS - 名前、メールアドレス、電話番号で既存の人物を検索します［前提条件］
  2. PIPEDRIVE_ADD_A_PERSON - 見つからない場合、新しい連絡先を作成します［必須］
  3. PIPEDRIVE_UPDATE_A_PERSON - 既存の連絡先情報を変更します［任意］
  4. PIPEDRIVE_GET_DETAILS_OF_A_PERSON - 連絡先の完全なレコードを取得します［任意］
  5. PIPEDRIVE_SEARCH_ORGANIZATIONS - 既存の組織を検索します［前提条件］
  6. PIPEDRIVE_ADD_AN_ORGANIZATION - 見つからない場合、新しい組織を作成します［必須］
  7. PIPEDRIVE_UPDATE_AN_ORGANIZATION - 組織のプロパティを変更します［任意］
  8. 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. アクティビティを予定し、追跡する

使用する場面：案件、連絡先、組織に関連付けられた電話、会議、タスク、その他のアクティビティを作成したい場合。

ツールの順序：

  1. PIPEDRIVE_SEARCH_PERSONS または PIPEDRIVE_GET_DETAILS_OF_A_DEAL - 関連付けるエンティティ ID を特定します［前提条件］
  2. PIPEDRIVE_ADD_AN_ACTIVITY - 件名、種類、期限を指定してアクティビティを作成します［必須］
  3. PIPEDRIVE_UPDATE_AN_ACTIVITY - アクティビティの詳細を変更するか、完了としてマークします［任意］
  4. PIPEDRIVE_GET_DETAILS_OF_AN_ACTIVITY - アクティビティのレコードを取得します［任意］
  5. PIPEDRIVE_GET_ALL_ACTIVITIES_ASSIGNED_TO_A_PARTICULAR_USER - ユーザーのアクティビティを一覧表示します［任意］

主なパラメーター：

  • subject：アクティビティのタイトル（必須）
  • type：アクティビティの種類を表すキー文字列（例："call"、"meeting"、"task"、"email"）（必須）
  • due_date：形式 YYYY-MM-DD
  • due_time：形式 HH:MM
  • duration：形式 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. メモの追加と管理

使用する場面：ユーザーが取引、人物、組織、リード、またはプロジェクトにメモを添付したい場合。

ツールの順序：

  1. PIPEDRIVE_SEARCH_PERSONS または PIPEDRIVE_GET_DETAILS_OF_A_DEAL - エンティティ ID を特定します［前提条件］
  2. PIPEDRIVE_ADD_A_NOTE - エンティティに関連付けて、HTML コンテンツを含むメモを作成します［必須］
  3. PIPEDRIVE_UPDATE_A_NOTE - メモの内容を変更します［任意］
  4. PIPEDRIVE_GET_ALL_NOTES - エンティティで絞り込んでメモを一覧表示します［任意］
  5. 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. パイプラインとステージの照会

使用する場面：ユーザーが営業パイプライン、ステージ、またはパイプラインやステージ内の取引を確認したい場合。

ツールの順序：

  1. PIPEDRIVE_GET_ALL_PIPELINES - すべてのパイプラインとその ID を一覧表示します［必須］
  2. PIPEDRIVE_GET_ONE_PIPELINE - 特定のパイプラインの詳細と取引の概要を取得します［任意］
  3. PIPEDRIVE_GET_ALL_STAGES - すべてのステージを一覧表示します。パイプラインでの絞り込みも可能です［必須］
  4. PIPEDRIVE_GET_ONE_STAGE - 特定のステージの詳細を取得します［任意］
  5. PIPEDRIVE_GET_DEALS_IN_A_PIPELINE - パイプライン内の全ステージにある取引を一覧表示します［任意］
  6. 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_DEALtitle, value, org_id, stage_id
取引を更新PIPEDRIVE_UPDATE_A_DEALid, status, value, stage_id
取引の詳細を取得PIPEDRIVE_GET_DETAILS_OF_A_DEALid
人物を検索PIPEDRIVE_SEARCH_PERSONSterm, fields
人物を追加PIPEDRIVE_ADD_A_PERSONname, email, phone, org_id
人物を更新PIPEDRIVE_UPDATE_A_PERSONid, name, email
人物の詳細を取得PIPEDRIVE_GET_DETAILS_OF_A_PERSONid
すべての人物を一覧表示PIPEDRIVE_GET_ALL_PERSONSstart, limit, filter_id
組織を検索PIPEDRIVE_SEARCH_ORGANIZATIONSterm, fields
組織を追加PIPEDRIVE_ADD_AN_ORGANIZATIONname, visible_to
組織を更新PIPEDRIVE_UPDATE_AN_ORGANIZATIONid, name, address
組織の詳細を取得PIPEDRIVE_GET_DETAILS_OF_AN_ORGANIZATIONid
アクティビティを追加PIPEDRIVE_ADD_AN_ACTIVITYsubject, type, due_date, deal_id
アクティビティを更新PIPEDRIVE_UPDATE_AN_ACTIVITYid, done, due_date
アクティビティの詳細を取得PIPEDRIVE_GET_DETAILS_OF_AN_ACTIVITYid
特定のユーザーに割り当てられたアクティビティを一覧表示PIPEDRIVE_GET_ALL_ACTIVITIES_ASSIGNED_TO_A_PARTICULAR_USERuser_id, start, limit
メモを追加PIPEDRIVE_ADD_A_NOTEcontent, deal_id または person_id
メモを一覧表示PIPEDRIVE_GET_ALL_NOTESdeal_id, person_id, start, limit
パイプラインを一覧表示PIPEDRIVE_GET_ALL_PIPELINES（なし）
パイプラインの詳細を取得PIPEDRIVE_GET_ONE_PIPELINEid
ステージを一覧表示PIPEDRIVE_GET_ALL_STAGESpipeline_id
パイプライン内の取引PIPEDRIVE_GET_DEALS_IN_A_PIPELINEid, stage_id
ステージ内の取引PIPEDRIVE_GET_DEALS_IN_A_STAGEid, start, limit
取引に製品を追加PIPEDRIVE_ADD_A_PRODUCT_TO_A_DEALid, product_id, item_price

Composio 提供

コメント

Markdown 対応