Integra server MCP (Model Context Protocol) esterni come GitHub MCP o Atlassian MCP con la tua Area di lavoro ClickUp, per permettere ai tuoi Super Agents e a ClickUp Brain di usare strumenti da app esterne.

Ad esempio, puoi collegare il server MCP del tuo CRM alla tua Area di lavoro. I tuoi Super Agents e ClickUp Brain potranno così usare gli strumenti MCP disponibili per eseguire azioni come creare record CRM, eseguire il provisioning di account o sincronizzare i dati dei clienti, il tutto da ClickUp.

Per i limiti delle chiamate MCP per piano, consulta Disponibilità e limiti delle funzionalità IA di ClickUp.

Questo articolo spiega come collegare ClickUp a server MCP esterni tramite l'App Center (connessioni in uscita). La connessione al server MCP di ClickUp, in cui un client IA esterno accede ai tuoi dati ClickUp, è una funzionalità separata gestita dalle autorizzazioni del token API personale.

Puoi collegare un server MCP esterno con qualsiasi piano.

Solo i titolari e gli amministratori dell'Area di lavoro possono configurare le connessioni dell'Area di lavoro.

I membri possono configurare connessioni personali dall'App Center se gli amministratori abilitano l'autorizzazione Connetti server MCP personale.

Gli ospiti e i membri con accesso limitato non possono configurare integrazioni.

Al momento, puoi collegare server MCP solo dall'app browser di ClickUp.

Tipi di connessione

Quando colleghi un server MCP esterno, devi selezionare un tipo di connessione:

• Solo per me: è una connessione personale. Collega il tuo account del server MCP esterno al tuo account utente ClickUp per ogni Area di lavoro che hai creato o a cui ti sei unito. Solo tu potrai usare gli strumenti di questa connessione in Super Agents e ClickUp Brain.
• Per tutti i membri: è una connessione dell'Area di lavoro, che può essere abilitata solo da un titolare o da un amministratore dell'Area di lavoro. Tutti i membri dell'Area di lavoro potranno usare gli strumenti di questa connessione in Super Agents e ClickUp Brain.

Controlli amministrativi per le connessioni

Le aree di lavoro che usano le autorizzazioni dei ruoli personalizzati possono disattivare la possibilità di aggiungere connessioni a server MCP dell'Area di lavoro o personali.

Collega un server MCP esterno

Prima di procedere, verifica con il tuo provider MCP quale metodo di autenticazione e quali intestazioni richiede. Usa le stesse impostazioni quando colleghi il server in ClickUp.

I server MCP devono avere un URL pubblico per potersi collegare.

ClickUp non usa indirizzi IP in uscita fissi per le connessioni di ClickUp Brain e Super Agent a server MCP esterni. Il traffico in uscita utilizza indirizzi IP cloud assegnati dinamicamente, quindi l'inserimento in allowlist degli IP non è supportato. Proteggi l'endpoint del tuo server MCP tramite autenticazione OAuth o chiave API.

Per collegare un server MCP esterno alla tua Area di lavoro:

1. Apri l'App Center:

   

   • Nell'angolo in alto a sinistra, fai clic sull'avatar della tua Area di lavoro e seleziona App.
   • Nella tua navigazione globale, fai clic su Altro e seleziona App.
   • Usa il comando Apri App Center nella barra dei comandi IA.
2. Nella barra laterale dell'App Center, seleziona Custom MCP.
3. Fai clic su Aggiungi nuovo in basso oppure seleziona uno dei modelli.
4. Scegli il tipo di connessione:
   • Scheda Per tutti i membri o Area di lavoro: configura una connessione dell'Area di lavoro.
   • Scheda Solo per me o Personale: configura una connessione personale.
5. Fai clic su Avanti.
6. Inserisci le informazioni del server nei campi richiesti oppure autorizza il tuo account se stai usando uno dei nostri modelli. Per i server personalizzati, devi indicare un nome, un URL e un metodo di autenticazione. Facoltativamente, puoi aggiungere un'icona e una descrizione per il server.

7. Quando colleghi un server MCP personalizzato, puoi scegliere tra tre metodi di autorizzazione:
   • OAuth: verrai reindirizzato al flusso OAuth del provider e poi riportato a ClickUp. Alcuni provider richiedono la registrazione di un URL di reindirizzamento/callback prima di poter stabilire la connessione. Usa https://search.clickup-prod.com/connect/mcp.
   • Chiave API: inserisci la tua chiave API. Se il tuo provider lo richiede, aggiungi le intestazioni personalizzate. Se i dati sono validi, ClickUp si collegherà e mostrerà gli strumenti disponibili.
   • Nessuna autenticazione: collega ClickUp direttamente. Se il tuo provider lo richiede, aggiungi le intestazioni personalizzate. Se i dati sono validi, ClickUp si collegherà e mostrerà gli strumenti disponibili.
8. Quando colleghi un server MCP personalizzato, puoi personalizzare il Client ID, il Client Secret e gli ambiti nella sezione Configurazione avanzata.

9. Una volta effettuata la connessione, nella sezione Strumenti IA dell'app troverai l'elenco di tutti gli strumenti disponibili, che puoi aggiungere ai Super Agents e usare in ClickUp Brain.

Usa un modello MCP

ClickUp offre modelli per collegarti facilmente ad alcuni dei server MCP più popolari.

Per collegare un server MCP esterno usando uno di questi modelli:

1. Apri l'App Center:
   • Nell'angolo in alto a sinistra, fai clic sull'avatar della tua Area di lavoro e seleziona App.
   • Nella tua navigazione globale, fai clic su Altro e seleziona App.
   • Usa il comando Apri App Center nella barra dei comandi IA.
2. Nella barra laterale dell'App Center, seleziona Server MCP.
3. Fai clic sul modello che vuoi usare.
4. Per impostazione predefinita, ti troverai nella scheda Personale. Per configurare una connessione dell'Area di lavoro, fai clic sulla scheda Area di lavoro.
5. Seleziona Connetti.
6. Completa i passaggi di autorizzazione per collegare il server MCP esterno.

Aggiungi strumenti MCP ai Super Agents

Ora che il tuo server MCP è collegato, i suoi strumenti sono disponibili per l'uso nei tuoi Super Agents.

La disponibilità e il comportamento degli strumenti dipendono dal provider del server MCP esterno.

Aggiungi strumenti MCP a un Super Agent esistente

Per aggiungere strumenti da un server MCP che hai collegato a un Super Agent esistente:

1. Apri il profilo del tuo Super Agent.
2. Nella sezione Strumenti, fai clic su Aggiungi strumenti.
3. Cerca e seleziona un modello MCP, oppure fai clic su Server MCP personalizzato per aggiungerne uno personalizzato.
4. Aggiungi gli strumenti MCP:
   • Per aggiungere tutti gli strumenti del server MCP, fai clic su Aggiungi tutti nella parte superiore del menu.
   • Per aggiungere singoli strumenti, selezionali uno per uno.

Non dimenticare di aggiornare anche le istruzioni del Super Agent!

Aggiungi strumenti MCP durante la creazione di un Super Agent

Se menzioni un flusso di lavoro che coinvolge un server MCP collegato mentre crei un Super Agent, gli strumenti di quel server vengono aggiunti automaticamente al Super Agent dopo la sua creazione.

Log di controllo dell'Area di lavoro e server MCP

I log di controllo dell'Area di lavoro includono informazioni sui server MCP esterni configurati nell'Area di lavoro. Chi ha accesso ai log di controllo della tua Area di lavoro può visualizzare le seguenti informazioni per i server MCP esterni:

• Chi ha collegato un server MCP esterno e la data e l'ora in cui è avvenuto
• Chi ha disconnesso un server MCP esterno e la data e l'ora in cui è avvenuto
• Chi ha aggiornato un server MCP esterno e la data e l'ora in cui è avvenuto
• Se la connessione del server MCP esterno è dell'Area di lavoro o personale
• I dettagli del server MCP esterno:
  • Nome
  • URL del server
  • Tipo di autorizzazione