Salesforce Hosted MCP Serversを使って、Claude DesktopからSalesforceのレコードデータを参照してみた

Salesforce Hosted MCP Serversを使って、Claude DesktopからSalesforceのレコードデータを参照してみた

2026.03.04

Salesforce Hosted MCP ServersとClaude Desktopを接続し、Salesforceのレコードデータの取得を試してみました。
手順はmcp-hostedを参照しています。

検証環境

  • macOS Tahoe バージョン 26.2
  • Claude for Mac バージョン 1.1.3189
  • Salesforce Developer Edition

Salesforceでの設定

MCPサービスの有効化

Salesforce組織でMCPサービスを有効にします。

  1. 設定 > ユーザーインターフェース > ユーザーインターフェース に移動します。
  2. 「MCP サービスを有効化 (ベータ)」にチェックを入れて保存します。
    MCPサービスを有効化

外部クライアントアプリケーションの作成

外部クライアントアプリケーションを作成し、OAuth設定を行います。

基本情報
外部クライアントアプリケーション名、API参照名などは適宜設定します。
外部クライアントアプリケーション基本情報

OAuth 設定

アプリケーション設定

  • コールバックURL: ローカルインストールするClaude Desktopからの接続なので次のURLを使用します。
  • OAuth範囲: 次の4つを選択します。
    • API を使用してユーザーデータを管理(api)
    • いつでも要求を実行 (refresh_token, offline_access)
    • Salesforce API プラットフォームにアクセス (sfap_api)
    • Einstein GPT サービスにアクセス (einstein_gpt_api)
      スクリーンショット 2026-03-04 9.35.01

セキュリティ
次の2つのみチェックをつけ、それ以外のチェックは外します。

  • サポートされる認証フローに Proof Key for Code Exchange (PKCE) 拡張を要求
  • 指名ユーザーの JSON Web トークン (JWT) ベースのアクセストークンを発行
    スクリーンショット 2026-03-04 9.37.26

外部クライアントアプリケーションの作成が完了したらコンシューマー鍵を控えておきます。
コンシューマー鍵はClaude Desktopでカスタムコネクターを設定する際に使用します。

Salesforce組織へのログイン

Claude Desktopで設定する際にOAuth経由でSalesforce組織への認証が行われます。
複数組織にログインした状態だと上手くいかない場合があるため、接続するSalesforce組織のみにログインしている状態にします。

Claude Desktopでの設定

カスタムコネクタのインストール

  1. Salesforce Hosted MCP Serversのリポジトリから、salesforce-hosted-mcp-servers.mcpb をダウンロードします。
  2. ダウンロードしたファイルをダブルクリックしてインストールを実行します。
    カスタムコネクタインストール

※ 検証を行った3/2時点ではClaudeの障害の影響なのかインストールに失敗することがありました。
「Try again」をクリックすることでインストールが完了しました。
インストールエラー画面

コネクタの設定

Claude Desktopでカスタムコネクタを設定します。

  1. カスタマイズ > コネクタ > + をクリックし、「•••カスタムコネクタを追加」を選択します。
  2. コネクタの一覧から Salesforce Hosted MCP Servers (Beta) を選択します。
    カスタムコネクタ設定
  3. Server URLを設定します。
    • Developer Edition環境では、https://api.salesforce.com/platform/mcp/v1-beta.2/<SERVER-NAME> を使用します。
    • <SERVER-NAME> には、Available Tools and Serversから、使用したいツールを選択します。
    • 今回は読み取り用のツールである sobject-reads を選択し、https://api.salesforce.com/platform/mcp/v1-beta.2/sobject-reads をServer URLに設定しました。
  4. Consumer Keyには先ほど控えておいたコンシューマー鍵を設定し、保存します。

コネクタの有効化

コネクタを有効化します。
ブラウザに遷移してSalesforceへのログインを求められるので、Developer Edtion組織にログインします。
アクセス許可を求められるので、「許可」をクリックします。
アクセス許可
コールバックURLに遷移し、「Authorization successful! You may close this window and return to the CLI.」と表示されたら認証成功です。
※ 上記メッセージが表示されても、Claude Desktop側ではエラーになることがありました。
コネクタ接続エラー
ログを見ると認証のエラーが発生していました。

[78806] Authorization error: InvalidGrantError: invalid code verifier
at parseErrorResponse

invalid code verifierなので ~/.mcp-auth ディレクトリのmcp-remoteの認証キャッシュをクリアし再度有効化したところ接続に成功しました。

ツールの権限設定

今回選択した sobject-reads では下記のツールごとに「常に許可」、「承認が必要」、「ブロック」が選択できるようです。
テストなのですべてのツールで「常に許可」を選択しています。
読み取り専用ツール

  • describe_global
  • get_user_info
  • describe_sobject

書き込み/削除ツール

  • list_recent_sobject_records
  • get_related_records
  • soql_query
  • find

※ 「list_recent_sobject_records」、「get_related_records」、「soql_query」、「find」は書き込み/削除ツールとなっていますが、実際には読み取りしかできないのではないかと思われます。
ツール権限設定

動作確認

Claude Desktopのチャットから下記のプロンプトを実行します。

Salesforceから取引先の一覧を取得してください

結果

Salesforceから取引先の一覧を取得しました。合計 **13件** の取引先が見つかりました。

| # | 取引先名 | 種別 | 業種 | 電話番号 | 所在地 |
|---|---------|------|------|---------|--------|
| 1 | Burlington Textiles Corp of America | Customer - Direct | アパレル | (336) 222-7000 | Burlington, USA |
| 2 | Dickenson plc | Customer - Channel | コンサルティング | (785) 241-6200 | Lawrence, USA |
| 3 | Edge Communications | Customer - Direct | エレクトロニクス | (512) 757-6000 | Austin, USA |
| 4 | Express Logistics and Transport | Customer - Channel | 輸送 | (503) 421-7800 | Portland, USA |
| 5 | GenePoint | Customer - Channel | バイオテクノロジー | (650) 867-3450 | Mountain View, USA |
| 6 | Grand Hotels & Resorts Ltd | Customer - Direct | ホスピタリティ | (312) 596-1000 | Chicago, USA |
| 7 | Pyramid Construction Inc. | Customer - Channel | 建設 | (014) 427-4427 | Paris, France |
| 8 | Sample Account for Entitlements | — | — | — | — |
| 9 | sForce | — | — | (415) 901-7000 | San Francisco, USA |
| 10 | United Oil & Gas Corp. | Customer - Direct | エネルギー | (212) 842-5500 | New York, USA |
| 11 | United Oil & Gas, Singapore | Customer - Direct | エネルギー | (650) 450-8810 | Singapore |
| 12 | United Oil & Gas, UK | Customer - Direct | エネルギー | +44 191 4956203 | UK |
| 13 | University of Arizona | Customer - Direct | 教育 | (520) 773-9050 | Tucson, USA |

何か特定の取引先の詳細情報や、絞り込み条件を追加して検索したい場合はお知らせください。

動作確認

Salesforceのレコードデータが参照できることが確認できました。

まとめ

Claude DesktopとSalesforce Hosted MCP Serversを連携させ、Salesforceからレコードデータを取得できることが確認できました。まだベータ版ということもあり動作が不安定なこともありますが、ClaudeのチャットやCoworkからSalesforceデータとの対話的な操作を行うことで様々な業務の効率化を行えるのではないかと思います。

この記事をシェアする

FacebookHatena blogX

関連記事