Connectez Salesforce MCP à ClickUp pour que vos outils d'IA puissent rechercher, lire, créer et mettre à jour des enregistrements Salesforce en langage naturel.

Ce guide couvre la configuration unique de Salesforce qu'un administrateur Salesforce doit effectuer, puis la procédure de connexion depuis ClickUp via OAuth 2.0 avec PKCE. L'opération prend environ 20 minutes, plus 30 minutes supplémentaires pour que Salesforce active l'application.

Ce dont vous aurez besoin

• Un Environnement de travail ClickUp
• Une organisation Salesforce (Enterprise Edition ou supérieure, ou Developer Edition) avec les permissions d'administrateur système
• La permission Personnaliser l'application dans Salesforce

Étapes Salesforce

Avant de pouvoir finaliser le processus dans ClickUp, plusieurs étapes de configuration sont nécessaires dans Salesforce.

Une fois les étapes Salesforce terminées, vous rapporterez trois éléments dans ClickUp :

• La clé client (Consumer Key) de votre application client externe
• Si vous connectez une organisation de production ou sandbox
• Le serveur MCP que vous avez activé

Étape 1 : activer le service MCP

Les serveurs MCP hébergés par Salesforce n'apparaissent sur la page de configuration Salesforce qu'une fois le service MCP activé pour votre organisation :

1. Sur la page de configuration Salesforce, saisissez Serveurs MCP dans le champ Recherche rapide.
2. Si Serveurs MCP apparaît sous Catalogue API, le service est déjà activé. Passez à l'étape 2 : activer un serveur.
3. S'il n'apparaît pas, saisissez Interface utilisateur dans le champ Recherche rapide, ouvrez Interface utilisateur et activez Activer le service MCP. Enregistrez ensuite.

Si vous ne trouvez pas les Serveurs MCP, vérifiez que l'édition de votre organisation prend en charge les serveurs MCP hébergés.

Étape 2 : activer un serveur

Les serveurs MCP sont désactivés par défaut. Un administrateur doit activer chacun d'eux avant qu'un client puisse se connecter :

1. Sur la page de configuration Salesforce, saisissez Serveurs MCP dans le champ Recherche rapide.
2. Cliquez sur Serveurs MCP sous Catalogue API.
3. Activez le serveur dont votre équipe a besoin. ClickUp prend en charge les serveurs suivants :
   • Lectures SObject (recommandé) : recherche et récupère les enregistrements et les relations
   • SObject complet : crée, lit, met à jour et supprime des enregistrements
   • Mutations SObject : crée et met à jour des enregistrements, sans suppression
   • Headless 360 (bêta) : accès unifié à la plateforme Salesforce étendue

Si vous ignorez cette étape, ClickUp se connecte avec succès mais ne trouve aucun outil. Vous choisirez ce même serveur dans ClickUp, notez donc bien lequel vous avez activé.

L'activation d'un serveur peut prendre jusqu'à 2 minutes après que vous l'avez activé.

Pour la référence complète, consultez le guide Salesforce sur l'activation des serveurs MCP.

Étape 3 : créer une application client externe

Vous devez utiliser une application client externe. Les applications connectées ne sont pas prises en charge pour MCP et entraînent des échecs d'authentification.

Pour créer une application client externe :

1. Sur la page de configuration Salesforce, saisissez Client externe dans le champ Recherche rapide.
2. Cliquez sur Gestionnaire d'applications client externes.
3. Cliquez sur Nouvelle application client externe.
4. Remplissez la section Informations de base. Donnez à l'application un nom tel que ClickUp MCP.
5. Développez API (Activer les paramètres OAuth) et cochez Activer OAuth.

Laissez ce formulaire ouvert. Les étapes 4 à 6 vous guideront pour renseigner le reste.

Si ClickUp signale ultérieurement un client non valide, la clé client que vous avez collée n'appartient pas à cette application, ou l'application n'a pas encore fini de se propager (étape 8).

Pour la référence complète, consultez le guide Salesforce sur la création d'une application client externe.

Étape 4 : paramètres de sécurité OAuth

Dans le même formulaire, sous Sécurité :

1. Cochez ces options :
   • Exiger l'extension PKCE (Proof Key for Code Exchange) pour les flux d'autorisation pris en charge
   • Activer la rotation des jetons d'actualisation
   • Émettre des jetons d'accès basés sur JSON Web Token (JWT) pour les utilisateurs nommés
   • Limiter la durée de vie (TTL) du jeton d'actualisation inactif à 30 jours

• Laissez ces options décochées :
  • Exiger un secret pour le flux du serveur Web
  • Exiger un secret pour le flux de jeton d'actualisation
  • Appliquer la liste d'autorisation IP des jetons d'actualisation

ClickUp utilise PKCE en tant que client public et n'a donc pas besoin du secret client. Si vous exigez un secret ici, la connexion échoue.

Étape 5 : ajouter l'URL de rappel

Dans le champ URL de rappel, saisissez l'URL de rappel de ClickUp :

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

L'URL de rappel doit correspondre exactement, sans barre oblique finale. ClickUp affiche la même valeur dans sa configuration guidée pour que vous puissiez la comparer.

Étape 6 : ajouter des portées OAuth

Pour ajouter des portées OAuth :

1. Sous Portées OAuth sélectionnées, ajoutez :
   • mcp_api : accéder aux serveurs MCP hébergés par Salesforce
   • refresh_token, offline_access : effectuer des requêtes à tout moment
2. Cliquez sur Créer.

Si vous avez effectué cette configuration pendant la phase bêta de Salesforce MCP, les anciennes portées (api, sfap_api, einstein_gpt_api) ne fonctionnent plus. Utilisez mcp_api et refresh_token. Consultez le guide de transition de la bêta vers la disponibilité générale de Salesforce.

Étape 7 : attribuer un ensemble de permissions

Par défaut, toute personne de votre organisation peut se connecter à l'application. Pour limiter l'accès à des personnes spécifiques, utilisez un ensemble de permissions. Cette étape est facultative.

L'ensemble de permissions contrôle uniquement qui peut se connecter. Les permissions existantes de chaque personne sur les objets, champs et partages Salesforce s'appliquent toujours à chaque appel d'outil.

Pour attribuer un ensemble de permissions :

1. Créez un ensemble de permissions pour les utilisateurs de ClickUp MCP, par exemple Utilisateur ClickUp MCP. Il n'a pas besoin de permissions supplémentaires.
2. Attribuez-le à toutes les personnes qui se connecteront depuis ClickUp.
3. Dans le Gestionnaire d'applications client externes, ouvrez votre application et cliquez sur Politiques.
4. Sous Politiques OAuth, définissez Utilisateurs autorisés sur Les utilisateurs approuvés par l'administrateur sont pré-autorisés.

5. Sous Politiques de l'application, déplacez votre ensemble de permissions vers Ensembles de permissions sélectionnés. Laissez Profils sélectionnés vide.

6. Cliquez sur Enregistrer.

Si vous choisissez Les utilisateurs approuvés par l'administrateur sont pré-autorisés sans sélectionner d'ensemble de permissions, personne ne pourra se connecter.

Laissez Portées OAuth personnalisées vide. ClickUp n'a besoin que des portées de l'étape 6.

Étape 8 : attendre la propagation de l'application

Une nouvelle application client externe peut prendre jusqu'à 30 minutes avant d'être disponible, comme pour la propagation DNS. Si ClickUp échoue peu après la configuration, attendez et réessayez.

Pendant ce temps, copiez votre clé client :

1. Dans le Gestionnaire d'applications client externes, ouvrez l'application que vous avez créée.
2. Cliquez sur Paramètres.
3. Cliquez sur Clé client et secret sous Paramètres OAuth.
4. Copiez la Clé client. Elle commence par 3MVG9.

Se connecter dans ClickUp

L'authentification OAuth Salesforce utilise votre session de navigateur active. Avant de commencer, préparez votre navigateur :

1. Déconnectez-vous de toutes les autres organisations Salesforce dans votre navigateur par défaut.
2. Connectez-vous à l'organisation qui contient votre application client externe et gardez le navigateur ouvert.

Cela évite que la connexion n'aboutisse dans la mauvaise organisation. Consultez le guide Salesforce sur la connexion à votre organisation.

Une fois votre navigateur prêt, vous pouvez vous connecter dans ClickUp :

1. Ouvrez l'App Center.
2. Recherchez et sélectionnez Salesforce.
3. Sélectionnez un onglet pour choisir un type de connexion :
   • Connexion personnelle : vous seul pouvez utiliser les outils Salesforce dans ClickUp. Votre identité et vos permissions Salesforce sont utilisées pour chaque appel d'outil.
   • Connexion à l'Environnement de travail : tous les membres de l'Environnement de travail peuvent utiliser les outils Salesforce, mais chaque personne se connecte avec ses propres identifiants Salesforce et, si vous avez restreint l'accès à l'étape 7, doit disposer de l'ensemble de permissions correspondant. Tout le monde partage la même application client externe, mais chaque personne possède sa propre autorisation.
4. Cliquez sur Connecter pour ouvrir la configuration guidée.
5. Sous Quelle organisation connectez-vous ?, choisissez Production / Developer Edition ou Sandbox / Scratch org.
6. Sous Quel serveur avez-vous activé ?, choisissez le serveur que vous avez activé à l'étape 2.
7. Vérifiez que l'URL de rappel affichée dans ClickUp correspond à celle de votre application client externe.
8. Collez votre Clé client de l'étape 8.
9. Cliquez sur Suivant.
10. Approuvez l'accès lorsque Salesforce vous le demande.
11. Attendez que ClickUp valide la connexion et charge vos outils.

Limitations

Limitations connues et problèmes courants avec Salesforce MCP :

• Durée de propagation : une nouvelle application client externe peut prendre jusqu'à 30 minutes pour fonctionner. Si la première tentative échoue, attendez et réessayez.
• Les applications connectées ne fonctionnent pas : vous devez utiliser une application client externe.
• Serveur non activé : la connexion fonctionne, mais aucun outil ne se charge si le serveur que vous avez choisi dans ClickUp n'est pas actif dans Salesforce.
• Accès restreint : si vous avez limité l'accès avec un ensemble de permissions à l'étape 7, les personnes qui ne le possèdent pas ne peuvent pas se connecter. Attribuez-le leur, ou redéfinissez Utilisateurs autorisés sur Tous les utilisateurs peuvent s'auto-autoriser.
• Seulement quatre serveurs dans ClickUp : la configuration guidée prend en charge les Lectures SObject, SObject complet, Mutations SObject et Headless 360 (bêta). Les autres serveurs Salesforce MCP, comme SObject Deletes ou Data Cloud SQL, ne sont pas encore disponibles dans ClickUp.
• Plusieurs organisations dans un même navigateur : si vous êtes connecté à plusieurs organisations, la connexion peut aboutir dans la mauvaise. Déconnectez-vous des autres d'abord.
• Limites de l'API et facturation : les appels d'outils MCP sont comptabilisés dans les limites de requêtes API de votre organisation, et Salesforce peut facturer l'utilisation MCP via des Flex Credits. Vérifiez l'Utilisation de l'API sur la page de configuration Salesforce.
• Scratch orgs : vous ne pouvez pas créer d'applications client externes dans des scratch orgs depuis la page de configuration Salesforce. Créez l'application dans une organisation Dev Hub, empaquetez-la et installez-la dans la scratch org.
• Configurations bêta : les anciennes portées bêta et les URL contenant v1-beta.2 ne fonctionnent plus. La configuration guidée de ClickUp utilise automatiquement le format d'URL en disponibilité générale.

Déconnecter ou révoquer l'accès

Pour vous déconnecter depuis ClickUp :

1. Dans l'App Center, recherchez et sélectionnez l'application.
2. Sélectionnez l'onglet Personnel ou Environnement de travail.
3. À côté de Connecté, cliquez sur l'icône des points de suspension...
4. Sélectionnez Déconnecter.
5. Pour confirmer, cliquez sur Déconnecter.

Pour révoquer complètement l'accès depuis Salesforce :

1. Sur la page de configuration Salesforce, ouvrez le Gestionnaire d'applications client externes.
2. Ouvrez votre application ClickUp MCP.
3. Cliquez sur Politiques OAuth.
4. Révoquez l'accès ou supprimez l'application client externe.

La déconnexion dans ClickUp révoque votre jeton OAuth mais laisse l'application client externe dans Salesforce, ce qui vous permet de vous reconnecter facilement.

Renforcement de la sécurité pour la production (facultatif)

• Restreindre par adresse IP : ajoutez des plages d'adresses IP autorisées dans les Politiques OAuth et cochez Appliquer la liste d'autorisation IP des jetons d'actualisation sous Sécurité. Vérifiez d'abord que les plages IP de votre client MCP respectent les limites de la liste d'autorisation Salesforce.
• Déconnexion unique : activez-la dans les Paramètres de session pour qu'une fin de session Salesforce mette également fin à la session MCP correspondante.
• Privilège minimal : préférez les Lectures SObject sauf si votre équipe a besoin de modifier des enregistrements.