Files
n8n-mcp/docs
czlonkowski eab3cc858e fix: comprehensive error handling and node-level properties validation (fixes #26)
Root cause: AI agents were placing error handling properties inside `parameters` instead of at node level

Major changes:
- Enhanced workflow validator to check for ALL node-level properties (expanded from 6 to 11)
- Added validation for onError property values and deprecation warnings for continueOnFail
- Updated all examples to use modern error handling (onError instead of continueOnFail)
- Added comprehensive node-level properties documentation in tools_documentation
- Enhanced MCP tool documentation for n8n_create_workflow and n8n_update_partial_workflow
- Added test script demonstrating correct node-level property usage

Node-level properties now validated:
- credentials, disabled, notes, notesInFlow, executeOnce
- onError, retryOnFail, maxTries, waitBetweenTries, alwaysOutputData
- continueOnFail (deprecated)

Validation improvements:
- Detects misplaced properties and provides clear fix examples
- Shows complete node structure when properties are incorrectly placed
- Type validation for all node-level boolean and string properties
- Smart error messages with correct placement guidance

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-09 20:39:24 +02:00
..

n8n-MCP Documentation

Welcome to the n8n-MCP documentation. This directory contains comprehensive guides for installation, configuration, and troubleshooting.

📚 Documentation Index

Getting Started

Deployment

Reference

For Users

For Developers

📋 Environment Variables

Key configuration options:

Variable Description Default
MCP_MODE Server mode: stdio or http stdio
USE_FIXED_HTTP Use fixed HTTP implementation (v2.3.2+) true
AUTH_TOKEN Authentication token for HTTP mode Required
PORT HTTP server port 3000
LOG_LEVEL Logging verbosity info

See Installation Guide for complete list.

🆘 Getting Help

  1. Check the Troubleshooting Guide
  2. Review HTTP Server Fix Documentation for v2.3.2 issues
  3. Open an issue on GitHub

📝 License

This project uses the Sustainable Use License. See LICENSE for details.