Torna al blog
HermesMCPIntegrationsAI Agents

Hermes Agent e MCP: un solo protocollo per ogni strumento

Come Hermes Agent usa il Model Context Protocol per connettersi a centinaia di strumenti esterni senza integrazioni personalizzate, e come aggiungerne di tuoi.

Di Hermify Team||7 min di lettura
Diagramma di interfaccia scura con Hermes Agent al centro collegato ai server MCP di GitHub, Slack, Postgres e Notion tramite linee verdi luminose

Perché MCP è importante per Hermes Agent

Per anni ogni assistente AI ha dovuto distribuire codice personalizzato per ogni strumento che voleva usare. GitHub richiedeva un'integrazione GitHub. Slack richiedeva un'integrazione Slack. Postgres richiedeva un adattatore per database. Il lavoro si moltiplicava a ogni nuovo strumento, e gran parte di esso diventava inutilizzabile non appena l'API sottostante cambiava.

Il Model Context Protocol (MCP) sostituisce quel modello con un unico standard aperto. Un server MCP espone uno strumento, una sorgente dati o un template di prompt in modo uniforme. Qualsiasi agente compatibile con MCP può connettersi ad esso senza scrivere nuovo codice di integrazione. L'ecosistema è cresciuto da circa 500 server a fine 2025 a tra i 10.000 e i 12.000 server pubblici un anno dopo, e il protocollo supera oggi i 97 milioni di download SDK al mese.

Hermes Agent è nativo MCP. Può connettersi immediatamente a qualsiasi server MCP che gli indichi, il che significa che l'agente non ha un catalogo di strumenti fisso. Gli strumenti che gli fornisci sono gli strumenti che ha.

Cos'è davvero MCP

MCP è stato introdotto da Anthropic alla fine del 2024 e adottato da OpenAI, Google, Microsoft, AWS e Cloudflare nel corso del 2025. La definizione più efficace è "l'USB-C per l'AI": un solo cavo, una sola forma, tanti dispositivi.

Il protocollo definisce tre primitive:

  • Tools sono funzioni eseguibili che il modello può richiamare. "Leggi questa issue", "pubblica questo messaggio", "esegui questa query". Il modello decide quando invocare uno strumento.
  • Resources sono porzioni di dati strutturati che l'applicazione può inserire nella finestra di contesto. Un file, una riga di database, un evento del calendario. L'applicazione host decide quali risorse caricare.
  • Prompts sono template di istruzioni riutilizzabili che l'utente può invocare, simili ai comandi slash. L'utente decide quale prompt attivare.

Un server MCP è semplicemente un processo che parla questo protocollo. Può girare in locale, su un'altra macchina o come servizio remoto. Il trasporto è JSON-RPC over stdio, HTTP o WebSocket a seconda dell'implementazione.

Come Hermes Agent usa MCP

Hermes Agent si comporta da host MCP. All'avvio del runtime di Hermes, legge la tua configurazione MCP, avvia ogni server configurato ed espone al modello gli strumenti, le risorse e i prompt risultanti a ogni turno.

Questo è il meccanismo alla base dei "40+ strumenti pronti all'uso" di Hermes Agent. Nessuno di questi strumenti è codificato nell'agente. Sono server MCP inclusi nella configurazione predefinita: un server filesystem, un server shell, un server di ricerca web, un server di memoria e così via. Puoi rimuoverne qualsiasi, sostituirli con alternative della community o aggiungerne di nuovi, e l'agente recepisce la modifica al riavvio.

Diagramma che mostra il processo host di Hermes Agent che avvia più processi server MCP e instrada le chiamate agli strumenti tra di essi e il modello linguistico

Il vantaggio è la componibilità. Se domani compare un nuovo server MCP per uno strumento che ti interessa, Linear, Figma, il tuo sistema di fatturazione interno, non hai bisogno di una nuova versione di Hermes. Aggiungi il server alla tua configurazione e l'agente inizia a usarlo.

I server MCP che vale la pena conoscere

Il progetto Model Context Protocol mantiene un piccolo insieme di server di riferimento ufficiali e punta a una directory molto più ampia di server mantenuti dalla community. L'ecosistema è sufficientemente vasto che per la maggior parte dei SaaS comuni esiste già un server MCP.

Categorie che puoi collegare a Hermes Agent già oggi:

  • Controllo versione: GitHub, GitLab, Git, Bitbucket
  • Comunicazione: Slack, Discord, Microsoft Teams, email
  • Knowledge base: Notion, Confluence, Linear, Jira
  • Database: Postgres, SQLite, MongoDB, BigQuery
  • Piattaforme cloud: AWS, Cloudflare, Vercel
  • File e ricerca: filesystem, Google Drive, Brave Search, Puppeteer
  • Strumenti interni personalizzati: qualsiasi cosa tu abbia racchiuso in un piccolo server MCP in Python o TypeScript

Le due directory principali da aggiungere ai preferiti sono il repository ufficiale modelcontextprotocol/servers su GitHub e le liste curate awesome-mcp-servers. Tra le due trovi quasi sempre un server mantenuto per quello che ti serve, spesso con un'installazione in una riga sola.

Collegare un server MCP a Hermes Agent

Aggiungere un server MCP a Hermes Agent self-hosted si riduce a un piccolo blocco JSON. Il percorso esatto dipende dalla tua distribuzione, ma la struttura della configurazione è universale:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..."
      }
    },
    "postgres": {
      "command": "uvx",
      "args": ["mcp-server-postgres", "postgres://user@host/db"]
    }
  }
}

Dopo il riavvio, l'agente esamina ogni server, apprende gli strumenti che espone e li aggiunge alle azioni disponibili del modello. Puoi verificare la connessione chiedendo all'agente qualcosa di specifico per quello strumento, per esempio "elenca le issue aperte sulla repo" oppure "mostrami lo schema della tabella users".

Per i piani ospitati su Hermify, la configurazione MCP è accessibile dalla dashboard. Selezioni un server MCP dal catalogo o incolli un blocco di configurazione, la piattaforma riavvia il runtime e lo strumento è disponibile nel messaggio successivo. Per saperne di più su cosa giriamo in produzione, scopri come la memoria e le skill di Hermes Agent si affiancano al layer MCP.

MCP vs integrazioni personalizzate

Vale la pena essere espliciti sul compromesso, perché alcuni team chiedono ancora se convenga costruire un'integrazione su misura invece di usare MCP.

Aspetto Integrazione personalizzata Server MCP
Tempo alla prima chiamata Da giorni a settimane Minuti
Riuso tra agenti Nessuno Qualsiasi host MCP
Manutenzione al cambio API Te ne occupi tu Se ne occupa il maintainer del server
Controllo granulare Totale Limitato a ciò che il server espone
Pattern di autenticazione Qualsiasi Token o OAuth, dipende dal server

Il default giusto è usare un server MCP esistente quando disponibile, e costruire un server personalizzato solo se hai bisogno di un comportamento che i server disponibili non offrono. Anche in quel caso, ciò che costruisci dovrebbe essere un server MCP, non un plugin specifico per Hermes. In questo modo funziona anche con Claude Desktop, ChatGPT, Cursor e qualsiasi altro agente arriverà in futuro.

Primo piano fotorealistico di uno schermo laptop che mostra l'output di terminale di un server MCP con l'elenco degli strumenti disponibili, con illuminazione verde di accento

Pattern pratici

Alcune abitudini che si sono dimostrate valide nell'ultimo anno di utilizzo di Hermes Agent con MCP:

Parti dal set minimo di server. Ogni server MCP espande la lista di strumenti del modello, e una lista più lunga degrada in modo affidabile l'accuratezza della selezione. Mantieni il set attivo ridotto e aggiungi server man mano che scopri che l'agente ne ha effettivamente bisogno.

Scopa le credenziali per server. Ogni server MCP usa le proprie credenziali. Usa un token con privilegi minimi per ciascuno, un utente Postgres in sola lettura, un token GitHub granulare limitato a un singolo repo, così un server difettoso non può fare più di quanto necessario.

Tratta la tua configurazione MCP come infrastruttura. Committala in una repo privata, rivedi le modifiche e distribuiscile nello stesso modo in cui distribuiresti un cambiamento Terraform. Il comportamento dell'agente dipende direttamente da questo file.

Controlla cosa invoca l'agente. Hermes Agent registra ogni chiamata agli strumenti. Sfoglia i log settimanalmente per vedere quali server vengono davvero usati. Quelli che non compaiono mai sono rumore; rimuovili.

Se la memoria e le skill sono ciò che rende Hermes Agent utile da tenere in esecuzione, MCP è ciò che lo rende utile da estendere. I due elementi si sommano: la memoria ricorda cosa è stato utile l'ultima volta, le skill catturano le procedure ricorrenti, e MCP fornisce all'agente gli strumenti grezzi per agire nel mondo. Insieme trasformano Hermes da un'interfaccia di chat in qualcosa di più simile a un piccolo collaboratore autonomo.

Inizia con Hermify e i tuoi server MCP sono pronti da configurare dalla dashboard, con runtime, persistenza e credenziali gestiti per te. Se vuoi confrontare come appare questo approccio rispetto a un approccio basato su framework, Hermes Agent vs LangChain analizza lo stesso problema.

Fonti

Avvia il tuo Hermes Agent

Porta la tua chiave API, collega Telegram e ottieni un agente IA che migliora da solo, online in 60 secondi.

Inizia ora