SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场make-mcp-reference

make-mcp-reference

智能体与模型

查看项目

更新于 10-15 15:10

技能介绍

Make MCP Server 是 Make.com 的 MCP 服务器技术参考，目标是让 AI 客户端能够执行 Make 场景并管理 Make 账户。已知的 Make 模块 ID 中，Make Code 模块为 "module": "code:ExecuteCode"。

一、连接方式

  1. Codex 快速设置 如果 Codex 插件已安装但 codex mcp list 中没有 Make MCP 服务器，可手动添加： codex mcp add make --url https://mcp.make.com codex mcp login make 登录后需重新连接 Codex 会话或新建会话，再测试工具。

  2. OAuth（默认） 通过 OAuth 同意流程连接，认证时选择组织和权限范围。 端点：https://mcp.make.com URL 变体：

  • 无状态 Streamable HTTP（默认）：https://mcp.make.com
  • Streamable HTTP：https://mcp.make.com/stream
  • SSE：https://mcp.make.com/sse 对于不支持 SSE 的客户端，可使用基于 Cloudflare mcp-remote 代理包装的旧版传输：npx -y mcp-remote https://mcp.make.com/sse。 Claude Code 配置示例： { "mcpServers": { "make": { "type": "http", "url": "https://mcp.make.com" } } } 访问控制：可在 OAuth 同意期间限制到特定组织。Teams 计划或更高版本支持团队级限制。
  1. MCP Token 在 Make 个人资料 → API access 标签页 → Add token 生成令牌。 端点：https://<MAKE_ZONE>/mcp/u/<MCP_TOKEN>/stateless URL 变体：
  • 无状态 Streamable HTTP：https://<ZONE>/mcp/u/<TOKEN>/stateless
  • Streamable HTTP：https://<ZONE>/mcp/u/<TOKEN>/stream
  • SSE：https://<ZONE>/mcp/u/<TOKEN>/sse
  • Header Auth：https://<ZONE>/mcp/stateless + Authorization: Bearer <TOKEN> Claude Code 配置示例： { "mcpServers": { "make": { "type": "http", "url": "https://<MAKE_ZONE>/mcp/u/<MCP_TOKEN>" } } } 将 <MAKE_ZONE> 替换为组织所在托管区域（例如 eu1.make.com、eu2.make.com、us1.make.com）。 安全：MCP 令牌应视为机密，切勿提交到版本控制。

二、权限范围（Scopes）

  1. 场景运行范围 允许 AI 客户端查看并运行激活的、按需调度的场景。
  • OAuth 范围："Run your scenarios"
  • Token 范围：mcp:use
  • 可用计划：所有计划
  1. 管理范围 允许 AI 客户端查看和修改账户内容（场景、连接、Webhook、数据存储、团队）。
  • 仅付费计划可用
  • 可对 Make 账户管理进行细粒度控制

三、将场景配置为 MCP 工具 要让场景作为 MCP 工具出现，需要：

  • 将场景设为激活状态
  • 将调度设为按需（on-demand）
  • 选择适当范围（Token 用 mcp:use，OAuth 用 "Run your scenarios"）
  • 配置场景输入——这些会成为工具参数
  • 配置场景输出——这些会成为工具返回值
  • 添加详细的场景描述——强烈建议，帮助 AI 理解工具用途并提升可发现性

输入/输出最佳实践：

  • 编写清晰、描述性的名称（AI 智能体依赖这些名称）
  • 添加详细描述，说明预期数据
  • 使用具体数据类型而非 Any
  • 保持执行时间在超时限制内

四、访问控制（Token 认证） 可通过 URL 查询参数限制哪些场景可用：

  • 组织级：?organizationId=<id>
  • 团队级：?teamId=<id>
  • 场景级（单个）：?scenarioId=<id>
  • 多个场景：?scenarioId[]=<id1>&scenarioId[]=<id2> 各层级互斥——不能同时组合组织、团队和场景过滤器。

五、超时

工具类型 | OAuth | Token（无状态） | Token（SSE/Stream） 场景运行 | 25s | 40s | 40s 管理 | 30s | 60s | 320s

当场景运行超过超时时间，响应会包含 executionId。场景会在 Make 中继续运行最多 40 分钟。可使用 executions_get 配合该 ID 轮询结果。

六、高级配置

工具名长度 可通过查询参数自定义工具名最大长度： ?maxToolNameLength=<32-160> 默认：56 个字符。

七、故障排查

问题 | 解决方案 场景未作为工具出现 | 检查：激活状态、按需调度、正确范围 超时错误 | 从 https://mcp.make.com 切换到区域特定的 https://<MAKE_ZONE>/mcp/<TRANSPORT> URL 以获得更长超时；或降低场景复杂度，或使用 SSE 传输 权限被拒绝 | 检查令牌范围和访问控制参数 连接被拒绝 | 验证区域 URL 和令牌有效性 工具列表陈旧 | 重新连接 MCP 客户端以刷新可用工具

八、资源

  • references/transport-details.md — 详细传输对比、URL 构造和区域列表
  • Make MCP Server 文档 — 官方文档
  • make-scenario-building 技能 — 场景构建：路由、过滤、迭代、聚合、错误处理、蓝图构建
  • make-module-configuring 技能 — 模块配置：参数、连接、映射、Webhook、数据存储