[有限发布版]{class="badge informative" title="此功能当前为有限测试版"}
Marketo Engage MCP服务器
模型上下文协议(Model Context Protocol,MCP)是一种开放标准,它使AI工具能够与外部服务进行通信。 Marketo MCP服务器充当您的AI助手与Marketo之间的桥梁。 它公开跨表单、项目、智能营销策划、潜在客户、电子邮件、代码片段、列表和文件夹的100多项操作。
当您的AI工具调用MCP服务器时,服务器会使用您在每个请求中提供的凭据,代表您执行相应的REST API调用。 您无需安装、部署或运行任何服务器端软件。
将MCP客户端或服务器连接到Adobe产品是客户选择的配置,客户负责评估任何MCP集成的安全性和适用性。Adobe对于因错误配置、滥用MCP、第三方实施中的漏洞或通过支持MCP的工作流执行的意外操作而产生的问题,概不负责。
为了降低风险,Adobe鼓励您在生产使用之前在沙盒环境中测试集成,并在确认或依赖集成之前,仔细审查和验证所有MCP启动的操作和响应。
MCP基础知识
将MCP想象为用于AI应用程序的USB-C端口。 正如USB-C提供了一种标准化方式将您的设备连接到各种外围设备和附件,MCP提供了一种标准化方式将AI模型连接到数据源和工具。 — 模型上下文协议
MCP允许AI工具同时连接到多个外部服务。 例如,AI助手可以:
- 连接到文字处理器以进行AI辅助文档生成
- 连接到动画工具(如Blender)以构建可视化图表
- 连接到Adobe After Effects以进行视频编辑
MCP是一种通信协议:任何应用程序都可以实施的开放标准,向AI工具公开其数据和操作。
Marketo Engage MCP执行和不执行的操作
了解MCP的范围有助于在连接AI工具之前设定期望值。
MCP可以:
- 通过标准REST API提供对Marketo数据和功能的访问
- 使用您在每个请求中提供的凭据代表您执行API调用
- 支持多个同步用户,每个用户均使用自己的凭据进行连接
- 自动处理OAuth令牌刷新。 您不需要管理令牌过期
- 在租户隔离的环境中操作,因此您的数据绝不会与其他用户的会话相交
MCP不是:
- 使用、托管或运行任何AI或机器学习模型。 所有AI处理都发生在AI工具中,而不是MCP中
- 对任何数据进行培训或从中学习,包括您的客户数据
- 生成预测、建议或决策。 决策是下游人工智能工具或用户的责任
- 在请求之间存储或保留凭据、请求数据或会话状态
- 要求您安装、部署或管理任何服务器端软件
根据API使用情况,MCP可能会传输数据,包括潜在的敏感字段,但B2B数据涉及客户业务数据,而不涉及PII数据。
先决条件
- 启用了REST API访问权限的Marketo实例
- 在Marketo LaunchPoint中创建API凭据的管理员访问权限
- 以下AI工具之一:Claude Desktop、Cursor、Codex、Claude Code (CLI)或具有GitHub Copilot的VS Code
- 对MCP服务器URL的网络访问:
https://marketo-mcp.adobe.io/mcp
获取Marketo凭据
您需要Marketo实例中的以下值:
- 客户端ID
- 客户端密码
- Munchkin帐户ID
如果您已经拥有这些工具,请跳到配置您的AI工具。
客户端ID和客户端密码
- 转到Admin > LaunchPoint。
- 选择您的API服务。 如果没有服务类型,请选择New > New Service,选择 Custom 作为服务类型,并分配一个专用的API用户。
- 选择 View Details 并复制 Client ID 和 Client Secret 值。
Munchkin帐户ID
- 转到Admin > Munchkin。
- 复制Munchkin Account ID。 格式为
XXX-XXX-XXX,与实例URL的前缀匹配。
配置AI工具
每个AI工具的设置略有不同。 为常用工具提供了连接示例。
marketo-prod和marketo-staging,每个条目都具有相应的凭据。克劳德桌面 claude-desktop
要连接到Claude Desktop,请下载marketo-mcp-bridge.zip并将其解包。 将marketo-mcp-bridge.mjs放置到已知位置,以便在下一步中可以参考。
您还需要:
- Node.js v18+
- npm
- 打开Claude Desktop
- 转到设置>开发人员>编辑配置
- 将以下内容添加到
claude_desktop_config.json:
{
"preferences": {
...
},
"mcpServers": {
"marketo-mcp": {
"command": "node",
"args": ["/path/to/marketo-bridge/bridge.mjs"],
"env": {
"MARKETO_MCP_PROD_CLIENT_ID": "<your-client-id>",
"MARKETO_MCP_PROD_CLIENT_SECRET": "<your-client-secret>",
"MARKETO_MCP_PROD_MUNCHKIN_ID": "<your-munchkin-id>"
}
}
}
}
- 重新启动Claude Desktop
光标 cursor
如果游标MCP配置已包含其他服务器,请在mcpServers下添加marketo项。
以下示例显示项目目录中Settings > MCP或.cursor/mcp.json中的完整mcpServers块:
| code language-json |
|---|
|
| code language-json |
|---|
|
重新启动光标。
克劳德代码(CLI) claude-code
在终端中运行以下命令,替换您的凭据:
| code language-bash |
|---|
|
| code language-bash |
|---|
|
OpenAI代码 codex
- 转到“设置”>“MCP服务器”>“添加服务器”
- 添加服务器URL:
https://marketo-mcp.adobe.io/mcp - 为身份验证方法添加标头:
- 授权:“持有者YOUR-IMS-TOKEN”
- x-gw-ims-org-id: “YOUR-IMS-ORG-ID”
- X-Marketo-Client-Id: “YOUR-CLIENT-ID”
- X-Marketo-Client-Secret: “YOUR-CLIENT-SECRET”
- X-Marketo-Munchkin-Id: “YOUR-MUNCHKIN-ID”
- 单击保存以完成该过程。
使用GitHub Copilot的VS代码 vscode
按Ctrl+Shift+P(或macOS上的Cmd+Shift+P),键入MCP: Open User Configuration,然后按Enter。 这将打开mcp.json。 在servers对象中添加marketo条目:
| code language-json |
|---|
|
| code language-json |
|---|
|
${MARKETO_CLIENT_SECRET})引用变量并在环境中设置它们。 这样可防止在版本控制文件中以纯文本形式存储凭据。Glean glean
要将Glean连接到Marketo Engage MCP服务器,必须由Glean支持团队配置以下自定义标头。
X-Marketo-Client-IdX-Marketo-Client-SecretX-Marketo-Munchkin-Id其他工具 other-tools
Marketo MCP服务器由Adobe托管,并在公共URL中公开。任何支持通过可流式传输HTTP传输远程服务器的MCP客户端都可以连接到该客户端。
您不需要工具专用的桥接器或任何本地安装的软件。如果您的工具未在上面列出,请使用下面的连接详细信息来手动配置它。
连接详细信息:
https://marketo-mcp.adobe.io/mcp身份验证标头:
通过每个请求发送以下身份验证方法之一的标头。 在何处输入服务器URL和标头取决于您的工具,因此请查阅其MCP文档。
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| 标头 | 值 |
Authorization |
Bearer YOUR-IMS-TOKEN |
x-gw-ims-org-id |
您的IMS组织ID |
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| 标头 | 值 |
X-Marketo-Client-Id |
您的客户端ID |
X-Marketo-Client-Secret |
您的客户端密码 |
X-Marketo-Munchkin-Id |
您的Munchkin帐户ID |
如果您的工具接受JSON配置,请从Cursor或VS代码示例开始,并调整键(mcpServers、servers)以匹配您工具的架构。
可用操作
连接后,您可以要求AI助手跨以下类别执行操作。 有关包含API引用的支持的操作的完整列表,请参阅支持的MCP操作。
表单
浏览、创建、克隆和批准表单。 添加或删除字段、配置字段可见性规则以及识别表单嵌入的位置。
示例提示:
- “显示所有批准的表单”
- “将‘与我们联系’表单克隆到第2季度Campaign文件夹”
- 在演示请求表单中添加公司字段
智能营销活动
创建智能营销活动、配置智能列表过滤器、添加流程步骤以及激活或停用营销活动。
示例提示:
- “目前哪些智能营销活动处于活动状态?”
- “在‘操作’文件夹中创建一个名为‘潜在客户评分更新’的新智能营销活动”
- “向我显示欢迎电子邮件营销活动中的流程步骤”
潜在客户和列表
按电子邮件地址查找潜在客户,创建或更新潜在客户记录,以及管理静态列表成员资格。
示例提示:
- “通过电子邮件查找潜在客户jane@example.com”
- “将潜在客户ID 12345添加到第2季度MQL列表”
- “新建一个称为夏季活动参与者的静态列表”
项目
创建、克隆和标记程序。 按类型、渠道或日期范围浏览程序。
示例提示:
- “将Q4网络研讨会项目克隆到2026年事件文件夹”
- “在Campaigns文件夹中创建一个名为Summer Sale的新电子邮件项目”
- “向我显示标记为网络研讨会的所有程序”
电子邮件和代码片段
浏览电子邮件、从模板创建电子邮件、更新内容部分和管理可重复使用的代码片段。
示例提示:
- “显示所有草稿电子邮件”
- “更新欢迎电子邮件的标题部分”
- “哪些资产使用假日促销活动片段?”
实例结构
要了解您的Marketo配置,请浏览文件夹、渠道、标记类型和活动类型。
示例提示:
- “列出Marketo中的所有文件夹”
- “显示所有可用渠道”
- “配置了哪些标记类型?”
批量操作
批量导出潜在客户数据并检查导入或导出作业状态。
示例提示:
- “批量导出过去30天内创建的潜在客户”
- “检查导出作业xx的状态”
故障排除
X-Marketo-Client-Id、X-Marketo-Client-Secret或X-Marketo-Munchkin-Id中的一个或多个缺失。Authorization标头。安全性注意事项
- 每个请求的凭据。 客户端ID、客户端密钥、Munchkin ID和REST API端点将随每个请求以HTTP标头传输。 服务器不会存储或缓存这些文件。
- 多租户隔离。 每个请求都使用自己的凭据集。 您的数据不会与任何其他用户的会话相交。
- Munchkin ID 允许列表。 服务器仅接受已批准Marketo实例的请求。 使用未经授权的Munchkin ID的请求会被拒绝,并出现403错误。
- API速率限制。 MCP服务器继承Marketo实例的API速率限制。 使用专用API用户跟踪和管理配额消耗。
- 将凭据保留在版本控制之外。 如果AI工具支持使用环境变量插值(
${MARKETO_CLIENT_SECRET}),因此凭据不会以纯文本形式存储在存储库文件中。