MCP Salesforce Example

🚀 Salesforce MCP 示例集成

本項目提供了一個基礎示例，展示如何運用模型上下文協議（MCP）與 Salesforce 進行集成。藉助 MCP 工具，用戶能夠與 Salesforce 的功能進行交互，例如發送電子郵件以及部署 Apex 代碼。

🚀 快速開始

先決條件

• 已安裝 Node.js 和 npm（或 yarn）。
• 在 Salesforce 組織中配置了一個可用於創建連接應用的用戶。

設置

1. 安裝依賴

   npm install
   # 或者
   yarn install
   

2. 配置 Salesforce 憑證

   • 您需要在 utils 文件夾內創建一個名為 credentials.js 的文件（路徑為 ./utils/credentials.js）。
   • 此文件需導出一個函數 getSalesforceCredentials()，該函數返回用於 JWT Bearer Flow 身份驗證的 Salesforce 連接詳細信息。

   ⚠️ 重要提示

   請確保在 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
• 更高質量的視頻。