mirror of
https://github.com/czlonkowski/n8n-mcp.git
synced 2026-01-30 06:22:04 +00:00
c2dc7c9c51
* fix: n8n_test_workflow webhookId resolution and form handling (v2.28.2) ## Bug Fixes - **webhookId Resolution**: Fixed trigger handlers using `node.id` instead of `node.webhookId` for building webhook URLs. This caused 404 errors when nodes had custom IDs. - **Chat Trigger URL**: Fixed chat triggers using wrong URL pattern. Now correctly uses `/webhook/<webhookId>/chat` endpoint. - **Form Content-Type**: Fixed form triggers failing with "Expected multipart/form-data" error by switching to proper multipart encoding. ## Enhancements - **Form Field Types**: Added support for all n8n form field types (text, textarea, email, number, password, date, dropdown, checkbox, file, hidden) - **Checkbox Arrays**: Automatically converts arrays to `field[]` format - **Helpful Warnings**: Reports missing required fields with names and labels - **Error Hints**: Provides complete field structure on failure Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * fix: address code review issues for form trigger improvements - Add form-data as direct dependency (was only in devDependencies) - Add TypeScript interfaces (FormFieldValue, FormFieldOption) replacing any types - Add FORM_FIELD_TYPES constants for type-safe switch statements - Add isValidBase64() validation for file uploads with size limits - Add MAX_FILE_SIZE_BYTES (10MB) constant with validation - Update form-handler.test.ts for FormData instead of JSON - Update trigger-detector.test.ts for chat URL /chat suffix Conceived by Romuald Członkowski - www.aiadvisors.pl/en 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * feat: configurable MAX_SESSIONS via N8N_MCP_MAX_SESSIONS env var (v2.28.3) (#468) Make MAX_SESSIONS limit configurable for multi-tenant SaaS deployments. - Add N8N_MCP_MAX_SESSIONS environment variable (default: 100) - Include safety floor with Math.max(1, ...) to prevent invalid configs - Update documentation in LIBRARY_USAGE.md, SESSION_PERSISTENCE.md - Update CLAUDE.md and CHANGELOG.md Fixes #468 Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * fix: add QEMU setup for multi-arch Docker builds Add docker/setup-qemu-action@v3 before Buildx setup to enable proper QEMU emulation for linux/arm64 builds on GitHub Actions. Fixes CI Docker build failure with "execve: No such file or directory" 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> --------- Co-authored-by: Claude <noreply@anthropic.com> Co-authored-by: Romuald Członkowski <romualdczlonkowski@MacBook-Pro-Romuald.local>
n8n-MCP Documentation
Welcome to the n8n-MCP documentation. This directory contains comprehensive guides for installation, configuration, and troubleshooting.
📚 Documentation Index
Getting Started
- Installation Guide - Comprehensive installation guide covering all methods
- Claude Desktop Setup - Step-by-step guide for Claude Desktop configuration
- Quick Start Tutorial - Basic overview and quick start instructions
Deployment
- HTTP Deployment Guide - Deploy n8n-MCP as an HTTP server for remote access
- Docker Deployment - Complete Docker deployment and configuration guide
- Release Guide - How to create releases and manage Docker tags
Reference
- Troubleshooting Guide - Solutions for common issues and errors
- HTTP Server Fix Documentation - Technical details of v2.3.2 HTTP server fixes
- Docker Optimization Guide - Reference for optimized Docker builds (~150MB)
- Changelog - Version history and release notes
🚀 Quick Links
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
- Check the Troubleshooting Guide
- Review HTTP Server Fix Documentation for v2.3.2 issues
- Open an issue on GitHub
📝 License
This project uses the Sustainable Use License. See LICENSE for details.