Salesforce CopilotStudio

用于Copilot Studio的Salesforce MCP服务器

一个具有流式HTTP传输的自托管Salesforce MCP（模型上下文协议）服务器，旨在连接到Microsoft Copilot Studio。

______________________________________________________________________

⚠️ 免责声明

此项目仅用于测试、开发和教育目的。

• 这是 非 Salesforce、微软或任何附属公司的官方产品。
• 这个项目是 非 由Salesforce或Microsoft认可、支持或维护。
• 作者接受 无责任 因使用本软件而导致的任何数据丢失、安全事件、服务中断或其他损害。
• 请勿在生产中使用 而无需执行自己的安全审查、渗透测试和合规性评估。
• 您全权负责保护您的Salesforce凭据、Azure资源以及通过此服务器处理的任何数据。
• Salesforce®是Salesforce，股份有限公司的注册商标，Microsoft®和Copilot Studio®是Microsoft Corporation的注册商标。所有商标均归其各自所有者所有。
• 使用本软件须遵守 MIT许可证 --按“原样”提供，不提供任何形式的保证。

______________________________________________________________________

概述

这个项目囊括了优秀的 tsmztech/mcp服务器销售团队 （MIT许可证） 流式HTTP传输层，使其能够与 微软复制品工作室 作为定制MCP连接器。

为什么存在

建筑

Microsoft Copilot Studio
    → Custom MCP Connector (Streamable HTTP)
        → Azure App Service / Container App
            → This MCP Server (HTTP transport)
                → Salesforce REST API (via jsforce)

可用工具（15）

先决条件

• Node.js 18+
• Salesforce组织 具有API访问权限（开发人员、企业版、无限版）
• Azure 订阅 （用于托管）
• 微软复制品工作室 许可证

快速入门（本地）

1.克隆并安装

git clone 
cd mcp-server-salesforce
npm install

2.配置Salesforce凭据

复制示例环境文件并填写您的凭据：

cp .env.example .env

编辑 .env:

SALESFORCE_CONNECTION_TYPE=User_Password
SALESFORCE_USERNAME=your-username@salesforce.com
SALESFORCE_PASSWORD=your-password
SALESFORCE_TOKEN=your-security-token
SALESFORCE_INSTANCE_URL=https://login.salesforce.com
PORT=3000

安全说明： 对于生产环境，请使用OAuth 2.0客户端凭据流，而不是用户名/密码。集 SALESFORCE_CONNECTION_TYPE=OAuth_2_0_Client_Credentials 并提供 SALESFORCE_CLIENT_ID 和 SALESFORCE_CLIENT_SECRET.

3.构建和运行

npm run build
node dist/http-server.js

4.测试

# Health check
curl http://localhost:3000/health

# Initialize MCP session
curl -X POST http://localhost:3000/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

部署到Azure

选项A：Azure应用服务

# Login to Azure
az login

# Create resource group
az group create --name rg-sf-mcp --location uksouth

# Create App Service plan
az appservice plan create --name plan-sf-mcp --resource-group rg-sf-mcp --sku B1 --is-linux

# Create web app
az webapp create --name sf-mcp-server --resource-group rg-sf-mcp --plan plan-sf-mcp --runtime "NODE:18-lts"

# Configure environment variables
az webapp config appsettings set --name sf-mcp-server --resource-group rg-sf-mcp --settings \
  SALESFORCE_CONNECTION_TYPE=User_Password \
  SALESFORCE_USERNAME=your-username@salesforce.com \
  SALESFORCE_PASSWORD=your-password \
  SALESFORCE_TOKEN=your-security-token \
  SALESFORCE_INSTANCE_URL=https://login.salesforce.com \
  PORT=8080

# Deploy
az webapp deploy --name sf-mcp-server --resource-group rg-sf-mcp --src-path ./deploy.zip

选项B：Azure容器应用程序

看 部署.md 用于具有托管身份的容器应用程序部署。

连接到Copilot工作室

使用MCP板载向导（推荐）

1. 在Copilot工作室→ 代理→ 工具 → 添加工具 → 新工具 → 模型上下文协议
2. 填写：

- 服务器名称： Salesforce CRM - 服务器描述： Query and manage Salesforce data — SOQL, CRUD, schema, Apex - 服务器URL: https://your-app-name.azurewebsites.net/

1. 身份验证： 无 （如果使用API密钥）或 OAuth 2.0 （如果使用Entra ID）
2. 点击 创建 → 创建连接 → 添加到代理

使用自定义连接器（替代方案）

1. 在Power Apps中→ 自定义连接器→ 导入OpenAPI文件
2. 使用提供的 swagger.yaml
3. 在“安全”选项卡上配置安全性
4. 将连接器添加到您的Copilot Studio代理

安全注意事项

当前状态

重要提示： 该项目目前适合 开发、演示和内部概念验证 使用。它需要对企业生产部署进行额外的强化。请参阅下面的路线图。

身份验证选项

生产清单

• \[\]使用OAuth 2.0客户端凭据进行Salesforce身份验证（不是用户名/密码）
• \[\]将机密存储在Azure密钥库中，而不是应用程序设置中
• \[\]仅启用HTTPS
• \[\]添加API密钥或Entra ID身份验证
• \[\]限制网络访问（IP分配列表或VNET）
• \[\]启用Azure监视器/应用程序洞察
• \[\]设置令牌刷新错误警报
• \[\]检查要公开哪些MCP工具（如果不需要，请禁用Apex/模式工具）

路线图

安全强化（优先级）

特性

项目结构

├── src/
│   ├── index.ts              # Original STDIO MCP server (from tsmztech)
│   ├── http-server.ts        # Streamable HTTP wrapper (added for Copilot Studio)
│   ├── tools/                # Tool implementations
│   │   ├── query.ts          # SOQL queries
│   │   ├── dml.ts            # Insert/Update/Delete/Upsert
│   │   ├── search.ts         # Object search
│   │   ├── searchAll.ts      # SOSL search
│   │   ├── describe.ts       # Schema metadata
│   │   ├── aggregateQuery.ts # Aggregate queries
│   │   ├── manageObject.ts   # Custom object management
│   │   ├── manageField.ts    # Custom field management
│   │   ├── readApex.ts       # Read Apex source
│   │   ├── writeApex.ts      # Write Apex source
│   │   └── ...
│   ├── types/                # TypeScript type definitions
│   └── utils/
│       └── connection.ts     # Salesforce connection factory
├── .env.example              # Example environment config
├── package.json
├── tsconfig.json
└── swagger.yaml              # OpenAPI spec for custom connector

积分

该项目建立在 tsmztech/mcp服务器销售团队 （MIT许可证）。HTTP传输包装器(http-server.ts)该项目增加了Copilot Studio集成。

许可证

麻省理工学院——见 许可证