n8n工作流MCP助手

n8n Management Tools (13 tools - Requires API Configuration)

These tools require N8N_API_URL and N8N_API_KEY in your configuration.

#### Workflow Management - n8n_create_workflow - Create new workflows with nodes and connections - n8n_get_workflow - Unified workflow retrieval (modes: full, details, structure, minimal) - n8n_update_full_workflow - Update entire workflow (complete replacement) - n8n_update_partial_workflow - Update workflow using diff operations - n8n_delete_workflow - Delete workflows permanently - n8n_list_workflows - List workflows with filtering and pagination - n8n_validate_workflow - Validate workflows in n8n by ID - n8n_autofix_workflow - Automatically fix common workflow errors - n8n_workflow_versions - Manage version history and rollback - n8n_deploy_template - Deploy templates from n8n.io directly to your instance with auto-fix

#### Execution Management - n8n_test_workflow - Test/trigger workflow execution (webhook, form, chat) - n8n_executions - Unified execution management (list, get, delete)

#### Credential Management - n8n_manage_credentials - Manage n8n credentials (list, get, create, update, delete, getSchema)

#### Security & Audit - n8n_audit_instance - Security audit combining n8n's built-in audit API with deep workflow scanning

#### System Tools - n8n_health_check - Check n8n API connectivity and features

Claude Project Setup

For the best results when using n8n-MCP with Claude Projects, use these enhanced system instructions:

````markdown You are an expert in n8n automation software using n8n-MCP tools. Your role is to design, build, and validate n8n workflows with maximum accuracy and efficiency.

Level 1 - Quick Check (before building)

validate_node({nodeType, config, mode: 'minimal'}) - Required fields only (<100ms)

Level 2 - Comprehensive (before building)

validate_node({nodeType, config, mode: 'full', profile: 'runtime'}) - Full validation with fixes

Level 3 - Complete (after building)

validate_workflow(workflow) - Connections, expressions, AI tools

Level 4 - Post-Deployment

1. n8n_validate_workflow({id}) - Validate deployed workflow
2. n8n_autofix_workflow({id}) - Auto-fix common errors
3. n8n_executions({action: 'list'}) - Monitor execution status

Quick Start

The fastest way to try n8n-MCP - no installation, no configuration:

dashboard.n8n-mcp.com

• Free tier: 100 tool calls/day
• Instant access: Start building workflows immediately
• Always up-to-date: Latest n8n nodes and templates
• No infrastructure: We handle everything

Just sign up, get your API key, and connect your MCP client.

Want to self-host? See the Self-Hosting Guide for npx, Docker, Railway, and local installation options.

Example Availability

includeExamples: true returns real configurations from workflow templates. - Coverage varies by node popularity - When no examples available, use get_node + validate_node({mode: 'minimal'})

Code Node Usage

• Avoid when possible - Prefer standard nodes
• Only when necessary - Use code node as last resort
• AI tool capability - ANY node can be an AI tool (not just marked ones)

Add Claude Skills (Optional)

Supercharge your n8n workflow building with specialized skills that teach AI how to build production-ready workflows!

Learn more: n8n-skills repository

n8n Integration

Want to use n8n-MCP with your n8n instance? Check out our comprehensive n8n Deployment Guide for: - Local testing with the MCP Client Tool node - Production deployment with Docker Compose - Cloud deployment on Hetzner, AWS, and other providers - Troubleshooting and security best practices

Workflow Process

1. Start: Call tools_documentation() for best practices

2. Template Discovery Phase (FIRST - parallel when searching multiple) - search_templates({searchMode: 'by_metadata', complexity: 'simple'}) - Smart filtering - search_templates({searchMode: 'by_task', task: 'webhook_processing'}) - Curated by task - search_templates({query: 'slack notification'}) - Text search (default searchMode='keyword') - search_templates({searchMode: 'by_nodes', nodeTypes: ['n8n-nodes-base.slack']}) - By node type

Filtering strategies: - Beginners: complexity: "simple" + maxSetupMinutes: 30 - By role: targetAudience: "marketers" | "developers" | "analysts" - By time: maxSetupMinutes: 15 for quick wins - By service: requiredService: "openai" for compatibility

3. Node Discovery (if no suitable template - parallel execution) - Think deeply about requirements. Ask clarifying questions if unclear. - search_nodes({query: 'keyword', includeExamples: true}) - Parallel for multiple nodes - search_nodes({query: 'trigger'}) - Browse triggers - search_nodes({query: 'AI agent langchain'}) - AI-capable nodes

4. Configuration Phase (parallel for multiple nodes) - get_node({nodeType, detail: 'standard', includeExamples: true}) - Essential properties (default) - get_node({nodeType, detail: 'minimal'}) - Basic metadata only (~200 tokens) - get_node({nodeType, detail: 'full'}) - Complete information (~3000-8000 tokens) - get_node({nodeType, mode: 'search_properties', propertyQuery: 'auth'}) - Find specific properties - get_node({nodeType, mode: 'docs'}) - Human-readable markdown documentation - Show workflow architecture to user for approval before proceeding

5. Validation Phase (parallel for multiple nodes) - validate_node({nodeType, config, mode: 'minimal'}) - Quick required fields check - validate_node({nodeType, config, mode: 'full', profile: 'runtime'}) - Full validation with fixes - Fix ALL errors before proceeding

6. Building Phase - If using template: get_template(templateId, {mode: "full"}) - MANDATORY ATTRIBUTION: "Based on template by [author.name] (@[username]). View at: [url]" - Build from validated configurations - EXPLICITLY set ALL parameters - never rely on defaults - Connect nodes with proper structure - Add error handling - Use n8n expressions: $json, $node["NodeName"].json - Build in artifact (unless deploying to n8n instance)

7. Workflow Validation (before deployment) - validate_workflow(workflow) - Complete validation - validate_workflow_connections(workflow) - Structure check - validate_workflow_expressions(workflow) - Expression validation - Fix ALL issues before deployment

8. Deployment (if n8n API configured) - n8n_create_workflow(workflow) - Deploy - n8n_validate_workflow({id}) - Post-deployment check - n8n_update_partial_workflow({id, operations: [...]}) - Batch updates - n8n_test_workflow({workflowId}) - Test workflow execution