Capacità dei server MCP e audit log

Quando Intric si connette a un server MCP, legge l’elenco degli strumenti che il server mette a disposizione. La piattaforma chiama questi strumenti capabilities: in questa pagina li chiamiamo capacità. Nella pagina Capabilities decidi, per ciascuna capacità, se può essere eseguita e se ogni esecuzione richiede l’approvazione di qualcuno. Da questa scelta dipende anche cosa registrerà l’audit log. Con alcune impostazioni resta traccia di ogni esecuzione, con altre non resta nulla.

Solo gli Admin dell’organizzazione possono modificare queste impostazioni. Per configurare un server da zero, vedi Collegare il proprio server MCP a Intric. Per capire il rapporto tra le modalità di approvazione e gli altri strumenti AI, vedi Strumenti AI.

Trovare la pagina Capabilities

1. Vai su Admin → AI Tools e apri la scheda MCP.
2. Apri il server MCP.
3. In Features & Permissions, fai clic su Capabilities.

Prima ancora di aprirla, la riga mostra un riepilogo, per esempio 12 tools · 3 automatic. Se la riga indica Not fetched, Intric non ha ancora letto l’elenco del server. Per recuperarlo, usa Refresh capabilities.

L'esempio mostra l'integrazione Outlook. La pagina Capabilities di un server MCP funziona allo stesso modo.

Modalità di approvazione

Ogni capacità compare con il suo nome e con la descrizione fornita dal server. In Intric non puoi modificare né il nome né la descrizione, perché arrivano entrambi dal server. Accanto a ogni capacità c’è un selettore a tre posizioni:

Modalità	Cosa succede in una conversazione
Off	L’Assistente non sa che la capacità esiste, quindi non può usarla.
Ask	Prima di ogni esecuzione, l’utente vede cosa l’Assistente vuole inviare allo strumento e sceglie Approve (approva) o Deny (rifiuta).
Auto	La capacità parte subito, senza chiedere nulla all’utente.

Lasciare che gli utenti approvino da soli

Con Ask selezionato puoi anche spuntare Users can enable auto-approval, cioè permettere agli utenti di attivare l’approvazione automatica. La scheda di approvazione offre allora due opzioni in più:

• Always allow for this assistant: Intric non chiede più conferma a quell’utente prima di eseguire la capacità, quando lavora con questo Assistente.
• Always allow everywhere: Intric non chiede più conferma a quell’utente prima di eseguire la capacità, in nessuna delle sue conversazioni.

L’utente deve prima confermare la scelta, che vale solo per lui. Nella conversazione, le esecuzioni coperte da questa scelta portano l’etichetta Auto-approved.

Nota: per ora un utente non può revocare un’approvazione automatica dopo averla concessa. Come admin, puoi bloccare tutte queste approvazioni per una capacità: impostala su Ask senza la casella di controllo, oppure su Off. Intric però conserva le approvazioni, che tornano valide se spunti di nuovo la casella.

Gestire molte capacità

• Per trovare una capacità, usa Search e il filtro All / Off / Ask / Auto. La riga sopra l’elenco indica quante capacità ci sono in ogni modalità.
• Set all to Off / Ask / Auto cambia tutte le capacità del server e non tiene conto di ricerche o filtri attivi.
• Nessuna modifica ha effetto finché non salvi. Done ti riporta al pannello del server, dove fai clic su Save changes. Revert annulla le modifiche fatte nella pagina Capabilities.

Valori predefiniti e aspetti da tenere presenti

• Le nuove capacità partono da Ask. Fa eccezione una capacità che secondo il server non richiede autorizzazione: quella parte da Auto.
• Quando riattivi il server, ogni capacità torna al valore predefinito. Se disattivi un server MCP e poi lo riattivi, perdi le impostazioni che avevi scelto per le singole capacità. Dopo aver riattivato un server, controlla la pagina Capabilities.
• Puoi modificare le impostazioni solo mentre il server è attivo.
• Se non resta attivo nulla, il server si disattiva da solo. Se imposti tutte le capacità su Off, rischi di disattivare l’intero server.
• Le impostazioni seguono il nome della capacità. Se il server rinomina uno strumento, Intric lo tratta come una capacità nuova, con il valore predefinito. Se una capacità scompare e poi ricompare con lo stesso nome, ritrova l’impostazione di prima.
• Risorse e prompt non compaiono nell’elenco. Oltre agli strumenti, un server MCP può offrire risorse (contenuti che l’Assistente può leggere) e prompt. Intric li usa, ma questa pagina non li mostra. Partono in automatico, a meno che il server non indichi che richiedono un’autorizzazione.
• La modalità è la stessa ovunque. Nessuno Space e nessun Assistente può cambiare la modalità di una capacità. Un Assistente aggiunge o rimuove il server nel suo insieme, e anche la classificazione di sicurezza vale per l’intero server, non per le singole capacità.

Aggiornare l’elenco delle capacità

Refresh capabilities chiede al server l’elenco attuale e sostituisce quello salvato in Intric. Intric aggiorna l’elenco anche da solo quando salvi un nuovo URL del server o colleghi un account OAuth. Il pulsante non è disponibile in tre casi:

• il server è disattivato
• nel pannello del server ci sono modifiche alla connessione non salvate
• il server usa OAuth e non hai collegato il tuo account

Come compaiono le impostazioni nell’audit log

L’audit log mostra ogni voce con il nome tecnico dell’evento, per esempio TOOL_UPDATE. Per vedere tutti i dettagli di una voce, aprila: trovi i suoi dati, gli stessi che compaiono nell’esportazione CSV.

Modifiche alle impostazioni

Quando salvi le modifiche nella pagina Capabilities, il log registra una voce TOOL_UPDATE. Lo stesso evento compare quando cambi la disponibilità del server per l’organizzazione o la sua classificazione di sicurezza.

• Actor: l’admin che ha salvato.
• Resource: di tipo MCPTool. Il nome della risorsa è sempre mcp, non quello del server: per distinguere un server dall’altro, usa il Resource ID.
• Details: il valore precedente e quello nuovo di tutto ciò che è cambiato. L’impostazione di una capacità ha questo aspetto:

"llm_tool_settings": { "items": { "search_documents": "auto_approve" } }

Il valore che il log salva per ogni modalità:

Nella pagina Capabilities	Nell’audit log
Off	denied
Ask	ask
Ask + Users can enable auto-approval	consent_allowed
Auto	auto_approve

Le modifiche al server stesso finiscono in voci separate. In MCP_SERVER_CREATE, MCP_SERVER_UPDATE e MCP_SERVER_DELETE la risorsa è il nome del server. MCP_SERVER_UPDATE registra quali campi sono cambiati (per esempio l’URL, oppure credentials per una chiave API o un client secret), ma non i nuovi valori.

Esecuzione delle capacità

Ogni volta che un Assistente usa una capacità, la modalità determina cosa finisce nel log:

Modalità	Cosa ha fatto l’utente	Voce nel log
Off	—	Nessuna. La capacità non può partire.
Ask	Ha fatto clic su Approve	TOOL_USE_APPROVE
Ask	Ha fatto clic su Deny, oppure ha scritto un nuovo messaggio invece di rispondere	TOOL_USE_REJECT
Ask + approvazione automatica consentita agli utenti	Ha scelto Always allow for this assistant o Always allow everywhere	TOOL_AUTO_APPROVE_CONSENT_GRANT e TOOL_USE_APPROVE
Ask + approvazione automatica consentita agli utenti	Niente: l’esecuzione rientrava in un “always allow” dato in precedenza	TOOL_USE_AUTO_APPROVE
Auto	Niente. La capacità è partita senza chiedere.	Nessuna

Le voci di approvazione, rifiuto e approvazione automatica sono collegate alla conversazione. Riportano il nome della capacità e i dati esatti che l’Assistente le ha inviato, ma non il nome del server né la risposta dello strumento. TOOL_AUTO_APPROVE_CONSENT_GRANT indica se l’approvazione vale per un solo Assistente o ovunque, e per quale Assistente.

Nota: TOOL_USE_AUTO_APPROVE e TOOL_AUTO_APPROVE_CONSENT_GRANT compaiono nel log, ma il filtro per evento non li elenca ancora. Per trovarli, filtra per utente o per intervallo di date, oppure cerca nell’esportazione CSV.

Cosa resta fuori dal log

• Le esecuzioni delle capacità impostate su Auto e quelle di risorse e prompt che partono in automatico.
• Le approvazioni e i rifiuti durante l’esecuzione di un piano. Un “always allow” dato in quel contesto, invece, finisce comunque nel log.
• Refresh capabilities, sia quando lo avvii tu sia quando Intric lo avvia da solo.
• Il collegamento e lo scollegamento di un account OAuth, e le verifiche della connessione.
• La risposta dello strumento.

Se ti serve una traccia di ogni esecuzione di una capacità, usa Ask, non Auto. Anche Ask con Users can enable auto-approval registra ogni esecuzione. Dopo il primo “always allow” di un utente, però, il log registra le sue esecuzioni come TOOL_USE_AUTO_APPROVE e non più come approvazioni.