MCP Salesforce Example

🚀 Salesforce MCP 示例集成

このプロジェクトは、モデルコンテキストプロトコル（MCP）を使用してSalesforceと統合する基本的なサンプルを提供します。MCPツールを通じて、Salesforceの機能（電子メールの送信やApexコードのデプロイなど）とやり取りできます。

🚀 クイックスタート

✨ 主な機能

• モデルコンテキストプロトコル（MCP）を使用してSalesforceとの統合を可能にする。
• MCPツールを通じて、Salesforceの機能（電子メールの送信やApexコードのデプロイなど）を操作できる。

📦 インストール

前提条件

• Node.jsとnpm（またはyarn）がインストールされていること。
• Salesforce組織で、接続アプリを作成できるユーザーが設定されていること。

手順

1. 依存関係のインストール

   npm install
   # または
   yarn install
   

2. Salesforceの認証情報を設定する

   • utilsフォルダ内にcredentials.jsという名前のファイル（パスは./utils/credentials.js）を作成する必要があります。
   • このファイルは、JWTBearer Flow認証に使用するSalesforceの接続詳細を返すgetSalesforceCredentials()関数をエクスポートする必要があります。
   • 重要：Salesforceで接続アプリを設定し、適切なスコープを有効にし、関連するユーザープロファイルを事前承認してください。

   utils/credentials.jsの例：

   import fs from 'fs';
   import path from 'path';
   // これらの情報は、環境変数や設定ファイルなどから読み込むことができます。
   
   export function getSalesforceCredentials() {
       // --- ここに、認証情報を安全に読み込むロジックを実装します ---
       const loginUrl = "YOUR_SALESFORCE_LOGIN_URL"; // 例: https://login.salesforce.com または https://yourdomain.my.salesforce.com
       const username = "YOUR_SALESFORCE_USERNAME";
       const clientId = "YOUR_CONNECTED_APP_CONSUMER_KEY";
       // JWTアサーションの署名に使用する秘密鍵を読み込む
       // 秘密鍵の形式が正しいことを確認してください。BEGIN/END行を含めます。
       const privateKey = fs.readFileSync(path.resolve(__dirname, 'path/to/your/server.key'), 'utf8'); 
       // 例: const privateKey = process.env.SF_PRIVATE_KEY;
   
       if (!loginUrl || !username || !clientId || !privateKey) {
            throw new Error("utils/credentials.jsにSalesforceの認証情報が不足しています");
       }
   
       return {
           loginUrl,
           username,
           clientId,
           privateKey
       };
   }
   

3. 設定ファイルを設定する

   • このリポジトリには、claude_desktop_config.jsonという名前のサンプル設定ファイルが含まれており、MCPサーバーを設定するために使用できます。
   • このファイル内のパスと認証情報を、環境設定に合わせて更新してください。

💻 使用例

基本的な使用法

サーバーを起動するには、以下のコマンドを実行します。

node server.js

サンプルデモ

• https://github.com/user-attachments/assets/08c8015a-bc57-4c5e-9f3d-4a9d9d310f4c
• 高画質のビデオ