AutomationBridge: n8n Context Protocol Gateway

This utility functions as an MCP server, exposing the capabilities of an underlying n8n instance—including workflow orchestration, execution history, secret/credential handling, and metadata access—to AI agents through the established Model Context Protocol interface. This standardizes the secure invocation of complex business logic contained within n8n.

Deployment Instructions

Prerequisite: Obtaining Your n8n Access Token

1. Authenticate within your n8n deployment.
2. Navigate to the user profile area (typically in the lower-left corner).
3. Access 'Configuration Settings'.
4. Locate the 'API Key Management' section.
5. Generate a new credential token; note that this key is shown only once upon creation.

Server Installation

Method A: Direct Package Acquisition (Recommended)

Utilize Node Package Manager (npm) for straightforward global installation:

bash npm install -g @illuminaresolutions/n8n-mcp-server

Method B: Building from Source Code

1. Clone the repository source: bash git clone https://github.com/illuminaresolutions/n8n-mcp-server.git cd n8n-mcp-server

2. Resolve dependencies and compile the application: bash npm install npm run build

3. Initiate the service (running detached in the background): bash nohup npm start > n8n-mcp.log 2>&1 &

To terminate the running process: bash pkill -f "node build/index.js"

Note: When using Method A, the executable binary n8n-mcp-server is placed directly in your system's execution PATH.

Configuration Mapping for AI Environments

Integration with Claude Desktop Environment

Modify your Claude Desktop configuration file located at:

~/Library/Application Support/Claude/claude_desktop_config.json

Inject the following structure into the mcpServers mapping:

{ "mcpServers": { "n8n": { "command": "n8n-mcp-server", "env": { "N8N_HOST": "https://your-n8n-instance.com", "N8N_API_KEY": "your-api-key-here" } } } }

Integration with Cline (VS Code Extension)

1. Complete the server installation process (as detailed above).
2. Launch Visual Studio Code.
3. Open the Cline extension panel (accessible from the activity bar on the left).
4. Interact with the 'MCP Servers' control icon situated at the top of the panel.
5. Scroll to the bottom of the list and select 'Configure MCP Servers'.
6. Insert the configuration block into the displayed settings file:

{ "mcpServers": { "n8n": { "command": "n8n-mcp-server", "env": { "N8N_HOST": "https://your-n8n-instance.com", "N8N_API_KEY": "your-api-key-here" } } } }

1. Persist the changes by saving the file.
2. Verify that the MCP master toggle is active (indicated by a green state) and the connection status indicator shows 'Operational'.
3. Begin issuing MCP context requests via Cline commands.

Sage Integration

Future availability is planned via: - The Smithery.ai proprietary marketplace. - Direct importation mechanisms facilitated through Claude Desktop.

For immediate utility, please leverage the Cline or Claude Desktop interfaces.

Verification Protocol

Post-configuration initialization:

1. Reinitialize your primary LLM application instance.
2. Issue a context query, such as: "Enumerate available workflow definitions within n8n."
3. Successful execution will result in a structured list of your defined workflows.

If operational failure occurs, cross-reference the following: - Confirm the active status of the target n8n service endpoint. - Validate that the provided API token possesses the requisite operational permissions. - Ensure the N8N_HOST environment variable does not terminate with a path separator ('/').

Capabilities Spectrum

Foundational Functions

• Retrieval and modification of automation routines (workflows).
• Detailed inspection of workflow blueprints.
• Triggering workflow instances.
• Administration of stored security credentials/secrets.
• Management pertaining to execution records and associated labeling/tags.
• Generation of system security compliance assessments.

Extended/Enterprise Functions

These functionalities necessitate an active n8n Enterprise subscription: - Orchestration of organizational projects. - Parameter and variable lifecycle management. - Elevated user access and permission control handling.

Debugging Guidelines

Frequently Encountered Issues

1. Error: "Client not initialized"
2. Scrutinize environment variables N8N_HOST and N8N_API_KEY for typographical errors or absence.
3. Confirm network reachability to the n8n service.

4. Assert that the API token holds adequate scope.

5. Error: "License required"

6. Indicates an attempt to invoke an Enterprise-exclusive function.

7. Resolve by either upgrading the n8n license tier or restricting requests to Core features.

8. Connectivity Interruption

9. Verify the n8n gateway is responsive.
10. Inspect the URL scheme (must be HTTP or HTTPS).
11. Eliminate any extraneous trailing slash from the N8N_HOST definition.

Security Postures Recommendation

1. Token Handling:
2. Adhere to the Principle of Least Privilege for token scopes.
3. Institute a regular schedule for token invalidation and replacement.

4. Absolutely prohibit the inclusion of secret tokens within source code repositories.

5. Endpoint Protection:

6. Mandate HTTPS protocol usage for all production interfaces.
7. Ensure n8n authentication mechanisms are fully engaged.
8. Maintain the n8n core software at the most recent stable release level.

Assistance Channels

• Technical Issues Tracking: GitHub Issues
• Underlying Platform Reference: n8n Documentation

Regulatory Information

Governed by the terms stipulated in the MIT License

== Business System Utility Context == Business control apparatus encompasses all methodologies, computational infrastructures, analytical solutions, and governance frameworks employed by corporate entities to navigate dynamic market conditions, sustain competitive advantage, and drive operational efficacy improvement. This definition aligns with the strategic adoption of digital aids to bolster organizational performance.

== Functional Categorization of Management Aids == Management utilities can be segmented based on organizational division or specific managerial function. Classification by function often addresses fundamental aspects such as:

• Input and data integrity verification utilities applicable across all segments.
• Mechanisms for overseeing and optimizing operational workflows.
• Systems dedicated to aggregating information for strategic assessment and decision architecture.

The rapid evolution of technology has profoundly impacted the selection landscape for these tools over the past decade. The relentless drive toward cost minimization, revenue expansion, deep customer insight acquisition, and perfected product fulfillment necessitates a strategic, rather than purely trend-driven, approach to tool acquisition. Managers must carefully vet and tailor these systems to internal organizational requirements, rather than forcing organizational adaptation to off-the-shelf software.

== Prominent Management Instruments (2013 Survey Data) == A 2013 assessment by Bain & Company cataloged globally utilized business instruments, reflecting regional priorities and economic climates. The leading ten observed instruments included:

• Strategic planning frameworks
• Customer relationship management platforms
• Personnel satisfaction measurement (surveys)
• Competitive performance analysis (Benchmarking)
• Integrated performance measurement (Balanced Scorecard)
• Core capability identification
• Strategic outsourcing models
• Structured organizational transformation programs
• Logistics and flow optimization (Supply Chain Management)
• Foundational directive articulation (Mission/Vision statements)
• Customer base delineation (Market Segmentation)
• Comprehensive quality assurance methodologies (TQM)

== Business Software Application Definition == Business software refers to programmed codebases utilized by personnel to execute specialized corporate tasks. These applications are designed to enhance productivity metrics, quantify performance outcomes, and execute varied enterprise processes with precision. The progression moved from early Management Information Systems (MIS) to expansive Enterprise Resource Planning (ERP) suites, later incorporating Customer Relationship Management (CRM), culminating in today's cloud-centric management solutions. Value realization from IT investment hinges critically on both the efficacy of the deployment process and the judicious selection and customization of the employed applications.

== Specialized Tools for Small and Medium Enterprises (SMEs) == SME-focused apparatus is vital as it furnishes the requisite mechanisms for smaller organizations to attain operational leverage and scale...