Connetti Salesforce MCP a ClickUp in modo che i tuoi strumenti IA possano cercare, leggere, creare e aggiornare i record Salesforce in linguaggio naturale.

Questa guida descrive la configurazione iniziale di Salesforce che un amministratore Salesforce deve eseguire, poi come connettersi da ClickUp tramite OAuth 2.0 con PKCE. Il processo richiede circa 20 minuti, più altri 30 minuti per l'attivazione dell'app da parte di Salesforce.

Cosa ti serve

• Un'Area di lavoro ClickUp
• Un'organizzazione Salesforce (Enterprise Edition o superiore, oppure Developer Edition) con autorizzazioni di amministratore di sistema
• L'autorizzazione Personalizza applicazione in Salesforce

Passaggi in Salesforce

Prima di completare il processo in ClickUp, devi eseguire alcuni passaggi di configurazione in Salesforce.

Al termine dei passaggi in Salesforce, dovrai riportare tre informazioni in ClickUp:

• La Chiave consumer della tua app client esterna
• Se stai connettendo un'organizzazione di produzione o sandbox
• Quale server MCP hai attivato

Passaggio 1: attiva il servizio MCP

I server MCP ospitati da Salesforce vengono visualizzati nella pagina Configurazione di Salesforce solo dopo che il servizio MCP è stato abilitato per la tua organizzazione:

1. Nella pagina Configurazione di Salesforce, digita Server MCP nella casella Ricerca rapida.
2. Se Server MCP è visualizzato sotto Catalogo API, il servizio è già attivo. Passa al Passaggio 2: attiva un server.
3. Se non è visualizzato, digita Interfaccia utente nella casella Ricerca rapida, apri Interfaccia utente e attiva Abilita servizio MCP. Poi salva.

Se non riesci a trovare Server MCP, verifica che l'edizione della tua organizzazione supporti i server MCP ospitati.

Passaggio 2: attiva un server

I server MCP sono disattivati per impostazione predefinita. Un amministratore deve attivare ciascun server prima che qualsiasi client possa connettersi:

1. Nella pagina Configurazione di Salesforce, digita Server MCP nella casella Ricerca rapida.
2. Fai clic su Server MCP sotto Catalogo API.
3. Attiva il server di cui ha bisogno il tuo team. ClickUp supporta i seguenti:
   • Letture SObject (consigliato): cerca e recupera record e relazioni
   • SObject completo: crea, legge, aggiorna ed elimina record
   • Mutazioni SObject: crea e aggiorna record, senza eliminazioni
   • Headless 360 (beta): accesso unificato all'intera piattaforma Salesforce

Se salti questo passaggio, ClickUp accede correttamente ma non trova nessuno strumento. Dovrai selezionare lo stesso server in ClickUp, quindi prendi nota di quale hai attivato.

Dopo l'attivazione, un server può impiegare fino a 2 minuti per diventare attivo.

Per il riferimento completo, consulta la guida di Salesforce all'attivazione dei server MCP.

Passaggio 3: crea un'app client esterna

Devi usare un'app client esterna. Le app connesse non sono supportate per MCP e causano errori di autenticazione.

Per creare un'app client esterna:

1. Nella pagina Configurazione di Salesforce, digita Client esterno nella casella Ricerca rapida.
2. Fai clic su Gestione app client esterne.
3. Fai clic su Nuova app client esterna.
4. Compila la sezione Informazioni di base. Assegna all'app un nome come ClickUp MCP.
5. Espandi API (abilita impostazioni OAuth) e seleziona Abilita OAuth.

Tieni aperto questo modulo. I passaggi da 4 a 6 ti chiederanno di compilare il resto.

Se ClickUp segnala un client non valido, la Chiave consumer che hai incollato non appartiene a questa app, oppure l'app non ha ancora terminato la propagazione (Passaggio 8).

Per il riferimento completo, consulta la guida di Salesforce alla creazione di un'app client esterna.

Passaggio 4: impostazioni di sicurezza OAuth

Nello stesso modulo, sotto Sicurezza:

1. Seleziona queste opzioni:
   • Richiedi l'estensione PKCE (Proof Key for Code Exchange) per i flussi di autorizzazione supportati
   • Abilita rotazione del token di aggiornamento
   • Emetti token di accesso basati su JSON Web Token (JWT) per gli utenti nominati
   • Limita il TTL (Time-to-Live) del token di aggiornamento inattivo a 30 giorni

• Lascia deselezionate queste opzioni:
  • Richiedi segreto per il flusso Web Server
  • Richiedi segreto per il flusso Token di aggiornamento
  • Applica l'elenco consentiti IP per il token di aggiornamento

ClickUp usa PKCE come client pubblico, quindi non ha bisogno del segreto consumer. Se richiedi un segreto qui, la connessione non riesce.

Passaggio 5: aggiungi l'URL di callback

Nel campo URL di callback, inserisci l'URL di callback di ClickUp:

https://search.clickup-prod.com/connect/salesforcemcp

L'URL di callback deve corrispondere esattamente, senza barra finale. ClickUp mostra lo stesso valore nella configurazione guidata così puoi confrontarli.

Passaggio 6: aggiungi gli ambiti OAuth

Per aggiungere gli ambiti OAuth:

1. Sotto Ambiti OAuth selezionati, aggiungi:
   • mcp_api: accede ai server MCP ospitati da Salesforce
   • refresh_token, offline_access: esegue richieste in qualsiasi momento
2. Fai clic su Crea.

Se hai eseguito questa configurazione durante la beta di Salesforce MCP, i vecchi ambiti (api, sfap_api, einstein_gpt_api) non funzionano più. Usa mcp_api e refresh_token. Consulta la guida alla transizione dalla beta alla disponibilità generale di Salesforce.

Passaggio 7: assegna un set di autorizzazioni

Per impostazione predefinita, chiunque nella tua organizzazione può connettersi all'app. Per limitare l'accesso a persone specifiche, usa un set di autorizzazioni. Questo passaggio è facoltativo.

Il set di autorizzazioni controlla solo chi può connettersi. Le autorizzazioni esistenti di ogni persona su oggetti, campi e condivisione di Salesforce si applicano comunque a ogni chiamata agli strumenti.

Per assegnare un set di autorizzazioni:

1. Crea un set di autorizzazioni per gli utenti di ClickUp MCP, ad esempio Utente ClickUp MCP. Non richiede autorizzazioni aggiuntive.
2. Assegnalo a tutti coloro che si connetteranno da ClickUp.
3. In Gestione app client esterne, apri la tua app e fai clic su Criteri.
4. Sotto Criteri OAuth, imposta Utenti autorizzati su Gli utenti approvati dall'amministratore sono pre-autorizzati.

5. Sotto Criteri app, sposta il tuo set di autorizzazioni in Set di autorizzazioni selezionati. Lascia Profili selezionati vuoto.

6. Fai clic su Salva.

Se selezioni Gli utenti approvati dall'amministratore sono pre-autorizzati senza scegliere un set di autorizzazioni, nessuno potrà connettersi.

Lascia Ambiti OAuth personalizzati vuoto. ClickUp ha bisogno solo degli ambiti del Passaggio 6.

Passaggio 8: attendi la propagazione dell'app

Una nuova app client esterna può impiegare fino a 30 minuti per diventare disponibile, in modo simile alla propagazione DNS. Se ClickUp non funziona subito dopo la configurazione, attendi e riprova.

Nel frattempo, copia la tua chiave consumer:

1. In Gestione app client esterne, apri l'app che hai creato.
2. Fai clic su Impostazioni.
3. Fai clic su Chiave e segreto consumer sotto Impostazioni OAuth.
4. Copia la Chiave consumer. Inizia con 3MVG9.

Connetti in ClickUp

OAuth di Salesforce usa la sessione del browser attiva. Prima di iniziare, prepara il browser:

1. Disconnettiti da tutte le altre organizzazioni Salesforce nel browser predefinito.
2. Accedi all'organizzazione che contiene la tua app client esterna e tieni il browser aperto.

In questo modo eviti che l'accesso finisca nell'organizzazione sbagliata. Consulta la guida di Salesforce per accedere alla tua organizzazione.

Quando il browser è pronto, puoi connetterti in ClickUp:

1. Apri l'App Center.
2. Cerca e seleziona Salesforce.
3. Seleziona una scheda per scegliere il tipo di connessione:
   • Connessione personale: solo tu puoi usare gli strumenti Salesforce in ClickUp. La tua identità e le tue autorizzazioni Salesforce vengono usate per ogni chiamata agli strumenti.
   • Connessione dell'area di lavoro: qualsiasi membro dell'Area di lavoro può usare gli strumenti Salesforce, ma ciascuno accede con le proprie credenziali Salesforce e, se hai limitato l'accesso nel Passaggio 7, ha bisogno del relativo set di autorizzazioni. Tutti condividono la stessa app client esterna, ma ciascuno ha la propria autorizzazione.
4. Fai clic su Connetti per aprire la configurazione guidata.
5. Sotto A quale organizzazione ti stai connettendo?, scegli Produzione / Developer Edition o Sandbox / Org scratch.
6. Sotto Quale server hai attivato?, scegli il server che hai attivato nel Passaggio 2.
7. Verifica che l'URL di callback mostrato in ClickUp corrisponda a quello nella tua app client esterna.
8. Incolla la tua Chiave consumer dal Passaggio 8.
9. Fai clic su Avanti.
10. Approva l'accesso quando Salesforce lo richiede.
11. Attendi che ClickUp validi la connessione e carichi i tuoi strumenti.

Limitazioni

Limitazioni note e problemi comuni con Salesforce MCP:

• Ritardo di propagazione: una nuova app client esterna può impiegare fino a 30 minuti per funzionare. Se il primo tentativo non riesce, attendi e riprova.
• Le app connesse non funzionano: devi usare un'app client esterna.
• Server non attivato: l'accesso funziona, ma nessuno strumento viene caricato se il server selezionato in ClickUp non è attivo in Salesforce.
• Accesso limitato: se hai limitato l'accesso con un set di autorizzazioni nel Passaggio 7, chi non ce l'ha non può connettersi. Assegnaglielo oppure reimposta Utenti autorizzati su Tutti gli utenti possono auto-autorizzarsi.
• Solo quattro server in ClickUp: la configurazione guidata supporta Letture SObject, SObject completo, Mutazioni SObject e Headless 360 (beta). Altri server MCP di Salesforce, come Eliminazioni SObject o Data Cloud SQL, non sono ancora disponibili in ClickUp.
• Più organizzazioni in un unico browser: se hai effettuato l'accesso a più di un'organizzazione, l'accesso potrebbe finire in quella sbagliata. Disconnettiti prima dalle altre.
• Limiti e fatturazione API: le chiamate agli strumenti MCP vengono conteggiate nei limiti delle richieste API della tua organizzazione e Salesforce potrebbe fatturare l'utilizzo MCP tramite Flex Credits. Controlla Utilizzo API nella pagina Configurazione di Salesforce.
• Org scratch: non è possibile creare app client esterne nelle org scratch dalla pagina Configurazione di Salesforce. Crea l'app in un'org Dev Hub, crea un pacchetto e installala nell'org scratch.
• Configurazioni beta: i vecchi ambiti beta e gli URL contenenti v1-beta.2 non funzionano più. La configurazione guidata di ClickUp usa automaticamente il formato URL della versione con disponibilità generale.

Disconnetti o revoca l'accesso

Per disconnetterti da ClickUp:

1. Nell'App Center, cerca e seleziona l'app.
2. Seleziona la scheda Personale o Area di lavoro.
3. Accanto a Connesso, fai clic sull'icona dei puntini di sospensione ...
4. Seleziona Disconnetti.
5. Per confermare, fai clic su Disconnetti.

Per revocare completamente l'accesso dal lato Salesforce:

1. Nella pagina Configurazione di Salesforce, apri Gestione app client esterne.
2. Apri la tua app ClickUp MCP.
3. Fai clic su Criteri OAuth.
4. Revoca l'accesso oppure elimina l'app client esterna.

La disconnessione in ClickUp revoca il tuo token OAuth ma lascia l'app client esterna in Salesforce, così puoi riconnetterti facilmente.

Sicurezza avanzata per la produzione (facoltativo)

• Limita per indirizzo IP: aggiungi gli intervalli IP consentiti in Criteri OAuth e seleziona Applica l'elenco consentiti IP per il token di aggiornamento sotto Sicurezza. Prima verifica che gli intervalli IP del tuo client MCP rientrino nei limiti dell'elenco consentiti di Salesforce.
• Disconnessione singola: attivala in Impostazioni sessione in modo che la chiusura di una sessione Salesforce termini anche la sessione MCP corrispondente.
• Privilegio minimo: preferisci Letture SObject a meno che il tuo team non abbia bisogno di modificare i record.