Salesforce MCP Sample Integration

Salesforce MCP 示例集成

本项目提供了一个使用 Model Context Protocol（MCP）与 Salesforce 集成的基础示例。它支持通过 MCP 工具与 Salesforce 的功能交互，例如发送电子邮件和部署 Apex 代码。

先决条件

• 已安装 Node.js 和 npm（或 yarn）。
• 拥有一个可创建 Connected App 的 Salesforce 组织。

设置

1. 安装依赖项：

   npm install
   # or
   yarn install
   

2. 配置 Salesforce 凭据：

   • 必须在 utils 文件夹中创建 credentials.js 文件（./utils/credentials.js）。
   • 此文件需要导出一个函数 getSalesforceCredentials()，该函数会返回 JWT Bearer Flow 身份验证所需的 Salesforce 连接详情。
   • 重要： 请确保已在 Salesforce 中配置 Connected App以进行 JWT 身份验证，并允许相应的作用域，同时预先授权相关用户配置文件。

   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("Missing required Salesforce credentials in utils/credentials.js");
       }
   
       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

更高画质的视频。