🚀 Salesforce MCP 服务器

这是一个将 Claude 集成到 Salesforce 中的 MCP（模型上下文协议）服务器实现。借助该服务器，您能够通过自然语言与 Salesforce 的数据和元数据进行交互，Claude 可以使用日常语言对 Salesforce 数据进行查询、修改和管理。

🚀 快速开始

您可以按照以下步骤完成服务器的安装和配置，开启使用之旅。

📦 安装指南

# 克隆仓库
git clone https://github.com/surajadsul02/mcp-server-salesforce.git

# 进入目录
cd mcp-server-salesforce

# 安装依赖项
npm install

# 构建项目
npm run build

📚 详细文档

设置

环境变量配置

使用用户名/密码认证：

• SALESFORCE_USERNAME：您的 Salesforce 用户名或电子邮件
• SALESFORCE_PASSWORD：您的 Salesforce 密码
• SALESFORCE_TOKEN：您的 Salesforce 安全令牌
• SALESFORCE_INSTANCE_URL：默认为 https://login.salesforce.com

使用 OAuth2 认证：

• SALESFORCE_USERNAME：您的 Salesforce 用户名或电子邮件
• SALESFORCE_PASSWORD：您的 Salesforce 密码
• SALESFORCE_CONSUMER_KEY：连接应用的消费者密钥
• SALESFORCE_CONSUMER_SECRET：连接应用的消费者秘密
• SALESFORCE_INSTANCE_URL：默认为 https://login.salesforce.com

💻 使用示例

基础用法

搜索对象

"查找所有与 Account 相关的对象"
"显示处理客户支持的对象"
"有哪些可用于订单管理的对象？"

获取架构信息

"Account 对象有哪些可用字段？"
"显示 Case 状态的下拉列表值"
"描述 Opportunity 的关系字段"

查询记录

"获取本月创建的所有 Account"
"显示高优先级的 Cases 及其相关联系人"
"查找所有金额超过 10 万美元的 Opportunities"

管理自定义对象

"创建一个客户反馈对象"
"在反馈对象中添加评分字段"
"更新服务请求对象的共享设置"

跨对象搜索

"在 Account 和 Opportunity 中查找 'cloud'"
"在 Cases 和知识文章中查找 '网络问题'"
"在所有相关对象中搜索客户名称"

高级用法

从源代码构建

# 克隆仓库
git clone https://github.com/surajadsul02/mcp-server-salesforce.git

# 进入目录
cd mcp-server-salesforce

# 安装依赖项
npm install

# 构建项目
npm run build

🔧 技术细节

故障排除

1. 认证错误

   • 验证您的凭证是否正确
   • 使用用户名/密码认证：确保安全令牌正确
   • 使用 OAuth2：验证消费者密钥和秘密

2. 连接问题

   • 检查 Salesforce 实例 URL
   • 确保网络连接正常
   • 确保正确的 API 访问权限

3. Cursor IDE 集成

   • 在配置更改后重新启动 Cursor IDE
   • 使用开发者工具检查错误信息（帮助 > 切换开发者工具）
   • 确认包已全局安装

4. Claude Desktop 集成

   • 验证配置文件位置
   • 检查文件权限
   • 在配置更改后重新启动 Claude Desktop
   • 确保环境变量正确设置

🤝 贡献

欢迎贡献！随时提交 Pull Request。

📄 许可证

此项目 licensed under MIT License，具体内容请参阅 LICENSE 文件。

❓ 问题与支持

如遇任何问题或需要支持，请在 GitHub 仓库中提交问题。