n8n工作流sdk MCP
使用Claude Code以编程方式管理n8n工作流的模板——使用MCP服务器工作流，让Claude使用TypeScript作为创作语言直接读取和更新您的n8n工作流程。
此模板旨在与 n8n工作流sdk-Claude代码技能，教授Claude完整的SDK API、正确的节点模式以及在TypeScript中创作n8n工作流的验证指南。
这是什么
此模板为您提供：
- Claude Code项目说明 (
CLAUDE.md)--教Claude TypeScript工作流约定、已知的SDK怪癖，以及如何通过MCP与n8n实例交互 - n8n MCP服务器工作流 (
n8n-workflow/)--您导入n8n的工作流，该工作流公开search_workflows,get_workflow,create_workflow，以及update_workflow通过MCP向Claude提供工具 - Playwright浏览器集成 --每次创建或更新工作流后，Claude都会在浏览器中打开工作流。你也可以让克劳德在任何时候目视检查画布。
- 可重复的模式 用于人工智能辅助的工作流创作、修改和部署
SDK如何融入
这 @n8n/workflow-sdk 是 不 您在本地安装的东西。它存在于MCP服务器工作流本身中，嵌入在代码节点中：
search_workflows--按名称搜索工作流，并返回一个包含ID和元数据的列表get_workflow--从n8n检索工作流的JSON，并使用SDK将其转换为TypeScript，然后返回给Claudecreate_workflow--从Claude接收TypeScript，使用SDK将其转换为n8n JSON，并创建新的工作流update_workflow--从Claude接收TypeScript，使用SDK将其解析回n8n JSON，并将更新推送到现有工作流
Claude完全使用TypeScript，从不处理原始n8n JSON。转换在n8n工作流中透明地进行。
先决条件
- 克劳德代码 安装
- n8n实例（自托管） 2.9.0或更高版本
- 在n8n实例上设置以下环境变量，以允许在Code节点内使用SDK：
NODE_FUNCTION_ALLOW_EXTERNAL="@n8n/workflow-sdk"- 这 n8n工作流sdk技能 安装在Claude Code中（见步骤8）
设置
1.克隆此存储库
克隆此存储库并导航到终端中的克隆文件夹。
2.配置n8n实例
将以下环境变量添加到n8n实例中并重新启动它：
NODE_FUNCTION_ALLOW_EXTERNAL="@n8n/workflow-sdk"3.导入和发布MCP工作流
导入 n8n-workflow/n8n workflow-sdk MCP.json 将其发布到n8n实例中。
4.使用Claude Code注册MCP服务器
打开 MCP触发器 节点，复制 生产URL，并从克隆的存储库文件夹中在终端中运行以下命令：
claude mcp add --transport sse n8n-workflows
5.安装Playwright MCP服务器
在同一个终端中，运行：
claude mcp add playwright-mcp npx @executeautomation/playwright-mcp-server6.更新CLAUDE.md
替换所有出现的 https://your-n8n-instance.com/ 使用您的n8n基本URL（出现两次）。
7.打开克劳德代码
在克隆的存储库文件夹中，打开Claude Code。所有MCP服务器现在从一开始就可用。
8.安装n8n工作流sdk技能
👉 在此处安装n8n工作流sdk技能 并按照安装说明进行操作。
之后关闭并重新打开Claude Code，以便技能完全加载。
运作原理
一旦设置好，只需自然地与Claude Code交谈即可。你可以说得很具体，也可以不干涉——剩下的由克劳德处理。
一次性委派所有任务：
“找到名为“发票处理器”的工作流，并将手动触发器替换为webhook。”
Claude将搜索、检索、更改、推回并在浏览器中打开它。
或者一步一步地走：
- 搜索 --让Claude按名称查找工作流。它返回一个包含名称和ID的列表，以便您可以选择正确的一个。
- 检索和检查 --Claude将工作流作为TypeScript获取。在触碰任何东西之前，你可以让克劳德解释、回顾或提出改进建议。
- 修改 --告诉克劳德要更改什么：交换节点、添加步骤、更新凭据、重新连接。Claude相应地编辑了TypeScript。
- 推 --Claude会自动将更新的工作流发送回n8n。
- 审查 --Claude在浏览器中打开工作流。你也可以让克劳德看看画布并给出反馈。
你也可以让克劳德 创建全新的工作流程 从头开始——描述一下它应该做什么。
使用它没有对错之分。你可以控制你委派了多少。