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

$3

Provision and manage FlowEngine instances for your clients:
- List all instances with details
- Monitor health and performance
- Create new instances
- Update configurations
- Delete instances

$3

Access and monitor your client portals:
- View all client portal URLs and access details
- Monitor workflows and components per portal

$3

Create and manage UI components with AI:
- Build forms, chatbots, and widgets
- List all components across instances
- Update component configurations
- Delete components

Installation

$3

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

$3

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

$3

#### Claude Desktop

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

``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:

`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:

`json
{
"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

$3

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:
1. Ask Claude using the exact commands above
2. Claude will display a rich HTML dashboard
3. 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"
`

$3

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

$3


- 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

$3

- flowengine_list_portals - List all portals

$3

- 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

$3

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

$3

For self-hosted or custom deployments:

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

Development

$3

`bash


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
`

$3

`
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
`

$3

Point your MCP config to local build:

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

Troubleshooting

$3

Error: "FlowEngine API key not configured"

Solution: Verify FLOWENGINE_API_KEY is set in your MCP config

$3

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)

$3

Server doesn't appear in Claude

Solutions:
- Restart Claude Desktop / reload VSCode / start new Claude Code session
- Check MCP config JSON syntax is valid
- View logs: ~/.claude/debug/latest` (Claude Code)

Support

- FlowEngine Support: flowengine.cloud/support
- Documentation: docs.flowengine.cloud
- GitHub Issues: github.com/FlowEngine-cloud/flowengine/issues
- MCP Protocol: modelcontextprotocol.io

License

MIT License - See LICENSE file for details

Contributing

Contributions welcome! Please read our contributing guidelines before submitting PRs.

---

Built by the FlowEngine team