Salesforce MCP Integration

Salesforce MCP統合

このプロジェクトは、Salesforce 統合用のモデル コンテキスト プロトコル (MCP) サーバーを提供し、SOQL クエリを実行し、標準化されたインターフェースを介して Salesforce データと対話できるようにします。

特徴

• 環境変数を使用して Salesforce 組織に接続する
• Salesforce データに対して SOQL クエリを実行する
• Salesforceレコードを取得して処理する
• 環境変数を使用した安全な資格情報管理

前提条件

• Node.js (v14以上)
• npm (ノード パッケージ マネージャー)
• APIアクセスを備えたSalesforce組織
• Salesforce の資格情報 (ユーザー名、パスワード、セキュリティ トークン)

インストール

1. このリポジトリをクローンします:
   git clone <repository-url> cd <repository-directory>
2. 依存関係をインストールします:
   npm install
3. Salesforce 資格情報を使用して、ルート ディレクトリに.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を追加します
• すべての機密情報に環境変数を使用する
• 実稼働環境ではより安全な認証方法の使用を検討してください

トラブルシューティング

接続の問題

接続の問題が発生した場合:

1. .envファイルで Salesforce の資格情報を確認します
2. Salesforce組織にアクセスできることを確認する
3. IP アドレスが Salesforce のホワイトリストに登録されていることを確認します (必要な場合)
4. Salesforce ユーザーに API アクセス権があることを確認する

クエリエラー

SOQL クエリが失敗した場合:

1. SOQL構文を確認する
2. オブジェクトとフィールドが組織内に存在することを確認します
3. ユーザーがオブジェクトとフィールドにアクセスする権限を持っていることを確認します

ライセンス

MITライセンス

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。