MakeSync MCP Server 使用说明

项目简介

MakeSync MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，专门为 Make.com 自动化平台设计。它允许用户通过标准化的 MCP 接口，与 Make.com 的场景 (Scenarios) 进行交互，实现智能化的自动化工作流管理。

主要功能点

读取场景蓝图: 获取 Make.com 场景的完整 JSON 蓝图，包括实时版本和草稿版本。
智能模块更新: 根据 Make.com 模块的元数据规范，智能地更新模块字段，支持跨模块类型的通用更新。
安全更新机制: 采用 'confirm' 逻辑，确保场景更新的安全性，尤其是在安装新应用时。
自动 Mapper 封装: 自动为缺失的 Mapper 字段添加 '{{...}}' 封装，简化操作。
兼容性广泛: 兼容 Claude Desktop、本地 Node 环境和 GitHub 工作流，方便在不同环境中使用。
丰富的工具集: 提供了一系列工具，用于读取场景蓝图、更新场景参数、列出场景等，方便用户进行自动化任务管理。

安装步骤

配置 API 密钥: 首先，您需要拥有一个 Make.com API 密钥，并确保该密钥包含以下必要的权限范围：

agents:read apps:read connections:read datastores:read devices:read functions:read scenarios:read scenarios:run scenarios:write teams:read

将您的 Make.com API 密钥设置为环境变量 'MAKE_DOT_COM_API_KEY' 和 'MAKE_DOT_COM_TEAM_ID'。如果您需要指定Make.com的Base URL，可以设置 'MAKE_DOT_COM_BASE_URL' 环境变量，默认为 'eu2.make.com'。

安装依赖并构建项目: 在仓库根目录下，运行以下命令安装依赖并构建项目：
```
npm install && npm run build
```

服务器配置

以下是 MCP 客户端连接 MakeSync MCP Server 时所需的配置信息（JSON 格式）：

{
  "serverName": "makesync-mcp-server",
  "command": "node",
  "args": [
    "dist/index.js"  //  指向构建后的服务器入口文件
  ],
  "env": {
    "MAKE_DOT_COM_API_KEY": "<your_make_dot_com_api_key>", // 替换为您的 Make.com API 密钥
    "MAKE_DOT_COM_TEAM_ID": "<your_make_dot_com_team_id>"  // 替换为您的 Make.com 团队ID
    // "MAKE_DOT_COM_BASE_URL": "eu2.make.com" // 可选: 如果需要，指定 Make.com Base URL
  }
}

配置说明:

'serverName': MCP 服务器的名称，可以自定义。
'command': 启动 MCP 服务器的命令，这里使用 'node' 运行 JavaScript 代码。
'args': 传递给 'node' 命令的参数，指向编译后的 'index.js' 文件，该文件是 MakeSync MCP Server 的入口点。
'env': 环境变量配置，务必替换 '<your_make_dot_com_api_key>' 和 '<your_make_dot_com_team_id>' 为您实际的 Make.com API 密钥和团队 ID。'MAKE_DOT_COM_BASE_URL' 是可选的，用于指定 Make.com 的 Base URL。

基本使用方法

MakeSync MCP Server 提供了一系列 Tools，可以通过 MCP 客户端调用。以下是部分 Tools 的使用示例：

读取场景蓝图: 使用 'read_make_dot_com_scenario_blueprint' 工具，输入 'scenario_id' (场景 ID) 和可选的 'draft' (是否草稿版本) 参数，即可获取指定场景的 JSON 蓝图。
更新场景模块参数: 使用 'update_module_parameters' 工具，输入 'scenario_id'、'module_id' (模块 ID) 和 'parameters' (参数键值对) 参数，可以更新场景中指定模块的参数。

更多工具和详细使用方法，请参考仓库的 README 文档和工具的 inputSchema 定义。

注意: 请确保您的 Make.com API 密钥拥有足够的权限，并且已正确配置环境变量。

关键词