flowengine-mcp-app

v2.0.1

Published

11 days ago

FlowEngine Model Context Protocol server for Claude. Manage n8n workflows, build UI components, configure client portals, and provision instances directly from Claude Desktop, VSCode, or CLI. Built with modern MCP Apps API.

0High
0Medium
0Low

flowengine.cloud

flowengine mcp mcp-app mcp-apps model-context-protocol claude automation n8n ui workflows no-code

FlowEngine MCP Server

Control your white-label automation platform directly from Claude

The official Model Context Protocol (MCP) server for FlowEngine. Manage instances, client portals, and build UI components using AI - all from Claude Desktop, VSCode, or Claude Code CLI.

What is FlowEngine?

FlowEngine is a white-label n8n automation platform that lets you build and deploy workflow automations for your clients. This MCP server brings FlowEngine's core capabilities into Claude for seamless management.

Core Features

Instance Management

Provision and manage FlowEngine instances for your clients:

List all instances with details
Monitor health and performance
Create new instances
Update configurations
Delete instances

Client Portals

Access and monitor your client portals:

View all client portal URLs and access details
Monitor workflows and components per portal

AI FlowBuilder

Create and manage UI components with AI:

Build forms, chatbots, and widgets
List all components across instances
Update component configurations
Delete components

Installation

Prerequisites

Node.js 18 or higher
FlowEngine account with API key (Get one here)
Claude Desktop, VSCode, or Claude Code CLI

Get Your API Key

Log in to FlowEngine
Go to Settings → API Access
Click "Generate API Key"
Copy your key (shown only once)

Quick Setup

Claude Desktop

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

{
  "mcpServers": {
    "flowengine": {
      "command": "npx",
      "args": ["-y", "flowengine-mcp-app"],
      "env": {
        "FLOWENGINE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code CLI

Edit ~/.claude/claude_code_config.json:

{
  "mcpServers": {
    "flowengine": {
      "command": "npx",
      "args": ["-y", "flowengine-mcp-app"],
      "env": {
        "FLOWENGINE_API_KEY": "your-api-key-here"
      }
    }
  }
}

VSCode (Claude Extension)

Add to your VSCode settings:

{
  "mcp.servers": {
    "flowengine": {
      "command": "npx",
      "args": ["-y", "flowengine-mcp-app"],
      "env": {
        "FLOWENGINE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Then restart Claude Desktop, start a new Claude Code session, or reload VSCode.

Usage

🎨 Interactive Dashboards (MCP Apps)

NEW! Visual dashboards with interactive HTML interfaces. Ask Claude:

| Command | What You Get | |---------|--------------| | "Show me the FlowEngine client portals dashboard" | Interactive dashboard with all your client portals, URLs, and storage details | | "Show me the AI FlowBuilder" | Visual dashboard for managing forms, chatbots, and widgets across all instances | | "Show me my FlowEngine instances" | Instance manager dashboard with resource details and quick actions |

How it works:

Ask Claude using the exact commands above
Claude will display a rich HTML dashboard
View all your data in a visual, organized format

Fallback: If dashboards don't appear, use text-based tools:

"Use flowengine_list_portals to show my portals"
"Use flowengine_list_instances"
"Use flowengine_list_components"

💬 Natural Language Commands

Manage your platform through conversation:

"List all my FlowEngine instances"
"What's the status of instance abc123?"
"Create a new contact form widget"
"Show me all UI components"
"Provision a new instance for Acme Corp"

Available Tools

Instance Management (5 tools)

flowengine_list_instances - List all instances
flowengine_get_instance_status - Get instance health
flowengine_create_instance - Provision new instance
flowengine_update_instance - Update settings
flowengine_delete_instance - Delete instance

Client Portals (1 tool)

flowengine_list_portals - List all portals

AI FlowBuilder (5 tools)

flowengine_list_components - List UI components
flowengine_get_component - Get component details
flowengine_create_component - Create form/chatbot/widget
flowengine_update_component - Update component
flowengine_delete_component - Delete component

Total: 11 tools (optimized to prevent API concurrency issues)

Resources

Interactive UI dashboards available via MCP Apps (MCP v1.1+):

ui://flowengine/portals - Client Portals Dashboard
ui://flowengine/ui-builder - AI FlowBuilder
ui://flowengine/instances - Instance Manager

Note: MCP Apps is a new feature announced January 26, 2026. Support may vary by client:

✅ Claude Desktop: Coming soon
✅ Claude Code: Check version compatibility
✅ VSCode: Depends on extension version

Configuration

Environment Variables

FLOWENGINE_API_KEY (required) - Your FlowEngine API key
FLOWENGINE_BASE_URL (optional) - Custom base URL (defaults to https://flowengine.cloud)

Custom Base URL

For self-hosted or custom deployments:

{
  "env": {
    "FLOWENGINE_API_KEY": "your-key",
    "FLOWENGINE_BASE_URL": "https://your-domain.com"
  }
}

Development

Local Development

# Clone and install
git clone https://github.com/FlowEngine-cloud/flowengine.git
cd flowengine/flowengine-mcp
npm install

# Build
npm run build

# Test locally
node build/index.js

Project Structure

flowengine-mcp/
├── src/
│   ├── index.ts       # MCP server
│   ├── client.ts      # FlowEngine API client
│   └── ui/            # Dashboard renderers
│       ├── base.ts
│       ├── portals.ts
│       ├── widgets.ts
│       └── instances.ts
├── package.json
├── tsconfig.json
└── README.md

Using Local Build

Point your MCP config to local build:

{
  "mcpServers": {
    "flowengine": {
      "command": "node",
      "args": ["/path/to/flowengine-mcp/build/index.js"],
      "env": {
        "FLOWENGINE_API_KEY": "your-key"
      }
    }
  }
}

Troubleshooting

API Key Issues

Error: "FlowEngine API key not configured"

Solution: Verify FLOWENGINE_API_KEY is set in your MCP config

Connection Issues

Error: "Failed to connect to FlowEngine API"

Solutions:

Check your internet connection
Verify API key is valid
Ensure FLOWENGINE_BASE_URL is correct (if using custom)

MCP Server Not Starting

Server doesn't appear in Claude