[Beta 版]{class="badge informative" title="此功能当前处于早期测试阶段"}
Marketo MCP服务器
模型上下文协议(MCP)是一个开放标准,它使AI工具能够与外部服务进行通信。 Marketo MCP服务器充当您的AI助手与Marketo之间的桥梁。 它公开跨表单、项目、智能营销策划、潜在客户、电子邮件、代码片段、列表和文件夹的100多项操作。
当您的AI工具调用MCP服务器时,服务器会使用您在每个请求中提供的凭据,代表您执行相应的REST API调用。 您无需安装、部署或运行任何服务器端软件。
先决条件
- 启用了REST API访问权限的Marketo实例
- 在Marketo LaunchPoint中创建API凭据的管理员访问权限
- 以下AI工具之一:Claude Desktop、Cursor、Claude Code (CLI)或使用GitHub Copilot的VS代码
- 对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工具从不同的位置读取MCP服务器配置。 请在下面找到您的工具,然后按照步骤添加Marketo MCP服务器。
克劳德桌面
配置文件是claude_desktop_config.json。 从以下位置之一打开它:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
如果文件已包含其他MCP服务器,请在mcpServers下添加marketo项。 以下示例显示完整的mcpServers块:
{
"mcpServers": {
"marketo": {
"type": "http",
"url": "https://marketo-mcp.adobe.io/mcp",
"headers": {
"X-Marketo-Client-Id": "YOUR-CLIENT-ID",
"X-Marketo-Client-Secret": "YOUR-CLIENT-SECRET",
"X-Marketo-Munchkin-Id": "YOUR-MUNCHKIN-ID"
}
}
}
}
保存文件,退出Claude Desktop,然后重新打开它。
光标
如果游标MCP配置已包含其他服务器,请在mcpServers下添加marketo项。 以下示例显示项目目录中Settings > MCP或.cursor/mcp.json中的完整mcpServers块:
{
"mcpServers": {
"marketo": {
"type": "http",
"url": "https://marketo-mcp.adobe.io/mcp",
"headers": {
"X-Marketo-Client-Id": "YOUR-CLIENT-ID",
"X-Marketo-Client-Secret": "YOUR-CLIENT-SECRET",
"X-Marketo-Munchkin-Id": "YOUR-MUNCHKIN-ID"
}
}
}
}
重新启动光标。
克劳德代码(CLI)
在终端中运行以下命令,替换您的凭据:
claude mcp add --transport http marketo \
https://marketo-mcp.adobe.io/mcp \
--header "X-Marketo-Client-Id: YOUR-CLIENT-ID" \
--header "X-Marketo-Client-Secret: YOUR-CLIENT-SECRET" \
--header "X-Marketo-Munchkin-Id: YOUR-MUNCHKIN-ID"
使用GitHub Copilot的VS代码
在macOS上按 Ctrl+Shift+P 或Cmd+Shift+P,然后选择 Preferences: Open User Settings (JSON) 以打开您的VS代码settings.json。 添加以下示例:
{
"mcp": {
"servers": {
"marketo": {
"type": "http",
"url": "https://marketo-mcp.adobe.io/mcp",
"headers": {
"X-Marketo-Client-Id": "YOUR-CLIENT-ID",
"X-Marketo-Client-Secret": "YOUR-CLIENT-SECRET",
"X-Marketo-Munchkin-Id": "YOUR-MUNCHKIN-ID"
}
}
}
}
}
按Ctrl+Shift+P(或macOS上的Cmd+Shift+P),键入Reload Window,然后按Enter。
${MARKETO_CLIENT_SECRET})引用变量并在环境中设置它们。 这样可以防止凭据以纯文本形式存储在可能提交到版本控制的文件中。可用操作
连接后,您可以要求AI助手跨以下类别执行操作。
表单
浏览、创建、克隆和批准表单。 添加或删除字段、配置字段可见性规则以及识别表单嵌入的位置。
示例提示:
- "显示所有批准的表单"
- “将‘与我们联系’表单克隆到第2季度Campaign文件夹”
- 在演示请求表单中添加公司字段
智能营销活动
创建智能营销活动、配置智能列表过滤器、添加流程步骤以及激活或停用营销活动。
示例提示:
- “目前哪些智能营销活动处于活动状态?”
- “在‘操作’文件夹中创建一个名为‘潜在客户评分更新’的新智能营销活动”
- “向我显示欢迎电子邮件营销活动中的流程步骤”
潜在客户和列表
按电子邮件地址查找潜在客户,创建或更新潜在客户记录,以及管理静态列表成员资格。
示例提示:
- “通过电子邮件查找潜在客户jane@example.com”
- “将潜在客户ID 12345添加到第2季度MQL列表”
- “新建一个称为夏季活动参与者的静态列表”
项目
创建、克隆和标记程序。 按类型、渠道或日期范围浏览程序。
示例提示:
- “将Q4网络研讨会项目克隆到2026年事件文件夹”
- “在Campaigns文件夹中创建一个名为Summer Sale的新电子邮件项目”
- “向我显示标记为网络研讨会的所有程序”
电子邮件和代码片段
浏览电子邮件、从模板创建电子邮件、更新内容部分和管理可重复使用的代码片段。
示例提示:
- “显示所有草稿电子邮件”
- “更新欢迎电子邮件的标题部分”
- “哪些资产使用假日促销活动片段?”
实例结构
浏览文件夹、渠道、标记类型和活动类型以了解您的Marketo配置。
示例提示:
- “列出Marketo中的所有文件夹”
- "显示所有可用渠道"
- “配置了哪些标记类型?”
批量操作
批量导出潜在客户数据并检查导入或导出作业状态。
示例提示:
- “批量导出过去30天内创建的潜在客户”
- “检查导出作业xx的状态”
故障排除
X-Marketo-Endpoint标头。X-Marketo-Client-Id、X-Marketo-Client-Secret或X-Marketo-Munchkin-Id中的一个或多个缺失。常见问题
marketo-prod和marketo-staging配置为单独的服务器。安全性注意事项
- 每个请求的凭据。 客户端ID、客户端密钥、Munchkin ID和REST API端点将随每个请求以HTTP标头传输。 服务器不会存储或缓存这些文件。
- 多租户隔离。 每个请求都使用自己的凭据集。 您的数据不会与任何其他用户的会话相交。
- Munchkin ID 允许列表。 服务器仅接受已批准Marketo实例的请求。 使用未经授权的Munchkin ID的请求会被拒绝,并出现403错误。
- 将凭据保留在版本控制之外。 如果您的AI工具支持使用环境变量插值(
${MARKETO_CLIENT_SECRET}),因此凭据不会以纯文本形式存储在提交到存储库的文件中。