内容
# Make.com MCP 连接器
MCP 连接器（适用于 Claude Desktop 的扩展），它连接 Claude 与 **Make.com**（Integromat）— 列表、运行、启用/禁用和跟踪场景（scenario / 自动化）。
> ⚠️ **私人仓库。** 配置文件包含 Make API 令牌 — 请勿公开。
> 令牌 **不** 在代码中 — 安装时输入（见下文）。
它与 Basecamp 连接器是分开的 — 它们在 Claude Desktop 上并行工作，互不干扰。该项目共享 Basecamp 连接器的成熟基础设施（企业 TLS 修复、稳定的 stdio 启动），但使用 Make API 令牌进行身份验证，而不是 OAuth。
## 结构
| 文件 | 角色 |
|---|---|
| `server.js` | 整个逻辑 — 工具 + MCP 服务器 |
| `manifest.json` | 扩展清单（版本、启动器、工具列表、配置） |
| `package.json` | 依赖项 |
## 工具（简要）
- **组织/团队：** `make_list_organizations`，`make_list_teams`
- **场景：** `make_list_scenarios`，`make_get_scenario`
- **操作：** `make_run_scenario`（立即运行），`make_start_scenario`（启用），`make_stop_scenario`（禁用）
- **跟踪：** `make_list_executions`（历史），`make_get_execution`（单个执行详情）
- **数据存储：** `make_list_data_stores`，`make_get_records`，`make_add_record`，`make_update_record`，`make_delete_record`（仅删除特定键）
- **其他：** `make_open_in_browser`
## 配置（适用于用户）
用户 **无需安装任何额外软件** — Claude Desktop 内置 Node。
1. 从 **Releases** （或公司文件夹）下载最新的 `.mcpb` 文件。
2. 进入 Claude Desktop → 设置 → 扩展 → **从文件安装** → 选择 `.mcpb` 文件。
3. 安装时填写：
- **Make API 令牌** — 在 Make 中创建：右上角头像 → *个人资料 → API / MCP 访问 → 添加令牌*。
授予权限：`scenarios:read`，`scenarios:write`，`scenarios:run`，`teams:read`，`organizations:read`，`datastores:read`，`datastores:write`。
- **区域（zone）** — 在 Make 仪表盘的 URL 中可见（例如 `eu1.make.com` → 输入 `eu1`）。
可能的值：`eu1`，`eu2`，`us1`，`us2`。错误的区域会导致即使使用有效令牌也无法访问。
- **组织 ID / 团队 ID** （可选）— 如果您只有一个组织，则会自动选择。
4. 完全退出并重启 Claude Desktop。
## 开发者
```
npm install # 安装依赖项（构建/测试所需）
node --check server.js
```
本地启动（需要环境变量）：
```
# PowerShell
$env:MAKE_API_TOKEN="…"; $env:MAKE_ZONE="eu1"; node server.js
```
有用的环境变量：
| 变量 | 含义 |
|---|---|
| `MAKE_API_TOKEN` | API 令牌（必填） |
| `MAKE_ZONE` | 区域：`eu1`（默认），`us1`... 或完整主机 |
| `MAKE_API_BASE` | 基本 URL 的完整覆盖（可选） |
| `MAKE_ORG_ID` | 默认组织 |
| `MAKE_TEAM_ID` | 默认团队 |
## 构建 `.mcpb`（手动）
```
npm install
npx @anthropic-ai/mcpb pack . Make-mcp-<版本>.mcpb
```
`.mcpb` 是包含 `manifest.json` 的 zip 文件。`.mcpbignore` 排除 `.git`、`.env` 等文件。
## 发布新版本
1. 在 `manifest.json` **和** `package.json` 中更新版本号。
2. 构建 `.mcpb` 并上传到 Releases。
## Make API — 注意事項
- 基本 URL：`https://{zone}.make.com/api/v2`
- 身份验证：`Authorization: Token <令牌>` 头部
- 文档：https://developers.make.com/api-documentation
