runelay

runelay+agentes.chatGuia

Conecte o agentes.chat ao Runelay

O Runelay, gateway MCP open source, dá ao agentes.chat um endpoint para todas as contas que você conectou. Adicione uma vez e o agentes.chat enxerga as mesmas tools, skills e memórias dos seus outros agentes.

O que o agentes.chat ganha

Sem um gateway, o agentes.chat 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

  1. 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 | sh
  2. Crie 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.

  3. Adicione em a seção MCPs das Configurações

    Adicione um servidor por URL e cole a sua chave rnl_ no campo de chave de API; o agentes.chat manda como bearer token. Ele só aceita endereço https:// público: IP privado ou nome só do Tailscale é recusado. Se o Runelay roda só no seu tailnet, ligue o Tailscale Funnel (tailscale funnel --bg http://127.0.0.1:4312) ou dê um domínio a ele. Troque a URL e a chave pelas suas. Com o app desktop a URL é http://127.0.0.1:4312/v1/mcp.

    Server URL   https://runelay.example.com/v1/mcp
    API key      rnl_...
  4. Ainda sem atalho na CLI

    runelay connect escreve no Claude Code, Codex, Cursor e Grok, não no agentes.chat. Adicione o Runelay à mão uma vez; a chave vale até você revogar no painel.

  5. Confira o conector

    O agentes.chat testa o servidor ao adicionar e lista as ferramentas. O Runelay aparece como Ativo com 9 ferramentas, e todos os agentes do workspace podem usar; ferramentas sensíveis continuam pedindo aprovação de uma pessoa. Sem reiniciar.

Traga o que você já tem

runelay migrate ainda não lê o agentes.chat, então os servidores MCP e os logins dele ficam onde estão. Adicione no painel do Runelay, pela URL, os servidores remotos que você usa e o agentes.chat chega neles pelo endpoint.

runelay push e runelay pull também não mexem nos arquivos do agentes.chat. Memórias e skills chegam pelo endpoint, com search_context, read_memory e read_skill.

Depois de conectado, no agentes.chat

  • search_tools e call_tool alcançam todas as contas conectadas, como Linear, GitHub e Notion.
  • execute encadeia várias chamadas num runtime JavaScript isolado.
  • search_context, read_memory e write_memory compartilham memória com os outros agentes.
  • read_skill entrega as mesmas skills para todos os agentes.

Perguntas

Os tokens das minhas contas chegam ao agentes.chat?

Não. O agentes.chat 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 precisa de endereço público?

O agentes.chat recusa endereços de conector em rede privada para bloquear SSRF, sem opção para liberar. Um endereço https público com a chave rnl_ na frente basta.

Teste na sua máquinaGrátis e open source. Roda no seu computador ou no seu servidor.
Baixar o runelayInstalar no seu servidor