Salesforce MCP サーバー
Claude と Salesforce を統合する MCP（Model Context Protocol）サーバー実装により、Salesforce のデータとメタデータを自然言語で操作できるようになります。このサーバーにより、Claude は日常的な言語で Salesforce のオブジェクトとレコードをクエリ、変更、管理できます。
特徴
- オブジェクトとフィールドの管理:自然言語を使用してカスタムオブジェクトとフィールドを作成および変更します
- スマートオブジェクト検索: 部分的な名前一致を使用して Salesforce オブジェクトを検索します
- 詳細なスキーマ情報: あらゆるオブジェクトの包括的なフィールドと関係の詳細を取得します
- 柔軟なデータクエリ: リレーションシップサポートと複雑なフィルターを使用してレコードをクエリします
- データ操作: レコードの挿入、更新、削除、アップサートが簡単に行えます
- クロスオブジェクト検索: SOSL を使用して複数のオブジェクトを検索する
- Apex コード管理: Apex クラスとトリガーの読み取り、作成、更新
- 直感的なエラー処理: Salesforce 固有のエラー詳細による明確なフィードバック
インストール
npm install -g @tsmztech/mcp-server-salesforce
ツール
セールスフォース検索オブジェクト
標準オブジェクトとカスタムオブジェクトを検索します。
- 名前の部分一致による検索
- 標準オブジェクトとカスタムオブジェクトの両方を検索します
- 例: 「Account に関連するオブジェクトを検索」では、Account、AccountHistory などが検索されます。
セールスフォースのオブジェクト記述
詳細なオブジェクト スキーマ情報を取得します。
- フィールド定義とプロパティ
- 関係の詳細
- 選択リストの値
- 例:「アカウントオブジェクトのすべてのフィールドを表示する」
セールスフォースクエリレコード
リレーションシップをサポートするクエリレコード:
- 親子関係
- 子と親の関係
- 複雑なWHERE条件
- 例: 「すべての取引先とそれに関連する連絡先を取得する」
セールスフォース_dml_レコード
データ操作を実行します。
- 新しいレコードを挿入する
- 既存のレコードを更新する
- レコードを削除する
- 外部IDを使用したアップサート
- 例:「複数のアカウントのステータスを更新する」
セールスフォース管理オブジェクト
カスタム オブジェクトを作成および変更します。
- 新しいカスタムオブジェクトを作成する
- オブジェクトのプロパティを更新する
- 共有設定を構成する
- 例:「顧客フィードバックオブジェクトを作成する」
セールスフォース管理フィールド
オブジェクト フィールドを管理します。
- 新しいカスタムフィールドを追加する
- フィールドプロパティを変更する
- 関係を築く
- 例: 「取引先に評価選択リスト項目を追加する」
セールスフォース検索すべて
複数のオブジェクトを検索:
- SOSLベースの検索
- 複数オブジェクトのサポート
- フィールドスニペット
- 例: 「アカウントと商談全体で「クラウド」を検索する」
セールスフォース_読み取り_apex
Apex クラスを読み取ります。
- 特定のクラスの完全なソースコードを取得する
- 名前パターンに一致するクラスを一覧表示する
- クラスのメタデータ（API バージョン、ステータスなど）を表示します
- 名前パターンでのワイルドカード（*と?）のサポート
- 例: 「AccountController クラスを表示」または「Account Contに一致するすべてのクラスを検索」
セールスフォースのApex書き込み
Apex クラスを作成および更新します。
- 新しいApexクラスを作成する
- 既存のクラス実装を更新する
- APIバージョンを指定する
- 例: 「アカウント操作を処理するための新しい Apex クラスを作成する」
セールスフォース読み取りApexトリガー
Apex トリガーを読み取ります。
- 特定のトリガーの完全なソースコードを取得する
- 名前パターンに一致するトリガーを一覧表示する
- トリガーのメタデータ（API バージョン、オブジェクト、ステータスなど）を表示します
- 名前パターンでのワイルドカード（*と?）のサポート
- 例: 「AccountTrigger を表示」または「Contact オブジェクトのすべてのトリガーを検索」
セールスフォースの書き込みApexトリガー
Apex トリガーを作成および更新します。
- 特定のオブジェクトに対して新しいApexトリガーを作成する
- 既存のトリガー実装を更新する
- APIバージョンとイベント操作を指定する
- 例: 「アカウントオブジェクトの新しいトリガーを作成する」または「リードトリガーを更新する」
セールスフォース実行匿名
匿名の Apex コードを実行します。
- 永続クラスを作成せずにApexコードを実行する
- デバッグログと実行結果を表示する
- 他のツールで直接サポートされていないデータ操作に役立ちます
- 例: 「アカウント指標を計算するための Apex コードを実行する」または「関連レコードを更新するスクリプトを実行する」
セールスフォース管理デバッグログ
Salesforce ユーザーのデバッグ ログを管理します。
- 特定のユーザーのデバッグログを有効にする
- アクティブなデバッグログ構成を無効にする
- デバッグログを取得して表示する
- ログ レベルを構成する (NONE、ERROR、WARN、INFO、DEBUG、FINE、FINER、FINEST)
- 例: 「 user@example.comのデバッグログを有効にする」または「管理者ユーザーの最近のログを取得する」
設定
Salesforce認証
次の 2 つの認証方法のいずれかを使用して Salesforce に接続できます。
1. ユーザー名/パスワード認証（デフォルト）
- Salesforceの認証情報を設定する
- セキュリティトークンを取得する（Salesforce設定からリセット）
2. OAuth 2.0 クライアント認証フロー
- Salesforceで接続アプリを作成する
- OAuth設定を有効にし、「クライアント資格情報フロー」を選択します
- 適切なスコープを設定します（通常は「api」で十分です）
- クライアントIDとクライアントシークレットを保存する
- 重要: 認証に必要なインスタンス URL (例:
https://your-domain.my.salesforce.com ) をメモしてください。
Claude Desktopでの使用
claude_desktop_config.jsonに追加します:
ユーザー名/パスワード認証の場合:
{
"mcpServers": {
"salesforce": {
"command": "npx",
"args": ["-y", "@tsmztech/mcp-server-salesforce"],
"env": {
"SALESFORCE_CONNECTION_TYPE": "User_Password",
"SALESFORCE_USERNAME": "your_username",
"SALESFORCE_PASSWORD": "your_password",
"SALESFORCE_TOKEN": "your_security_token",
"SALESFORCE_INSTANCE_URL": "org_url" // Optional. Default value: https://login.salesforce.com
}
}
}
}
OAuth 2.0 クライアント資格情報フローの場合:
{
"mcpServers": {
"salesforce": {
"command": "npx",
"args": ["-y", "@tsmztech/mcp-server-salesforce"],
"env": {
"SALESFORCE_CONNECTION_TYPE": "OAuth_2.0_Client_Credentials",
"SALESFORCE_CLIENT_ID": "your_client_id",
"SALESFORCE_CLIENT_SECRET": "your_client_secret",
"SALESFORCE_INSTANCE_URL": "https://your-domain.my.salesforce.com" // REQUIRED: Must be your exact Salesforce instance URL
}
}
}
}
注：OAuth 2.0クライアント認証情報フローの場合、 SALESFORCE_INSTANCE_URLはSalesforceインスタンスの正確なURL（例：https: https://your-domain.my.salesforce.com ）である必要があります。トークンエンドポイントは<instance_url>/services/oauth2/tokenとして構築されます。
使用例
オブジェクトの検索
"Find all objects related to Accounts"
"Show me objects that handle customer service"
"What objects are available for order management?"
スキーマ情報の取得
"What fields are available in the Account object?"
"Show me the picklist values for Case Status"
"Describe the relationship fields in Opportunity"
レコードのクエリ
"Get all Accounts created this month"
"Show me high-priority Cases with their related Contacts"
"Find all Opportunities over $100k"
カスタムオブジェクトの管理
"Create a Customer Feedback object"
"Add a Rating field to the Feedback object"
"Update sharing settings for the Service Request object"
オブジェクト間の検索
"Search for 'cloud' in Accounts and Opportunities"
"Find mentions of 'network issue' in Cases and Knowledge Articles"
"Search for customer name across all relevant objects"
Apexコードの管理
"Show me all Apex classes with 'Controller' in the name"
"Get the full code for the AccountService class"
"Create a new Apex utility class for handling date operations"
"Update the LeadConverter class to add a new method"
Apexトリガーの管理
"List all triggers for the Account object"
"Show me the code for the ContactTrigger"
"Create a new trigger for the Opportunity object"
"Update the Case trigger to handle after delete events"
匿名Apexコードの実行
"Execute Apex code to calculate account metrics"
"Run a script to update related records"
"Execute a batch job to process large datasets"
デバッグログの管理
"Enable debug logs for user@example.com"
"Retrieve recent logs for an admin user"
"Disable debug logs for a specific user"
"Configure log level to DEBUG for a user"
発達
ソースからのビルド
# Clone the repository
git clone https://github.com/tsmztech/mcp-server-salesforce.git
# Navigate to directory
cd mcp-server-salesforce
# Install dependencies
npm install
# Build the project
npm run build
貢献
貢献を歓迎します！お気軽にプルリクエストを送信してください。
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。
問題とサポート
問題が発生した場合やサポートが必要な場合は、 GitHub リポジトリに問題を報告してください。