Skip to main content
Glama
deenesjakoruzh
ZLeventer

salesforce-marketing-mcp

by ZLeventer
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

salesforce-marketing-mcp

MIT License Node.js MCP

这是一个生产就绪的 Model Context Protocol (MCP) 服务器，使 AI 助手（Claude、Cursor 等）能够直接访问 Salesforce CRM 数据。专为需要 AI 辅助访问潜在客户、联系人、营销活动、营销活动成员、任务和 14 个报告工具的市场运营、营收运营和 B2B 营销团队打造，无需编写 SOQL。

功能

  • 潜在客户 (Leads) — 搜索、获取、创建、更新和转换潜在客户

  • 联系人 (Contacts) — 搜索、获取、创建、更新以及通过电子邮件查找

  • 客户 (Accounts) — 搜索、获取并列出每个客户下的联系人

  • 营销活动 (Campaigns) — 列出、获取、创建和更新营销活动

  • 营销活动成员 (Campaign Members) — 列出成员、添加个人、批量添加最多 200 人、更新状态

  • 任务 (Tasks) — 创建任务；按潜在客户、联系人或营销活动列出任务

  • 分析报告 (Analytics Reports) — 列出、运行和描述 Salesforce 分析报告

  • 营销活动分析 (Campaign Analytics) — ROI 计算、成员状态细分、顶级营销活动、绩效趋势

  • 归因 (Attribution) — 潜在客户来源细分、按营销活动划分的渠道、CampaignInfluence、按营销活动划分的赢单收入、潜在客户转化指标

  • 渠道 (Pipeline) — 渠道摘要、按潜在客户来源划分的渠道、MQL 趋势、预测摘要

  • 活动 (Activity) — 按维度划分的活动摘要、按潜在客户或联系人划分的近期活动

  • 高级工具 (Power tools) — 原生 SOQL、SObject 描述、列出所有对象

前置要求

  • Salesforce 组织（任何具有 API 访问权限的版本）

  • 您的 Salesforce 用户名、密码和安全令牌

    • 获取/重置安全令牌：设置 > 个人信息 > 重置我的安全令牌

  • Node.js 20 或更高版本

无需配置连接的应用程序或 OAuth。

设置

1. 安装

npm install -g salesforce-marketing-mcp
# or run directly with npx
npx salesforce-marketing-mcp

2. 环境变量

变量

必需

默认值

描述

SF_USERNAME

是

—

Salesforce 登录邮箱

SF_PASSWORD

是

—

Salesforce 密码

SF_SECURITY_TOKEN

是

—

安全令牌（登录时附加在密码后）

SF_LOGIN_URL

否

https://login.salesforce.com

沙盒环境请使用 https://test.salesforce.com

SF_API_VERSION

否

60.0

Salesforce API 版本

创建 .env 文件或在 shell 中设置它们：

export SF_USERNAME="you@yourcompany.com"
export SF_PASSWORD="yourpassword"
export SF_SECURITY_TOKEN="yourtoken"
# For sandbox:
export SF_LOGIN_URL="https://test.salesforce.com"

使用方法

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 或 %APPDATA%\Claude\claude_desktop_config.json (Windows)：

{
  "mcpServers": {
    "salesforce": {
      "command": "npx",
      "args": ["salesforce-marketing-mcp"],
      "env": {
        "SF_USERNAME": "you@yourcompany.com",
        "SF_PASSWORD": "yourpassword",
        "SF_SECURITY_TOKEN": "yourtoken",
        "SF_LOGIN_URL": "https://login.salesforce.com"
      }
    }
  }
}

Claude Code

claude mcp add salesforce-marketing-mcp \
  -e SF_USERNAME=you@yourcompany.com \
  -e SF_PASSWORD=yourpassword \
  -e SF_SECURITY_TOKEN=yourtoken \
  -- npx salesforce-marketing-mcp

Cursor

在 .cursor/mcp.json 中：

{
  "mcpServers": {
    "salesforce": {
      "command": "npx",
      "args": ["salesforce-marketing-mcp"],
      "env": {
        "SF_USERNAME": "you@yourcompany.com",
        "SF_PASSWORD": "yourpassword",
        "SF_SECURITY_TOKEN": "yourtoken"
      }
    }
  }
}

工具参考

工具

描述

sf_search_leads

在潜在客户姓名、电子邮件和公司中进行 SOSL 搜索

sf_get_lead

通过 ID 获取完整的潜在客户记录

sf_create_lead

创建新的潜在客户

sf_update_lead

更新任何潜在客户字段

sf_convert_lead

将潜在客户转换为客户/联系人/商机

sf_search_contacts

在联系人姓名和电子邮件中进行 SOSL 搜索

sf_get_contact

包含客户名称的完整联系人记录

sf_create_contact

创建新的联系人

sf_update_contact

更新任何联系人字段

sf_contact_by_email

通过电子邮件地址查找联系人（最多 10 个匹配项）

sf_search_accounts

在客户名称上进行 SOSL 搜索

sf_get_account

包含未结商机数和潜在客户数的客户记录

sf_list_account_contacts

与客户关联的联系人

sf_list_campaigns

列出营销活动，支持可选的状态/类型/活跃过滤器

sf_get_campaign

包含所有绩效指标的完整营销活动记录

sf_create_campaign

创建新的营销活动

sf_update_campaign

更新任何营销活动字段

sf_get_campaign_members

列出包含潜在客户/联系人详细信息的营销活动成员

sf_add_campaign_member

将单个潜在客户或联系人添加到营销活动

sf_bulk_add_campaign_members

一次调用最多添加 200 个潜在客户/联系人

sf_update_campaign_member_status

更新成员状态和 HasResponded 标志

sf_create_task

创建链接到潜在客户、联系人或营销活动的任务

sf_list_tasks_by_lead

与潜在客户关联的任务

sf_list_tasks_by_contact

与联系人关联的任务

sf_list_tasks_by_campaign

与营销活动关联的任务

sf_list_reports

列出可用的 Salesforce 分析报告

sf_run_report

执行报告并返回结构化行

sf_get_report_metadata

报告的列定义和分组

sf_campaign_roi

每个营销活动的 ROI、CPL、CPO 和响应率

sf_campaign_member_status_breakdown

营销活动的成员状态计数

sf_top_campaigns

按响应、商机或赢单收入对营销活动进行排名

sf_campaign_performance_trend

随时间（周/月）变化的成员添加情况

sf_lead_source_breakdown

按潜在客户来源划分的潜在客户数量、转化率和收入

sf_pipeline_by_campaign

按营销活动和阶段分组的未结渠道

sf_campaign_influence

将营销活动链接到商机的 CampaignInfluence 记录

sf_won_revenue_by_campaign

按主要营销活动分组的已赢单收入

sf_lead_conversion_metrics

按潜在客户来源或营销活动划分的转化率

sf_pipeline_summary

按阶段划分的渠道：计数、金额、概率、加权值

sf_pipeline_by_lead_source

按潜在客户来源分组的渠道

sf_mql_trend

随时间变化的 MQL（或任何状态）数量

sf_forecast_summary

在日期范围内结束的商机的预期收入

sf_activity_summary

按潜在客户来源、营销活动或所有者划分的任务/事件计数

sf_recent_activities_by_lead

特定潜在客户的任务和事件

sf_recent_activities_by_contact

特定联系人的任务和事件

sf_run_soql

执行原生 SOQL（自定义查询的逃生舱）

sf_describe_object

任何 SObject 的完整字段元数据

sf_list_objects

列出所有可查询的 SObject，支持可选过滤器

提示词示例

连接后，您可以向 Claude 询问如下问题：

"本季度按赢单收入排名前 5 的营销活动是什么？"

"显示过去 90 天的潜在客户来源细分 — 包括转化率。"

"为潜在客户 00Q 创建一个跟进任务……截止日期为下周五。"

"哪些营销活动的 ROI 最高？包括每个潜在客户的成本。"

"显示今年按月划分的 MQL 趋势。"

"将此列表中的所有潜在客户添加到状态为 'Invited' 的 Q2 网络研讨会营销活动中。"

"我们当前按阶段划分的渠道摘要及其加权值是多少？"

工作原理

  • 身份验证：使用 jsforce 通过 Salesforce 用户名 + 密码 + 安全令牌进行连接。连接缓存 25 分钟，并在出现 INVALID_SESSION_ID 错误时自动刷新。

  • 生产和沙盒：设置 SF_LOGIN_URL=https://test.salesforce.com 以定位沙盒环境。

  • 速率限制：所有查询均遵守 Salesforce API 限制。使用 limit 参数控制结果大小。

许可证

MIT

Install Server
A
license - permissive license
B
quality
C
maintenance

How are these scores calculated?

Resources

Tools

View all tools

Related MCP Connectors

  • Vee3

    Hosted MCP with 91 agent tools: X, domains, SEO, Maps, Trends, Search, YouTube, TikTok, and more.

  • mcp-knowledge

    100+ MCP tools for AI agents: content metadata, trade intelligence, business-expertise analysis.

  • 11agents Cloud MCP

    Cloud MCP for project data, analytics, research, content planning, media generation, and growth.

View all MCP Connectors

Appeared in Searches

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ZLeventer/salesforce-marketing-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server