pipedrive-automation

Rube MCP による Pipedrive の自動化

Composio の Pipedrive ツールキットを通じて、案件管理、連絡先や組織の操作、アクティビティのスケジュール設定、メモ、パイプラインやステージの照会など、Pipedrive CRM のワークフローを自動化します。

前提条件

• Rube MCP が接続されている必要があります（RUBE_SEARCH_TOOLS が利用可能）
• ツールキット pipedrive を指定した RUBE_MANAGE_CONNECTIONS による、有効な Pipedrive 接続
• 現在のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出してください

セットアップ

既存の承認済み Rube 接続を使用してください。エンドポイントを追加するだけでは、Pipedrive の認証は行われません。サポートされているホストのセットアップ／認証フローは、依頼された範囲内でのみ使用してください。

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 またはステージ ID（単一項目のエンドポイントで必須）
• pipeline_id：パイプラインでステージを絞り込みます
• totals_convert_currency：換算後の合計金額に使用する 3 文字の通貨コード、または "default_currency"
• get_summary：パイプラインの応答に取引の概要を含めるには 1 を設定します

注意点：

• PIPEDRIVE_GET_ALL_PIPELINES はパラメーターを受け取らず、すべてのパイプラインを返します
• pipeline_id を指定しない場合、PIPEDRIVE_GET_ALL_STAGES はすべてのパイプラインのステージを返します
• パイプライン概要の取引件数で 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 を実行し、名前で一致するものを確認します

ページネーション

ページネーションの仕様は API／ツールのバージョンによって異なります。確認できたカーソルまたはオフセットの仕様に従ってください。過去のオフセット方式の例：

• 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 は真偽値の true/false ではなく、整数の 0/1 です
• 組織の作成時に重複が自動的に統合される場合があり、その際は通知されません。レスポンスの 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

使用する場面

このスキルは、概要に記載されたワークフローまたはアクションを実行する場合に適用されます。

例

ユーザーのリクエスト:

Rube MCP (Composio) を介して、案件、担当者、組織、アクティビティ、ノート、パイプライン管理を含む Pipedrive CRM の操作を自動化します。

制限事項

• このスキルは、タスクが上記の範囲に明確に一致する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代替として扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が欠けている場合は、停止して明確化を求めてください。