runelay+OpenCodeGuia
Conecte o OpenCode ao Runelay
O Runelay, gateway MCP open source, dá ao OpenCode um endpoint para todas as contas que você conectou. Adicione uma vez e o OpenCode enxerga as mesmas tools, skills e memórias dos seus outros agentes.
O que o OpenCode ganha
Sem um gateway, o OpenCode se conecta a cada servidor MCP por conta própria, carrega a lista inteira de tools de cada um e guarda os próprios logins.
Com o Runelay ele se conecta a um endpoint, /v1/mcp. O gateway guarda as credenciais e expõe poucas tools para buscar e chamar tudo que está atrás dele. No nosso benchmark foram 1.045 tokens de contexto na conexão para 125 tools (Runelay 0.3.2, 14 nov 2026, números completos).
Passo a passo
Rode o Runelay
Use o app desktop ou instale o servidor com Docker. Os dois servem o painel e o endpoint MCP na porta 4312.
$curl -fsSL runelay.com/install | shCrie uma chave
No painel, o guia de configuração de agentes cria uma chave que começa com
rnl_. Cada agente pode ter a própria chave, então dá para revogar uma sem mexer nas outras.Adicione ao
~/.config/opencode/opencode.jsonO OpenCode lê servidores MCP na chave
mcp. Um servidor remoto étype: "remote", eoauth: falsediz ao OpenCode para usar a chave deheadersem vez de abrir um login no navegador. Umopencode.jsondentro de um repositório vale para um projeto. Troque a URL e a chave pelas suas. Com o app desktop a URL éhttp://127.0.0.1:4312/v1/mcp.{ "$schema": "https://opencode.ai/config.json", "mcp": { "runelay": { "type": "remote", "url": "https://runelay.example.com/v1/mcp", "oauth": false, "headers": { "Authorization": "Bearer rnl_..." } } } }Ainda sem atalho na CLI
runelay connectescreve no Claude Code, Codex, Cursor e Grok, não no OpenCode. Adicione o Runelay à mão uma vez; a chave vale até você revogar no painel.Abra uma sessão nova e confira
O OpenCode conecta nos servidores MCP quando inicia. Abra uma sessão nova, ou rode
opencode mcp listpara ver o Runelay conectado.$opencode mcp list
Traga o que você já tem
runelay migrate lê os servidores MCP do ~/.config/opencode/opencode.json, então os servidores remotos que você já usa ali vão para o Runelay e todos os agentes passam a compartilhá-los.
runelay push envia ~/.config/opencode/skills e o ~/.config/opencode/AGENTS.md, e assim o Claude Code e o Codex leem as mesmas skills e instruções.
Depois de conectado, no OpenCode
search_toolsecall_toolalcançam todas as contas conectadas, como Linear, GitHub e Notion.executeencadeia várias chamadas num runtime JavaScript isolado.search_context,read_memoryewrite_memorycompartilham memória com os outros agentes.read_skillentrega as mesmas skills para todos os agentes.
Perguntas
Os tokens das minhas contas chegam ao OpenCode?
Não. O OpenCode guarda só a chave do Runelay. Tokens OAuth e chaves de API ficam no seu servidor, criptografados com AES-256-GCM usando o seu RUNELAY_SECRET.
Preciso de Docker?
Não. O app desktop para Mac, Windows e Linux roda o mesmo servidor no seu computador. O Docker é para um servidor que fica sempre ligado.
Posso manter os servidores MCP que já configurei?
Sim. O Runelay é mais um servidor MCP na configuração. Se você migrar os outros, runelay migrate --replace remove os migrados e deixa só o Runelay.
Por que oauth: false?
O OpenCode tenta OAuth em todo servidor remoto, a menos que oauth seja false. O Runelay autentica com a chave rnl_ no header Authorization, então não há login para fazer.