How to Use the Activepieces MCP in Claude

Q: How do I connect Activepieces to Claude Desktop?

Open your claudedesktopconfig.json file and add the Activepieces server configuration block under the mcpServers key. Once you save and restart Claude Desktop, the MCP tools will show up under the hammer icon in your chat window.

Q: Can I build new automations in Activepieces using Claude Desktop?

Yes. You can command your agent to run createflow and build out steps using applyflowoperation. It builds the logic structure directly inside your Activepieces account.

Q: How do I handle third-party app authentication?

You run upsertappconnection to feed the required OAuth or secret tokens to the integration. This connects the flow securely to your external tools without exposing raw keys in plain chat.

Build, run, and debug your Activepieces automation flows directly inside Claude Desktop.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Activepieces MCP to Claude Desktop

Create your Vinkius account to connect Activepieces to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Activepieces with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Control Activepieces flows inside Claude Desktop

This MCP Server lets you initiate new automation flows directly inside your Activepieces account using the `create_flow` tool. You modify specific steps or change flow behaviors using `apply_flow_operation` without switching context. Instead of jumping back and forth between browser tabs, your agent handles updates on the fly. It checks current statuses with `list_flows` and cleans up old experiments using `delete_flow` directly from the chat window.

Securely configure your app credentials

The `upsert_app_connection` tool manages your external credentials and application integrations. You can store API keys, basic auth, or OAuth2 credentials securely. When projects wrap up, you remove old integrations entirely with `delete_app_connection`. This keeps your credentials updated without manual copy-pasting. Your agent handles the auth configuration directly through the MCP Server so you focus on the workflow logic itself.

Debug failing automation runs in real time

The `list_flow_runs` tool pulls your execution logs to show you exactly where an automation stopped. When a step fails, you call `get_flow_run` to inspect the exact input payload and error logs. No more guessing why a webhook failed. Your agent reviews the execution data and suggests immediate fixes to your active steps.

Setup guide

Set up Activepieces MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Activepieces MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Activepieces MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under activepieces-mcp.

json

{
  "mcpServers": {
    "activepieces-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Activepieces. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Activepieces now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Activepieces MCP in Claude Desktop

Open your claude_desktop_config.json file and add the Activepieces server configuration block under the mcpServers key. Once you save and restart Claude Desktop, the MCP tools will show up under the hammer icon in your chat window.

Yes. You can command your agent to run `create_flow` and build out steps using `apply_flow_operation`. It builds the logic structure directly inside your Activepieces account.

Absolutely. The MCP Server lets you switch contexts easily. You can run `list_projects` to find the right workspace and `invite_user` to bring team members into the project.

You run `upsert_app_connection` to feed the required OAuth or secret tokens to the integration. This connects the flow securely to your external tools without exposing raw keys in plain chat.

Your Activepieces credentials and API tokens never pass through external third-party servers. All requests run through a secure V8 sandbox that isolates your app connections and flow runs, discarding the session data immediately after execution.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript