I tuoi modelli e agenti IA possono usare il nostro server MCP (Model Context Protocol) ufficiale per accedere ai tuoi dati ClickUp in modo semplice e sicuro. È progettato per funzionare perfettamente con i più diffusi assistenti IA come ChatGPT, Cursor e Claude.

ClickUp MCP è disponibile su tutti i piani.

Puoi configurare il server ClickUp MCP con qualsiasi app che supporti i server MCP, come Claude, Cursor o VS Code.

Cosa posso fare con il server ClickUp MCP?

• Gestire i flussi di lavoro delle attività: crea, arricchisci e instrada le attività con assegnatari, Priorità e date di scadenza tra Elenchi e Spazi.
• Creare report dirigenziali: produci note di rilascio, aggiornamenti di stato e rollup di Portfolio consolidati da attività, commenti e Documenti.
• Monitorare il tempo: avvia e arresta i timer, registra voci storiche e recupera le voci.
• Rispondere a domande sul lavoro: cerca attività, Documenti e commenti per fornire risposte rapide e ricche di contesto.
• Collaborare nei commenti e nella Chat: riepiloga i thread, estrai gli elementi d'azione e pubblica aggiornamenti.

Strumenti disponibili

Il server MCP di ClickUp consente agli assistenti IA come ChatGPT, Claude, Cursor o VS Code di integrarsi con gli strumenti e i dati di ClickUp. Questo significa che il tuo assistente IA può eseguire azioni, recuperare informazioni e fornire istantaneamente insight intelligenti e contestualizzati.

Per un elenco completo degli strumenti supportati, leggi questo articolo per sviluppatori.

Prima di connettere un client MCP, consulta la sezione sui limiti di frequenza qui sotto per scoprire quali limiti si applicano alla tua area di lavoro e come viene conteggiato l'utilizzo.

Esempi di richieste

Ecco alcuni esempi di richieste che puoi fare dopo aver connesso il tuo assistente IA al server MCP di ClickUp:

• Create a task for this bug we're working on.
• Find all my incomplete tasks due this week.
• List all milestones in the Product Launch project.
• How many hours has the team spent on clients this month?

Istruzioni di configurazione

Per istruzioni dettagliate passo dopo passo, leggi il nostro articolo sulle istruzioni di configurazione del server MCP.

Limiti di frequenza

Il server MCP di ClickUp ha limiti di frequenza che dipendono da due criteri:

1. Se la tua area di lavoro ha acquistato il componente aggiuntivo Everything AI.
2. Il piano della tua area di lavoro.

I limiti di frequenza MCP e i limiti di frequenza delle API pubbliche sono due limiti separati. Le API pubbliche limitano le richieste al minuto, per token. Senza il componente aggiuntivo Everything AI, ClickUp MCP limita invece le chiamate per periodo continuo di 24 ore.

Con il componente aggiuntivo Everything AI

Se la tua area di lavoro ha acquistato il componente aggiuntivo Everything AI, i tuoi limiti di frequenza MCP coincidono con i limiti di frequenza della nostra API pubblica, che variano in base al piano.

Con il componente aggiuntivo, il limite continuo di 24 ore non si applica più. Le tue richieste MCP vengono conteggiate nello stesso limite al minuto per token dell'API pubblica:

• Piani Free Forever, Unlimited e Business: 100 richieste al minuto, per token.
• Piano Business Plus: 1.000 richieste al minuto, per token.
• Piano Enterprise: 10.000 richieste al minuto, per token.

Senza il componente aggiuntivo Everything AI

Se la tua area di lavoro non ha acquistato il componente aggiuntivo Everything AI, il tuo utilizzo MCP è soggetto ai seguenti limiti di frequenza giornalieri per piano:

• Piano Free Forever: 100 chiamate ogni 24 ore.
• Piano Unlimited: 300 chiamate ogni 24 ore.
• Piano Business: 1.000 chiamate ogni 24 ore.
• Piano Business Plus: 2.500 chiamate ogni 24 ore.
• Piano Enterprise: 5.000 chiamate ogni 24 ore.

Questo limite si applica all'intera area di lavoro. Ogni client MCP connesso alla stessa area di lavoro attinge dallo stesso pool di chiamate.

Ogni richiesta MCP viene conteggiata nel limite, incluse le azioni quotidiane come la lettura, la creazione e l'aggiornamento delle attività. Il limite non riguarda solo le azioni generate dall'IA.

Limiti di frequenza con periodo continuo di 24 ore

Il limite di frequenza con periodo continuo di 24 ore decorre dalla tua prima richiesta.

Ad esempio, se la tua prima richiesta MCP lunedì è all'una di pomeriggio e raggiungi il limite giornaliero del tuo piano martedì alle 11, il limite di frequenza resterà attivo fino all'una di pomeriggio di martedì, 24 ore dopo la tua prima richiesta.

Tentare di inviare richieste mentre il limite di frequenza è attivo non estende la finestra di 24 ore.

I limiti di frequenza non possono essere reimpostati.

Quando la tua area di lavoro raggiunge il limite, le richieste MCP restituiscono un errore 429 RATE_LIMIT_EXCEEDED fino al ripristino della finestra continua di 24 ore.

Domande frequenti

Domande frequenti sul server ClickUp MCP.

Posso monitorare quante chiamate MCP ha utilizzato la mia area di lavoro?

Al momento no.

Posso autenticarmi con le mie chiavi API o token di accesso?

No, è supportato solo OAuth. OAuth è un protocollo standard del settore che fornisce accesso delegato e sicuro. Ti permette di concedere accesso limitato alle tue risorse senza condividere le credenziali, supporta autorizzazioni granulari e semplifica la revoca dell'accesso.

Le chiavi API sono meno sicure perché sono statiche, di solito hanno un accesso ampio e sono più difficili da gestire o revocare in caso di compromissione.

Posso usare ClickUp MCP per cercare nelle app esterne che ho connesso alla mia area di lavoro ClickUp?

No, la Ricerca connessa può essere usata solo dall'interno della tua area di lavoro. Per un elenco di tutte le app esterne che supportano la Ricerca connessa, leggi il nostro articolo sulla Ricerca connessa.

Gli amministratori devono eseguire delle operazioni in ClickUp prima di configurare uno strumento esterno come Claude o ChatGPT?

Non è necessaria alcuna operazione in ClickUp. ClickUp MCP fornirà l'elenco degli strumenti disponibili.

Il mio LLM personalizzato si collegherà?

Sì, se il tuo team crea un'implementazione client MCP che soddisfa i seguenti criteri:

• Implementa il protocollo JSON-RPC 2.0 su HTTP
• Supporta l'autenticazione OAuth 2.1 con PKCE
• Segue le specifiche MCP