Salesforce CLI Connect MCP

Salesforce CLI连接MCP

一个模型上下文协议（MCP）服务器，它提供了一个用户友好的设置向导，用于通过Salesforce CLI将Claude Desktop连接到Salesforce。

概述

此MCP服务器充当设置助手，指导非技术用户连接到Salesforce。它处理：

1. ✅ 检查Salesforce CLI安装
2. ✅ 如果需要，安装Salesforce CLI
3. ✅ 打开浏览器进行安全的OAuth身份验证
4. ✅ 验证连接
5. ✅ 提供清晰的重启说明

不需要技术知识——用户只需让Claude“帮助我连接到Salesforce”，安装向导就会引导他们完成整个过程。

特性

• 自动安装：安装Salesforce CLI（如果尚未安装）
• 基于浏览器的登录：通过默认浏览器保护OAuth流
• 无纯文本凭据：所有凭据都通过Salesforce CLI安全存储
• 个人用户身份验证：每个用户都使用自己的Salesforce帐户进行身份验证
• 可配置的：支持任何Salesforce实例URL
• 交叉平台的：适用于Windows、macOS和Linux

面向IT管理员

快速开始

1. 全局安装软件包（可选）:

   npm install -g @digitalrupix/connect-to-salesforce-mcp

1. 部署Claude Desktop配置 用户的机器：

- 苹果电脑: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%\Claude\claude_desktop_config.json - Linux: ~/.config/Claude/claude_desktop_config.json

1. 配置文件:

{
  "mcpServers": {
    "connect-to-salesforce": {
      "command": "npx",
      "args": ["-y", "@digitalrupix/connect-to-salesforce-mcp"],
      "env": {
        "SALESFORCE_INSTANCE_URL": "https://your-org.my.salesforce.com",
        "SALESFORCE_ORG_ALIAS": "mcp-server-connect"
      }
    },
    "salesforce": {
      "command": "npx",
      "args": ["-y", "@tsmztech/mcp-server-salesforce"],
      "env": {
        "SALESFORCE_CONNECTION_TYPE": "Salesforce_CLI",
        "SALESFORCE_INSTANCE_URL": "https://your-org.my.salesforce.com"
      }
    }
  }
}

1. 指示用户 致：

- 打开克劳德桌面 - 类型：“帮助我设置Salesforce”或“连接到Salesforce” - 按照屏幕上的说明进行操作 - 出现提示时重新启动Claude Desktop

就是这样！最终用户不需要手动CLI命令或配置文件编辑。

配置选项

重要说明

• 两台MCP服务器（连接到salesforce和salesforces）都应使用 相同 SALESFORCE_INSTANCE_URL
• 安装MCP和Salesforce MCP配置之间的组织别名必须匹配
• 用户需要在他们的机器上安装Node.js和npm

面向最终用户

安装说明

1. 打开克劳德桌面
2. 问克劳德： “帮我设置Salesforce” 或 “连接到Salesforce”
3. Claude将指导您完成设置过程
4. 浏览器窗口将打开，供您登录Salesforce
5. 成功登录后，完全关闭并重新打开Claude Desktop
6. 您已准备好与Claude一起使用Salesforce！

安装什么

• Salesforce命令行界面：一个安全存储Salesforce凭据的命令行工具
• 组织连接：您的连接已使用别名保存 mcp-server-connect （或IT设置的自定义别名）

如何重新启动克劳德桌面

• 苹果电脑：新闻 Cmd+Q 要退出，请重新打开Claude Desktop
• 视窗：右键单击任务栏中的Claude图标→ “关闭窗口”，然后重新打开
• Linux：从菜单中选择“退出”，然后重新打开

与Claude一起使用Salesforce

设置完成后，您可以向Claude询问以下问题：

• “我的Salesforce组织中有多少个帐户？”
• “显示本月创造的所有机会”
• “查找名为John的联系人”
• “为Acme Corp创建新帐户”
• “更新案例00012345的状态”

技术细节

需求

• Node.js 18.0.0或更高版本
• NPM（附带Node.js）
• 克劳德桌面
• 具有适当权限的活动Salesforce帐户

运作原理

1. MCP服务器检查是否安装了Salesforce CLI
2. 如果没有安装，它会通过npm自动安装
3. 跑 sf org login web 这将打开您的浏览器进行安全的OAuth身份验证
4. 通过检查组织状态来验证连接
5. 通过Salesforce CLI安全地存储凭据（非纯文本）

认证方式

此工具使用 Salesforce CLI OAuth （基于浏览器的身份验证）：

• 打开Salesforce登录页面的默认浏览器
• 使用OAuth 2.0授权代码流
• Salesforce CLI安全地存储凭据
• 每个用户都使用自己的帐户进行身份验证
• 配置文件中未存储密码

安全

• ✅ 凭据从不以纯文本形式存储
• ✅ 身份验证使用Salesforce的OAuth流
• ✅ 由Salesforce CLI的安全存储管理的凭据
• ✅ 每个用户都使用自己的Salesforce帐户进行身份验证
• ✅ 没有共享服务帐户

故障排除

“安装失败”消息

如果安装失败，请尝试以下步骤：

1. 完全关闭克劳德桌面
2. 打开终端/命令提示符
3. 运行： npm install -g @salesforce/cli
4. 运行： sf org login web --instance-url https://your-org.my.salesforce.com --alias mcp-server-connect
5. 重新启动克劳德桌面

浏览器无法打开

• 检查默认浏览器设置
• 尝试在步骤4中运行上述手动命令
• 确保弹出窗口未被阻止
• 如果问题仍然存在，请联系您的IT管理员

重新启动后连接不起作用

• 确保您完全退出Claude Desktop（而不仅仅是关闭窗口）
• 通过运行以下命令验证组织别名： sf org list
• 你应该看看 mcp-server-connect 在列表中
• 检查配置中的实例URL是否与Salesforce组织匹配

“JSON无效”错误

这通常意味着版本不匹配。尝试：

1. 更新Salesforce CLI： npm install -g @salesforce/cli@latest
2. 重新启动克劳德桌面
3. 再次运行安装程序

安装过程中出现权限错误

在某些系统上，您可能需要管理员权限：

• 视窗：以管理员身份运行命令提示符
• Mac/Linux：使用 sudo npm install -g @salesforce/cli

发展

局部测试

# Clone the repository
git clone https://github.com/jake-hebert/connect-to-salesforce-mcp.git
cd connect-to-salesforce-mcp

# Install dependencies
npm install

# Test locally by adding to Claude Desktop config:
{
  "mcpServers": {
    "connect-to-salesforce-local": {
      "command": "node",
      "args": ["/absolute/path/to/index.js"],
      "env": {
        "SALESFORCE_INSTANCE_URL": "https://your-org.my.salesforce.com",
        "SALESFORCE_ORG_ALIAS": "mcp-server-connect"
      }
    }
  }
}

发布更新

# Update version in package.json
npm version patch  # or minor, major

# Publish to npm
npm publish --access public

贡献

欢迎投稿！请随时提交拉取请求。

支持

技术支持：

• 联系您的IT管理员
• 在
• 检查 Salesforce MCP文档

相关项目

• Salesforce MCP服务器 -Salesforce运营的主MCP服务器
• 模型上下文协议 -MCP标准文件

许可证

麻省理工学院

更新日志

v1.0.0

• 初始版本
• Salesforce CLI自动安装
• 基于浏览器的OAuth身份验证
• 连接验证
• 跨平台支持（Windows、macOS、Linux）