[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和客户端密码

  1. 转到​Admin > LaunchPoint
  2. 单击您的API服务。 如果没有服务类型,请选择​New > New Service,选择​ Custom ​作为服务类型,并分配一个专用的API用户。
  3. 单击​ View Details ​并复制​ Client ID ​和​ Client Secret ​值。

Munchkin帐户ID

  1. 转到​Admin > Munchkin
  2. 复制​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。

NOTE
为安全起见,请在配置文件中使用环境变量插值,而不是直接粘贴凭据。 您可以使用语法(如${MARKETO_CLIENT_SECRET})引用变量并在环境中设置它们。 这样可以防止凭据以纯文本形式存储在可能提交到版本控制的文件中。

可用操作

连接后,您可以要求AI助手跨以下类别执行操作。

表单

浏览、创建、克隆和批准表单。 添加或删除字段、配置字段可见性规则以及识别表单嵌入的位置。

示例提示:

  • "显示所有批准的表单"
  • “将‘与我们联系’表单克隆到第2季度Campaign文件夹”
  • 在演示请求表单中添加公司字段

智能营销活动

创建智能营销活动、配置智能列表过滤器、添加流程步骤以及激活或停用营销活动。

示例提示:

  • “目前哪些智能营销活动处于活动状态?”
  • “在‘操作’文件夹中创建一个名为‘潜在客户评分更新’的新智能营销活动”
  • “向我显示欢迎电子邮件营销活动中的流程步骤”

潜在客户和列表

按电子邮件地址查找潜在客户,创建或更新潜在客户记录,以及管理静态列表成员资格。

示例提示:

  • “通过电子邮件查找潜在客户jane@example.com”
  • “将潜在客户ID 12345添加到第2季度MQL列表”
  • “新建一个称为夏季活动参与者的静态列表”

项目

创建、克隆和标记程序。 按类型、渠道或日期范围浏览程序。

示例提示:

  • “将Q4网络研讨会项目克隆到2026年事件文件夹”
  • “在Campaigns文件夹中创建一个名为Summer Sale的新电子邮件项目”
  • “向我显示标记为网络研讨会的所有程序”

电子邮件和代码片段

浏览电子邮件、从模板创建电子邮件、更新内容部分和管理可重复使用的代码片段。

示例提示:

  • “显示所有草稿电子邮件”
  • “更新欢迎电子邮件的标题部分”
  • “哪些资产使用假日促销活动片段?”

实例结构

浏览文件夹、渠道、标记类型和活动类型以了解您的Marketo配置。

示例提示:

  • “列出Marketo中的所有文件夹”
  • "显示所有可用渠道"
  • “配置了哪些标记类型?”

批量操作

批量导出潜在客户数据并检查导入或导出作业状态。

示例提示:

  • “批量导出过去30天内创建的潜在客户”
  • “检查导出作业xx的状态”

故障排除

错误
原因
修复
“未提供Marketo端点”
您的配置中缺少X-Marketo-Endpoint标头。
重新检查您的MCP配置,并确认所有四个标头都存在。
“未提供Marketo凭据”
X-Marketo-Client-IdX-Marketo-Client-SecretX-Marketo-Munchkin-Id中的一个或多个缺失。
验证配置中是否存在所有四个标头。
“身份验证错误”
您的凭据无效或已过期。
在​Admin > LaunchPoint​中重新检查您的客户端ID和客户端密钥。
“403禁止访问”
您的Munchkin ID不在服务器允许列表上。
请联系您的Marketo MCP管理员以添加您的Munchkin ID。
连接超时或已拒绝
无法从您的网络访问MCP服务器。
确认您可以从环境访问服务器URL。 检查VPN要求(如果适用)。
工具调用返回空结果
API用户缺少所请求资源类型的权限。
要求您的Marketo管理员检查API用户角色和权限。

常见问题

我的数据安全吗?
凭据将以HTTP标头与每个单独的请求一起传输。 服务器不会在会话之间存储或缓存凭据,并且每个请求都是完全隔离的。
是否可以多人同时使用它?
可以。 服务器是多租户。 每个用户都使用自己的凭据进行连接,并且请求相互隔离。
如果我的访问令牌过期,会发生什么情况?
使用客户端ID和客户端密钥进行身份验证时,服务器会自动处理令牌刷新。 您无需采取任何操作。
我需要安装或运行任何项目吗?
不会。 MCP服务器由Adobe托管。 您只需配置人工智能工具即可连接到该工具。
我的API用户需要哪些Marketo权限?
API用户需要访问您打算管理的资源类型。 至少为浏览操作分配只读角色,为创建或修改资产分配读写角色。 与您的Marketo管理员合作以分配适当的权限。
什么是速率限制?
MCP服务器继承Marketo实例的API速率限制。 使用专用API用户跟踪和管理配额消耗。
支持哪些AI工具?
Claude Desktop、Cursor、Claude Code (CLI)和带GitHub Copilot的VS代码。 任何支持通过HTTP的模型上下文协议的AI工具都应正常工作。
我可以连接到多个Marketo实例吗?
可以。 在AI工具的MCP配置中添加多个条目,每个条目都具有唯一名称和相应实例的凭据。 例如,您可以将marketo-prodmarketo-staging配置为单独的服务器。

安全性注意事项

IMPORTANT
在Marketo中使用专用API用户,但仅具有您的工作所需的权限。 请勿重复使用管理员凭据进行API访问。
  • 每个请求的凭据。 客户端ID、客户端密钥、Munchkin ID和REST API端点将随每个请求以HTTP标头传输。 服务器不会存储或缓存这些文件。
  • 多租户隔离。 每个请求都使用自己的凭据集。 您的数据不会与任何其他用户的会话相交。
  • Munchkin ID 允许列表。 服务器仅接受已批准Marketo实例的请求。 使用未经授权的Munchkin ID的请求会被拒绝,并出现403错误。
  • 将凭据保留在版本控制之外。 如果您的AI工具支持使用环境变量插值(${MARKETO_CLIENT_SECRET}),因此凭据不会以纯文本形式存储在提交到存储库的文件中。
recommendation-more-help
bb269a6d-047a-4bf7-9acd-23ad9a63dc59