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ライセンス

貢献

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