在 MonstarX 中使用 n8n
要点在“后端 → 云服务”的 n8n 一行中填写 n8n 实例地址和 n8n API 密钥。之后，MonstarX 的构建助手就能列出和读取你的工作流及执行记录，比如构建一个调用某个工作流 webhook 的应用，或查出某次运行失败的原因。它只读取，不会运行或修改工作流。
读取你的 n8n 工作流及其运行情况。
- 类型
- 业务工具 · API 密钥
- 类别
- 自动化
- 连接方式
- API 密钥
n8n 是一款工作流自动化工具：你把各种应用和步骤串成工作流（workflow），在触发条件满足时运行，每次运行就是一条执行记录（execution）。用 API 密钥（一串类似密码的代码，让软件可以使用你的 n8n）连接 n8n 实例后，MonstarX 的构建助手（就是和你聊天的那个 AI）在工作时就能读取你的工作流和运行情况：在把应用接到某个工作流的 webhook 之前，先看看它需要什么数据；或者查一查昨晚那次运行为什么失败。
这是一个业务工具：由 MonstarX 替你读取 n8n。你构建的应用永远拿不到你的密钥。
MonstarX 能用它做什么？
Section titled “MonstarX 能用它做什么？”| MonstarX 能做什么 | 什么时候 |
|---|---|
| 列出你的工作流，一次最多 100 个 | 任何模式 |
| 读取单个工作流：它的步骤和设置 | 任何模式 |
| 列出执行记录：所有工作流的，或某一个工作流的 | 任何模式 |
| 读取单条执行记录：某次运行的情况 | 任何模式 |
它绝不会做的事：运行、激活、停用、创建、编辑或删除工作流，或重试、停止执行。
- 一个能通过 HTTPS 以普通网址从互联网访问的 n8n 实例：n8n Cloud（如
https://your-name.app.n8n.cloud）或你自己的服务器。私有网络中的地址、纯 IP 地址和localhost都会被拒绝。 - n8n 的 API。n8n Cloud 免费试用期间无法使用 API，请先升级。如果是自托管实例，公共 API 不能被关闭。
- 你是这个 MonstarX 项目的所有者。只有所有者可以连接或断开工具。
获取你的密钥
Section titled “获取你的密钥”-
登录 n8n，进入 Settings > n8n API。
-
选择 Create an API key，设置 Label（如
MonstarX）和 Expiration（有效期）。 -
如果是 Enterprise 套餐，还需要选择 Scopes（权限范围）：给它
workflow:list、workflow:read、execution:list和execution:read。其他套餐的密钥拥有完全访问权限。 -
复制 My API Key。
n8n 官方指南：Authentication。
在 MonstarX 中连接
Section titled “在 MonstarX 中连接”-
打开你的项目，点击顶部栏中的后端，再点击云服务。
-
滚动到连接器，找到 n8n，点击连接。
-
在 n8n 实例 URL 中填写实例地址（只填地址，如
https://your-name.app.n8n.cloud），把密钥粘贴到 API 密钥输入框中，然后点击连接。 -
MonstarX 会通过列出一个工作流来检查两者。检查通过后，这一行会显示已连接到，后面是你的实例地址。如果地址或密钥被拒绝，你会看到错误信息，并且不会保存任何内容。
让 MonstarX 使用它
Section titled “让 MonstarX 使用它”| 你输入 | 会发生什么 |
|---|---|
| “读取我的 n8n 工作流‘New booking’，让预约表单提交到它的 webhook。” | MonstarX 读取这个工作流，弄清它的 webhook 需要什么，并在构建模式下把表单接上去。 |
| “我的‘Daily report’工作流昨晚为什么失败了？” | 它列出这个工作流的执行记录，读取失败的那一条，并解释原因。 |
| “我的 n8n 工作流中哪些是激活状态？” | 它列出你的工作流及其状态。 |
- 只留在 MonstarX。 密钥加密存储在 MonstarX 的服务器上，绝不会写进应用代码，也不会交给你的应用。
- 只读。 MonstarX 只读取。如果是 Enterprise 套餐，只给密钥读取权限范围。
- 只当作信息。 工作流数据和执行结果中可能包含你的业务数据；MonstarX 把它们当作信息，绝不当作指令。
- 随时断开。 在 后端云服务 中点击 n8n 旁边的断开连接，并确认 从此项目断开 n8n？。MonstarX 会删除地址和密钥。如果不再需要，也请在 Settings > n8n API 中删除这个密钥。
- 发往你实例的每个请求都必须在 15 秒内得到响应。非常慢或处于休眠状态的实例可能会超时，请重试。
- n8n 中的密钥过期后，请求会失败。请创建新密钥并重新连接。
- 如果想让应用触发某个工作流，请让 MonstarX 在应用中调用这个工作流的 webhook。webhook 地址属于工作流本身，与这个连接无关。
MonstarX 能运行我的 n8n 工作流吗？
不能通过这个连接运行，它只读取工作流和执行记录。不过你的应用仍然可以调用工作流的 webhook 来启动它，请让 MonstarX 构建这个功能。
支持自托管的 n8n 吗？
支持，前提是你的实例能通过 HTTPS 地址从互联网访问，并且公共 API 处于开启状态。私有网络中或 localhost 上的实例无法访问。
为什么我的密钥被拒绝？
请检查地址是否以 https:// 开头、不带 ? 部分，你的套餐是否包含 n8n API（Cloud 免费试用不包含），以及密钥是否已过期。