Devart MCP Server for Salesforce Marketing Cloud (ADO.NET)

版本 1.1.0

更新内容 · 更新日志

Devart Salesforce Marketing Cloud MCP 服务

Devart Salesforce Marketing Cloud MCP 服务可让 AI 客户端通过在您的环境中运行的安全服务与数据交互。它将普通的 AI 聊天转变为处理真实业务数据的实用方式，而且比传统的导出或手动查询更快。

主要优势

Devart Salesforce Marketing Cloud MCP 服务可以帮助您：

• 通过自然语言直观地处理数据。
• 在几分钟内获取所需数据以进行分析。
• 借助 AI 助手更快地生成数据报告。
• 尽量减少手动数据处理和集成维护。

工作原理

Devart Salesforce Marketing Cloud MCP 服务通过自然语言提示词帮助 AI 客户端直接与 Salesforce Marketing Cloud 数据库通信。它会将 AI 请求转换为结构化查询，通过 Devart 连接驱动程序执行查询，并返回整洁、结构化的结果，从而实现无缝的 AI 驱动数据访问。

快速入门

要开始使用 Devart Salesforce Marketing Cloud MCP 服务：

1. 下载并安装 Devart Salesforce Marketing Cloud ODBC Driver。

2. 下载并安装 Devart Salesforce Marketing Cloud MCP 服务。

3. 在 Devart Salesforce Marketing Cloud MCP 服务中，配置数据连接和集成设置。

4. 运行您的第一个自然语言查询。

手动安装和配置

先决条件

在构建和运行 Devart Salesforce Marketing Cloud MCP 服务之前，请确保已安装以下组件：

• .NET 8 SDK
• ADO.NET 连接 — Devart.AI.McpServer.AdoNet.SalesforceMc.csproj Devart dotConnect for Salesforce Marketing Cloud（在构建期间通过 NuGet 自动安装）
• ODBC 连接 — Devart.AI.McpServer.Odbc.SalesforceMc.csproj Devart Salesforce Marketing Cloud ODBC Driver（需要手动下载和安装）

步骤 1：克隆仓库

克隆项目仓库并导航到项目目录：

1. 打开命令提示符。

2. 输入以下命令：

git clone https://github.com/devart-ai-connectivity/devart-mcp-server-salesforce-marketing-cloud.git
cd devart-mcp-server-salesforce-marketing-cloud

步骤 2：从源代码构建 MCP 服务

您可以使用支持的数据库连接技术之一（ADO.NET 或 ODBC）从源代码构建 Devart Salesforce Marketing Cloud MCP 服务。

• 要使用 ADO.NET 构建 MCP 服务，请运行以下命令：

dotnet publish Devart.AI.McpServer.AdoNet/Devart.AI.McpServer.AdoNet.SalesforceMc/Devart.AI.McpServer.AdoNet.SalesforceMc.csproj -c ReleaseSalesforceMc /p:TargetFramework=net8.0

Devart dotConnect for Salesforce Marketing Cloud NuGet 包会自动下载并还原。

• 要使用 ODBC 构建 MCP 服务，请根据数据源的位数选择命令。

对于 64 位数据源，请运行以下命令：

dotnet publish Devart.AI.McpServer.Odbc/Devart.AI.McpServer.Odbc.SalesforceMc/Devart.AI.McpServer.Odbc.SalesforceMc.csproj -c ReleaseSalesforceMc -r "win-x64" /p:TargetFramework=net8.0

对于 32 位数据源，请运行以下命令：

dotnet publish Devart.AI.McpServer.Odbc/Devart.AI.McpServer.Odbc.SalesforceMc/Devart.AI.McpServer.Odbc.SalesforceMc.csproj -c ReleaseSalesforceMc -r "win-x86" /p:TargetFramework=net8.0

注意

目标平台必须与 ODBC 数据源的位数相匹配。

步骤 3：为 MCP 服务配置数据库连接

1. 在已构建的 MCP 服务可执行文件所在目录中创建 mcpserver.json 配置文件。

2. 在文件中配置数据库连接。

• 使用 ADO.NET 配置连接。

将以下配置添加到 mcpserver.json 文件中：

{
  "Connections": [
    {
      "Name": "my_salesforcemc",
      "ConnectionString": "Authentication Type=UserNamePassword;Url=https://your-exacttarget-url;User Id=your_user;Password=your_password;License Key=your_license_key;",
      "ProtocolType": "stdio"
    }
  ]
}

• 使用 ODBC 配置连接。

将以下配置添加到 mcpserver.json 文件中：

{
  "Connections": [
    {
      "Name": "my_salesforcemc",
      "DsnName": "your_dsn_name",
      "ProtocolType": "stdio"
    }
  ]
}

• 使用连接字符串配置 ODBC 连接。

将以下配置添加到 mcpserver.json 文件中：

{
  "Connections": [
    {
      "Name": "my_salesforcemc",
      "ConnectionString": "Driver={Devart ODBC Driver for Salesforce Marketing Cloud};Server=localhost;User ID=salesforcemc;Password=your_password;Database=your_database;",
      "ProtocolType": "stdio"
    }
  ]
}

其中：

• Name — 连接名称。

• ConnectionString（适用于 ADO.NET）— 用于建立与目标数据库连接的数据库专用连接字符串。

• DsnName（适用于 ODBC）— 数据源名称。

• ProtocolType — 传输协议。可选项为：stdio 或 http。

• HttpPort（当 ProtocolType 设置为 http 时必填）— http 协议的端口号。

步骤 4：运行 MCP 服务

配置好 MCP 服务后，即可启动它。

注意

只有在 ProtocolType 配置为 http 时，才需要执行此步骤。如果使用 stdio 传输协议，AI 客户端会自动启动服务。

• 要使用 ADO.NET 启动服务，请运行以下命令：

Devart.AI.McpServer.AdoNet.SalesforceMc.exe run my_salesforcemc

• 要使用 ODBC 启动服务，请运行以下命令：

Devart.AI.McpServer.Odbc.SalesforceMc.exe run my_salesforcemc

其中，my_salesforcemc 是 ODBC 连接的名称。

步骤 5：与 Claude Desktop 集成

1. 打开 Claude 配置文件 claude_desktop_config.json。

提示

如果找不到配置文件，它可能尚不存在。要创建该文件，请打开 Claude Desktop 并依次进入 文件 > 设置 > 开发者，然后点击 编辑配置。系统会打开包含 claude_desktop_config.json 文件的文件夹。

2. 根据 MCP 服务使用的传输协议，添加以下对象之一：

• STDIO

{
  "mcpServers": {
    "devart": {
      "command": "C:\\path\\to\\Devart.AI.McpServer.AdoNet.SalesforceMc.exe",
      "args": [
        "run",
        "my_salesforcemc"
      ]
    }
  }
}

其中：

• devart 是将在 Claude Desktop 中显示的连接器名称。

• C:\\path\\to\\Devart.AI.McpServer.AdoNet.SalesforceMc.exe 是可执行文件的路径。对于 ODBC 连接，请使用 Devart.AI.McpServer.Odbc.SalesforceMc.exe。

• my_salesforcemc 是 mcpserver.json 配置文件中指定的连接名称。

• HTTP

    "mcpServers": {
      "devart": {
        "command": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "http://localhost:5000/sse"
        ]
      }
    }
  

  其中：

  • devart 是将在 Claude Desktop 中显示的连接器名称。
  • 5000 是 MCP 服务的监听端口。

3. 保存文件。

4. 重启 Claude Desktop。

Devart MCP Server for Salesforce Marketing Cloud 现已与 Claude 集成，devart 会显示在 Claude Desktop 应用的 自定义 > 连接器 中。

你也可以将 Devart MCP Server for Salesforce Marketing Cloud 集成，用于其他 AI 客户端，例如 Cline、Codex、Cursor、Visual Studio Code、Windsurf、Zed。

支持的客户端

Devart MCP Server for Salesforce Marketing Cloud 支持与以下 AI 客户端集成：

• Claude Desktop
• Visual Studio Code
• Cursor
• Codex
• Windsurf
• Cline
• Zed
• ……以及其他兼容 MCP 的 AI 客户端

典型用例

Devart MCP Server for Salesforce Marketing Cloud 非常适合将 Salesforce Marketing Cloud 作为主要数据源的团队。

• 电子邮件营销活动效果分析
  查询 Marketing Cloud 电子邮件营销活动的发送量、打开率、点击率、退信量和退订量，无需创建自定义报告。

• 受众与订阅者分析
  分析 Marketing Cloud 中存储的订阅者列表增长情况、互动评分、抑制列表和受众细分组成。

• 客户旅程分析
  探索 Marketing Cloud Journey Builder 数据中的旅程进入率、路径分布、退出节点和转化效果。

• 跨渠道互动报告
  查询电子邮件、短信、推送通知和广告受众的互动数据，了解跨渠道营销活动的效果。

• 数据扩展探索
  访问并分析 Marketing Cloud 中存储的自定义数据扩展、同步的 CRM 数据和关系表，用于自定义营销活动分析。

• 送达能力与列表健康状况监控
  调查 Marketing Cloud 发送日志中的退信类别、垃圾邮件投诉率和列表卫生指标。

许可与激活

Devart MCP Server for Salesforce Marketing Cloud 以免费的单一数据源 MCP 服务形式分发。

要连接到 Salesforce Marketing Cloud，服务需要相应的 Devart ODBC Driver for Salesforce Marketing Cloud，该产品为付费产品。

Devart ODBC Driver for Salesforce Marketing Cloud 提供 30 天免费试用。

有关最新的安装和激活详情，请参阅产品页面和文档。

支持

• 文档
• 提交请求
• 提出功能建议
• 加入我们的论坛

其他 Devart 连接解决方案

• Universal MCP Server
• ODBC Driver for Salesforce Marketing Cloud
• dotConnect ADO.NET Provider for Salesforce Marketing Cloud