Azioni MCP

MCP (Model Context Protocol) è uno standard aperto che consente a un’AI di usare direttamente gli strumenti di un altro servizio. Invece di descrivere manualmente un endpoint e i suoi parametri, il server MCP pubblica i propri strumenti, che il tuo agente AI può individuare e utilizzare.

Per la maggior parte dei servizi basta un clic per collegarsi. Vai in Azioni e MCP, fai clic su + Aggiungi azione e scegli MCP.

Verifica un collegamento MCP di esempio all’endpoint della documentazione di Cloudflare o di Microsoft Learn. La verifica effettua soltanto richieste di inizializzazione ed elenco degli strumenti, senza accesso né esecuzione di strumenti.

Strumenti di configurazione facoltativi

• Visualizza un’anteprima delle mappature di memoria MCP. Applica le regole di memoria fornite al risultato di esempio di uno strumento MCP, senza chiamare strumenti o modificare la memoria della conversazione.

• Confronta elenchi di strumenti MCP. Confronta due elenchi di strumenti forniti e le impostazioni di attivazione dichiarate per individuare modifiche alle definizioni e aspetti da verificare. Questo strumento non si collega a un server e non dimostra la compatibilità.

• Verifica la direzione del collegamento MCP. Prepara i dettagli di configurazione a partire da un endpoint pubblico e dallo scopo scelto. Questo strumento non accetta credenziali, non si collega a un server e non modifica il tuo account.

Collegarsi dal catalogo

La schermata MCP si apre su un catalogo di servizi noti con funzione di ricerca, suddivisi per categoria (Popolare, Assistenza clienti, CRM e vendite, Pianificazione, E-commerce, Pagamenti e fatturazione, Marketing ed email, Comunicazione, Produttività, Dati e analisi, Ricerca e web, Viaggi e prenotazioni, Design, Sviluppo e infrastruttura).

1. Trova il servizio desiderato sfogliando il catalogo o usando la casella di ricerca.
2. Fai clic sul suo riquadro. Quickchat verifica il server e individua gli strumenti disponibili.
3. Se il servizio richiede l’accesso, viene mostrato il pannello Autorizzazione richiesta. Fai clic su Collega <servizio>, approva l’accesso nella finestra popup che si apre e il pannello passa allo stato collegato.
4. L’azione viene creata e abilitata e vengono elencati i suoi strumenti. Il tuo agente AI può usarli dal messaggio successivo.

Nota

Dopo l’avvio dell’autorizzazione, Quickchat conserva l’azione e l’autorizzazione in sospeso anche se chiudi il pannello delle azioni o la finestra popup di autorizzazione. Riapri l’azione e fai clic su Apri di nuovo l’autorizzazione per continuare oppure su Annulla per interrompere. Se il provider completa l’autorizzazione dopo la chiusura del pannello, Quickchat completa il collegamento in background e abilita l’azione quando il tuo piano dispone di capacità sufficiente.

Consiglio

Il browser deve consentire i popup per la dashboard di Quickchat, altrimenti la finestra di autorizzazione non può aprirsi. Se viene bloccata, un messaggio ti chiederà di consentire i popup e riprovare.

Collegare un server non presente nel catalogo

Fai clic su Inserisci un URL manualmente sotto il catalogo, poi:

1. Incolla l’URL del server MCP (deve iniziare con https://).
2. Se il server usa un token statico per l’autenticazione anziché una procedura di accesso, apri Header del collegamento (facoltativi) e aggiungi l’header richiesto, ad esempio Authorization: Bearer <your-token>.
3. Fai clic su Collega.

Usa Esplora il catalogo per tornare alla vista a riquadri. Se manca un servizio di cui hai bisogno, Manca un’integrazione? Suggeriscine una apre un’email precompilata indirizzata al nostro team.

Scegliere gli strumenti utilizzabili dall’AI

Una volta collegata, l’azione elenca tutti gli strumenti esposti dal server, ciascuno con il proprio interruttore. Disattiva quelli che non vuoi far richiamare all’AI: ad esempio, puoi mantenere attive le ricerche in sola lettura di un server di prenotazione e disattivare lo strumento di cancellazione.

Attivazione predefinita degli strumenti determina cosa succede quando il server aggiunge un nuovo strumento: se attiva, i nuovi strumenti sono immediatamente disponibili; se disattiva, devi abilitare ciascuno esplicitamente.

Alcune voci del catalogo hanno l’indicatore Ottimizzato da Quickchat. Quickchat ha verificato questi server dall’inizio alla fine e fornisce una selezione mirata di strumenti, le regole di memoria necessarie e un Messaggio di elaborazione per ciascuno. Seleziona Usa la configurazione consigliata per vedere cosa cambierebbe con la configurazione verificata: la finestra Applicare la configurazione consigliata? elenca gli strumenti che verrebbero attivati e disattivati, le regole di memoria impostate e segnala se sovrascriverebbe regole modificate da te. Nulla viene salvato finché non salvi l’azione e puoi comunque modificare ogni strumento in seguito.

Consiglio

Nome dell’azione MCP e Descrizione dell’azione MCP sono etichette per te e il tuo team: identificano l’azione nell’elenco delle azioni e l’AI non le legge mai. A guidare l’AI sono le descrizioni degli strumenti pubblicate dal server MCP insieme al Prompt principale dell’agente. Per orientarla, descrivi le situazioni in cui deve usare gli strumenti del server (“rispondi a tutte le domande sul progetto con gli strumenti di Linear”) e specifica i valori che il modello dovrebbe altrimenti indovinare (“cerca sempre nello spazio di lavoro acme-eng”). Quando colleghi lo stesso server due volte, assegna a ogni collegamento un nome basato sullo scopo (“Centro assistenza Notion”, “Richieste di assistenza Notion”) anziché sul fornitore.

Orari delle prenotazioni con Calendly

Quando un’azione si collega al server https://mcp.calendly.com di Calendly e abilita entrambi gli strumenti indicati di seguito, Quickchat fornisce loro parametri di ingresso con ora locale. I nomi rimangono invariati e non vengono aggiunti strumenti di conversione. Se è abilitato solo uno dei due strumenti, conserva i parametri originali di Calendly.

• Disponibilità: event_types-list_event_type_available_times riceve local_start_time, local_end_time e un fuso orario IANA timezone, ad esempio Europe/London. Fornisci date e ore locali nel formato YYYY-MM-DDTHH:MM:SS. Quickchat converte l’intervallo in UTC usando le regole del fuso per quelle date, compresi i giorni di 23 o 25 ore dovuti al cambio dell’ora.
• Prenotazione: meetings-create_invitee riceve local_start_time e booking_timezone dell’opzione selezionata all’interno di post_invitee_request. Il campo esistente invitee.timezone continua a indicare il fuso orario del cliente, che può differire da quello dell’appuntamento. Ad esempio, un invitato in America/New_York può prenotare una fascia oraria espressa in Europe/London.

Copia l’ora locale e il fuso restituiti con l’opzione di disponibilità. Se l’ora restituita include uno scostamento UTC, conservalo: consente di distinguere gli orari locali ripetuti quando l’orologio viene portato indietro. Vengono rifiutati gli orari locali non validi o inesistenti, gli orari ambigui senza scostamento e gli scostamenti non coerenti con il fuso indicato.

Proporre una fascia oraria non la riserva. Prima di creare l’appuntamento, Quickchat verifica di nuovo la disponibilità corrente e trasmette a Calendly il timestamp corrispondente del provider senza modificarlo. Se la fascia non è più disponibile, non viene tentata alcuna prenotazione. Il risultato della prenotazione include un’ora locale da mostrare nella conferma dell’agente; i campi del provider usati da Salva in memoria, come $.resource.event, rimangono disponibili.

Mantieni nel Prompt principale il requisito dell’approvazione del cliente e conferma una prenotazione soltanto dopo un esito positivo del provider. Stabilisci esplicitamente nella conversazione il fuso orario dell’appuntamento, indipendentemente dal browser o dal canale di messaggistica. Se non è chiaro, chiedilo al cliente prima di verificare la disponibilità o prenotare.

Salvare in memoria il risultato di uno strumento MCP

Espandi uno strumento e usa Salva in memoria quando un valore del suo risultato servirà più avanti nella conversazione. Aggiungi un’espressione JSONPath per il valore e una Chiave di memoria per identificarlo. Puoi salvare fino a 10 valori da uno strumento.

Le chiavi di memoria sono condivise con le azioni API dell’agente. Se un’azione API salva già nella stessa chiave, il campo Chiave di memoria segnala il conflitto al salvataggio: scegli quindi una chiave diversa.

Il valore salvato entra a far parte dei dati della conversazione che l’AI può leggere negli scambi successivi. Ad esempio, uno strumento di prenotazione può salvare l’URI di un evento per consentire a uno strumento di cancellazione di sapere esattamente quale appuntamento annullare. Gli strumenti MCP non usano il segnaposto {{metadata_<key>}} mostrato per le azioni API, perché l’AI fornisce direttamente i loro argomenti.

Le operazioni collettive Abilita tutto e Disabilita tutto conservano le regole di memoria. Anche Ricollega conserva la selezione degli strumenti e le regole di memoria mentre aggiorna l’elenco degli strumenti del server.

Cosa vedono i visitatori

Durante l’esecuzione di uno strumento, il widget di chat mostra una breve riga di stato che descrive cosa sta facendo l’AI. Ogni strumento ha un campo Messaggio di elaborazione nel pannello Strumenti: lascialo vuoto per ricavare la riga dal nome dello strumento (uno strumento chiamato search_flights mostra “Ricerca voli…”) oppure scrivi un messaggio personalizzato (“Ricerca nel centro assistenza”). I server ottimizzati hanno questi campi già compilati per gli strumenti consigliati. La riga fornisce al visitatore un’informazione utile durante l’attesa anziché un semplice indicatore di scrittura.

Ricollegare e scollegare

• Ricollega: ripete l’autorizzazione. Usalo se il collegamento è scaduto, vuoi autorizzare un account diverso oppure l’elenco degli strumenti del server è cambiato e vuoi acquisire i nuovi strumenti.
• Scollega: revoca l’autorizzazione memorizzata e porta l’azione offline. L’azione rimane nell’elenco, così puoi ricollegarla in seguito senza configurarla di nuovo.

Modificare l’URL del server MCP di un’azione collegata ne elimina l’autorizzazione e disattiva l’azione, perché le credenziali emesse da un server non vengono mai riutilizzate con un altro. Autorizzala di nuovo per riattivarla.

Risoluzione dei problemi

Cosa vedi	Cosa significa
Autorizzazione non completata	Fai clic su Riprova. Se hai negato l’accesso, approvalo al tentativo successivo. Per un altro errore, contatta l’assistenza includendo il codice di errore mostrato nel messaggio.
Collegato, ma caricamento degli strumenti non riuscito	L’autorizzazione è riuscita, ma l’elenco degli strumenti non è stato caricato. Fai clic su Ricollega.
Nessuno strumento trovato su questo server. Prova a ricollegarti.	Il server ha autorizzato l’accesso ma non ha pubblicato strumenti. Verifica che l’account approvato possa accedere ai dati previsti.
Inserisci un URL valido che inizi con https://	Non è stato possibile leggere l’URL. Usa l’indirizzo completo https:// del server. Quickchat si collega sempre tramite https, così le credenziali non vengono mai inviate senza crittografia.
L’azione si è disattivata da sola	L’autorizzazione è scaduta o è stata revocata dal provider. Apri l’azione e fai clic su Ricollega.

Nota

Le azioni MCP vengono conteggiate nella quota di azioni personalizzate del tuo piano, come le azioni API.