Salesforce MCP

Salesforce MCP サーバーを有効にする

Salesforceで、Setupを開きます。

1. Quick Findで、MCP Serversを検索します。
2. API Catalog の下にある MCP Servers を開きます。
3. 使用するサーバーを有効にします。初回セットアップ時は、platform/sobject-reads を有効にしてください。
4. サーバーがアクティブになるまで最大2分間お待ちください。

full-accessの例を使用する予定の場合は、代わりに platform/sobject-all を有効にしてください。

外部クライアントアプリを作成する

Salesforceの設定にて:

1. Quick Findで、External Client App Managerを検索します。
2. New External Client App をクリックします。
3. 基本的なアプリ情報を入力します。LibreChat Salesforce MCP のような分かりやすい名前を使用してください。
4. API (Enable OAuth Settings) を展開し、OAuth を有効にします。
5. LibreChatのコールバックURLを追加します。

ローカル開発の場合:

http://localhost:3080/api/mcp/salesforce/oauth/callback

本番環境では、ベースURLを公開用のLibreChat URLに置き換えてください：

https://chat.example.com/api/mcp/salesforce/oauth/callback

OAuthスコープとセキュリティの設定

External Client App OAuth設定で、以下のスコープを追加してください：

mcp_api
refresh_token

Hosted MCP サーバーには、標準の Salesforce api スコープを使用しないでください。MCP サーバーは mcp_api スコープを想定しています。

外部クライアントアプリのセキュリティ設定で：

• Issue JSON Web Token (JWT)-based access tokens for named users（指定されたユーザーに対してJSON Web Token (JWT) ベースのアクセストークンを発行する）を選択します。
• Require Proof Key for Code Exchange (PKCE) extension for Supported Authorization Flows を選択します。
• このガイドの基本的なセットアップでは、Require Secret for Web Server Flow を無効のままにしてください。
• このガイドの基本的なセットアップでは、Require Secret for Refresh Token Flow は無効のままにしておいてください。

Createをクリックし、アプリ設定を開いてConsumer Keyをコピーします。Salesforceによると、新しいExternal Client Appが利用可能になるまで最大30分かかる場合があります。

SalesforceクライアントIDを .env に追加する

LibreChatの .env ファイルに External Client App のコンシューマーキーを追加します：

SALESFORCE_MCP_CLIENT_ID=your-salesforce-consumer-key

Require Secret for Web Server Flow を有効にした場合は、以下も追加してください：

SALESFORCE_MCP_CLIENT_SECRET=your-salesforce-client-secret

librechat.yaml に Salesforce MCP を追加する

この例では、本番環境またはDeveloper Edition組織向けに読み取り専用のSObjectサーバーを設定します。

mcpServers:
  salesforce:
    type: streamable-http
    url: 'https://api.salesforce.com/platform/mcp/v1/platform/sobject-reads'
    timeout: 90000
    initTimeout: 150000
    requiresOAuth: true
    startup: false
    oauth:
      authorization_url: 'https://login.salesforce.com/services/oauth2/authorize'
      token_url: 'https://login.salesforce.com/services/oauth2/token'
      client_id: '${SALESFORCE_MCP_CLIENT_ID}'
      scope: 'mcp_api refresh_token'
      redirect_uri: 'http://localhost:3080/api/mcp/salesforce/oauth/callback'

サンドボックスまたはスクラッチ組織の場合は、サンドボックスのMCP URLとSalesforceサンドボックスのOAuth endpointを使用してください：

mcpServers:
  salesforce:
    type: streamable-http
    url: 'https://api.salesforce.com/platform/mcp/v1/sandbox/platform/sobject-reads'
    timeout: 90000
    initTimeout: 150000
    requiresOAuth: true
    startup: false
    oauth:
      authorization_url: 'https://test.salesforce.com/services/oauth2/authorize'
      token_url: 'https://test.salesforce.com/services/oauth2/token'
      client_id: '${SALESFORCE_MCP_CLIENT_ID}'
      scope: 'mcp_api refresh_token'
      redirect_uri: 'http://localhost:3080/api/mcp/salesforce/oauth/callback'

外部クライアントアプリでクライアントシークレットが必要な場合は、oauth 内に以下のフィールドを追加してください：

oauth:
  client_secret: '${SALESFORCE_MCP_CLIENT_SECRET}'
  token_exchange_method: default_post
  token_endpoint_auth_methods_supported: ['client_secret_post']

LibreChatをパブリックURLでデプロイしている場合は、Salesforceに登録されているコールバックURLと完全に一致するように redirect_uri を更新してください。

必要に応じて、Salesforceへのフルアクセスに切り替える

読み取り専用サーバーが動作した後、url を変更することで、有効化された別の Salesforce サーバーに切り替えることができます。

本番環境またはDeveloper Edition組織でSObjectへの完全なアクセス権を得るには：

url: 'https://api.salesforce.com/platform/mcp/v1/platform/sobject-all'

サンドボックスまたはスクラッチ組織で完全なSObjectアクセスを行うには：

url: 'https://api.salesforce.com/platform/mcp/v1/sandbox/platform/sobject-all'

Salesforceレコードの作成、更新、削除をアシスタント経由で許可すべきユーザーに対してのみ、変更または削除が可能なサーバーを公開してください。

LibreChatを再起動する

LibreChatを再起動して、.env と librechat.yaml を再読み込みしてください。

Dockerでサーバーが読み込まれたことを確認するには、APIログを確認してください：

docker logs LibreChat --tail 200 | grep MCP

LibreChatでSalesforceを接続する

LibreChatを開き、チャット入力欄にあるMCP SettingsまたはMCP Serversドロップダウンを開きます。

1. Salesforceサーバーの Connect をクリックします。
2. Salesforce OAuthフローを完了します。
3. 要求された mcp_api および refresh_token スコープを確認してください。
4. OAuthの成功ページが閉じた後、LibreChatに戻ります。

OAuthが成功し、MCP接続が初期化されると、SalesforceツールがチャットおよびAgent Builder内で利用可能になります。