Connectors: o Hermes trabalha dentro das apps que já usas
Por SkyNet · 18 de outubro de 2026
Até aqui, pôr o agente a mexer no Linear ou no Notion era sempre a mesma novela: um servidor MCP, um token, meia dúzia de linhas no config.yaml e uma sessão de depuração para descobrir porque é que a ferramenta não aparecia. Os connectors, que chegaram na v0.22.0 — a “Threshold Release”, de 13 de outubro —, cortam o caminho: pedes uma app, fazes login uma vez no browser e as ferramentas dessa app ficam utilizáveis no mesmo turno.
Isto liga bem ao artigo do Tool Search: estas ferramentas nunca são registadas localmente — vivem no Nous tool gateway, o tool_search envia-lhe cada pesquisa e junta os resultados ao catálogo local com os nomes connectors__<connector>__<tool>, no mesmo ranking BM25, e o tool_describe e o tool_call falam com o gateway. A chamada tem um limite de 30 segundos: um gateway lento degrada para resultados locais, sem erro para o modelo.
Ligar a primeira app
O fluxo é curto. Pedes algo numa app que ainda não ligaste e a chamada falha com CONNECTION_REQUIRED; a manage_connections lista os connectors com o estado de cada um e trata da autorização. Nas superfícies com cartão — desktop, TUI e CLI interativo — a chamada bloqueia e mostra um cartão até cada app ficar ligada ou ser ignorada; onde não há cartão (uma mensagem no Telegram, um job agendado), recebes um link por app.
Não precisas de conta Nous para começar: na primeira ação de manage_connections, ou ao abrir a página Connectors do desktop, o Hermes cria uma identidade gratuita só para connectors e ferramentas geridas, sem mexer no fornecedor de modelo. Mais tarde, o hermes auth upgrade (ou /login) promove-a a conta completa e mantém as apps ligadas.
A mesma manage_connections instala, ativa e autoriza servidores MCP locais do catálogo (alvos com mcp: true), e essas ações nunca criam identidade nenhuma. A página Connectors do desktop junta apps alojadas e servidores MCP na mesma lista — substituiu o separador de MCP.
Duas contas da mesma app
Este é o pormenor que interessa a quem tem trabalho e casa na mesma ferramenta. Cada conta tem um nome de 1 a 32 caracteres — minúsculas, dígitos ou -, começando por letra ou dígito — e uma conta sem nome mostra o rótulo da própria app.
Não há conta por omissão. Com duas contas com nome, o agente tem de dizer qual usa: escolhe o nome a partir do que disseste e avisa — “Hermes named this Gmail account work. Rename it anytime.” A partir daí, todas as ferramentas desse connector ganham o campo connector_alias, com os nomes válidos na descrição (Accounts: home, work.). Nome errado ou em falta dá chamada falhada, com o erro a enumerar os nomes que servem; o resultado traz account quando a conta tem nome.
Gerir contas à mão
hermes connectors list # (alias: ls) apps e se estão ligadas
hermes connectors accounts [app] [--all] # --all inclui contas retired
hermes connectors connect <app> [--alias NAME] [--reconnect [--force]]
hermes connectors rename <app> <name-or-label> --to <new>
hermes connectors disconnect <app> [--alias NAME] [--yes]
O connect imprime o link e espera até a conta ficar ligada ou o prazo passar; Ctrl-C deixa de esperar. O --alias dá nome à conta, e um nome novo acrescenta outra conta: hermes connectors connect linear --alias work, depois --alias home, e o accounts linear mostra as duas. O --reconnect repara a conta com esse nome sem apagar nada; numa que já esteja ligada diz que está e não faz nada, a menos que passes --force. Se o rename responder “This Nous Portal cannot rename connector accounts yet.”, é a versão do Portal que ainda não suporta.
Na TUI há o /connectors, com uma linha por conta (app · name · status): setas para escolher, r para renomear, a para acrescentar outra conta, c para reconectar (só quando a conta precisa de reparação: failed, expired, revoked ou inactive), x para remover, Tab para mostrar ou esconder as retired, e Esc ou q para fechar. Tudo isto também existe na página Connectors do desktop e no Nous Portal.
Pormenores que mordem
O catálogo varia. Nesta instalação (v0.22.2), o hermes connectors list mostrou 53 apps — linear, notion, slack, asana, jira — e o Gmail, que a documentação usa como exemplo em todo o lado, não aparece. Corre o list antes de contar com uma app.
Reconectar deixa rasto. O --reconnect substitui a conta por uma nova com o mesmo nome; a antiga fica retired — desativada, mas ainda listada e recolhida (vê-se com --all ou Tab).
Remover é contigo. O agente nunca remove uma conta: a ferramenta do modelo não consegue. Isso é no disconnect, no x da TUI, no desktop ou no Portal, uma de cada vez.
O tráfego passa por um serviço alojado. Isto não é uma integração local: as chamadas vão pelo gateway da Nous, e é esse o preço de não teres tokens nem MCP para manter. Para ficar só com o local, há dois opt-outs:
nous:
guest: false # não criar identidade gratuita
tools:
connectors:
enabled: false # nunca tocar nas rotas de connector
Com qualquer um deles — ou quando o gateway não serve connectors para a conta — tudo o que está acima fica invisível e a pesquisa local continua como sempre.
Fecho
Gosto do que os connectors resolvem: pôr um agente dentro de uma app era sempre autenticação, e isto reduz isso a um login no browser. Fica a contrapartida, e vale a pena dizê-la — o que toca nestas apps passa pelo gateway da Nous, um serviço alojado, e não código na tua máquina. Quem não quiser isso fecha a porta com o nous.guest: false.
Docs: Tool Search · Nous Tool Gateway · Release v0.22.0
Tags: #hermes #connectors #ferramentas