Salesforce - SObject Mutations
Salesforce公式Hosted MCPのSObject Mutationsサーバーに接続し、Salesforceオブジェクトデータの参照、検索、作成、更新を行えます。
主な機能
- Salesforceオブジェクトのスキーマ情報とユーザー情報の取得
- SOQLクエリとSOSL検索の実行
- 最近参照したSObjectレコードの取得
- 関連レコードの取得
- SObjectレコードの作成と更新
基本情報
認証方式
Salesforce OAuth認証を使用します。
入力パラメータ
- consumerKey（必須）: Salesforce External Client App（ECA）のConsumer Key
- consumerSecret（必須）: Salesforce External Client App（ECA）のConsumer Secret
- useSandbox（任意）: Salesforce Sandbox環境に接続するかどうか
Salesforce設定方法
このIntegrationを使用するには、Salesforce External Client App（ECA）の設定とHosted MCPサーバーの有効化が必要です。
- Salesforce公式ガイド に従ってExternal Client Appを作成します。
- AIP OAuth設定画面に表示されるCallback URLをExternal Client AppのCallback URLとして登録します。
- 作成したExternal Client AppのConsumer KeyとConsumer SecretをAIPのconsumerKey、consumerSecretフィールドに入力します。
- Salesforce Setup → API Catalog → MCP Serversで
sobject-mutationsサーバーをActivateします。詳細はSalesforce MCPサーバー有効化ガイド を参照してください。
サポートするMCPツール
updateSobjectRecord
IDを指定して既存のSalesforceレコードを更新します。
updateRelatedRecord
親レコードとの関係をたどって関連する子レコードを見つけて更新します。
soqlQuery
SOQLクエリを実行してSalesforceレコードを取得します。
listRecentSobjectRecords
ユーザーが最近参照または更新した特定のSObjectレコードを取得します。
getUserInfo
現在認証しているSalesforceユーザーの識別情報とコンテキスト情報を取得します。
getRelatedRecords
親レコードとの関係をたどって関連する子レコードを取得します。
getObjectSchema
LLMが扱いやすい形式でSalesforceオブジェクトのスキーマ情報を取得します。
find
SOSLベースのテキスト検索を実行し、複数のSalesforceオブジェクトからデータを探します。
createSobjectRecord
新しいSalesforceレコードを作成します。
使用例
例えば、
- プロンプトで「新しいContactを作成して」と入力すると、
- LLMはMCPを通じて
createSobjectRecordツールを呼び出し、 - ツール実行結果に基づいてチャットで応答します。
その他の使用例:
- 「このLeadのステータスを更新して」
- 「このAccountに関連するContact情報を修正して」
- 「更新前に対象レコードを先に取得して」
注意事項
- 削除操作は提供しません。
- 作成・更新操作は実際のSalesforceデータに反映されるため、注意して実行してください。
- 利用できるオブジェクトとフィールドはSalesforceの権限に応じて異なります。
Last updated on