Skip to Content
runelay
Connect agents

OpenCode

One block in opencode.json.

Add runelay to OpenCode with your endpoint and an agent key (rnl_…). Replace the URL and the key with yours; with the desktop app the URL is http://127.0.0.1:4312/v1/mcp.

~/.config/opencode/opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "runelay": {
      "type": "remote",
      "url": "https://runelay.example.com/v1/mcp",
      "oauth": false,
      "headers": { "Authorization": "Bearer rnl_..." }
    }
  }
}

Open a new session, or run opencode mcp list to see runelay connected. oauth: false matters: OpenCode tries a browser sign-in on every remote server unless it is off.

runelay connect writes this entry, with "enabled": true, into opencode.json in $XDG_CONFIG_HOME/opencode (default ~/.config/opencode). If you only have an opencode.jsonc, it writes there when the file is plain JSON, and asks you to add the entry by hand when it has comments. runelay migrate and runelay push read OpenCode too, and runelay pull writes the brief into ~/.config/opencode/AGENTS.md.

Step by step, with what OpenCode gets once connected: runelay.com/guides/opencode.