Strumenti e integrazioni

Un’integrazione è un server MCP che i tuoi agenti usano mentre lavorano: un servizio di posta, un tracker di issue, un database, uno strumento tuo. Lo aggiungi una volta, per tutto l’account, e lo attivi solo dove serve: per il tuo agente, e per ogni progetto. Una squadra riceve ciò che il suo progetto attiva; un run avviato da un incarico riceve quello del suo progetto.

È l’altro verso rispetto al connettore: il connettore fa usare Kedalio a Claude e ChatGPT; le integrazioni fanno usare altri server ai tuoi agenti.

Tutto sta nell’app, in Sistema → Strumenti.

Aggiungere un server

Aggiungi un server chiede:

Campo	Cos’è
Nome	Lettere, numeri, - e _. Dopo non si può cambiare. kedalio è preso: è il connettore di Kedalio dentro un run.
Tipo	Remoto: Kedalio ne chiama l’indirizzo da sé. Locale: un comando (e i suoi argomenti) che lancia un host; serve un host collegato.
Indirizzo / Comando	L’URL di un server remoto (senza credenziali dentro), o il comando di uno locale.
Header / Ambiente	I server remoti prendono header, quelli locali variabili d’ambiente. Ogni valore è il nome di un segreto nel vault, mai il valore stesso.
Dove vanno i suoi dati	Locale, Tuo server o Terzi: vedi la regola sui dati.

Se il segreto che serve a una riga non è ancora nel vault, il modulo rimanda a Sistema → Chiavi e token: aggiungilo prima lì. Il vault non ha un segreto con quel nome, e il modulo lo dice.

L’accesso

• Un token in un header (remoto, o una variabile d’ambiente per un server locale): incolli il token una volta nel vault, e la riga del server lo nomina.
• OAuth (solo remoto): la maggior parte dei server ospitati parla solo questo. Salva il server con il suo indirizzo, poi premi Collega. Entri nel servizio e torni; Kedalio è il client OAuth (scoperta, registrazione e PKCE come li descrive la specifica MCP). I token sono un segreto del vault, come gli altri: Kedalio rinnova il token d’accesso e ne passa uno valido a ogni run. Scollega lo dimentica, Collega di nuovo è quello che premi quando un accesso è finito e non si è potuto rinnovare. Un accesso iniziato e non finito entro dieci minuti va ricominciato.

OAuth non è un quarto tipo di credenziale: i suoi token sono segreti del vault, scritti e mai riletti (Account e accesso).

Prova

Prova chiede al server i suoi strumenti: a uno remoto direttamente dal server di Kedalio, a uno locale tramite un host collegato. La riga mostra poi Raggiungibile e quanti strumenti ha, oppure Non va con il motivo, e quando è stata fatta l’ultima prova. L’elenco degli strumenti resta con il server, così puoi dare regole strumento per strumento; riprova per aggiornarlo.

Kedalio chiama solo indirizzi pubblici quando prova o collega: un indirizzo di una rete privata viene rifiutato, a meno che il server non sia stato avviato con KEDALIO_PROBE_PRIVATE=1 (per un server MCP che tieni a casa), e gli indirizzi di loopback e link-local sono sempre rifiutati. Un segreto che compare in un errore viene tagliato.

Attivarlo

Un server non fa nulla finché non è attivato. Dove:

• Il tuo agente: Sistema → Il mio agente → Strumenti → Server.
• Un progetto: le Impostazioni del progetto → Integrazioni.

Ogni server lì ha un interruttore («Usa …») e una regola, cosa può fare:

• Chiedi ogni volta (il default): ogni strumento ti chiede prima.
• Consenti tutti i suoi strumenti, oppure Vieta tutti i suoi strumenti.
• Per strumento, dopo che il server è stato provato: Chiedi, Consenti o Vieta per ciascuno. Un server non ancora provato lo dice.

Le regole sono la delega del run, nella stessa sintassi del resto (mcp__<server> o mcp__<server>__<strumento>): compaiono come richieste che salgono fino a te, e un divieto vince. Un agente non le allarga mai.

In Sistema → Strumenti, ogni server mostra dove è usato («l’agente», i progetti) o «Non ancora usato». Eliminare un server lo disattiva anche ovunque, e lo stesso vale eliminando un progetto.

Gli strumenti incorporati dell’agente

Oltre al connettore, Il mio agente → Strumenti ha due interruttori per ciò che l’agente può fare senza chiedere: Lettura web (WebFetch) e Ricerca web (WebSearch). Ognuno scrive una riga di delega.

La regola sui dati

Ogni server ha una destinazione, come ogni account dei motori, e viene controllata contro la classe di dati del progetto quando lo attivi:

Destinazione	Significato	Quali progetti possono usarlo
Locale	Resta sulla tua macchina	Qualunque
Tuo server	Gira su un tuo server	Qualunque
Terzi	Il servizio di qualcun altro	Non un progetto client

Un progetto client (la classe di default) non può attivare un server di terzi: l’app rifiuta, e dice quale classe e quale server. Un progetto personal o public può. La tabella che lo decide è quella di Motori e costi.

Segreti e run

Il vault tiene ogni valore: la riga del server contiene solo nomi. Un run riceve un segreto solo quando ne ha bisogno, in memoria sull’host, e quello che uno strumento restituisce e sembra un segreto viene mascherato. Un server locale lo avvia l’host che esegue il run. Un server che gira su un host come pacchetto fissato da un digest (Gitea / Forgejo e Coolify sono pronti da aggiungere, Forgejo con un’opzione che aggiunge tutta la sua API) si raggiunge dal gateway: l’host lo scarica verificando il digest, lo avvia con i segreti solo nel suo ambiente, lo tiene attivo qualche minuto e toglie ogni segreto da quello che restituisce; crearne uno richiede la tua passkey.

Non ancora costruito

• Un elenco pronto di server tra cui scegliere: oggi ne aggiungi ciascuno con il suo indirizzo o il suo comando.
• Uno spazio di lavoro come strumento incorporato (una cartella per chat sull’host).
• Le impostazioni di Claude Desktop e Claude Code sulle tue macchine: appartengono all’app desktop.