salesforce-automation

Rube MCP 経由の Salesforce 自動化

Rube MCP 経由で Composio の Salesforce ツールキットを利用し、Salesforce CRM の操作を自動化します。

ツールキットのドキュメント：composio.dev/toolkits/salesforce

前提条件

• Rube MCP に接続されていること（RUBE_SEARCH_TOOLS が利用可能）
• RUBE_MANAGE_CONNECTIONS を使って、ツールキット salesforce の有効な Salesforce 接続があること
• 現在のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出してください

セットアップ

Rube MCP の取得：クライアントの設定で https://rube.app/mcp を MCP サーバーとして追加します。API キーは不要です。エンドポイントを追加するだけで動作します。

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

主なワークフロー

1. リードを管理する

使用する場面：ユーザーがリードの作成、検索、更新、一覧表示を希望する場合

ツールの実行順序：

1. SALESFORCE_SEARCH_LEADS - 条件でリードを検索［任意］
2. SALESFORCE_LIST_LEADS - すべてのリードを一覧表示［任意］
3. SALESFORCE_CREATE_LEAD - 新しいリードを作成［任意］
4. SALESFORCE_UPDATE_LEAD - リードのフィールドを更新［任意］
5. SALESFORCE_ADD_LEAD_TO_CAMPAIGN - リードをキャンペーンに追加［任意］
6. SALESFORCE_APPLY_LEAD_ASSIGNMENT_RULES - 割り当てルールを適用［任意］

主なパラメーター：

• LastName：リードの作成に必須
• Company：リードの作成に必須
• Email、Phone、Title：一般的なリードのフィールド
• lead_id：更新対象のリード ID
• campaign_id：キャンペーン操作のキャンペーン ID

注意点：

• リードの作成には LastName と Company が必須です
• リード ID は 15 文字または 18 文字の Salesforce ID です

2. 取引先責任者と取引先を管理する

使用する場面：ユーザーが取引先責任者と関連する取引先の管理を希望する場合

ツールの実行順序：

1. SALESFORCE_SEARCH_CONTACTS - 取引先責任者を検索［任意］
2. SALESFORCE_LIST_CONTACTS - 取引先責任者を一覧表示［任意］
3. SALESFORCE_CREATE_CONTACT - 新しい取引先責任者を作成［任意］
4. SALESFORCE_SEARCH_ACCOUNTS - 取引先を検索［任意］
5. SALESFORCE_CREATE_ACCOUNT - 新しい取引先を作成［任意］
6. SALESFORCE_ASSOCIATE_CONTACT_TO_ACCOUNT - 取引先責任者を取引先にリンク［任意］

主なパラメーター：

• LastName：取引先責任者の作成に必須
• Name：作成する取引先の名前
• AccountId：取引先責任者に関連付ける取引先 ID
• contact_id、account_id：関連付けに使う ID

注意点：

• 取引先責任者には少なくとも LastName が必要です
• 取引先の関連付けには、有効な取引先責任者 ID と取引先 ID の両方が必要です

3. 商談を管理する

使用する場面：ユーザーが営業案件の追跡と管理を希望する場合

ツールの実行順序：

1. SALESFORCE_SEARCH_OPPORTUNITIES - 商談を検索［任意］
2. SALESFORCE_LIST_OPPORTUNITIES - すべての商談を一覧表示［任意］
3. SALESFORCE_GET_OPPORTUNITY - 商談の詳細を取得［任意］
4. SALESFORCE_CREATE_OPPORTUNITY - 新しい商談を作成［任意］
5. SALESFORCE_RETRIEVE_OPPORTUNITIES_DATA - 商談データを取得［任意］

主なパラメーター：

• Name：商談名（必須）
• StageName：営業ステージ（必須）
• CloseDate：予想完了日（必須）
• Amount：案件金額
• AccountId：関連する取引先

注意点：

• 作成には Name、StageName、CloseDate が必須です
• ステージ名は Salesforce で設定されている名称と完全に一致する必要があります

4. SOQL クエリを実行する

使用する場面：ユーザーが独自の SOQL で Salesforce データをクエリする場合

ツールの実行順序：

1. SALESFORCE_RUN_SOQL_QUERY / SALESFORCE_QUERY - SOQL を実行［必須］

主なパラメーター：

• query：SOQL クエリ文字列

注意点：

• SOQL の構文は SQL と異なり、Salesforce のオブジェクト名とフィールドの API 名を使用します
• フィールドの API 名は表示ラベルと異なる場合があります（例：Account Name ではなく Account.Name）
• 大規模なデータセットの結果はページ分割されます

5. タスクの管理

使用する場面: ユーザーがタスクの作成、検索、更新、完了を希望する場合

ツールの順序:

1. SALESFORCE_SEARCH_TASKS - タスクを検索 [任意]
2. SALESFORCE_UPDATE_TASK - タスクの項目を更新 [任意]
3. SALESFORCE_COMPLETE_TASK - タスクを完了としてマーク [任意]

主なパラメーター:

• task_id: 更新するタスクの ID
• Status: タスクのステータス値
• Subject: タスクの件名

注意点:

• タスクのステータス値は、Salesforce の選択リストのオプションと一致している必要があります

一般的なパターン

SOQL 構文

基本的なクエリ:

SELECT Id, Name, Email FROM Contact WHERE LastName = 'Smith'

リレーションシップを使用する場合:

SELECT Id, Name, Account.Name FROM Contact WHERE Account.Industry = 'Technology'

日付によるフィルタリング:

SELECT Id, Name FROM Lead WHERE CreatedDate = TODAY
SELECT Id, Name FROM Opportunity WHERE CloseDate = NEXT_MONTH

ページネーション

• 大量の結果を返す SOQL クエリは、ページネーショントークンを返します
• ページネーションには nextRecordsUrl を指定して SALESFORCE_QUERY を使用します
• レスポンスの done フィールドを確認し、false の場合はページングを続けます

既知の注意点

項目の API 名:

• 常に表示ラベルではなく API 名を使用してください
• カスタム項目は __c サフィックスで終わります
• カスタムオブジェクトを確認するには SALESFORCE_GET_ALL_CUSTOM_OBJECTS を使用します

ID の形式:

• Salesforce の ID は 15 文字（大文字と小文字を区別）または 18 文字（大文字と小文字を区別しない）です
• ほとんどの操作で両方の形式が受け入れられます

クイックリファレンス

タスク	ツールスラッグ	主なパラメーター
リードを作成	SALESFORCE_CREATE_LEAD	LastName, Company
リードを検索	SALESFORCE_SEARCH_LEADS	query
リードを一覧表示	SALESFORCE_LIST_LEADS	(filters)
リードを更新	SALESFORCE_UPDATE_LEAD	lead_id, fields
取引先責任者を作成	SALESFORCE_CREATE_CONTACT	LastName
取引先責任者を検索	SALESFORCE_SEARCH_CONTACTS	query
取引先を作成	SALESFORCE_CREATE_ACCOUNT	Name
取引先を検索	SALESFORCE_SEARCH_ACCOUNTS	query
取引先責任者をリンク	SALESFORCE_ASSOCIATE_CONTACT_TO_ACCOUNT	contact_id, account_id
商談を作成	SALESFORCE_CREATE_OPPORTUNITY	Name, StageName, CloseDate
商談を取得	SALESFORCE_GET_OPPORTUNITY	opportunity_id
商談を検索	SALESFORCE_SEARCH_OPPORTUNITIES	query
SOQL を実行	SALESFORCE_RUN_SOQL_QUERY	query
クエリ	SALESFORCE_QUERY	query
タスクを検索	SALESFORCE_SEARCH_TASKS	query
タスクを更新	SALESFORCE_UPDATE_TASK	task_id, fields
タスクを完了	SALESFORCE_COMPLETE_TASK	task_id
ユーザー情報を取得	SALESFORCE_GET_USER_INFO	(none)
カスタムオブジェクト	SALESFORCE_GET_ALL_CUSTOM_OBJECTS	(none)
レコードを作成	SALESFORCE_CREATE_A_RECORD	object_type, fields
所有者を移譲	SALESFORCE_MASS_TRANSFER_OWNERSHIP	records, new_owner

---

Powered by Composio