make-mcp-reference

Make MCP 服务参考

Make.com MCP 服务的技术参考 — 支持 AI 客户端执行场景并管理 Make 账户。

已知的 Make 模块 ID：Make Code 模块为 "module": "code:ExecuteCode"。

连接方式

Codex 快速设置

如果 Codex 插件已安装，但 codex mcp list 中没有 Make MCP 服务，请手动添加：

codex mcp add make --url https://mcp.make.com
codex mcp login make

登录后，请重新连接 Codex 会话或启动新会话，然后再测试工具。

OAuth（默认）

通过 OAuth 授权流程连接。身份验证期间选择组织和范围。

端点： https://mcp.make.com

URL 变体：

传输方式	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 计划或更高版本支持团队级限制。

MCP 令牌

在 Make 个人资料 → API access 标签页 → Add token 中生成令牌。

端点： https://<MAKE_ZONE>/mcp/u/<MCP_TOKEN>/stateless

URL 变体：

传输方式	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 令牌视为机密信息。切勿将其提交到版本控制系统。

范围

场景运行范围

允许 AI 客户端查看并运行已激活的按需场景。

• OAuth 范围：“运行你的场景”
• 令牌范围： mcp:use
• **适用计划：**所有计划

管理范围

允许 AI 客户端查看和修改账户内容（场景、连接、Webhook、数据存储、团队）。

• **适用计划：**仅限付费计划
• 启用对 Make 账户管理的精细控制

将场景配置为 MCP 工具

若要让场景显示为 MCP 工具：

1. 将场景状态设为已激活
2. 将计划设为按需
3. 选择适当的范围（令牌使用 mcp:use，OAuth 使用“运行你的场景”）
4. 配置场景输入 — 这些将成为工具参数
5. 配置场景输出 — 这些将成为工具返回值
6. 添加详细的场景描述 — 强烈建议这样做，以帮助 AI 理解工具用途并提升可发现性

输入/输出最佳实践：

• 使用清晰、描述性强的名称（AI Agent 会依赖这些名称）
• 添加详细描述，说明预期数据
• 尽量使用具体的数据类型，而非 Any
• 确保执行时间低于超时限制

访问控制（令牌身份验证）

通过 URL 查询参数限制可用的场景：

组织级别：

?organizationId=<id>

团队级别：

?teamId=<id>

场景级别（单个）：

?scenarioId=<id>

多个场景：

?scenarioId[]=<id1>&scenarioId[]=<id2>

各级别互斥 — 不能组合使用组织、团队和场景筛选条件。

超时

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

场景运行超时后，响应中会包含一个 executionId。场景会在 Make 中继续运行，最长可达 40 分钟。使用该 ID 调用 executions_get 以轮询结果。

高级配置

工具名称长度

使用查询参数自定义工具名称的最大长度：

?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、数据存储