3分钟跑通n8n-mcp一份完整部署并接入Claude的教程【免费下载链接】n8n-mcpA MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you项目地址: https://gitcode.com/GitHub_Trending/n8/n8n-mcpn8n-mcp是一个基于n8n的MCP服务把500多个节点的检索、工作流校验、模板生成封装成标准工具让Claude这类AI客户端能直接读懂你的工作流。这篇面向新手的n8n工作流MCP教程带你完成n8n-mcp部署并接入Claude Desktop不需要服务器背景照做就能跑通。 把n8n-mcp部署到云上只要3分钟推荐走Railway一键云部署在Railway的模板市场找到n8n-mcp点击Deploy用账号登录后等2到3分钟即上线。HTTPS和域名由平台自动配好你不用自己开端口、配证书。如果只想在本机跑三行就够先执行git clone https://gitcode.com/GitHub_Trending/n8/n8n-mcp拿到代码进入目录运行docker-compose up -d服务就挂在http://localhost:3000/mcp。后面的换令牌、接Claude这两步和云部署完全一样。 生成安全令牌并拿到服务地址要处理两件事。第一是换令牌服务启动时带一个占位令牌不改它日志会一直提示你。先在本机运行openssl rand -base64 32把输出的字符串复制到Railway的Variables标签页替换AUTH_TOKEN的值保存后会自动重新部署。第二是拿地址在服务的Deployments标签页你会看到一个https://your-app-name.up.railway.app形式的URL。在末尾加上/mcp这就是稍后接Claude要用的完整地址/mcp这个后缀别漏。 把n8n-mcp接进Claude Desktop打开Claude Desktop的配置文件三个系统的位置分别是macOS在~/Library/Application Support/Claude/claude_desktop_config.jsonWindows在%APPDATA%\Claude\claude_desktop_config.jsonLinux在~/.config/Claude/claude_desktop_config.json。文件不存在就新建一个。把下面配置加进去URL和Bearer后面的令牌换成上一步拿到的两个值{ 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在对话框输入/mcp查看状态看到 n8n-mcp 一行显示 connected、工具数39连接就成功了。如果你用的是Cursor或Windsurf做法一样把同样的URL和Authorization头填进它们各自的MCP配置即可。 连上之后马上能用的5个核心工具接好后你用自然语言说需求Claude会自己挑工具。39个工具里最常用的五个是search_nodes按名字或按任务找节点比如找一个发Slack消息的节点get_node_essentials拿到该节点的关键配置项和真实配置示例写参数时照着填search_templates检索两千多个官方模板Claude会先找现成的找不到再自己写validate_workflow把你刚生成的工作流校验一遍跑之前先接住连接和参数错误n8n_create_workflow把完成的工作流直接写回你的n8n实例如果你已有自己的n8n实例在Railway的Variables里补上下面这几个变量列表里的n8n_*管理类工具建工作流、查执行历史、触发webhook就会全部可用限流和SSRF保护参数也可以顺手调默认值对大多数人够用N8N_API_URLhttps://your-n8n.example.com N8N_API_KEYyour-api-key WEBHOOK_SECURITY_MODEstrict AUTH_RATE_LIMIT_MAX20 连不上时自查这3个点地址漏了/mcp完整地址必须以/mcp结尾只填https://your-app-name.up.railway.app会一直超时。令牌两边不一致核对Claude配置里Bearer后面的令牌和Railway的AUTH_TOKEN是否一字不差改过令牌后等Railway重新部署完成新令牌才生效。Windows下npx报错提示找不到命令时把command改成nodeargs首项指向npm自带的npx-cli.js{ mcpServers: { n8n-railway: { command: node, args: [ C:\\Program Files\\nodejs\\node_modules\\npm\\bin\\npx-cli.js, -y, mcp-remote, https://your-app-name.up.railway.app/mcp, --header, Authorization: Bearer YOUR_SECURE_TOKEN_HERE ] } } }部署细节的完整说明见 docs/RAILWAY_DEPLOYMENT.md想改用npx或本地安装见 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），仅供参考