金大哥 - Agentforce (Salesforce) MCP 详情

article

README

🚀 Agentforce代理服务器指南

Agentforce代理服务器指南旨在帮助用户完成环境变量配置、GitHub推送脚本使用、Salesforce相关信息获取等操作，以顺利部署和使用代理服务器。

🚀 快速开始

环境准备

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

下载源码

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

配置环境变量

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

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

依赖安装

进入项目目录后运行：

mvn clean install

启动服务器

cd $AGENTFORCE_HOME/bin
./start.sh

停止服务器

cd $AGENTFORCE_HOME/bin
./stop.sh

✨ 主要特性

提供环境变量配置和GitHub推送脚本，简化操作流程。
自动管理消息交换的序列号，维护每个电子邮件地址的身份验证和会话状态。
记录所有API交互，方便调试。

📦 安装指南

环境变量配置

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

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

下载与依赖安装

下载源码：

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

配置环境变量：编辑~/.bash_profile文件，添加以下内容：

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

依赖安装：

mvn clean install

💻 使用示例

基础用法

使用github_push.sh脚本

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

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

赋予执行权限并运行：

chmod +x github_push.sh
./github_push.sh

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

高级用法

配置文件路径示例

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

# 设置运行环境
export ENV=development

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

📚 详细文档

创建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交互都会记录以备调试使用。

GitHub推送脚本

该脚本将执行以下操作：

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

📄 许可证

文档中未提及相关许可证信息。

⚠️ 注意事项

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

💡 使用建议

故障排除

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

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

常见问题解答

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

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

ssh -T git@github.com

Q: 推送失败怎么办？

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

完整示例

# 下载源码
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

运行以上命令后，您将成功部署并启动Agentforce代理服务器。

Agentforce (Salesforce)