Como Conectar o Agente Hermes ao MCP com Arcade.dev
Para desenvolvedores que executam o Hermes Agent da Nous Research, conectar-se a um servidor remoto do Model Context Protocol (MCP) é simples. Mas à medida que você adiciona mais serviços, enfrenta problemas reais: expansão da configuração, gerenciamento de credenciais e wrappers de API brutos que fazem o modelo de linguagem alucinar parâmetros e queimar tokens.
O gateway MCP da Arcade.dev dá ao seu Hermes Agent acesso a milhares de ferramentas otimizadas para agentes através de um único ponto de extremidade, com credenciais armazenadas longe do processo do agente e OAuth nativo para autenticação do gateway.
Nota de escopo: Uma pessoa, um perfil Hermes, um processo de gateway. Um serviço multiusuário compartilhado precisa de conexões MCP por usuário e armazenamento de tokens, além de uma fronteira de isolamento apropriada (containers ou separação em nível de SO, uma vez que os perfis Hermes não são sandboxes). As Fontes de Usuário da Arcade podem fornecer identidade externa para agentes de produção, mas não adicionam isolamento MCP por usuário ao Hermes por si só. Essa arquitetura é um problema separado.
TL;DR
-
Instale o suporte a MCP (incluído no instalador padrão; a partir do código-fonte:
uv pip install -e ".[mcp]"). - Apontar o Hermes para o seu gateway MCP da Arcade usando
auth: oauthem~/.hermes/config.yaml. Não coloque uma chave de API estáticaARCADE_API_KEYna configuração; o fluxo nativo de OAuth do Hermes estabelece uma sessão vinculada ao usuário na Arcade. - Autorizar cada ferramenta ou conjunto de escopo de provedor necessário através da
tools.authorizeAPI antes de executar chamadas de ferramentas que precisem delas. A Arcade armazena os tokens para que eles nunca cheguem ao modelo de linguagem. - Restringir a exposição de ferramentas com
tools.include/tools.excludepara o menor privilégio.
Como conectar o Hermes Agent a um servidor MCP (início rápido)
Antes de se conectar à Arcade, certifique-se de que sua instalação base do Hermes Agent suporta o Model Context Protocol. O instalador padrão inclui suporte a MCP por padrão. Se você estiver trabalhando a partir do código-fonte ou gerenciando um ambiente personalizado, instale os extras do MCP a partir da raiz do repositório:
Instalar suporte a MCP (a partir do código-fonte)
uv pip install -e ".[mcp]"
Adicionar um servidor MCP a ~/.hermes/config.yaml
Uma vez instalado, o Hermes roteia conexões através do bloco mcp_servers em config.yaml. Para um teste básico contra um servidor HTTP MCP padrão, defina a conexão e injete um token Bearer estático:
mcp_servers:
remote_test_api:
url: "https://mcp.internal.example.com"
headers:
Authorization: "Bearer ${REMOTE_TEST_API_KEY}"
Esse padrão é bom para um único desenvolvedor acessando um servidor de teste interno que ele controla. Para servidores remotos que suportam OAuth, prefira o fluxo nativo de OAuth do Hermes em vez de tokens estáticos.
Autenticar com o fluxo nativo de OAuth do Hermes
A maneira recomendada de conectar o Hermes a servidores MCP remotos protegidos por OAuth, incluindo a Arcade, é através de seu suporte nativo ao OAuth 2.1. Defina auth: oauth no bloco de configuração. Quando configurado, o Hermes lida com o registro dinâmico de clientes, imprime uma URL de autorização no terminal, abre seu navegador e aguarda o retorno em uma porta de loopback local.
mcp_servers:
my_server:
url: "https://example.com/mcp"
auth: oauth
Autenticar e recarregar ferramentas
Após salvar uma configuração de OAuth, execute hermes mcp login <server> a partir de um terminal novo. Isso fornece tempo suficiente para concluir a autenticação no navegador (cinco minutos, em comparação com a janela de 30 segundos durante o recarregamento automático da configuração). Uma vez autenticado, inicie ou reinicie o Hermes. Use /reload-mcp na interface de chat quando precisar atualizar as ferramentas registradas após alterações de configuração posteriores.
Verifique se as ferramentas foram carregadas com sucesso executando:
hermes mcp test <server>
Por que conectar o Hermes à Arcade
Você poderia conectar o Hermes a cada serviço individualmente, um servidor MCP para Gmail, outro para Slack, outro para seu CRM. Isso funciona até que você esteja gerenciando uma dúzia de blocos de configuração, cada um com suas próprias credenciais, timeouts e modos de falha. A Arcade resolve vários problemas de uma só vez.
Um ponto de extremidade em vez de muitos
O Gateway MCP da Arcade dá ao seu Hermes Agent acesso a milhares de ferramentas através de uma única URL. Em vez de gerenciar conexões de servidores separadas e acompanhar onde cada serviço está, seu Hermes Agent se comunica com um único gateway. A Arcade cuida do roteamento e da execução das ferramentas por trás disso.
Ferramentas otimizadas para agentes reduzem alucinações e custo de tokens
Wrappers de API brutos prejudicam o desempenho do agente porque são construídos para software determinístico, não para modelos de linguagem probabilísticos.
Quando um agente recebe uma definição de API bruta, ele frequentemente alucina parâmetros necessários, entra em loops de repetição em payloads JSON malformados e queima tokens tentando corrigir seus próprios erros. As ferramentas da Arcade são projetadas no nível da intenção, traduzindo linguagem natural em chamadas de API precisas. Em benchmarkings publicados, essa abordagem reduziu substancialmente o uso de tokens de resposta em comparação com o passthrough de API bruta, ao mesmo tempo em que diminuiu as taxas de alucinação de parâmetros.
Credenciais downstream permanecem fora do processo do agente
Armazenar chaves de API e tokens de OAuth em arquivos de ambiente é um risco real, mesmo para um único usuário. Relatórios recentes da GitGuardian identificaram dezenas de milhares de segredos únicos expostos em arquivos de configuração MCP públicos.
A Arcade armazena tokens de serviços downstream (Gmail, Slack, CRM, etc.) para que eles nunca cheguem ao Hermes ou ao contexto do modelo. A atualização e a revogação são centralizadas na Arcade, em vez de espalhadas por arquivos de configuração.
Como configurar o gateway MCP da Arcade no Hermes
Configuração do gateway
Defina a conexão do gateway em ~/.hermes/config.yaml
A integração do Agente Hermes com o MCP através do Arcade.dev pode otimizar a operação de empresas brasileiras, permitindo acesso a ferramentas otimizadas para agentes. Isso reduz a complexidade na gestão de credenciais e melhora a eficiência nas interações com APIs.
