Salesforce MCP統合
このプロジェクトは、Salesforce 統合用のモデル コンテキスト プロトコル (MCP) サーバーを提供し、SOQL クエリを実行し、標準化されたインターフェースを介して Salesforce データと対話できるようにします。
特徴
環境変数を使用して Salesforce 組織に接続する
Salesforce データに対して SOQL クエリを実行する
Salesforceレコードを取得して処理する
環境変数を使用した安全な資格情報管理
Related MCP server: MCP Salesforce Connector
前提条件
Node.js (v14以上)
npm (ノード パッケージ マネージャー)
APIアクセスを備えたSalesforce組織
Salesforce の資格情報 (ユーザー名、パスワード、セキュリティ トークン)
インストール
このリポジトリをクローンします:
git clone <repository-url> cd <repository-directory>依存関係をインストールします:
npm installSalesforce 資格情報を使用して、ルート ディレクトリに
.envファイルを作成します。SF_LOGIN_URL=https://your-instance.salesforce.com/ SF_USERNAME=your_username SF_PASSWORD=your_password SF_SECURITY_TOKEN=your_security_token PORT=3000注: サンドボックス環境の場合は、ログイン URL として
https://test.salesforce.com/使用します。
使用法
MCPサーバーの起動
Node.js を使用してサーバーを実行します。
サーバーは、 .envファイル内の資格情報を使用して Salesforce に接続し、MCP リクエストのリッスンを開始します。
SOQLクエリの実行
サーバーが起動したら、MCPインターフェースを介してSOQLクエリを実行できます。サーバーは、SOQLクエリを受け入れて結果を返すsoqlQueryツールを提供します。
SOQL クエリの例:
プロジェクト構造
server.js- メインMCPサーバーの実装.env- Salesforce 資格情報の環境変数package.json- プロジェクトの依存関係とスクリプト
セキュリティに関する考慮事項
.envファイルをバージョン管理にコミットしないでください.gitignoreファイルに.envを追加しますすべての機密情報に環境変数を使用する
実稼働環境ではより安全な認証方法の使用を検討してください
トラブルシューティング
接続の問題
接続の問題が発生した場合:
.envファイルで Salesforce の資格情報を確認しますSalesforce組織にアクセスできることを確認する
IP アドレスが Salesforce のホワイトリストに登録されていることを確認します (必要な場合)
Salesforce ユーザーに API アクセス権があることを確認する
クエリエラー
SOQL クエリが失敗した場合:
SOQL構文を確認する
オブジェクトとフィールドが組織内に存在することを確認します
ユーザーがオブジェクトとフィールドにアクセスする権限を持っていることを確認します
ライセンス
貢献
貢献を歓迎します！お気軽にプルリクエストを送信してください。