Integrazioni

Cosa sonoAggiungerne unaStrumenti e confermeIn chat e negli agentiPrivacyVecchi server MCPIn arrivo

Cosa sono

Un'integrazione è un server MCP (Model Context Protocol): uno standard aperto per dare ai modelli strumenti esterni, come memoria, calendari, database e servizi web. Ce ne sono di due tipi:

Tipo	Come funziona
Sul PC	Un programma che HotMoE avvia sul tuo computer. I dati restano sul PC, salvo quello che il programma stesso manda in rete.
Remota (online)	Un servizio online, a un indirizzo https://. Le richieste del modello e le risposte passano da internet e dal fornitore del servizio. Nelle liste ha l'etichetta ONLINE.

Le integrazioni sono tue, non del singolo agente: come gli account di posta, le configuri una volta e poi le spunti dove vuoi usarle.

Aggiungere un'integrazione

1. Apri la pagina Integrazioni dalla barra a sinistra e scegli Aggiungi integrazione.
2. Compila i campi (vedi la tabella sotto).
3. Premi Collega e mostra gli strumenti. L'app salva, si collega al server e ne elenca gli strumenti.
4. Scegli gli strumenti da accendere, poi spunta l'integrazione dove vuoi usarla: in chat o in un agente (vedi sotto).

Campo	A cosa serve
Nome	Come la riconosci nelle liste. In chat è anche il nome del suo ruolo.
A cosa serve	Una frase, meglio in inglese, con i verbi di cosa fa (per esempio «the user's GitHub: issues, pull requests, code review»). La chat la usa per capire quando servono questi strumenti; se la lasci vuota usa i nomi degli strumenti.
Dove gira	Sul PC o Remota (online).
Comando	Sul PC. Il programma da avviare con i suoi argomenti, come nella documentazione del server: per esempio npx -y @modelcontextprotocol/server-memory.
Chiavi e variabili	Sul PC, facoltative. Le variabili d'ambiente che il server vuole, per esempio GITHUB_TOKEN. I valori si salvano cifrati e non si mostrano più: per cambiarne uno scrivi quello nuovo; lascia il campo vuoto per tenere quello salvato.
Indirizzo	Remota. L'indirizzo del servizio, che inizia con https://.
Accesso	Remota. Nessuno, Token (chiave personale) o Accesso col browser (OAuth).

Accesso col browser (OAuth)

Con OAuth, Collega e mostra gli strumenti apre il browser per accedere al servizio. HotMoE non vede la tua password: salva solo il permesso, cifrato, e lo rinnova da solo.

Se l'accesso scade, la chat non apre il browser da sola: mostra una nota che ti chiede di rifarlo dalla pagina Integrazioni.

Se manca un programma

Molte integrazioni sul PC si avviano con npx (Node.js), uvx (uv) o Docker. Se il programma non è installato, la pagina te lo dice prima di provare a collegarsi, con il link Dove scaricarlo.

Strumenti e conferme

• Dopo il collegamento, sotto Strumenti, compare ogni strumento del server con un interruttore.
• Di default sono accesi solo quelli che il server dichiara di sola lettura (segnati sola lettura). Accendi gli altri se vuoi che il modello possa anche cambiare qualcosa.
• Ogni chiamata a uno strumento chiede comunque conferma, mostrandoti i dati che sta per ricevere.
• Consenti sempre vale per il singolo strumento, non per tutta l'integrazione. Lo revochi in Accessi › Permessi (per un agente, nel suo editor).
• Ogni chiamata finisce nel Registro, anche quelle che hai negato. Non si annullano.

In chat e negli agenti

Un'integrazione configurata non fa niente finché non la spunti:

• In chat: negli Accessi, sezione Integrazioni, spunta quelle che la chat può usare.
• In un agente: nell'editor dell'agente, sezione Integrazioni.

Accanto alle caselle, il link Configura nella pagina Integrazioni porta qui, per aggiungerne o cambiarne una.

In chat ogni integrazione spuntata è un ruolo, come File, Posta o Schermo, con il nome dell'integrazione. La chat lo attiva solo quando la richiesta riguarda quel servizio, e solo allora il modello riceve i suoi strumenti. I modelli locali hanno poco contesto: così non si riempie di strumenti che non servono.

Privacy

• Sul PC: i dati restano sul tuo computer, salvo quello che il programma stesso manda in rete.
• Remota: le richieste del modello e le risposte passano da internet e arrivano al fornitore del servizio. Collegala solo se ti fidi.
• La testata della chat te lo dice. Di solito, accanto al modello, c'è «· locale, niente esce dal PC». Quando spunti un'integrazione remota diventa «· usa anche servizi online:» seguito dai loro nomi.
• Valori delle variabili, token e permessi d'accesso si salvano cifrati e non si mostrano più.

Vecchi server MCP degli agenti

Prima i server MCP si aggiungevano dentro ogni agente, nella sezione Server MCP dell'editor. Quei server sono diventati integrazioni da soli: li trovi nella pagina Integrazioni, già spuntati negli agenti che li usavano. Lo stesso server presente in più agenti è diventato una sola integrazione.

In arrivo

HotMoE è un progetto di Virsion. Questa guida descrive l'app com'è oggi: quello che è ancora in arrivo è segnato come tale.