Connessioni MCP per agenti personalizzati

Le connessioni MCP (Model Context Protocol) consentono al tuo agente personalizzato di connettersi in modo sicuro ad app esterne. Con le connessioni MCP, il tuo agente può leggere informazioni ed eseguire azioni utilizzando connessioni preconfigurate con app come Linear, Ramp, Figma e altre, oppure connettersi a qualsiasi app configurando connessioni MCP personalizzate.

Nota: Le connessioni MCP sono disponibili solo nei piani Business e piano Enterprise.

Le connessioni MCP consentono agli agenti personalizzati di interagire con strumenti e servizi esterni tramite il Model Context Protocol. Gli strumenti MCP funzionano con tutti i tipi di trigger, incluse le esecuzioni pianificate, le esecuzioni attivate in base a eventi Notion o Slack e le esecuzioni manuali da chat o @-menzioni.

Caratteristiche principali:

• Server preconfigurati: Connettiti rapidamente ad app popolari senza alcuna configurazione aggiuntiva.

• Server personalizzati: Connettiti a qualsiasi strumento che supporti un server MCP ospitato utilizzando URL disponibili pubblicamente.

• Personalizzazione: Gli strumenti per ogni connessione possono essere attivati o disattivati e puoi scegliere se richiedere una conferma prima dell'esecuzione, eseguire automaticamente o consentire in modo permanente tutti gli strumenti di un server.

Ogni connessione MCP è univoca per un singolo agente personalizzato e utilizza le credenziali della persona che l'ha autenticata. Le connessioni non sono condivise tra gli agenti, anche se si connettono allo stesso servizio.

Questo significa che:

• Se configuri una connessione Figma per l'agente A, l'agente B avrà bisogno della propria connessione Figma separata.

• Devi accedere a ogni server MCP per ogni agente che configuri.

• La revoca di una connessione in un agente non influisce sugli altri agenti.

Puoi connetterti alle seguenti app senza alcuna configurazione aggiuntiva:

• Amplitude

• Attio

• Box

• ClickHouse

• Figma

• GitHub

• HubSpot

• Intercom

• Linear

• Mercury

• Miro

• Mixpanel

• n8n

• Ramp

• Stripe

• Sentry

• Wiz

1. Apri le Impostazioni del tuo agente personalizzato.

2. Vai su Tools & Access.

3. Fai clic su Aggiungi connessione → Aggiungi.

4. Scegli un server preconfigurato.

5. Segui le istruzioni di autenticazione per connettere il tuo account.

6. Seleziona quali strumenti del server vuoi che il tuo agente utilizzi. Questi varieranno in base al server scelto.

7. Fai clic su Connetti.

Per connettersi a un server MCP non presente nell'elenco preconfigurato, un amministratore dello spazio di lavoro deve prima attivare questa opzione. Esistono due impostazioni separate: una per consentire server MCP personalizzati e una per decidere se i membri possono installare qualsiasi connessione o solo quelle approvate dall'amministratore.

Per consentire server MCP personalizzati:

1. In qualità di amministratore dello spazio di lavoro, vai su Impostazioni → Connessioni.

2. Nella scheda Manage, attiva server MCP personalizzati.

Per scegliere se i membri possono installare qualsiasi connessione o solo quelle approvate dall'amministratore:

1. In qualità di amministratore dello spazio di lavoro, vai su Impostazioni → Connessioni.

2. Nella scheda Manage, trova la sezione Gestione permessi.

3. Accanto a Limita quali connessioni i membri possono installare, scegline una:

   • Approved & recommended: approva automaticamente tutte le connessioni consigliate da Notion.

   • Solo approvate: seleziona manualmente ogni connessione che i membri possono installare.

4. Seleziona Connessioni approvate per rivedere ciò che i membri possono installare.

5. Seleziona Aggiungi connessione approvata, quindi scegli cosa vuoi consentire:

   • Connessioni: cerca una connessione per nome o ID e aggiungila all'elenco delle opzioni approvate.

   • Server MCP personalizzato: aggiungi un URL specifico del server MCP personalizzato che desideri consentire.

6. Fai clic su Salva.

Una volta impostato, chiunque nello spazio di lavoro può connettersi alle opzioni approvate durante la configurazione di un Agente personalizzato. Si autenticheranno con le proprie credenziali.

Per aggiungere un MCP personalizzato a un Agente personalizzato:

1. Apri le Impostazioni del tuo Agente personalizzato.

2. Vai su Tools & Access.

3. Fai clic su Aggiungi connessione → Server MCP personalizzato.

4. Dovrai inserire l'URL del server MCP dallo strumento o dal provider a cui ti stai connettendo (ad esempio: il team dello strumento interno della tua azienda).

5. Fornisci un nome visualizzato per la connessione (facoltativo).

6. Aggiungi eventuali dettagli di autenticazione obbligatori.

7. Fai clic su Connetti.

I server MCP personalizzati possono supportare uno o entrambi i seguenti metodi di accesso:

• OAuth

• Autenticazione basata su titolo

  (ad esempio, chiavi API o token bearer)

Alcuni server OAuth non supportano la registrazione dinamica del client (DCR). Ciò significa che Notion deve pre-registrare un'applicazione client presso il servizio di terze parti prima che l'accesso OAuth possa funzionare. Se il server che desideri utilizzare non supporta la DCR, controlla la sua documentazione per vedere se puoi utilizzare invece una chiave API o un token bearer. Se nessuna delle due opzioni è disponibile, il server MCP non può essere utilizzato con gli Agenti personalizzati.

Puoi decidere come un Agente personalizzato deve utilizzare una connessione MCP nelle Impostazioni del tuo agente, alla voce Strumenti e Accesso. Espandi la voce della connessione MCP per vedere gli strumenti disponibili e determinare come vengono eseguiti. Gli strumenti possono essere abilitati o disabilitati utilizzando il menu a tendina adiacente.

Strumenti di lettura e scrittura

• Gli strumenti di lettura (es: ricerca, recupero, elenco, visualizzazione) consentono all'Agente personalizzato di recuperare o visualizzare informazioni senza apportare modifiche ai sistemi esterni.

• Gli strumenti di scrittura (es: creazione, aggiornamento, elimina, invio, pubblicazione) apportano modifiche ai dati nei sistemi esterni. Per impostazione predefinita, questi richiedono confermaprima che l'agente esegua l'azione.

Esegui automaticamente o chiedi sempre

• Esegui automaticamente consente allo strumento di essere eseguito senza richiedere la conferma dell'utente. Questa impostazione è ideale per gli strumenti di lettura (Cerca, recupera, elenco, visualizzazione) poiché non modificano i dati.

• Chiedi sempre richiede all'utente di approvare o annullare un'azione prima che venga eseguita. Questa è l'impostazione predefinita per gli strumenti di scrittura (creazione, aggiornamento, elimina, invio) per evitare modifiche indesiderate.

• Consenti sempre approva in modo permanente tutti gli strumenti da un server e rimuove le future richieste di conferma.

Per rimuovere una connessione MCP

1. Apri le Impostazioni del tuo agente.

2. Vai su Strumenti & Accesso.

3. Trova la connessione MCP e fai clic su Disconnetti.

4. Fai clic su Disconnetti per confermare.

5. Prova sempre il tuo agente dopo aver apportato modifiche. Puoi riconnetterti in qualsiasi momento autenticandoti di nuovo.

Nota: Se rimuovi una connessione, l'agente non potrà più accedere a quel servizio e le esecuzioni pianificate che dipendono da quel server potrebbero non riuscire. I flussi di lavoro del tuo agente potrebbero interrompersi non appena ti disconnetti. Puoi riconnetterti in qualsiasi momento autenticandoti di nuovo.

Le connessioni MCP rispettano i livelli di autorizzazione utente impostati sul tuo Agente personalizzato. Ecco cosa può fare ogni livello di autorizzazione con gli strumenti connessi tramite MCP.

Gli utenti con permessi "accesso completo" e "può modificare" per un agente personalizzato possono:

• Aggiungere nuove connessioni MCP all'Agente personalizzato.

• Chattare con l'agente e utilizzare tutti gli strumenti connessi, anche se non hanno accesso allo strumento al di fuori dell'agente.

• Visualizzare il registro delle attività dell'agente e l'utilizzo degli strumenti MCP.

• Rimuovere le connessioni MCP esistenti.

• Riconnettere o aggiornare le credenziali del server MCP.

E per le connessioni MCP impostate, gli utenti con permessi "accesso completo" e "può modificare" possono:

• Configurare quali strumenti sono abilitati o disabilitati e modificare le impostazioni di esecuzione degli strumenti (esecuzione automatica o richiesta sempre)

Nota: Una volta stabilita una connessione MCP, solo la persona che l'ha autenticata può configurare e aggiornare le impostazioni degli strumenti — anche se altri dispongono di permessi "accesso completo" o "può modificare" per l'agente personalizzato. L'agente utilizza le credenziali e i permessi di quella persona quando accede al servizio esterno.

Gli utenti con permessi di visualizzazione e interazione per un agente personalizzato possono:

• Chattare con l'Agente personalizzato e utilizzare tutti gli strumenti connessi, anche se non hanno accesso agli strumenti al di fuori dell'Agente personalizzato.

• Attivare azioni sia di lettura che di scrittura tramite l'agente.

• Approvare o annullare le azioni di scrittura quando è richiesta una conferma.

• Visualizzare quali server MCP sono connessi (nelle impostazioni dell'Agente personalizzato).

Gli utenti con permessi di visualizzazione e interazione non possono:

• Aggiungere o rimuovere connessioni MCP.

• Modificare quali strumenti sono abilitati.

• Modificare le impostazioni di esecuzione degli strumenti.

• Visualizzare il registro completo delle attività dell'agente.

Nota: Le azioni di scrittura (come la creazione o l'aggiornamento di elementi) richiedono per impostazione predefinita una conferma per evitare modifiche indesiderate. Gli utenti visualizzeranno un prompt che mostra esattamente quale azione intraprenderà l'agente prima che venga eseguita.

Se gli strumenti non vengono visualizzati dopo la connessione:

• Aggiornare la pagina delle impostazioni dell'agente.

• Verificare che il server MCP sia stato autenticato correttamente (cerca un segno di spunta verde o lo stato "Connesso").

• Verificare che il server sia online e che restituisca i metadati dello strumento.

• Prova a riconnettere il server, oppure a disconnetterlo e riaggiungerlo.

Se le esecuzioni dell'agente personalizzato falliscono con errori MCP:

• Controlla la scheda Attività per messaggi di errore specifici.

• Verifica che la tua connessione sia ancora valida (i token potrebbero essere scaduti).

• Assicurati che la connessione sia ancora abilitata nelle impostazioni dell'agente.

• Prova a riconnettere il server MCP per aggiornare le credenziali.

• Aggiorna le istruzioni del tuo agente personalizzato per includere la menzione del nome del server o dello strumento che desideri utilizzare. Ad esempio: “Usa Linear MCP per recuperare i metadati per questo mock.”