Docs

Connect Claude Desktop and Cursor with AIBuildr (MCP)

Official guide to use n8n hosted on AIBuildr as a native backend for your AI Agents via Model Context Protocol (MCP).

Connect your AI to your Infrastructure

AIBuildr is optimized to act as the “executive brain” for your local AI agents. Thanks to the Model Context Protocol (MCP), you can allow Claude Desktop or Cursor to safely read, edit, and run workflows on your private n8n server.

Why do this?

  • Total Control: Your AI doesn’t just generate code; it can now execute real actions (webhooks, database queries, APIs).
  • Privacy: Sensitive data stays on your AIBuildr server, not in the AI cloud.
  • Speed: Run heavy tasks on your dedicated VPS, not on your local machine.

1. Configuration for Claude Desktop

To let Claude interact with your n8n instance, you need to add the MCP server configuration.

  1. Open the Claude configuration file:

    • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Add the following block (make sure to have your n8n API Key handy):

{
  "mcpServers": {
    "aibuildr-n8n": {
      "command": "npx",
      "args": [
        "-y",
        "@n8n/mcp-server",
        "--n8n-url",
        "https://n8n.yourdomain.aibuildr.tech",
        "--api-key",
        "your-n8n-api-key-here"
      ]
    }
  }
}
  1. Restart Claude Desktop. You will now see a “plug” 🔌 icon indicating that Claude is connected to your infrastructure.

2. Configuration for Cursor (AI IDE)

Cursor allows interacting with your n8n server directly from the code editor, ideal for developers building custom nodes.

  1. Go to Cursor Settings > Features > MCP.
  2. Click on + Add new MCP server.
  3. Fill in the details:
    • Type: command
    • Name: AIBuildr n8n
    • Command: npx -y @n8n/mcp-server --n8n-url https://n8n.yourdomain.aibuildr.tech --api-key your-api-key

Troubleshooting

Error: “Connection refused”

Ensure your n8n instance on AIBuildr is active and publicly accessible. AIBuildr automatically configures SSL, so make sure to use https://.

Error: “Invalid API Key”

Generate a new API Key in n8n:

  1. Enter your n8n panel.
  2. Go to Settings > Public API.
  3. Create a new key and copy it immediately.