MCP Salesforce Connector

Salesforce統合のためのModel Context Protocol (MCP) サーバー実装であり、LLMがSOQLクエリやSOSL検索を通じてSalesforceデータと対話できるようにします。

機能

• SOQL (Salesforce Object Query Language) クエリの実行

• SOSL (Salesforce Object Search Language) 検索の実行

• フィールド名、ラベル、型を含むSalesforceオブジェクトのメタデータの取得

• 利用可能なすべてのSObjectのリスト表示 - 標準オブジェクトおよびカスタムオブジェクトの検出

• レコードの取得、作成、更新、削除

• Tooling APIリクエストの実行

• Apex RESTリクエストの実行

• Salesforceへの直接的なREST API呼び出し

Related MCP server: Salesforce MCP Integration

設定

Model Context Protocol

このサーバーをModel Context Protocolで使用するには、claude_desktop_config.jsonファイルで設定する必要があります。mcpServersセクションに以下のエントリを追加してください：

{
    "mcpServers": {
        "salesforce": {
        "command": "uvx",
        "args": [
            "--from",
            "mcp-salesforce-connector",
            "salesforce"
        ],
        "env": {
            "SALESFORCE_ACCESS_TOKEN": "SALESFORCE_ACCESS_TOKEN",
            "SALESFORCE_INSTANCE_URL": "SALESFORCE_INSTANCE_URL",
            "SALESFORCE_DOMAIN": "SALESFORCE_DOMAIN"
            }
        }
    }
}

利用可能なツール

クエリおよび検索ツール

• run_soql_query - Salesforceに対してSOQLクエリを実行します

• run_sosl_search - オブジェクト全体でSOSL検索を実行します

メタデータツール

• get_object_fields - 特定のオブジェクトのフィールドメタデータを取得します

• list_sobjects - 利用可能なすべてのSObject（標準およびカスタム）をリスト表示します

単一レコード操作

• get_record - IDを指定して特定のレコードを取得します

• create_record - 新しいレコードを作成します

• update_record - 既存のレコードを更新します

• delete_record - レコードを削除します

一括操作

• bulk_create_records - 1回の操作で複数のレコードを作成します

• bulk_update_records - 複数のレコードを更新します（Idフィールドを含める必要があります）

• bulk_delete_records - レコードIDを使用して複数のレコードを削除します

高度なAPIツール

• tooling_execute - Tooling APIリクエストを実行します

• apex_execute - Apex RESTリクエストを実行します

• restful - Salesforceへの直接的なREST API呼び出しを行います

Salesforce認証方法に関する注意点

このサーバーは4つの認証方法をサポートしています：

• OAuth (推奨): SALESFORCE_ACCESS_TOKEN および SALESFORCE_INSTANCE_URL を環境変数として設定します。

• クライアント資格情報: OAuth 2.0 クライアント資格情報フローのために SALESFORCE_CLIENT_ID および SALESFORCE_CLIENT_SECRET を設定します。これはサーバー間統合に役立ちます。

• Salesforce CLI (デフォルト組織): OAuth環境変数が設定されていない場合、サーバーは現在のワークスペースからアクティブなSalesforce CLIデフォルト組織の使用を試みます（sf org display --json または sfdx force:org:display --json を経由）。オプションで SALESFORCE_CLI_TARGET_ORG を設定して特定の組織をターゲットにできます。

• ユーザー名/パスワード (レガシー): SALESFORCE_ACCESS_TOKEN および SALESFORCE_INSTANCE_URL が設定されていない場合、サーバーは SALESFORCE_USERNAME、SALESFORCE_PASSWORD、および SALESFORCE_SECURITY_TOKEN を使用するフォールバックを行います。

環境設定

• SALESFORCE_DOMAIN (オプション): Salesforceサンドボックス環境に接続するには test に設定します。設定されていないか空の場合、サーバーは本番環境に接続します。

• SALESFORCE_CLI_TARGET_ORG (オプション): Salesforce CLI認証方法を使用する場合、デフォルト組織の代わりに特定の組織エイリアスまたはユーザー名をターゲットにするためにこれを設定します。