Synapse MCP is available for macOS, Windows, and Linux.

1-CLICK INSTALLATION & CONFIGURATION GUIDE

Connect Synapse MCP to Your Editor

Synapse MCP runs locally as a high-performance HTTP / Server-Sent Events (SSE) server on port 8585. Use the 1-click installer to auto-detect and configure your editor, or paste the exact configuration snippet for your AI tool below.

🚀 Recommended: 1-Click Automatic Setup

Run the Synapse installer in your terminal. It automatically detects all installed IDEs, writes the correct config format for each, and registers global AI steering rules.

npx @myelixlabs/synapse-mcp

Or run non-interactively in quiet mode: npx @myelixlabs/synapse-mcp install --quiet

Already upgraded to Pro?
Activate immediately

After checkout succeeds, refresh the entitlement cached by your local installation to unlock Pro immediately. Choose any of these:

  1. Press Open Synapse
  2. OR Open the local Synapse Dashboard and press Refresh in the User tab.
  3. OR Run in your terminal:
    npx @myelixlabs/synapse-mcp auth refresh
Manual executable download
Direct binary

Download the public launcher directly if you do not want to use npm or the shell installer. Choose the file for your OS, save it as synapse-mcp (or synapse-mcp.exe on Windows), and put it on your PATH.

# Linux x86_64
curl -fL https://downloads.synapse-mcp.dev/synapse-mcp/latest/synapse-mcp-linux-x86_64 -o synapse-mcp
chmod +x synapse-mcp

# Linux ARM64
curl -fL https://downloads.synapse-mcp.dev/synapse-mcp/latest/synapse-mcp-linux-aarch64 -o synapse-mcp
chmod +x synapse-mcp

# macOS Apple Silicon
curl -fL https://downloads.synapse-mcp.dev/synapse-mcp/latest/synapse-mcp-darwin-aarch64 -o synapse-mcp
chmod +x synapse-mcp

# Windows x86_64
curl -fL https://downloads.synapse-mcp.dev/synapse-mcp/latest/synapse-mcp-windows-x86_64.exe -o synapse-mcp.exe
Required network access
Endpoints

Synapse MCP runs locally, but installation and authentication need access to these servers:

For offline usage or usage behind a corporate firewall, contact us for details about allow-listing, mirrored downloads, and managed deployment options.

Supported IDEs, Agents & Frameworks

Synapse MCP works natively with 23+ AI coding environments:

Cursor Auto-Configured
Windsurf Auto-Configured
Claude Code (CLI) Auto-Configured
Claude Desktop Auto-Configured
Warp Terminal Auto-Configured
Antigravity / Gemini Auto-Configured
VS Code / Copilot Auto-Configured
Cline Auto-Configured
Roo Code Auto-Configured
Zed Auto-Configured
OpenAI Codex Auto-Configured
Continue.dev Auto-Configured
Hermes Auto-Configured
Trae Auto-Configured
Factory.ai Auto-Configured
OpenClaw Auto-Configured
Qodo Auto-Configured
Devin Auto-Configured
JetBrains / IntelliJ Manual Setup
Bolt.new Manual Setup
Neovim (mcphub) Manual Setup
Helix Manual Setup
Emacs (mcp.el) Manual Setup

Manual IDE Configuration Snippets

If you prefer to configure your editor manually, copy the exact JSON/TOML/YAML snippet below for your tool.

Cursor
JSON
~/.cursor/mcp.json (Unix) or %APPDATA%\Cursor\User\mcp.json (Windows)
{
  "mcpServers": {
    "synapse": {
      "url": "http://localhost:8585"
    }
  }
}
Windsurf (Codeium)
JSON (serverUrl)
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "synapse": {
      "serverUrl": "http://localhost:8585"
    }
  }
}
Claude Code (CLI)
CLI / JSON
Run via terminal or edit .mcp.json / ~/.claude.json
claude mcp add synapse http://localhost:8585
Claude Desktop
JSON Bridge
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:8585"]
    }
  }
}
Warp Terminal
JSON
~/.warp/.mcp.json
{
  "mcpServers": {
    "synapse": {
      "url": "http://localhost:8585"
    }
  }
}
Antigravity / Gemini CLI
JSON (httpUrl)
~/.gemini/settings.json or ~/.gemini/config/mcp_config.json
{
  "mcpServers": {
    "synapse": {
      "httpUrl": "http://localhost:8585"
    }
  }
}
VS Code (GitHub Copilot)
JSON (servers)
.vscode/mcp.json or User/mcp.json
{
  "servers": {
    "synapse": {
      "type": "http",
      "url": "http://localhost:8585"
    }
  }
}
Cline & Roo Code
JSON
~/.cline/mcp.json or ~/.roo-code/mcp.json
{
  "mcpServers": {
    "synapse": {
      "url": "http://localhost:8585"
    }
  }
}
Zed
JSON (context_servers)
~/.config/zed/settings.json
{
  "context_servers": {
    "synapse": {
      "command": {
        "path": "npx",
        "args": ["mcp-remote", "http://localhost:8585"]
      }
    }
  }
}
OpenAI Codex CLI
TOML
~/.codex/config.toml
[mcp_servers.synapse]
url = "http://localhost:8585"
Continue.dev & Hermes
YAML
~/.continue/config.yaml or ~/.hermes/config.yaml
mcpServers:
  - name: synapse
    url: http://localhost:8585
JetBrains (IntelliJ, PyCharm, WebStorm)
GUI Settings

Configure via IDE settings UI (2025.2+):

  1. Open Settings (⌘+, on macOS / Ctrl+Alt+S on Windows/Linux)
  2. Navigate to: Tools → AI Assistant → Model Context Protocol (MCP)
  3. Click + (Add) and select transport type: HTTP
  4. Enter URL: http://localhost:8585 and click OK
CLI Editors (Neovim, Helix, Emacs)
Lisp / Lua / TOML
-- Neovim (mcphub.nvim)
synapse = { url = "http://localhost:8585" }

# Helix (~/.config/helix/config.toml)
[editor.mcp.servers.synapse]
url = "http://localhost:8585"

;; Emacs (mcp.el)
(use-package mcp :config (mcp-connect-http "synapse" "http://localhost:8585"))

Ready to Supercharge Your AI Agent?

Run the 1-click setup command now or upgrade to Synapse Pro for advanced impact analysis, crash trace resolution, and encrypted knowledge persistence.

Install Free Edition (npx @myelixlabs/synapse-mcp) → Upgrade to Pro ($19/mo) →