Installation

Choose Your Setup Method

Synta MCP supports two authentication methods:

OAuth

Easy setup - One-click install with automatic credential syncRequirements:

A Synta account at synta.io
Your n8n instance setup in your Synta account
A paid Claude plan (Pro, Team, or Enterprise)

For free plan users, see API Key installation.

API Key

Full control - Manual credential managementWorks on all Claude plans, but only in the desktop app.Requirements:

Node.js 16+ installed
Synta API Key from synta.io/mcp
Your n8n instance URL and API key

How to Get These Details

OAuth Requirements
API Key Requirements

Synta Account Setup

Go to synta.io
Click Continue with Google to sign up or log in
Complete the onboarding to configure your n8n instance URL and API key (and optionally login email and password for self-healing)
Your credentials are now stored securely for OAuth access

Your n8n instance must be publicly accessible (e.g., https://your-instance.app.n8n.cloud). Localhost URLs are not supported.

Install Node.js

Download and install Node.js 16 or higher from nodejs.org.Verify installation:

node --version

Get Your Synta API Key

Go to synta.io/mcp
Sign up or log in
Navigate to the API Keys section
Create a new API key and copy it

Get Your n8n Instance URL & API Key

n8n Instance URL: Your publicly accessible n8n URL (e.g., https://your-instance.app.n8n.cloud)n8n API Key:

Open your n8n instance and log in
Go to Settings → n8n API
Click “Create an API Key”, give it a label, and click “Create”
Copy and save the key (you won’t see it again!)

Localhost URLs are not supported. Your n8n instance must be publicly accessible.

(Optional) n8n Login Credentials for Self-Healing

For AI-driven workflow testing and self-healing capabilities, you can optionally add your n8n login credentials:

Login Email: Your n8n account email
Login Password: Your n8n account password

This enables advanced tools:

n8n_trigger_execution: Execute workflows directly, detect errors, and automatically fix issues
n8n_manage_pindata CRUD operations: Add/update/remove/clear pin data for testing workflows

Configuration by Client

Select your AI client below:

OAuth
API Key

OAuth provides automatic credential sync from your Synta account.

One-Click InstallRecommended

Click the button to add Synta MCP to Cursor automatically:

Add to Cursor

Manual Installation

Open Cursor Settings

Go to Cursor → Settings → Cursor Settings → Tools & MCP

Add MCP Server

Click on “New MCP Server” and add the configuration below:

{
  "mcpServers": {
    "synta-mcp": {
      "url": "https://mcp.synta.io/mcp"
    }
  }
}

Authenticate

When Cursor connects, it will open your browser for OAuth. Log in with the same account you used at synta.io.

Use API keys for manual credential management. Requires Node.js.

One-Click InstallRecommended

Click the button, then edit to add your credentials:

Add to Cursor

After installing, edit the config to replace YOUR_SYNTA_API_KEY, YOUR_N8N_URL, and YOUR_N8N_API_KEY.

Manual Installation

Open Cursor Settings

Go to Cursor → Settings → Cursor Settings → Tools & MCP

Add MCP Server

Click on “New MCP Server”, add the configuration below and save the file:

{
  "mcpServers": {
    "synta-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.synta.io/mcp",
        "--header",
        "X-Synta-Api-Key: YOUR_SYNTA_API_KEY",
        "--header",
        "X-N8n-Url: YOUR_N8N_URL",
        "--header",
        "X-N8n-Key: YOUR_N8N_API_KEY"
      ]
    }
  }
}

Replace Credentials

YOUR_SYNTA_API_KEY - Get from synta.io/mcp
YOUR_N8N_URL - Your n8n instance URL
YOUR_N8N_API_KEY - Your n8n API key

(Optional) Enable Self-Healing

Add n8n login credentials for AI-driven workflow testing:

{
  "mcpServers": {
    "synta-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.synta.io/mcp",
        "--header",
        "X-Synta-Api-Key: YOUR_SYNTA_API_KEY",
        "--header",
        "X-N8n-Url: YOUR_N8N_URL",
        "--header",
        "X-N8n-Key: YOUR_N8N_API_KEY",
        "--header",
        "X-N8n-Login-Email: YOUR_EMAIL",
        "--header",
        "X-N8n-Login-Password: YOUR_PASSWORD"
      ]
    }
  }
}

Self-Healing Benefits:

Enables n8n_trigger_execution - execute workflows and auto-fix errors
Enables n8n_manage_pindata CRUD operations - add/update/remove/clear pin data for testing
Full execution data for debugging

Highly recommended: Configure Rules & Agent Instructions to improve workflow quality.

OAuth (Paid Plans only)
API Key (Desktop app only)

OAuth requires a paid Claude plan (Pro, Team, or Enterprise) and works on both the Desktop app and Claude.ai website. For free plan users, please check the API Key tab.

Open Connectors Settings

Go to Settings → Connectors → Add custom connector

Add MCP Server

Name:

synta-mcp

Remote MCP server URL:

https://mcp.synta.io/mcp

Authenticate

API key authentication works on all Claude plans but only in the Claude Desktop app. Requires Node.js.

Locate Config File

Via Claude Desktop UI:

Go to Claude → Settings → Developer → Edit Config

Add Configuration

{
  "mcpServers": {
    "synta-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.synta.io/mcp",
        "--header",
        "X-Synta-Api-Key: YOUR_SYNTA_API_KEY",
        "--header",
        "X-N8n-Url: YOUR_N8N_URL",
        "--header",
        "X-N8n-Key: YOUR_N8N_API_KEY"
      ]
    }
  }
}

Replace Credentials

YOUR_SYNTA_API_KEY - Get from synta.io/mcp
YOUR_N8N_URL - Your n8n instance URL
YOUR_N8N_API_KEY - Your n8n API key

(Optional) Enable Self-Healing

Add n8n login credentials for AI-driven workflow testing:

{
  "mcpServers": {
    "synta-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.synta.io/mcp",
        "--header",
        "X-Synta-Api-Key: YOUR_SYNTA_API_KEY",
        "--header",
        "X-N8n-Url: YOUR_N8N_URL",
        "--header",
        "X-N8n-Key: YOUR_N8N_API_KEY",
        "--header",
        "X-N8n-Login-Email: YOUR_EMAIL",
        "--header",
        "X-N8n-Login-Password: YOUR_PASSWORD"
      ]
    }
  }
}

Self-Healing Benefits:

Enables n8n_trigger_execution - execute workflows and auto-fix errors
Enables n8n_manage_pindata CRUD operations - add/update/remove/clear pin data for testing
Full execution data for debugging

Save & Restart Claude Desktop

Save the file and restart Claude Desktop.

Highly recommended: Configure Rules & Agent Instructions to improve workflow quality.

OAuth
API Key

OAuth provides automatic credential sync from your Synta account.

Add MCP Server

Run this command in your terminal:

claude mcp add --transport http --scope user synta-mcp https://mcp.synta.io/mcp

Open Claude Code

Start Claude Code in your terminal:

claude

Access MCP Menu

Inside Claude Code, type this command and press Enter:

/mcp

Authenticate

You should see synta-mcp with a ⚠️ needs authentication message next to it. Navigate to it, press Enter, then select Authenticate and press Enter again. Claude Code will open a browser window. Log in with the same account you used at synta.io.

Confirm Success

After login, you should see: ✓ Authentication successful. Connected to synta-mcp.Verify the server is authenticated by running:

/mcp

Use API keys for manual credential management. Requires Node.js.

Add MCP Server

claude mcp add --scope user synta-mcp \
  -- npx -y mcp-remote https://mcp.synta.io/mcp \
  --header "X-Synta-Api-Key: YOUR_SYNTA_API_KEY" \
  --header "X-N8n-Url: YOUR_N8N_URL" \
  --header "X-N8n-Key: YOUR_N8N_API_KEY"

Replace Credentials

YOUR_SYNTA_API_KEY - Get from synta.io/mcp
YOUR_N8N_URL - Your n8n instance URL
YOUR_N8N_API_KEY - Your n8n API key

(Optional) Enable Self-Healing

Add n8n login credentials:

claude mcp add --scope user synta-mcp \
  -- npx -y mcp-remote https://mcp.synta.io/mcp \
  --header "X-Synta-Api-Key: YOUR_SYNTA_API_KEY" \
  --header "X-N8n-Url: YOUR_N8N_URL" \
  --header "X-N8n-Key: YOUR_N8N_API_KEY" \
  --header "X-N8n-Login-Email: YOUR_EMAIL" \
  --header "X-N8n-Login-Password: YOUR_PASSWORD"

Self-Healing Benefits:

Enables n8n_trigger_execution - execute workflows and auto-fix errors
Enables n8n_manage_pindata CRUD operations - add/update/remove/clear pin data for testing
Full execution data for debugging

Verify Installation

Run:

claude mcp get synta-mcp

Highly recommended: Configure Rules & Agent Instructions to improve workflow quality.

ChatGPT only supports OAuth authentication. This works with Pro, Plus, Business, Enterprise and Education paid plans on the web.

Enable Developer Mode

Go to Settings → Apps → Advanced settingsToggle Developer Mode on

Create MCP App

Go back and click “Create app”Name:

synta-mcp

MCP Server URL:

https://mcp.synta.io/mcp

Authentication: Leave as OAuth (default)

Authenticate

Click Create and log in with the same account you used at synta.io. Your n8n credentials are fetched automatically.

Connection issues? ChatGPT’s MCP link is very unstable. If the server doesn’t load, repeat the steps 3-5 times. This is a known ChatGPT issue, and we advise using other clients for now.

Highly recommended: Configure Rules & Agent Instructions to improve workflow quality.

OAuth
API Key

OAuth provides automatic credential sync from your Synta account.

Open MCP Settings

Click the three dots (…) at the top of the editor’s agent panel, then go to MCP Servers → Manage MCP Servers → View raw config

Add Configuration

Paste the following configuration and click Save:

{
  "mcpServers": {
    "synta-mcp": {
      "serverUrl": "https://mcp.synta.io/mcp"
    }
  }
}

Authenticate

When Antigravity connects, it will open your browser for OAuth. Log in with the same account you used at synta.io. Your n8n credentials are fetched automatically.

Refresh and Verify

Go back and click Refresh — you’ll see a list of available tools.

Use API keys for manual credential management. Requires Node.js.

Open MCP Settings

Click the three dots (…) at the top of the editor’s agent panel, then go to MCP Servers → Manage MCP Servers → View raw config

Add Configuration

Paste the following configuration and click Save:

{
  "mcpServers": {
    "synta-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.synta.io/mcp",
        "--header",
        "X-Synta-Api-Key: YOUR_SYNTA_API_KEY",
        "--header",
        "X-N8n-Url: YOUR_N8N_URL",
        "--header",
        "X-N8n-Key: YOUR_N8N_API_KEY"
      ]
    }
  }
}

Replace Credentials

YOUR_SYNTA_API_KEY - Get from synta.io/mcp
YOUR_N8N_URL - Your n8n instance URL
YOUR_N8N_API_KEY - Your n8n API key

(Optional) Enable Self-Healing

Add n8n login credentials for AI-driven workflow testing:

{
  "mcpServers": {
    "synta-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.synta.io/mcp",
        "--header",
        "X-Synta-Api-Key: YOUR_SYNTA_API_KEY",
        "--header",
        "X-N8n-Url: YOUR_N8N_URL",
        "--header",
        "X-N8n-Key: YOUR_N8N_API_KEY",
        "--header",
        "X-N8n-Login-Email: YOUR_EMAIL",
        "--header",
        "X-N8n-Login-Password: YOUR_PASSWORD"
      ]
    }
  }
}

Self-Healing Benefits:

Enables n8n_trigger_execution - execute workflows and auto-fix errors
Enables n8n_manage_pindata CRUD operations - add/update/remove/clear pin data for testing
Full execution data for debugging

Refresh and Verify

Go back and click Refresh — you’ll see a list of available tools.

Highly recommended: Configure Rules & Agent Instructions to improve workflow quality.

OAuth
API Key

OAuth provides automatic credential sync from your Synta account.

Command SetupRecommended

Enable rMCP Client

Enable experimental rMCP client support:

codex --config experimental_use_rmcp_client=true

Add MCP Server

Run this command in your terminal:

codex mcp add synta-mcp --url https://mcp.synta.io/mcp

Authenticate

When Codex connects, it will open your browser for OAuth. Log in with the same account you used at synta.io.

Verify Installation

Run:

codex mcp list

Direct Config File Setup

Codex requires extended timeout settings for Synta to work properly. If you see startup timeout errors, try increasing startup_timeout_sec to 40.

Open Configuration File

Open your global Codex configuration file in your preferred text editor:File path:

macOS/Linux: ~/.codex/config.toml
Windows: C:\Users\<YourUsername>\.codex\config.toml

Command example:

nano ~/.codex/config.toml

Enable Experimental Feature

At the top level of the file (not nested under any existing brackets), add:

experimental_use_rmcp_client = true

Add MCP Server

Add a new section for the Synta server at the bottom of the file:

[mcp_servers.synta-mcp]
url = "https://mcp.synta.io/mcp"
type = "http"
startup_timeout_sec = 30
tool_timeout_sec = 360

Authenticate

When Codex connects, it will open your browser for OAuth. Log in with the same account you used at synta.io.

Save and Verify

Save the file and exit your editor. Restart your terminal or Codex session to reload the configuration.Run:

codex mcp list

Use API keys for manual credential management. Requires Node.js.

Command SetupRecommended

Add MCP Server

codex mcp add synta-mcp \
  -- npx -y mcp-remote https://mcp.synta.io/mcp \
  --header "X-Synta-Api-Key: YOUR_SYNTA_API_KEY" \
  --header "X-N8n-Url: YOUR_N8N_URL" \
  --header "X-N8n-Key: YOUR_N8N_API_KEY"

Note: This command does not configure timeout settings. For extended timeouts, use the Direct Config File Setup below.

Replace Credentials

YOUR_SYNTA_API_KEY - Get from synta.io/mcp
YOUR_N8N_URL - Your n8n instance URL
YOUR_N8N_API_KEY - Your n8n API key

(Optional) Enable Self-Healing

Add n8n login credentials:

codex mcp add synta-mcp \
  -- npx -y mcp-remote https://mcp.synta.io/mcp \
  --header "X-Synta-Api-Key: YOUR_SYNTA_API_KEY" \
  --header "X-N8n-Url: YOUR_N8N_URL" \
  --header "X-N8n-Key: YOUR_N8N_API_KEY" \
  --header "X-N8n-Login-Email: YOUR_EMAIL" \
  --header "X-N8n-Login-Password: YOUR_PASSWORD"

Self-Healing Benefits:

Enables n8n_trigger_execution - execute workflows and auto-fix errors
Enables n8n_manage_pindata CRUD operations - add/update/remove/clear pin data for testing
Full execution data for debugging

Verify Installation

Run:

codex mcp list

Direct Config File Setup

Codex requires extended timeout settings for Synta to work properly. If you see startup timeout errors, try increasing startup_timeout_sec to 40.

Open Configuration File

Open your global Codex configuration file in your preferred text editor:File path:

macOS/Linux: ~/.codex/config.toml
Windows: C:\Users\<YourUsername>\.codex\config.toml

Command example:

nano ~/.codex/config.toml

Enable Experimental Feature

At the top level of the file (not nested under any existing brackets), add:

experimental_use_rmcp_client = true

Add MCP Server with Headers

Add a new section for the Synta server at the bottom of the file:

[mcp_servers.synta-mcp]
command = "npx"
args = [
  "-y",
  "mcp-remote",
  "https://mcp.synta.io/mcp",
  "--header",
  "X-Synta-Api-Key: YOUR_SYNTA_API_KEY",
  "--header",
  "X-N8n-Url: YOUR_N8N_URL",
  "--header",
  "X-N8n-Key: YOUR_N8N_API_KEY"
]
startup_timeout_sec = 30
tool_timeout_sec = 360

Replace Credentials

YOUR_SYNTA_API_KEY - Get from synta.io/mcp
YOUR_N8N_URL - Your n8n instance URL
YOUR_N8N_API_KEY - Your n8n API key

(Optional) Enable Self-Healing

Add n8n login credentials to the args array:

[mcp_servers.synta-mcp]
command = "npx"
args = [
  "-y",
  "mcp-remote",
  "https://mcp.synta.io/mcp",
  "--header",
  "X-Synta-Api-Key: YOUR_SYNTA_API_KEY",
  "--header",
  "X-N8n-Url: YOUR_N8N_URL",
  "--header",
  "X-N8n-Key: YOUR_N8N_API_KEY",
  "--header",
  "X-N8n-Login-Email: YOUR_EMAIL",
  "--header",
  "X-N8n-Login-Password: YOUR_PASSWORD"
]
startup_timeout_sec = 30
tool_timeout_sec = 360

Self-Healing Benefits:

Enables n8n_trigger_execution - execute workflows and auto-fix errors
Enables n8n_manage_pindata CRUD operations - add/update/remove/clear pin data for testing
Full execution data for debugging

Note: n8n_manage_pindata’s analyzePinDataRequirement mode works without login credentials.

Save and Verify

Save the file and exit your editor. Restart your terminal or Codex session to reload the configuration.Run:

codex mcp list

Highly recommended: Configure Rules & Agent Instructions to improve workflow quality.

OAuth
API Key

OAuth provides automatic credential sync from your Synta account.

Interactive SetupRecommended

Run Interactive Setup

Run this command in your terminal:

opencode mcp add

Follow the Prompts

Answer the interactive prompts:MCP server name:

synta-mcp

Select MCP server type: RemoteMCP server URL:

https://mcp.synta.io/mcp

Does this server require OAuth authentication?: YesDo you have a pre-registered client ID?: No

Authenticate

Run the auth command:

opencode mcp auth synta-mcp

Your browser will open for OAuth authentication. Log in with the same account you used at synta.io.

Verify Connection

Run:

opencode mcp list

Edit Config File Directly

Open Config File

Edit your OpenCode configuration file:File path:

macOS/Linux: ~/.config/opencode/opencode.json
Windows: %APPDATA%\opencode\opencode.json

Command example:

nano ~/.config/opencode/opencode.json

Add MCP Server Configuration

Add the following to your config file:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "synta-mcp": {
      "type": "remote",
      "url": "https://mcp.synta.io/mcp",
      "enabled": true
    }
  }
}

Authenticate

Run the auth command in your terminal:

opencode mcp auth synta-mcp

Your browser will open for OAuth authentication. Log in with the same account you used at synta.io.

Verify Connection

Run:

opencode mcp list

Use API keys for manual credential management. Requires Node.js.

Interactive SetupRecommended

Run Interactive Setup

Run this command in your terminal:

opencode mcp add

Follow the Prompts

Answer the interactive prompts:MCP server name:

synta-mcp

Select MCP server type: LocalEnter command to run:

npx -y mcp-remote https://mcp.synta.io/mcp --header "X-Synta-Api-Key: YOUR_SYNTA_API_KEY" --header "X-N8n-Url: YOUR_N8N_URL" --header "X-N8n-Key: YOUR_N8N_API_KEY"

Replace Credentials

Edit the command you just pasted and replace:

YOUR_SYNTA_API_KEY - Get from synta.io/mcp
YOUR_N8N_URL - Your n8n instance URL
YOUR_N8N_API_KEY - Your n8n API key

(Optional) Enable Self-Healing

To add self-healing capabilities, run the interactive setup again with the full command including login credentials:

opencode mcp add

When prompted for Enter command to run, paste:

npx -y mcp-remote https://mcp.synta.io/mcp --header "X-Synta-Api-Key: YOUR_SYNTA_API_KEY" --header "X-N8n-Url: YOUR_N8N_URL" --header "X-N8n-Key: YOUR_N8N_API_KEY" --header "X-N8n-Login-Email: YOUR_EMAIL" --header "X-N8n-Login-Password: YOUR_PASSWORD"

Replace all credentials including:

YOUR_EMAIL - Your n8n account email
YOUR_PASSWORD - Your n8n account password

Self-Healing Benefits:

Enables n8n_trigger_execution - execute workflows and auto-fix errors
Enables n8n_manage_pindata CRUD operations - add/update/remove/clear pin data for testing
Full execution data for debugging

Note: n8n_manage_pindata’s analyzePinDataRequirement mode works without login credentials.

Verify Installation

Run:

opencode mcp list

Edit Config File Directly

Open Config File

Edit your OpenCode configuration file:File path:

macOS/Linux: ~/.config/opencode/opencode.json
Windows: %APPDATA%\opencode\opencode.json

Command example:

nano ~/.config/opencode/opencode.json

Add MCP Server with Headers

Add the following to your config file:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "synta-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "mcp-remote",
        "https://mcp.synta.io/mcp",
        "--header",
        "X-Synta-Api-Key: YOUR_SYNTA_API_KEY",
        "--header",
        "X-N8n-Url: YOUR_N8N_URL",
        "--header",
        "X-N8n-Key: YOUR_N8N_API_KEY"
      ],
      "enabled": true
    }
  }
}

Replace Credentials

YOUR_SYNTA_API_KEY - Get from synta.io/mcp
YOUR_N8N_URL - Your n8n instance URL
YOUR_N8N_API_KEY - Your n8n API key

(Optional) Enable Self-Healing

Add n8n login credentials to the command array:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "synta-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "mcp-remote",
        "https://mcp.synta.io/mcp",
        "--header",
        "X-Synta-Api-Key: YOUR_SYNTA_API_KEY",
        "--header",
        "X-N8n-Url: YOUR_N8N_URL",
        "--header",
        "X-N8n-Key: YOUR_N8N_API_KEY",
        "--header",
        "X-N8n-Login-Email: YOUR_EMAIL",
        "--header",
        "X-N8n-Login-Password: YOUR_PASSWORD"
      ],
      "enabled": true
    }
  }
}

Self-Healing Benefits:

Enables n8n_trigger_execution - execute workflows and auto-fix errors
Enables n8n_manage_pindata CRUD operations - add/update/remove/clear pin data for testing
Full execution data for debugging

Note: n8n_manage_pindata’s analyzePinDataRequirement mode works without login credentials.

Verify Installation

Run:

opencode mcp list

Highly recommended: Configure Rules & Agent Instructions to improve workflow quality.

OAuth
API Key

OAuth provides automatic credential sync from your Synta account. Requires the mcporter skill.

Command Setup

Install the mcporter Skill

In the OpenClaw gateway UI:

On the sidebar, navigate to Agent → Skills and search for mcporter.
Expand Built-in skills, find the mcporter skill, click Install, and wait until it shows Installed.

Add Synta MCP

Run the command for your OS:

mcporter config add synta \
  --url "https://mcp.synta.io/mcp" \
  --auth oauth \
  --config ~/.openclaw/workspace/config/mcporter.json

Authenticate

Run the auth command:

mcporter auth synta-mcp --config ~/.openclaw/workspace/config/mcporter.json

A browser window will open. Log in with your Synta account and finish when you see Authorization successful.

Expected mcporter bug: If you see this message after signing in:

Failed to authorize ‘synta-mcp’: MCP error -32001: Request timed out

This is a mcporter bug. Authentication can still succeed and the MCP can still work normally.

Enable full tool profile and restart gateway

Run this command:

openclaw config set tools.profile full && openclaw gateway restart

Verify Synta MCP is available

Run:

mcporter list --config ~/.openclaw/workspace/config/mcporter.json

You should see synta-mcp in the list of configured MCP servers.

Use API keys for manual credential management. Requires the mcporter skill and Node.js installed.

Command Setup

Install the mcporter Skill

In the OpenClaw gateway UI:

On the sidebar, navigate to Agent → Skills and search for mcporter.
Expand Built-in skills, find the mcporter skill, click Install, and wait until it shows Installed.

Add Synta MCP with API key headers

Run the command for your OS:

mcporter config add synta \
  --url "https://mcp.synta.io/mcp" \
  --header "X-Synta-Api-Key=YOUR_SYNTA_API_KEY" \
  --header "X-N8n-Url=YOUR_N8N_URL" \
  --header "X-N8n-Key=YOUR_N8N_API_KEY" \
  --config ~/.openclaw/workspace/config/mcporter.json

Replace credentials

YOUR_SYNTA_API_KEY - Get from synta.io/mcp
YOUR_N8N_URL - Your n8n instance URL
YOUR_N8N_API_KEY - Your n8n API key

(Optional) Enable Self-Healing

Add n8n login credentials for self-healing:

mcporter config add synta \
  --url "https://mcp.synta.io/mcp" \
  --header "X-Synta-Api-Key=YOUR_SYNTA_API_KEY" \
  --header "X-N8n-Url=YOUR_N8N_URL" \
  --header "X-N8n-Key=YOUR_N8N_API_KEY" \
  --header "X-N8n-Login-Email=YOUR_EMAIL" \
  --header "X-N8n-Login-Password=YOUR_PASSWORD" \
  --config ~/.openclaw/workspace/config/mcporter.json

Self-Healing Benefits:

Enables n8n_trigger_execution - execute workflows and auto-fix errors
Enables n8n_manage_pindata CRUD operations - add/update/remove/clear pin data for testing
Full execution data for debugging

Note: n8n_manage_pindata’s analyzePinDataRequirement mode works without login credentials.

Enable full tool profile and restart gateway

Run this command:

openclaw config set tools.profile full && openclaw gateway restart

Verify Synta MCP is available

Run:

mcporter list --config ~/.openclaw/workspace/config/mcporter.json

You should see synta in the list of configured MCP servers.

Highly recommended: Configure Rules & Agent Instructions to improve workflow quality.

OAuth
API Key

OAuth provides automatic credential sync from your Synta account.

Open MCP Settings

Go to Windsurf → Settings → Windsurf Settings, click the Cascade tab on the left-hand sidebar, find the MCP Servers heading and click on “Open MCP Marketplace”.

Add Configuration

In the text labelled “Installed MCPs” on the right-hand side, click the gear icon to open the raw configuration editor.Paste the following configuration and save:

{
  "mcpServers": {
    "synta-mcp": {
      "serverUrl": "https://mcp.synta.io/mcp"
    }
  }
}

Authenticate

When you save the configuration, Windsurf will prompt you to authorize. Log in with the same account you used at synta.io. Your n8n credentials are fetched automatically.

Verify Installation

Go back to the MCP Marketplace tab and confirm that synta-mcp appears in your list of installed servers.

Use API keys for manual credential management. Requires Node.js.

Open MCP Settings

Go to Windsurf → Settings → Windsurf Settings, click the Cascade tab on the left-hand sidebar, find the MCP Servers heading and click on “Open MCP Marketplace”.

Add Configuration

In the text labelled “Installed MCPs” on the right-hand side, click the gear icon to open the raw configuration editor.Paste the following configuration:

{
  "mcpServers": {
    "synta-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.synta.io/mcp",
        "--header",
        "X-Synta-Api-Key: YOUR_SYNTA_API_KEY",
        "--header",
        "X-N8n-Url: YOUR_N8N_URL",
        "--header",
        "X-N8n-Key: YOUR_N8N_API_KEY"
      ]
    }
  }
}

Replace Credentials

YOUR_SYNTA_API_KEY - Get from synta.io/mcp
YOUR_N8N_URL - Your n8n instance URL
YOUR_N8N_API_KEY - Your n8n API key

(Optional) Enable Self-Healing

Add n8n login credentials for AI-driven workflow testing:

{
  "mcpServers": {
    "synta-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.synta.io/mcp",
        "--header",
        "X-Synta-Api-Key: YOUR_SYNTA_API_KEY",
        "--header",
        "X-N8n-Url: YOUR_N8N_URL",
        "--header",
        "X-N8n-Key: YOUR_N8N_API_KEY",
        "--header",
        "X-N8n-Login-Email: YOUR_EMAIL",
        "--header",
        "X-N8n-Login-Password: YOUR_PASSWORD"
      ]
    }
  }
}

Self-Healing Benefits:

Enables n8n_trigger_execution - execute workflows and auto-fix errors
Enables n8n_manage_pindata CRUD operations - add/update/remove/clear pin data for testing
Full execution data for debugging

Verify Installation

Go back to the MCP Marketplace tab and confirm that synta-mcp appears in your list of installed servers.

Highly recommended: Configure Rules & Agent Instructions to improve workflow quality.

Verify Installation

After setup, verify by asking your AI agent:

Can you search for the slack node in n8n?

Your AI should respond with Slack node search results if configured correctly.

Having issues? Check the Troubleshooting page for common problems and solutions.

Getting Started

Features

Rules

Best Practices

Privacy

Choose Your Setup Method

OAuth

API Key

How to Get These Details

Configuration by Client

Verify Installation

Next Steps

Explore Agent Tools

Configure Agent Rules

Getting Started

Features

Rules

Best Practices

Privacy

​Choose Your Setup Method

OAuth

API Key

​How to Get These Details

​Configuration by Client

​Verify Installation

​Next Steps

Explore Agent Tools

Configure Agent Rules

Choose Your Setup Method

How to Get These Details

Configuration by Client

Verify Installation

Next Steps