MCP — Conecte o Hermes a Milhares de Ferramentas

Se você já desejou que o Hermes pudesse usar uma ferramenta que já existe em outro lugar — um bot do GitHub, um cliente de banco de dados, um navegador de arquivos, uma API interna — o MCP (Model Context Protocol) é a forma mais limpa de tornar isso realidade.

O MCP permite que o Hermes se conecte a servidores de ferramentas externos, para que o agente possa usar ferramentas que vivem fora do próprio Hermes. Pense nele como um adaptador universal: em vez de escrever uma ferramenta nativa do Hermes do zero, você simplesmente aponta o Hermes para um servidor MCP e ele descobre quais ferramentas estão disponíveis.

O que o MCP oferece

Acesso a ecossistemas de ferramentas externas sem precisar escrever uma ferramenta nativa do Hermes primeiro
Servidores locais e remotos — servidores stdio e servidores MCP HTTP funcionam na mesma configuração
Descoberta automática de ferramentas na inicialização — o Hermes encontra e registra tudo automaticamente
Wrappers utilitários para recursos e prompts MCP quando o servidor os suporta
Filtragem por servidor — exponha apenas as ferramentas MCP que você realmente quer que o Hermes veja

Início rápido

O suporte a MCP já vem com a instalação padrão — nenhum passo extra é necessário. Veja como começar:

1. Adicione um servidor MCP ao ~/.hermes/config.yaml:

mcp_servers:
  filesystem:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/projects"]

2. Inicie o Hermes:

hermes chat

3. Peça ao Hermes para usar o recurso baseado em MCP.

Por exemplo:

Liste os arquivos em /home/user/projects e resuma a estrutura do repositório.

O Hermes descobrirá as ferramentas do servidor MCP e as usará como qualquer outra ferramenta. É isso — sem configuração extra, sem sintaxe especial.

Catálogo: instalação com um clique para MCPs aprovados pela Nous

O Hermes vem com um catálogo selecionado de servidores MCP que a equipe da Nous revisou e mesclou. Eles estão desativados por padrão — instale apenas o que você realmente quiser.

hermes mcp                # seletor interativo (padrão)
hermes mcp catalog        # lista em texto puro, scriptável
hermes mcp install n8n    # instala uma entrada do catálogo pelo nome

O seletor mostra cada entrada com seu status atual:

n8n          disponível              Gerencie e inspecione workflows do n8n a partir do Hermes
linear       ativado                 Gerenciamento de issues/projetos do Linear (OAuth remoto)
github       instalado (desativado)  Ferramentas de repositório + PR do GitHub

Pressione Enter em uma linha para instalar, ativar, desativar ou desinstalar. As entradas do catálogo podem exigir diferentes tipos de credenciais:

Chave de API — o Hermes solicita no momento da instalação e grava o valor em ~/.hermes/.env
OAuth (MCP remoto) — gravado como auth: oauth na sua configuração; o cliente MCP abre um navegador na primeira conexão
OAuth (provedor terceirizado) — o Hermes aponta você para hermes auth <provider> se você ainda não autenticou

Seleção de ferramentas na instalação

Após configurar as credenciais, o Hermes consulta o servidor MCP para listar todas as ferramentas que ele expõe e apresenta uma lista de verificação:

Selecione as ferramentas para 'linear' (ESPAÇO alterna, ENTER confirma)
  [x] find_issues       Encontra issues que correspondem a uma consulta
  [x] get_issue         Obtém uma única issue
  [x] create_issue      Cria uma nova issue
  [ ] delete_workspace  Exclui um workspace do Linear
  ...

As linhas pré-marcadas vêm de:

Sua seleção anterior, se você já instalou esta entrada antes
O tools.default_enabled do manifesto, se a entrada declarar um
Tudo, se nenhum dos casos se aplicar

Envie a lista de verificação com ENTER. Apenas as ferramentas marcadas vão para mcp_servers.<nome>.tools.include. Se você selecionar tudo, nenhum filtro é gravado — formato de configuração mais limpo, comportamento idêntico.

Se a sondagem falhar (servidor inacessível, OAuth ainda não concluído), a instalação ainda é bem-sucedida: os padrões do manifesto são aplicados diretamente, ou nenhum filtro é gravado. Execute hermes mcp configure <nome> novamente quando o servidor estiver acessível para refinar.

Modelo de confiança

Instalar uma entrada do catálogo executa o que o manifesto especifica — git clone, comandos de bootstrap e, em última instância, o próprio código do servidor MCP. Os manifestos passam por revisão de PR no repositório hermes-agent, então a Nous revisou cada entrada antes de ser publicada — mas você ainda deve ler o manifesto antes de instalar, especialmente o repositório no campo source:, os comandos install.bootstrap: e qualquer invocação de transport.command:.

Os manifestos ficam em optional-mcps/<nome>/manifest.yaml no GitHub. O seletor imprime a URL source: do manifesto no momento da instalação para que você possa verificar rapidamente o repositório upstream. O painel web, na página MCP, exibe o mesmo detalhe para cada entrada do catálogo — transporte, tipo de autenticação, URL do endpoint, fonte de instalação git, comandos de bootstrap e notas de configuração — com o source: renderizado como um link clicável.

Compatibilidade de versão do manifesto

Os manifestos fixam um manifest_version. O catálogo é compatível com versões futuras: se um PR adicionar uma entrada com uma versão mais recente do que a que seu Hermes instalado entende, o seletor mostrará um aviso (⚠ '<nome>' requer um Hermes mais recente) em vez de ocultá-la silenciosamente. Execute hermes update para instalar o Hermes mais recente quando você vir isso.

Substituição de `${ENV_VAR}` em tempo de execução

Dentro de transport.command, transport.args, transport.url e headers de uma entrada, os placeholders ${VAR} são resolvidos em tempo de execução a partir do seu ambiente — assim você pode manter segredos fora da sua configuração e referenciá-los dinamicamente.

Vindo do Claude Code?

O bloco mcpServers no seu ~/.claude.json mapeia para mcp_servers no config.yaml do Hermes — e o hermes import-agent claude-code migra isso (junto com skills e instruções) automaticamente.

O MCP é a forma mais rápida de dar superpoderes ao Hermes sem reinventar a roda. Experimente hoje.