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

API Key

Full control - Manual credential managementRequirements:

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

Configuration by Client

Select your AI coding agent below:

Cursor
Claude Desktop & Claude.ai
Claude Code
ChatGPT
Google Antigravity

OAuth
API Key

OAuth provides automatic credential sync - your n8n instance configured at synta.io/mcp is used automatically.

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 → MCPOr press Cmd+Shift+P (macOS) / Ctrl+Shift+P (Windows/Linux) and type “Cursor Settings”

Add MCP Server

Click “Add a Custom MCP Server” or edit your config file directly:Config file location:

macOS: ~/.cursor/mcp.json
Windows: %APPDATA%\Cursor\mcp.json
Linux: ~/.config/cursor/mcp.json

{
  "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 → MCPOr press Cmd+Shift+P (macOS) / Ctrl+Shift+P (Windows/Linux) and type “Cursor Settings”

Add MCP Server

Click “Add a Custom MCP Server” or edit your config file directly:Config file location:

macOS: ~/.cursor/mcp.json
Windows: %APPDATA%\Cursor\mcp.json
Linux: ~/.config/cursor/mcp.json

{
  "mcpServers": {
    "synta-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.synta.io/mcp",
        "--header",
        "Authorization: Bearer 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",
        "Authorization: Bearer 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:

AI tests workflows, detects errors, and automatically self-corrects issues
Execute workflows directly to verify functionality
Full execution data for debugging

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

OAuth (Paid Plans)
API Key (Free Plan - Desktop Only)

OAuth is available for Claude Pro, Team, and Enterprise users on both desktop and Claude.ai.

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 for Claude Free plan on Desktop only. Claude.ai access requires a paid plan with OAuth.Requires Node.js.

Locate Config File

Via Claude Desktop UI:

Go to Claude → Settings → Developer → Edit Config

Direct File Edit:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Add Configuration

{
  "mcpServers": {
    "synta-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.synta.io/mcp",
        "--header",
        "Authorization: Bearer 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",
        "Authorization: Bearer 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:

AI tests workflows, detects errors, and automatically self-corrects issues
Execute workflows directly to verify functionality
Full execution data for debugging

Restart Claude Desktop

Fully quit 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 synta-mcp https://mcp.synta.io/mcp

Authenticate

Claude Code will open a browser window. Log in with the same account you used at synta.io.

Verify Connection

claude mcp list

Use MCP Tools

Type /mcp in a conversation to see available tools.

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

Add MCP Server

Linux, macOS, Windows (WSL/Git Bash):

claude mcp add synta-mcp \
  -- npx -y mcp-remote https://mcp.synta.io/mcp \
  --header "Authorization: Bearer YOUR_SYNTA_API_KEY" \
  --header "X-N8n-Url: YOUR_N8N_URL" \
  --header "X-N8n-Key: YOUR_N8N_API_KEY"

Windows PowerShell:

claude mcp add synta-mcp `
  -- npx -y mcp-remote https://mcp.synta.io/mcp `
  --header "Authorization: Bearer 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:Linux, macOS, Windows (WSL/Git Bash):

claude mcp add synta-mcp \
  -- npx -y mcp-remote https://mcp.synta.io/mcp \
  --header "Authorization: Bearer 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:

AI tests workflows, detects errors, and automatically self-corrects
Execute workflows directly to verify functionality
Full execution data for debugging

Verify Installation

claude mcp list
claude mcp get synta-mcp

Already configured in Claude Desktop? Import with: claude mcp add-from-claude-desktop

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.

Antigravity only supports API key authentication for MCP servers. 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",
        "Authorization: Bearer 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",
        "Authorization: Bearer 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:

AI tests workflows, detects errors, and automatically self-corrects issues
Execute workflows directly to verify functionality
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.

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