runelay+Claude CodeGuide
Connect Claude Code to Runelay
Runelay, an open source MCP gateway, gives Claude Code one endpoint for every account you connected. Add it once and Claude Code sees the same tools, skills and memories as your other agents.
What Claude Code gets
Without a gateway, Claude Code connects to every MCP server on its own, loads each full tool list at connect and keeps its own logins.
With Runelay it connects to one endpoint, /v1/mcp. The gateway holds the credentials and exposes a small set of tools to search and call everything behind it. In our benchmark that was 1,045 context tokens at connect for 125 tools (Runelay 0.3.2, 14 Nov 2026, full numbers).
Set it up
Run Runelay
Use the desktop app, or install the server with Docker. Both serve the panel and the MCP endpoint on port 4312.
$curl -fsSL runelay.com/install | shCreate a key
In the panel, the agent setup guide creates a key that starts with
rnl_. Each agent can have its own key, so you can revoke one without touching the others.Add it to Claude Code
Replace the URL and the key with yours. With the desktop app the URL is
http://127.0.0.1:4312/v1/mcp.claude mcp add --scope user --transport http runelay https://runelay.example.com/v1/mcp \ --header "Authorization: Bearer rnl_..."Or let the CLI do it
runelay loginsaves a key for this computer andrunelay connectregisters Runelay in Claude Code, Codex, Cursor and Grok at once.$curl -fsSL runelay.com/cli | sh$runelay login && runelay connectRestart the agent
Claude Code loads MCP servers when a session starts. Open a new session and the Runelay tools are there.
Bring what you already have
runelay migrate reads the MCP servers, memories, skills and global instructions Claude Code already has. On macOS it can read the OAuth tokens Claude Code keeps in the Keychain, so those accounts arrive connected.
runelay push sends ~/.claude/skills, the project memories and ~/.claude/CLAUDE.md. runelay pull writes the shared brief into CLAUDE.md, only between the Runelay markers.
Once connected, in Claude Code
search_toolsandcall_toolreach every connected account, such as Linear, GitHub and Notion.executechains several calls in a sandboxed JavaScript runtime.search_context,read_memoryandwrite_memoryshare memory with your other agents.read_skillserves the same skills to every agent.
Questions
Do my account tokens reach Claude Code?
No. Claude Code only holds the Runelay key. OAuth tokens and API keys stay on your server, encrypted with AES-256-GCM using your RUNELAY_SECRET.
Do I need Docker?
No. The desktop app for Mac, Windows and Linux runs the same server on your computer. Docker is for a server that stays on.
Can I keep the MCP servers I already configured?
Yes. Runelay is one more MCP server in the config. If you migrate them, running runelay migrate --replace removes the migrated ones and leaves only Runelay.
Why --scope user?
User scope makes Runelay available in every project on this computer, instead of only the current folder.