Salesforce

Présentation

Ce guide explique comment connecter Salesforce à Forge via le serveur MCP hébergé par Salesforce (Hosted MCP). Il s'adresse aux administrateurs Salesforce et aux administrateurs de workspace Forge.

L'intégration Salesforce dans Forge repose sur deux niveaux de configuration :

Une fois connecté, le coach Forge peut interroger vos données CRM (comptes, opportunités, contacts, etc.) dans le périmètre des droits de l'utilisateur connecté.

Important : les données visibles par le coach sont celles auxquelles l'utilisateur Salesforce connecté a accès. Forge ne contourne pas les permissions Salesforce.

Prérequis

Côté Salesforce

• Un accès administrateur (ou équivalent) à votre org Salesforce (production ou sandbox).
• La possibilité de créer une External Client App (application cliente externe) avec OAuth 2.0.
• Les Hosted MCP Servers activés pour votre org (fonctionnalité Salesforce — voir la documentation officielle).
• Votre URL My Domain au format https://…my.salesforce.com.

Côté Forge

• Rôle Administrateur sur le workspace Forge concerné.
• Accès à Paramètres → Intégrations → Outils (ou Settings → Tools).

Étape 0 — Activer les serveurs MCP hébergés dans Salesforce

Administrateur Salesforce. À faire en premier — si les serveurs MCP ne sont pas activés, la connexion depuis Forge ne fonctionnera pas, quelle que soit la qualité du reste de la configuration.

1. Dans Salesforce, ouvrez Setup (Configuration).
2. Dans la zone Quick Find (Recherche rapide), tapez MCP Servers et sélectionnez MCP Servers (sous API Catalog).
3. Passez en revue les serveurs disponibles et activez ceux dont votre équipe a besoin — en particulier le serveur utilisé par Forge, platform/sobject-reads (lecture seule sur les objets SObject).
4. Comptez jusqu'à 2 minutes pour qu'un serveur devienne actif après son activation.

Une fois les serveurs actifs, poursuivez avec l'étape 1. Voir le guide Salesforce sur l'activation des serveurs MCP pour le détail.

Étape 1 — Créer une External Client App dans Salesforce

Les libellés exacts dans Setup peuvent varier selon votre version Salesforce. Pour le détail à jour, consultez la documentation Salesforce sur les Hosted MCP Servers.

1.1 Créer l'application

1. Connectez-vous à Salesforce en tant qu'administrateur.
2. Ouvrez Setup (Configuration).
3. Créez une External Client App dédiée à Forge (nom suggéré : Forge MCP ou similaire).

1.2 Configurer OAuth

Dans les paramètres OAuth de l'application :

Options à activer (cases à cocher) :

• Enable Authorization Code and Credentials Flow (section Flow Enablement)
• Require Proof Key for Code Exchange (PKCE) extension for Supported Authorization Flows — obligatoire
• Issue JSON Web Token (JWT)-based access tokens for named users

Forge utilise OAuth 2.0 avec PKCE. Un Consumer Secret n'est pas requis dans l'interface Forge pour Salesforce (le flux fonctionne avec la Consumer Key / Client ID uniquement).

Important — ces deux cases doivent être décochées. Comme PKCE est activé, l'application ne doit pas exiger de Consumer Secret. Dans les paramètres OAuth de l'External Client App, assurez-vous que les deux options suivantes sont décochées :

• Require secret for Web Server Flow
• Require secret for Refresh Token Flow

Si l'une des deux reste cochée, la connexion OAuth depuis Forge échouera.

1.3 Récupérer les informations

Notez les éléments suivants — vous en aurez besoin à l'étape 2 :

• Consumer Key (également appelée Client ID)
• My Domain URL de votre org, par exemple :
  • Production : https://votre-entreprise.my.salesforce.com
  • Sandbox / Developer : https://votre-org.develop.my.salesforce.com ou https://votre-org--sandbox.sandbox.my.salesforce.com

URL My Domain — bonnes pratiques

URL de callback

L'URL de callback OAuth doit être enregistrée à l'identique dans Salesforce et correspond au format suivant :

{URL_API_FORGE}/tools-oauth/salesforce-mcp/callback

Exemples selon l'environnement Forge

Recommandation : copiez l'URL affichée dans Forge lors de la Configuration organisation — c'est la valeur exacte à coller dans Salesforce. Ne modifiez ni le chemin, ni la casse, ni les slashs finaux.

Étape 2 — Configuration organisation dans Forge

Réservé à l'administrateur du workspace.

1. Ouvrez Paramètres → Intégrations → Outils.
2. Repérez Salesforce dans les intégrations disponibles.
3. Lancez la Configuration organisation (ou configurez l'intégration si elle n'est pas encore faite).
4. Copiez l'URL de callback affichée et ajoutez-la dans votre External Client App Salesforce (étape 1).
5. Renseignez :
   • URL My Domain — l'URL de votre org Salesforce
   • Consumer Key / Client ID — la clé de votre External Client App
6. Enregistrez.

Cette étape ne connecte pas encore un utilisateur : elle prépare le workspace pour que chaque membre puisse se connecter individuellement.

Étape 3 — Connexion utilisateur

Chaque utilisateur Forge qui souhaite utiliser Salesforce avec le coach.

1. Ouvrez Paramètres → Intégrations → Outils.
2. Cliquez sur Salesforce → Connecter (ou modifiez une connexion existante).
3. Donnez un nom à la connexion si besoin (ex. « Salesforce — Jean »).
4. Cliquez sur Connecter : vous serez redirigé vers Salesforce pour autoriser l'accès.
5. Acceptez les permissions demandées.
6. Une fois la redirection terminée, la connexion apparaît comme active dans Forge.

Chaque utilisateur doit effectuer cette étape avec son propre compte Salesforce.

Ce que le coach peut faire

Forge se connecte au serveur MCP hébergé par Salesforce platform/sobject-reads (lecture seule sur les objets SObject autorisés).

Le coach peut notamment vous aider à :

• Retrouver des comptes, contacts, opportunités et pistes
• Préparer des rendez-vous commerciaux et des relances
• Suivre votre pipeline dans le cadre de vos droits Salesforce

Les signaux Forge (opportunités ouvertes, deals récemment perdus) sont également calculés à partir des données de l'utilisateur connecté.

Supprimer la connexion

1. Accédez à Paramètres > Outils.
2. Repérez la connexion Salesforce et cliquez sur Supprimer (icône corbeille).
3. Confirmez la suppression dans la fenêtre de confirmation.

Conséquences de la suppression :

• Le coach perd immédiatement l'accès aux données Salesforce — il ne pourra plus les interroger pendant les conversations.
• Les signaux liés à Salesforce (opportunités ouvertes, deals perdus) ne seront plus générés.
• Les conversations en cours ne sont pas interrompues, mais toute requête impliquant Salesforce sera signalée comme indisponible.
• Données : Forge ne conserve aucune donnée Salesforce de manière permanente — l'intégration fonctionne en temps réel et aucune copie n'est conservée après la suppression. L'autorisation OAuth est révoquée côté Forge ; vous pouvez aussi la révoquer côté Salesforce (Connected Apps OAuth Usage).
• Vous pouvez reconnecter Salesforce à tout moment en répétant l'étape 3.

Sandbox vs production

Configurez une External Client App par org (sandbox et production sont distinctes). Si vous testez d'abord en sandbox, refaites la configuration organisation dans Forge avec l'URL et la Consumer Key de la sandbox.

Dépannage

« instanceUrl must be your Salesforce org URL… »

• Vérifiez que l'URL se termine par .my.salesforce.com.
• N'utilisez pas une URL copiée depuis une page Setup Salesforce.
• Utilisez https:// uniquement.

Erreur OAuth / « redirect_uri mismatch »

• L'URL de callback dans Salesforce doit correspondre exactement à celle affichée dans Forge.
• Vérifiez qu'il n'y a pas d'espace, de slash en trop ou de différence http / https.

PKCE / scopes refusés

• PKCE doit être activé sur l'External Client App.
• Les scopes mcp_api et refresh_token doivent être autorisés.
• Les options Require secret for Web Server Flow et Require secret for Refresh Token Flow doivent être décochées (PKCE n'utilise pas de Consumer Secret).

Le coach ne voit aucune donnée

• Les serveurs MCP hébergés sont-ils activés dans Salesforce (étape 0) ?
• L'utilisateur Forge a-t-il connecté son propre compte Salesforce ?
• L'administrateur a-t-il terminé la configuration organisation ?
• L'utilisateur Salesforce a-t-il les droits de lecture sur les objets concernés (Opportunity, Account, etc.) ?

Connexion expirée

• Forge tente de rafraîchir automatiquement le token via refresh_token.
• Si la connexion apparaît comme expirée, ouvrez la connexion dans Forge et cliquez sur Reconnecter.

Les membres ne peuvent pas se connecter

• Seul un administrateur workspace peut effectuer la configuration organisation.
• Tant que cette étape n'est pas faite, les utilisateurs verront un message indiquant que la configuration workspace est en attente.

Checklist récapitulative

Administrateur Salesforce

• Serveurs MCP hébergés activés (platform/sobject-reads)
• External Client App créée
• « Enable Authorization Code and Credentials Flow » cochée
• Extension PKCE activée (obligatoire)
• « Issue JSON Web Token (JWT)-based access tokens for named users » cochée
• Cases « Require secret for Web Server Flow » et « Require secret for Refresh Token Flow » décochées
• Scopes mcp_api + refresh_token configurés
• URL de callback Forge enregistrée
• Consumer Key notée
• URL My Domain identifiée

Administrateur workspace Forge

• Configuration organisation enregistrée (My Domain + Consumer Key)
• URL de callback vérifiée

Utilisateur final

• Connexion Salesforce personnelle créée dans Forge
• Autorisation OAuth acceptée dans Salesforce

Ressources

• Documentation Salesforce — Hosted MCP Servers
• Salesforce — Activer les serveurs MCP
• Salesforce — External Client Apps (libellés Setup Salesforce)

Support

Pour toute question sur la configuration Forge, contactez votre interlocuteur Forge habituel ou le support via l'application.

Pour les questions liées aux droits Salesforce, aux External Client Apps ou à l'activation MCP dans votre org, contactez votre administrateur Salesforce.