AI导哈

Salesforce数据查询服务

该项目实现了一个与Salesforce集成的模型上下文协议（MCP）服务器，允许Claude Desktop查询Salesforce组织中的账户信息。

  • by syafiq555
  • 本地部署
  • 更新于
在 GitHub 查看 syafiq555/salesforce-mcp-server

使用说明

Salesforce MCP服务器

该项目实现了一个与Salesforce集成的模型上下文协议（MCP）服务器，允许Claude Desktop与Salesforce数据进行交互。目前，它支持从Salesforce组织查询帐户信息。

先决条件

  • Node.js v16或更高版本
  • Salesforce命令行界面（sf）
  • Claude桌面应用程序
  • 访问Salesforce组织（沙盒或生产）

安装

  1. 克隆存储库：
git clone [repository-url]
cd salesforce-mcp-server
  1. 安装依赖项：
npm install
  1. 创建一个 .env 项目根目录中的文件：
SF_LOGIN_URL=https://test.salesforce.com
SF_API_VERSION=59.0
SF_ORG_ALIAS=your-sandbox-alias
  1. 使用Salesforce进行身份验证：
# Login to your sandbox
sf org login web --alias your-sandbox-alias --instance-url https://test.salesforce.com

配置

配置Claude桌面

  1. 打开Claude Desktop配置文件：
# On Windows
code "%APPDATA%\Claude\claude_desktop_config.json"

# On macOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
  1. 添加以下配置：
{
  "mcpServers": {
    "salesforce": {
      "command": "npm",
      "args": ["run", "dev"],
      "cwd": "path/to/your/salesforce-mcp-server"
    }
  }
}

替换 path/to/your/salesforce-mcp-server 带有项目目录的实际路径。

运行服务器

  1. 启动服务器：
npm run dev
  1. 打开克劳德桌面
  2. 寻找“⚡“右下角的按钮
  3. 点击它通过MCP服务器访问Salesforce数据

可用特征

资源

  • accounts/list：返回Salesforce帐户列表

工具

  • refresh_accounts：手动刷新帐户数据

发展

项目结构

salesforce-mcp-server/
├── src/
│   └── index.ts         # Main server implementation
├── package.json         # Project dependencies and scripts
├── tsconfig.json        # TypeScript configuration
├── .env                 # Environment variables
└── README.md           # This file

脚本

  • npm run dev：以开发模式启动服务器
  • npm run build：构建TypeScript代码
  • npm start：运行构建版本
  • npm run clean：清理构建目录

故障排除

常见问题

  1. 连接问题：

    • 使用验证Salesforce身份验证 sf org display
    • 检查Claude Desktop配置路径是否正确
    • 确保.env文件具有正确的值

  2. 身份验证问题：

    • 使用Salesforce重新进行身份验证 sf org login web
    • 验证.env中的组织别名是否与经过身份验证的组织匹配

  3. 服务器问题：

    • 检查克劳德桌面日志：
      # On Windows
type "%APPDATA%\Claude\logs\claude\mcp.log"

# On macOS
tail -f ~/Library/Logs/Claude/mcp.log

许可证

[您的许可证]

贡献

  1. 分叉存储库
  2. 创建功能分支
  3. 提交您的更改
  4. 推到分支
  5. 创建新的Pull请求

相关 MCP