关于 Salesforce MCP Server
Salesforce MCP Server 是一个基于 jsforce 通过 REST API 访问 Salesforce 的 MCP 服务。它面向需要让 AI 查询和维护 Salesforce 数据的开发者与团队,支持通过 Smithery 安装到 Claude Desktop。
主要功能
- 01执行 SOQL 查询
- 02获取对象元数据
- 03创建、更新和删除记录
- 04安全的身份验证处理
- 05实时数据访问
适用场景
- 01让 AI 助手查询 Salesforce 账户和联系人数据
- 02通过 MCP 客户端读取 Salesforce 对象结构
- 03在对话中创建或更新 Salesforce 记录
MCP 相关
该项目是一个 MCP 服务,向 MCP 客户端暴露 query、describe-object、create、update 和 delete 等工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
Salesforce MCP 服务
这是一个 Model Context Protocol 服务实现,使用 jsforce 通过 REST API 与 Salesforce 交互。
通过 Smithery 安装
要通过 Smithery 自动为 Claude Desktop 安装 Salesforce 服务:
npx -y @smithery/cli install salesforce-mcp-server --client claude
功能
- 执行 SOQL 查询
- 获取对象元数据
- 创建、更新和删除记录
- 安全地处理身份验证
- 实时访问数据
设置
- 克隆仓库
- 将
.env.example复制为.env,并填写 Salesforce 凭据 - 安装依赖项:
npm install - 构建:
npm run build - 启动:
npm start
用法
该服务提供多个函数:
query
对 Salesforce 实例执行 SOQL 查询:
{
"name": "query",
"parameters": {
"query": "SELECT Id, Name FROM Account LIMIT 5"
}
}
describe-object
获取 Salesforce 对象的元数据:
{
"name": "describe-object",
"parameters": {
"objectName": "Account"
}
}
create
创建新记录:
{
"name": "create",
"parameters": {
"objectName": "Contact",
"data": {
"FirstName": "John",
"LastName": "Doe",
"Email": "[email protected]"
}
}
}
update
更新现有记录:
{
"name": "update",
"parameters": {
"objectName": "Contact",
"data": {
"Id": "003XXXXXXXXXXXXXXX",
"Email": "[email protected]"
}
}
}
delete
删除记录:
{
"name": "delete",
"parameters": {
"objectName": "Contact",
"id": "003XXXXXXXXXXXXXXX"
}
}
运行 evals
evals 软件包会加载一个 MCP 客户端,然后运行 index.ts 文件,因此无需在测试之间重新构建。你可以在 npx 命令前添加环境变量来加载它们。完整文档请见此处。
OPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/tools.ts
安全
请务必:
- 妥善保管
.env文件,切勿提交 - 尽可能在 Salesforce 中使用 IP 限制
- 定期轮换安全令牌
- 考虑为 MCP 服务实现额外的身份验证
贡献
欢迎贡献!请提交改进内容的 PR。
Salesforce MCP 服务
这是一个 Model Context Protocol 服务实现,使用 jsforce 通过 REST API 与 Salesforce 交互。
通过 Smithery 安装
要通过 Smithery 自动为 Claude Desktop 安装 Salesforce 服务:
npx -y @smithery/cli install salesforce-mcp-server --client claude
功能
- 执行 SOQL 查询
- 获取对象元数据
- 创建、更新和删除记录
- 安全地处理身份验证
- 实时访问数据
设置
- 克隆仓库
- 将
.env.example复制为.env,并填写 Salesforce 凭据 - 安装依赖项:
npm install - 构建:
npm run build - 启动:
npm start
用法
该服务提供多个函数:
query
对 Salesforce 实例执行 SOQL 查询:
{
"name": "query",
"parameters": {
"query": "SELECT Id, Name FROM Account LIMIT 5"
}
}
describe-object
获取 Salesforce 对象的元数据:
{
"name": "describe-object",
"parameters": {
"objectName": "Account"
}
}
create
创建新记录:
{
"name": "create",
"parameters": {
"objectName": "Contact",
"data": {
"FirstName": "John",
"LastName": "Doe",
"Email": "[email protected]"
}
}
}
update
更新现有记录:
{
"name": "update",
"parameters": {
"objectName": "Contact",
"data": {
"Id": "003XXXXXXXXXXXXXXX",
"Email": "[email protected]"
}
}
}
delete
删除记录:
{
"name": "delete",
"parameters": {
"objectName": "Contact",
"id": "003XXXXXXXXXXXXXXX"
}
}
安全
请务必:
- 妥善保管
.env文件,切勿提交 - 尽可能在 Salesforce 中使用 IP 限制
- 定期轮换安全令牌
- 考虑为 MCP 服务实现额外的身份验证
贡献
欢迎贡献!请提交改进内容的 PR。
许可证
MIT 许可证
MIT License
Copyright (c) 2024 Kablewy,LLC
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。
