Salesforce MCP服务器
MCP（模型上下文协议）服务器实现，将Claude与Salesforce集成在一起，实现了与Salesforce数据和元数据的自然语言交互。此服务器允许Claude使用日常语言查询、修改和管理Salesforce对象和记录。
特性
- 对象和字段管理：使用自然语言创建和修改自定义对象和字段
- 智能对象搜索：使用部分名称匹配查找Salesforce对象
- 详细架构信息：获取任何对象的全面字段和关系详细信息
- 灵活的数据查询：使用关系支持和复杂筛选器查询记录
- 数据操作：轻松插入、更新、删除和追加销售记录
- 跨对象搜索：使用SOSL跨多个对象搜索
- 直观的错误处理：明确反馈Salesforce特定的错误详细信息
安装
npm install -g @surajadsul02/mcp-server-salesforce设置
Salesforce身份验证
您可以使用以下两种方法之一向Salesforce进行身份验证：
1.用户名/密码验证
- 设置您的Salesforce凭据
- 获取您的安全令牌（从Salesforce设置重置）
- 按照配置部分所示配置环境变量
2.使用消费者密钥/秘密的OAuth2身份验证
- 在Salesforce中设置互联应用程序
- 获取消费者密钥和消费者秘密
- 按照配置部分所示配置环境变量
IDE集成
光标IDE设置
- 全局安装软件包：
npm install -g @surajadsul02/mcp-server-salesforce- 在Cursor IDE中配置MCP服务器
.cursor/mcp.json:
使用env命令
{
"mcpServers": {
"salesforce": {
"command": "env",
"args": [
"SALESFORCE_USERNAME=your.actual.email@example.com",
"SALESFORCE_PASSWORD=YourActualPassword123",
"SALESFORCE_TOKEN=YourActualSecurityToken123",
"SALESFORCE_INSTANCE_URL=https://login.salesforce.com",
"npx",
"-y",
"@surajadsul02/mcp-server-salesforce"
]
}
}
}用于游标中的OAuth2身份验证
{
"mcpServers": {
"salesforce": {
"command": "env",
"args": [
"SALESFORCE_USERNAME=your.actual.email@example.com",
"SALESFORCE_PASSWORD=YourActualPassword123",
"SALESFORCE_TOKEN=YourActualSecurityToken123",
"SALESFORCE_INSTANCE_URL=https://login.salesforce.com",
"SALESFORCE_CONSUMER_KEY=YourConsumerKey",
"SALESFORCE_CONSUMER_SECRET=YourConsumerSecret",
"npx",
"-y",
"@surajadsul02/mcp-server-salesforce"
]
}
}
}Claude桌面设置
- 全局安装软件包（如果尚未安装）：
npm install -g @surajadsul02/mcp-server-salesforce- 添加到您的
claude_desktop_config.json:
用于用户名/密码验证
{
"mcpServers": {
"salesforce": {
"command": "npx",
"args": ["-y", "@surajadsul02/mcp-server-salesforce"],
"env": {
"SALESFORCE_USERNAME": "your_username",
"SALESFORCE_PASSWORD": "your_password",
"SALESFORCE_TOKEN": "your_security_token",
"SALESFORCE_INSTANCE_URL": "https://login.salesforce.com"
}
}
}
}对于OAuth2身份验证
{
"mcpServers": {
"salesforce": {
"command": "npx",
"args": ["-y", "@surajadsul02/mcp-server-salesforce"],
"env": {
"SALESFORCE_USERNAME": "your_username",
"SALESFORCE_PASSWORD": "your_password",
"SALESFORCE_CONSUMER_KEY": "your_consumer_key",
"SALESFORCE_CONSUMER_SECRET": "your_consumer_secret",
"SALESFORCE_INSTANCE_URL": "https://login.salesforce.com"
}
}
}
}- 配置文件位置：
- macOS： ~/Library/Application Support/Claude Desktop/claude_desktop_config.json - 窗户： %APPDATA%\Claude Desktop\claude_desktop_config.json - Linux： ~/.config/Claude Desktop/claude_desktop_config.json
所需的环境变量
用户名/密码验证：
SALESFORCE_USERNAME：您的Salesforce用户名/电子邮件SALESFORCE_PASSWORD：您的Salesforce密码SALESFORCE_TOKEN：您的Salesforce安全令牌SALESFORCE_INSTANCE_URL：您的Salesforce实例URL（可选，默认：https://login.salesforce.com)
对于OAuth2身份验证：
SALESFORCE_USERNAME：您的Salesforce用户名/电子邮件SALESFORCE_PASSWORD：您的Salesforce密码SALESFORCE_CONSUMER_KEY：您的互联应用的消费者密钥SALESFORCE_CONSUMER_SECRET：您的互联应用的消费者秘密SALESFORCE_INSTANCE_URL：您的Salesforce实例URL（可选，默认：https://login.salesforce.com)
示例用法
搜索对象
"Find all objects related to Accounts"
"Show me objects that handle customer service"
"What objects are available for order management?"获取架构信息
"What fields are available in the Account object?"
"Show me the picklist values for Case Status"
"Describe the relationship fields in Opportunity"查询记录
"Get all Accounts created this month"
"Show me high-priority Cases with their related Contacts"
"Find all Opportunities over $100k"管理自定义对象
"Create a Customer Feedback object"
"Add a Rating field to the Feedback object"
"Update sharing settings for the Service Request object"跨对象搜索
"Search for 'cloud' in Accounts and Opportunities"
"Find mentions of 'network issue' in Cases and Knowledge Articles"
"Search for customer name across all relevant objects"发展
从源头构建
# Clone the repository
git clone https://github.com/surajadsul02/mcp-server-salesforce.git
# Navigate to directory
cd mcp-server-salesforce
# Install dependencies
npm install
# Build the project
npm run build故障排除
- 身份验证错误
- 验证您的凭据是否正确 - 对于用户名/密码身份验证：确保安全令牌正确 - 对于OAuth2：验证消费者密钥和机密
- 连接问题
- 检查您的Salesforce实例URL - 验证网络连接 - 确保正确的API访问权限
- 游标IDE集成
- 配置更改后重新启动Cursor IDE - 检查开发人员工具（帮助>切换开发人员工具）以获取错误消息 - 验证该包是否已全局安装
- Claude桌面集成
- 验证配置文件位置 - 检查文件权限 - 配置更改后重新启动Claude Desktop - 确保环境变量设置正确
贡献
欢迎投稿！请随时提交Pull Request。
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
问题和支持
如果您遇到任何问题或需要支持，请在GitHub存储库上提交问题。