n8n-mcp 接入 Claude从 Railway 一键上云到本地 Docker 部署的完整路径【免费下载链接】n8n-mcpA MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you项目地址: https://gitcode.com/GitHub_Trending/n8/n8n-mcp让 AI 帮你搭 n8n 工作流时最怕它编造不存在的节点名、写出参数对不上的配置——根源是模型对 n8n 节点体系没有权威知识。n8n-mcp 就是为此做的 MCP Server把 2,412 个 n8n 节点的元数据、属性 Schema 和 2,300 多个工作流模板打包成工具供 Claude Desktop、Cursor、Windsurf 等 AI 助手在动手前先查证。AI 到底靠 n8n-mcp 解决什么问题手工搭 n8n 工作流时最耗时的三件事是知道有哪些节点、每个节点接受什么参数、节点之间的连线是否合法。n8n-mcp 把这三类问题变成了模型能直接调用的工具search_nodes/get_node——检索 829 个核心节点加 1,583 个社区节点返回参数 Schema 与真实配置示例search_templates——从 2,352 个工作流模板库里直接取材首版不必从零画validate_workflow/n8n_create_workflow——建流程前校验结构与表达式连上真实实例后还能增删改工作流。客户端连接成功后会列出类似这样的工具清单有一点要提前记住别让 AI 直接修改生产环境的工作流。先复制一份、在开发环境跑通、验证无误再上线——项目 README 把这条安全警告放在了最前面不是客套。 云托管路线在 Railway 上让实例跑起来没有服务器预算时Railway 是最省事的一条路。按 Railway 部署文档里的入口点击部署用 GitHub 账号登录、选好区域大约两三分钟构建完成。唯一的强制动作是AUTH_TOKEN服务没有它拒绝启动。一键模板会预填一个占位值且服务会每 5 分钟提示一次直到替换为止。所以部署完先登录控制台进入服务的 Variables 标签页在本地生成一个真令牌贴进去openssl rand -base64 32保存后 Railway 自动重新部署。接着从服务页复制那个https://your-app-name.up.railway.app形式的 URL末尾补上/mcp才是完整的 MCP 端点——这个后缀是后文所有排障项里最高频的漏项。⚙️ 本地路线用 Docker 拉起 MCP Server想把数据留在自己机器上或者客户端和 n8n 实例都在内网就走 n8n-mcp Docker 部署这条线。先克隆代码仓库git clone https://gitcode.com/GitHub_Trending/n8/n8n-mcp cd n8n-mcp启动容器前要先导出同一个鉴权令牌compose 文件把AUTH_TOKEN声明为 HTTP 模式的必填变量缺失会直接报错。然后一条命令拉起export AUTH_TOKEN$(openssl rand -base64 32) docker-compose up -d容器默认映射 3000 端口本地端点即http://localhost:3000/mcp后面的客户端接法与云路线完全一致只是 URL 换了个前缀。接入 Claude Desktop把 mcp-remote 指向 /mcp 端点客户端侧要做的 MCP Server 配置本质是本地起一个 stdio 进程去桥接远端 HTTP 服务mcp-remote一行参数搞定。打开配置文件——macOS 在~/Library/Application Support/Claude/claude_desktop_config.jsonWindows 在%APPDATA%\Claude\claude_desktop_config.jsonLinux 在~/.config/Claude/claude_desktop_config.json——加入{ mcpServers: { n8n-railway: { command: npx, args: [ -y, mcp-remote, https://your-app-name.up.railway.app/mcp, --header, Authorization: Bearer YOUR_SECURE_TOKEN_HERE ] } } }保存后重启 Claude Desktop侧边栏出现 n8n 服务器和它的工具列表即代表接入成功。Windows 上如果 npx 不被识别把 command 改成nodeargs 第一项换成C:\Program Files\nodejs\node_modules\npm\bin\npx-cli.js其余参数不动。同样的机制在 Claude Code、Cursor、Windsurf、Codex 里都适用仓库为每个客户端备了独立指南Cursor 配置、Windsurf 配置、Claude Code 配置。接入自己的 n8n 实例解锁管理工具默认的 n8n-mcp 只扮演知识库 校验器。要让它真正管理生产实例——列工作流、看执行记录、触发 webhook、读写配置——需要再补两个环境变量指向已有的 n8n 实例N8N_API_URLhttps://n8n.your-domain.com N8N_API_KEYn8n 设置页生成的 API 密钥云路线直接加在 Variables 标签页截图即是添加N8N_API_URL的位置本地路线则在启动容器前 export。保存后服务自动重启工具列表随即多出十几个n8n_*管理工具。有一个联动项当N8N_API_URL指向 localhost 或内网地址时把WEBHOOK_SECURITY_MODE从默认的strict调成moderate否则 SSRF 防护会拦掉本地调用细节见 docs/N8N_DEPLOYMENT.md。 安全收口与三个高频连接坑默认参数已经偏保守但公网暴露的端点值得在环境变量里写死WEBHOOK_SECURITY_MODEstrict # SSRF 防护默认即 strict AUTH_RATE_LIMIT_WINDOW900000 # 认证限流窗口15 分钟 AUTH_RATE_LIMIT_MAX20 # 每 IP 最大认证尝试次数连不通时按顺序排查三处端点漏了/mcp后缀客户端 Bearer 令牌与服务端AUTH_TOKEN不一致配置 JSON 多了或少了一个逗号。三处都是 30 秒能改完的问题。验证动作现在就能做在 Claude 里问一句列出能发送 Slack 消息的前 5 个 n8n 节点并给出各自必填参数返回的节点名真实、参数与官方文档一致就算接入完成。更完整的自建选项参考 docs/SELF_HOSTING.md。【免费下载链接】n8n-mcpA MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you项目地址: https://gitcode.com/GitHub_Trending/n8/n8n-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 n8n-mcp 接入 Claude：从 Railway 一键上云到本地 Docker 部署的完整路径
n8n-mcp 接入 Claude从 Railway 一键上云到本地 Docker 部署的完整路径【免费下载链接】n8n-mcpA MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you项目地址: https://gitcode.com/GitHub_Trending/n8/n8n-mcp让 AI 帮你搭 n8n 工作流时最怕它编造不存在的节点名、写出参数对不上的配置——根源是模型对 n8n 节点体系没有权威知识。n8n-mcp 就是为此做的 MCP Server把 2,412 个 n8n 节点的元数据、属性 Schema 和 2,300 多个工作流模板打包成工具供 Claude Desktop、Cursor、Windsurf 等 AI 助手在动手前先查证。AI 到底靠 n8n-mcp 解决什么问题手工搭 n8n 工作流时最耗时的三件事是知道有哪些节点、每个节点接受什么参数、节点之间的连线是否合法。n8n-mcp 把这三类问题变成了模型能直接调用的工具search_nodes/get_node——检索 829 个核心节点加 1,583 个社区节点返回参数 Schema 与真实配置示例search_templates——从 2,352 个工作流模板库里直接取材首版不必从零画validate_workflow/n8n_create_workflow——建流程前校验结构与表达式连上真实实例后还能增删改工作流。客户端连接成功后会列出类似这样的工具清单有一点要提前记住别让 AI 直接修改生产环境的工作流。先复制一份、在开发环境跑通、验证无误再上线——项目 README 把这条安全警告放在了最前面不是客套。 云托管路线在 Railway 上让实例跑起来没有服务器预算时Railway 是最省事的一条路。按 Railway 部署文档里的入口点击部署用 GitHub 账号登录、选好区域大约两三分钟构建完成。唯一的强制动作是AUTH_TOKEN服务没有它拒绝启动。一键模板会预填一个占位值且服务会每 5 分钟提示一次直到替换为止。所以部署完先登录控制台进入服务的 Variables 标签页在本地生成一个真令牌贴进去openssl rand -base64 32保存后 Railway 自动重新部署。接着从服务页复制那个https://your-app-name.up.railway.app形式的 URL末尾补上/mcp才是完整的 MCP 端点——这个后缀是后文所有排障项里最高频的漏项。⚙️ 本地路线用 Docker 拉起 MCP Server想把数据留在自己机器上或者客户端和 n8n 实例都在内网就走 n8n-mcp Docker 部署这条线。先克隆代码仓库git clone https://gitcode.com/GitHub_Trending/n8/n8n-mcp cd n8n-mcp启动容器前要先导出同一个鉴权令牌compose 文件把AUTH_TOKEN声明为 HTTP 模式的必填变量缺失会直接报错。然后一条命令拉起export AUTH_TOKEN$(openssl rand -base64 32) docker-compose up -d容器默认映射 3000 端口本地端点即http://localhost:3000/mcp后面的客户端接法与云路线完全一致只是 URL 换了个前缀。接入 Claude Desktop把 mcp-remote 指向 /mcp 端点客户端侧要做的 MCP Server 配置本质是本地起一个 stdio 进程去桥接远端 HTTP 服务mcp-remote一行参数搞定。打开配置文件——macOS 在~/Library/Application Support/Claude/claude_desktop_config.jsonWindows 在%APPDATA%\Claude\claude_desktop_config.jsonLinux 在~/.config/Claude/claude_desktop_config.json——加入{ mcpServers: { n8n-railway: { command: npx, args: [ -y, mcp-remote, https://your-app-name.up.railway.app/mcp, --header, Authorization: Bearer YOUR_SECURE_TOKEN_HERE ] } } }保存后重启 Claude Desktop侧边栏出现 n8n 服务器和它的工具列表即代表接入成功。Windows 上如果 npx 不被识别把 command 改成nodeargs 第一项换成C:\Program Files\nodejs\node_modules\npm\bin\npx-cli.js其余参数不动。同样的机制在 Claude Code、Cursor、Windsurf、Codex 里都适用仓库为每个客户端备了独立指南Cursor 配置、Windsurf 配置、Claude Code 配置。接入自己的 n8n 实例解锁管理工具默认的 n8n-mcp 只扮演知识库 校验器。要让它真正管理生产实例——列工作流、看执行记录、触发 webhook、读写配置——需要再补两个环境变量指向已有的 n8n 实例N8N_API_URLhttps://n8n.your-domain.com N8N_API_KEYn8n 设置页生成的 API 密钥云路线直接加在 Variables 标签页截图即是添加N8N_API_URL的位置本地路线则在启动容器前 export。保存后服务自动重启工具列表随即多出十几个n8n_*管理工具。有一个联动项当N8N_API_URL指向 localhost 或内网地址时把WEBHOOK_SECURITY_MODE从默认的strict调成moderate否则 SSRF 防护会拦掉本地调用细节见 docs/N8N_DEPLOYMENT.md。 安全收口与三个高频连接坑默认参数已经偏保守但公网暴露的端点值得在环境变量里写死WEBHOOK_SECURITY_MODEstrict # SSRF 防护默认即 strict AUTH_RATE_LIMIT_WINDOW900000 # 认证限流窗口15 分钟 AUTH_RATE_LIMIT_MAX20 # 每 IP 最大认证尝试次数连不通时按顺序排查三处端点漏了/mcp后缀客户端 Bearer 令牌与服务端AUTH_TOKEN不一致配置 JSON 多了或少了一个逗号。三处都是 30 秒能改完的问题。验证动作现在就能做在 Claude 里问一句列出能发送 Slack 消息的前 5 个 n8n 节点并给出各自必填参数返回的节点名真实、参数与官方文档一致就算接入完成。更完整的自建选项参考 docs/SELF_HOSTING.md。【免费下载链接】n8n-mcpA MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you项目地址: https://gitcode.com/GitHub_Trending/n8/n8n-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考