O que é agent-skills?

Esta habilidade orienta o assistente de IA no processo completo de configuração de servidores MCP (Model Context Protocol) remotos que utilizam autenticação OAuth no Hermes. Ela descreve o fluxo desde a adição do servidor via CLI nativa (`hermes mcp add`), passando pela execução interativa do fluxo OAuth em um PTY (pseudo-terminal) — onde o usuário deve autorizar no navegador — até a ativação explícita das ferramentas descobertas e verificação final com comandos como `hermes mcp list` e `hermes mcp test`. A habilidade é útil porque garante que a instalação siga os passos corretos sem expor códigos de autorização ou tokens no chat, preservando a segurança. Ela também cobre armadilhas comuns, como não salvar configurações após falhas de sonda de endpoint e não assumir sucesso apenas pela escrita de configuração, exigindo sempre uma verificação autenticada bem-sucedida. O escopo de ativação é por inicialização/sessão, então o usuário deve recarregar o MCP com `/reload-mcp` ou iniciar uma nova sessão para usar as novas ferramentas em conversas abertas.

Funciona com~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/aman-sharma-nine/agent-skills/tree/HEAD/skills/hermes-remote-mcp-setup

Documentação

Configuração de MCP Remoto no Hermes

Quando Usar

Use esta habilidade ao adicionar, autorizar, solucionar problemas ou verificar um servidor MCP OAuth remoto no Hermes.

Procedimento

Preserve a identidade e o endpoint do servidor solicitado. Use a URL exata fornecida pelo usuário primeiro. Se ela retornar uma resposta não MCP, consulte a documentação oficial do fornecedor ou os metadados do endpoint antes de tentar um endpoint alternativo; nunca substitua silenciosamente uma URL adivinhada.
Adicione servidores com capacidade OAuth usando a CLI nativa. Use:
```
hermes mcp add <name> --url <endpoint> --auth oauth
```
Adicione --connect-timeout 120 quando a autorização ou a descoberta de ferramentas estiver lenta.
Execute a configuração interativa através de um PTY. O fluxo OAuth inicial pode abrir um navegador e pausar para autorização. Mantenha o processo ativo, informe ao usuário para concluir a autorização no navegador e nunca solicite ou aceite códigos OAuth no chat.
Habilite as ferramentas explicitamente. Quando o Hermes listar as ferramentas descobertas, selecione todas apenas se o usuário pediu para instalar o servidor de forma geral; caso contrário, selecione o subconjunto solicitado. Em fluxos PTY, um y\r bruto pode ser necessário após um envio normal se o prompt de seleção permanecer aberto.
Verifique antes de relatar sucesso. Execute:
```
hermes mcp list
hermes mcp test <name>
hermes config get mcp_servers.<name>
```
Relate o endpoint, o método de autenticação, o status da conexão e a contagem exata de ferramentas descobertas/habilitadas.
Declare o escopo de ativação. A descoberta nativa de MCP tem escopo de inicialização/sessão. Informe ao usuário para executar /reload-mcp ou iniciar uma nova sessão antes de usar as ferramentas recém-adicionadas em uma conversa já aberta.

Armadilhas

Não salve um servidor após uma sonda de endpoint com falha, a menos que o usuário explicitamente queira uma configuração adiada e não verificada; uma página HTML 403 ou uma incompatibilidade de tipo de conteúdo SSE é evidência de que a URL não é o endpoint MCP utilizável.
Não afirme que a configuração OAuth foi bem-sucedida apenas porque o Hermes escreveu a configuração; exija um hermes mcp test autenticado bem-sucedido.
Mantenha credenciais, códigos de autorização, tokens de portador e URLs OAuth completos fora da memória, habilidades e chat; eles são segredos ou dados de sessão de curta duração.
Trate redirecionamentos de endpoint do fornecedor como um problema de descoberta, não como motivo para normalizar silenciosamente a URL do usuário; preserve a URL original no relatório e nomeie o endpoint alternativo verificado.

aman-sharma-nine/agent-skills