项目简介
Marketo MCP服务器是一个基于Model Context Protocol (MCP) 的后端服务,旨在将Marketo的市场自动化平台与支持MCP的AI客户端(如某些LLM应用)连接起来。它将Marketo的功能封装成AI可调用的“工具”,允许AI安全、标准化地访问和操作Marketo中的数据和资源,特别是表单。
主要功能点
该服务器通过MCP向连接的AI客户端暴露以下核心功能(工具):
- 获取表单列表: 查询Marketo账户中的表单列表,支持按数量、偏移量和状态(草稿/已批准)进行过滤。
- 按ID获取表单: 根据指定的表单ID检索单个表单的详细信息。
- 克隆表单: 复制一个现有的Marketo表单,并指定新表单的名称、描述和存放文件夹。
- 批准表单: 标记一个草稿状态的Marketo表单为已批准,支持添加批准评论。
安装步骤
- 前提条件: 确保您已安装 Node.js (v14 或更高版本)。
- 获取Marketo API凭据: 登录您的Marketo管理后台,导航至 Admin > Integration > LaunchPoint,创建一个新服务以获取 Client ID 和 Client Secret。
- 配置环境变量: 在项目根目录下创建 '.env' 文件,填入您的Marketo连接信息:
MARKETO_BASE_URL=你的Marketo实例URL (例如: https://123-ABC-456.mktorest.com/rest) MARKETO_CLIENT_ID=你的Marketo Client ID MARKETO_CLIENT_SECRET=你的Marketo Client Secret - 安装依赖并构建: 打开终端,切换到项目目录,运行以下命令:
构建过程会将TypeScript代码编译成JavaScript,并生成运行服务器所需的配置信息输出到控制台。npm install npm run build
服务器配置
构建过程会在控制台输出一段JSON格式的MCP服务器配置信息。您需要将这段信息复制并粘贴到您的MCP客户端(如 Claude Desktop 的开发者设置)中,以便客户端能够发现并连接到这个Marketo MCP服务器。
典型的配置信息如下所示:
{ "mcpServers": { "MarketoAPI": { // 这个名称会显示在MCP客户端中 "command": "node", // 启动服务器使用的命令 "args": [ // 服务器主脚本的路径,由构建过程生成 "build/index.js" ], "env": { // 服务器运行所需的环境变量,确保您已在本地.env中配置正确的值 "MARKETO_BASE_URL": "<您的Marketo实例URL>", "MARKETO_CLIENT_ID": "<您的Marketo Client ID>", "MARKETO_CLIENT_SECRET": "<您的Marketo Client Secret>" } } } }
注意: '<您的Marketo实例URL>' 等占位符需要您根据 '.env' 文件中的实际值进行确认或在MCP客户端的配置界面中填写。
基本使用方法
- 启动服务器: 根据您MCP客户端的设置,通常客户端会在需要时自动启动配置好的MCP服务器(即执行上面配置中的 'command' 和 'args')。
- AI交互: 一旦服务器成功启动并与客户端建立连接,支持MCP的AI模型就能够感知到服务器提供的工具能力(如获取Marketo表单列表、克隆表单等)。在与AI对话时,如果用户的请求与这些工具的能力相关,AI可能会决定调用相应的工具来完成任务,例如:“帮我查找一下所有草稿状态的Marketo表单”。
信息
分类
商业系统