MCP提交

Agentforce (Salesforce)

一个与Salesforce Agentforce API交互的MCP服务器，提供认证、会话管理和消息传递功能。

客户支持开发者工具 #Salesforce集成 #会话管理 #消息传递 #API代理 .Python

2.5分

2025-04-28 10:43:44

概述

安装

内容详情

替代品

什么是Agentforce MCP服务器？

Agentforce MCP服务器是一款专为与Salesforce Agentforce API集成而设计的工具。它允许您通过简单的设置流程实现身份验证、创建会话并发送消息给Agentforce代理。

如何使用Agentforce MCP服务器？

只需几个简单的步骤即可完成安装和配置。您可以使用我们的交互式脚本快速启动服务器，或者手动设置环境变量并运行脚本。

适用场景

Agentforce MCP服务器非常适合需要实时与Salesforce代理通信的企业客户，例如客服中心或技术支持团队。

主要功能

身份验证使用客户端邮箱进行身份验证，确保您的账户安全。

创建会话为指定的代理创建一个新会话，并管理其状态。

发送消息向代理发送自定义消息，并接收他们的回复。

获取会话状态检查当前会话的状态，包括身份验证状态、会话ID和序列ID。

完整对话流程自动执行身份验证、会话创建和消息发送的整个流程。

优势与局限性

优势

易于使用且无需复杂配置

支持多客户端并发处理

全面的日志记录便于调试

局限性

需要稳定的网络连接

对Salesforce权限设置有一定依赖

如何使用

安装依赖首先确保已安装Python 3.10及以上版本，并通过pip安装所需的依赖项。

配置环境变量复制.env.example文件为.env，并填写您的Salesforce凭据。

运行服务器赋予脚本执行权限后，直接运行server脚本。

使用案例

身份验证测试尝试使用特定客户端邮箱进行身份验证。

发送消息到代理向代理发送一条问候消息并等待响应。

常见问题

如何找到我的Salesforce Org ID？登录到您的Salesforce实例，导航至“公司信息”页面，在“组织ID”字段中查找您的Org ID。

如果遇到身份验证失败怎么办？请确认您的Connected App设置是否正确，并检查Client ID和Secret是否匹配。

服务器支持哪些操作系统？Agentforce MCP服务器可以在Windows、macOS和Linux上运行。

Agentforce代理服务器指南

环境变量配置

要配置环境变量，请按照以下步骤操作：

打开终端
运行命令：source ~/.bash_profile

GitHub 推送脚本使用说明

为了简化将更改推送到GitHub的过程，我们提供了一个方便的脚本。请按以下步骤操作：

赋予脚本执行权限：
```
chmod +x github_push.sh
```
执行脚本：
```
./github_push.sh
```

该脚本将执行以下操作：

检查系统是否已安装Git
确保敏感文件（如.env）不会被推送到GitHub（这些文件已添加到.gitignore）
提示用户输入GitHub仓库URL
初始化Git仓库或更新远程仓库URL
显示要提交的文件供用户确认
自动生成提交消息并推送更改

详细步骤说明

创建Connected App

使用管理员账户登录Salesforce组织
进入设置
在快速搜索栏中输入"App Manager"并点击进入
点击新建连接应用
填写基本信息：
- 应用程序名称：例如 "Agentforce MCP集成"
- API名称：将自动填充
- 联系邮箱：填写您的邮箱地址
启用OAuth设置选项
设置回调URL为https://localhost/oauth/callback
在选择的OAuth范围中，添加：
- 管理用户数据（api）
- 任何时间执行请求（refresh_token, offline_access）
点击保存
在连接应用详情页面记录消费者密钥(Client ID)
点击显示旁边的消费者秘密(Consumer Secret)以获取客户端密码

获取代理ID

登录Salesforce组织
导航至Einstein Agent Builder
选择要使用的代理
查看浏览器地址栏中的URL，格式为https://your-salesforce-instance.lightning.force.com/lightning/r/Agent__c/0XxXXXXXXXXXXXXX/view
提取18位字符ID（如 0XxXXXXXXXXXXXXX）作为代理ID

获取Salesforce My Domain URL

登录Salesforce组织
进入设置
在快速搜索栏中输入"My Domain"并点击进入
查看显示的域名格式为DOMAIN-NAME.my.salesforce.com
将此URL（不带"https://”前缀）用于.env文件

获取组织ID

登录Salesforce组织
进入设置
在快速搜索栏中输入"公司信息"并点击进入
查看"组织ID"字段，这是您的 Salesforce 组织ID
它将是一个15或18位的字符编码

注意事项

服务器自动管理消息交换的序列号
每个电子邮件地址维护身份验证和会话状态
所有API交互都会记录以备调试使用

故障排除

遇到问题时，请检查以下内容：

认证失败：确认连接应用设置无误
代理ID获取错误：检查Einstein Agent Builder中的URL
组织ID错误：在公司信息页面核对
回调URL问题：确保设置了正确的本地回拨地址

脚本示例

配置文件路径示例

# 设置代理服务器路径
export AGENTFORCE_HOME=/path/to/agentforce-server

# 设置运行环境
export ENV=development

# 启动服务器
$AGENTFORCE_HOME/bin/start.sh

使用github_push.sh脚本

执行命令赋予权限：
```
chmod +x github_push.sh
```
运行脚本：
```
./github_push.sh
```

按照提示输入GitHub仓库URL后，脚本会自动处理其余步骤。

完整指南

1. 环境准备

操作系统：Linux/MacOS/Windows（推荐使用Linux或 MacOS）
Java版本：JDK 8 或更高版本
Git工具：建议安装Git for Windows（若在Windows上）

2. 安装步骤

下载源码

git clone https://github.com/agentforce/server.git
cd server

配置环境变量

编辑~/.bash_profile文件，添加以下内容：

export AGENTFORCE_HOME=$(pwd)
source ~/.bash_profile

依赖安装

进入项目目录后运行：

mvn clean install

3. 运行指南

启动服务器：

cd $AGENTFORCE_HOME/bin
./start.sh

停止服务器：

cd $AGENTFORCE_HOME/bin
./stop.sh

4. 其他工具使用说明

使用github_push.sh脚本

该脚本帮助将本地仓库推送到GitHub，特别适合新项目初始化。

操作步骤：

将脚本添加到项目根目录：

wget https://raw.githubusercontent.com/agentforce/server/master/bin/github_push.sh

赋予执行权限并运行：

chmod +x github_push.sh
./github_push.sh

参数说明：

该脚本无需额外参数，自动检测Git配置。
提示输入仓库URL后自动完成推送。

5. 常见问题解答

Q: 如何处理SSH连接问题？

A: 确保本地已生成SSH密钥，并添加到GitHub的SSH Keys设置中。运行以下命令测试：

ssh -T git@github.com

Q: 推送失败怎么办？

A: 检查网络连接，确认仓库URL正确，然后重新运行脚本。

6. 完整示例

# 下载源码
git clone https://github.com/agentforce/server.git
cd server

# 配置环境变量
echo 'export AGENTFORCE_HOME=$(pwd)' >> ~/.bash_profile
source ~/.bash_profile

# 安装依赖
mvn clean install

# 启动服务器
cd $AGENTFORCE_HOME/bin
./start.sh