Marketo MCP 服务器

一个用于 Adobe Marketo Engage 的 Model Context Protocol 服务器。 让 Claude Desktop、Cursor 和其他兼容 MCP 的客户端能够直接、经过身份验证地访问 Marketo REST API —— 通过自然语言读取和写入表单、智能列表、渠道、潜在客户、活动和列表。

为什么使用它

营销运营、增长和 RevOps 团队花费数小时点击 Marketo UI 来克隆表单、批准资产、查找潜在客户或审计智能列表。Marketo MCP 服务器 将这些相同的 REST API 操作连接到 LLM 代理中，因此您可以说：

• “将表单 1234 克隆到 Q2 网络研讨会文件夹中并批准它。”

• “向我展示 alex@example.com 的近期活动。”

• “创建一个名为 'Lifecycle Nurture' 的新电子邮件渠道。”

……模型会代表您执行实际的 Marketo API 调用。

Related MCP server: Dynamic Form MCP

目录

• 功能

• 快速入门

• 先决条件

• 配置

• 可用工具

• 与 Claude Desktop 一起使用

• 与 Cursor / 其他 MCP 客户端一起使用

• 故障排除

• 开发

• 贡献

功能

• 表单管理 — 通过 Marketo Asset API 列出、检查、克隆和批准表单

• 智能列表操作 — 列出和检查智能列表

• 渠道 CRUD — 创建、读取、更新和删除渠道

• 潜在客户数据库 — 按 ID 或电子邮件获取潜在客户，批量创建或更新潜在客户，删除潜在客户

• 活动与变更日志 — 获取任何潜在客户的活动和字段变更

• 列表成员资格 — 将潜在客户添加到静态列表或从中移除

• 程序管理 — 列出、检查、克隆程序并检索程序成员

• 电子邮件操作 — 列出、检查并发送用于 QA 的示例电子邮件

• 自动身份验证 — 带有令牌缓存和刷新的 OAuth 2.0 客户端凭据流

• Stdio 传输 — 开箱即用地适用于 Claude Desktop、Cursor 以及任何支持 stdio 的 MCP 客户端

快速入门

选项 A — Smithery（推荐）

npx -y @smithery/cli install @alexleventer/marketo-mcp --client claude

按照提示粘贴您的 Marketo 基础 URL、客户端 ID 和客户端密钥。

选项 B — npx（无需安装）

将以下内容添加到您的 MCP 客户端配置中（例如 claude_desktop_config.json）：

{
  "mcpServers": {
    "marketo": {
      "command": "npx",
      "args": ["-y", "marketo-mcp"],
      "env": {
        "MARKETO_BASE_URL": "https://123-ABC-456.mktorest.com/rest",
        "MARKETO_CLIENT_ID": "your-client-id",
        "MARKETO_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

选项 C — 从源码构建

git clone https://github.com/alexleventer/marketo-mcp.git
cd marketo-mcp
npm install
npm run build

将构建打印出的配置块复制到您的 MCP 客户端中。

先决条件

• Node.js 18 或更高版本

• Marketo API 凭据（来自 LaunchPoint 服务的客户端 ID 和客户端密钥）

• 已启用 REST API 访问的 Marketo 实例

• 兼容 MCP 的客户端 — Claude Desktop、Cursor、Cline 或任何其他客户端

获取 Marketo API 凭据

1. 登录 Marketo 管理后台

2. 管理 (Admin) → 集成 (Integration) → LaunchPoint

3. 新建 (New) → 新建服务 (New Service)，将服务类型设置为 自定义 (Custom) 并选择一个显示名称（例如 MCP Server）

4. 分配一个具有所需权限（只读资产、读写潜在客户等）的仅 API 用户

5. 保存 客户端 ID (Client ID) 和 客户端密钥 (Client Secret)

6. 您的 基础 URL (base URL) 位于 管理 (Admin) → 集成 (Integration) → Web 服务 (Web Services) → REST API 端点（去掉 /rest/v1/* — 只保留 https://<munchkin>.mktorest.com/rest）

配置

所有配置均通过环境变量进行：

将 .env.example 复制到 .env 以进行本地开发。

可用工具

每个工具都接受使用 zod 验证的类型化参数，并返回原始 Marketo JSON 响应。有关字段级详细信息，请参阅 Adobe Marketo REST API 参考。

与 Claude Desktop 一起使用

1. 安装 Claude Desktop

2. 打开配置文件 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 或 %APPDATA%\Claude\claude_desktop_config.json (Windows)

3. 粘贴 快速入门 中的 mcpServers 块

4. 重启 Claude Desktop

与 Cursor / 其他 MCP 客户端一起使用

任何支持 stdio 服务器的 MCP 客户端都可以使用。将其指向构建好的二进制文件：

{
  "mcpServers": {
    "marketo": {
      "command": "npx",
      "args": ["-y", "marketo-mcp"],
      "env": { "MARKETO_BASE_URL": "...", "MARKETO_CLIENT_ID": "...", "MARKETO_CLIENT_SECRET": "..." }
    }
  }
}

速率限制

Marketo 强制执行多项 API 速率限制。在运行批处理操作时请记住这些限制：

如果您遇到 606 Max rate limit reached，请等待 20 秒后再重试。Marketo REST API 在某些情况下会返回 Retry-After 标头。

故障排除

您可以使用 MCP 检查器在本地检查工具调用：

npm run inspector

开发

src/
├── index.ts       # MCP server + all tool registrations
├── auth.ts        # OAuth token manager (caches until expiry)
└── constants.ts   # Env var bindings

npm run dev          # Run with ts-node + .env
npm run typecheck    # Type-check without emit
npm run lint         # ESLint
npm run format       # Prettier
npm run build        # Compile to build/

贡献

欢迎在 github.com/alexleventer/marketo-mcp 提交问题和拉取请求。

1. Fork 该仓库

2. 创建功能分支

3. npm run lint && npm run typecheck

4. 提交 PR

许可证

ISC — 请参阅 LICENSE。

关键词： marketo mcp server, marketo model context protocol, marketo claude, marketo ai, adobe marketo mcp, marketo api claude desktop, marketo automation llm, marketo engage mcp