Connecter Claude à votre CRM avec MCP - Relaticle         

Comment connecter Claude à votre CRM avec MCP
=============================================

Connectez Claude à Relaticle via OAuth ou un jeton limité. Comprenez les champs personnalisés, la découverte des outils et l'écriture directe avant de modifier des enregistrements.

 Manuk Minasyan · 28 août 2026 · 15 min de lecture

 ![Comment connecter Claude à votre CRM avec MCP](https://relaticle.com/storage/ink/01M7T45M05JKNK8TE3DDDCPVN9.png) 

Avec Claude Code, environ deux minutes suffisent pour permettre à Claude de lire et d'écrire dans votre CRM Relaticle. Comptez quelques minutes de plus pour connecter Claude.ai ou Claude Desktop via OAuth. Une fois connecté, Claude peut rechercher vos entreprises, personnes, opportunités, tâches et notes, lire le détail complet d'un enregistrement, et créer, modifier ou supprimer des enregistrements directement, avec les mêmes attributs personnalisés que votre équipe a déjà configurés. Voici le guide de configuration : ce que la connexion vous apporte concrètement, comment la mettre en place depuis chaque client et ce que savent faire les outils disponibles. Il explique aussi ce que la plupart des guides passent sous silence : comment se comportent exactement les écritures dès que Claude a accès.

La référence canonique pour chaque détail ci-dessous se trouve sur [relaticle.com/developers/mcp](https://relaticle.com/fr/developers/mcp). Cet article est le guide pas à pas. Ajoutez cette page à vos favoris pour les schémas exacts des outils et le dépannage.

[](#ce-que-la-connexion-vous-apporte "Permalink")Ce que la connexion vous apporte
---------------------------------------------------------------------------------

[MCP (Model Context Protocol)](https://modelcontextprotocol.io/) est le standard ouvert qui permet à un assistant IA d'appeler de vrais outils sur un vrai système. Vous n'avez plus à copier des données dans les deux sens entre une fenêtre de discussion et votre CRM. Relaticle exploite un MCP server à l'adresse `mcp.relaticle.com`, qui expose votre espace de travail à tout client compatible MCP.

Une fois connecté, Claude peut :

- Rechercher et lister les entreprises, personnes, opportunités, tâches et notes, avec filtrage, tri et pagination
- Récupérer un enregistrement avec tout son détail et ses relations (les personnes d'une entreprise, les tâches liées à une opportunité, etc.)
- Créer, modifier et supprimer logiquement (soft delete) des enregistrements de ces cinq types d'entités
- Lire et écrire les attributs personnalisés de votre espace de travail, pas seulement les champs intégrés
- Lier ou dissocier des tâches et des notes d'entreprises, de personnes et d'opportunités, et assigner des tâches aux membres de l'espace de travail
- Lire une ressource de schéma par entité pour connaître vos codes de champ et valeurs d'option exacts avant d'écrire quoi que ce soit

Chacune de ces opérations est limitée à un seul espace de travail : celui que vous avez choisi en autorisant la connexion. Avec le même jeton, Claude ne peut ni voir ni modifier les données d'un autre espace de travail.

[](#se-connecter-depuis-claude-web-et-bureau "Permalink")Se connecter depuis Claude (web et bureau)
---------------------------------------------------------------------------------------------------

Le MCP server de Relaticle prend en charge deux méthodes d'authentification, et celle à utiliser dépend du client.

**OAuth (recommandé pour Claude.ai, Claude Desktop et Claude Code).** Ajoutez Relaticle comme connecteur personnalisé avec l'URL du point de terminaison MCP, `https://mcp.relaticle.com`, ou avec votre propre domaine si vous l'hébergez vous-même. Le serveur prend en charge OAuth 2.1 avec Dynamic Client Registration. Claude s'enregistre donc automatiquement et vous guide dans un écran de consentement en un clic : vous choisissez l'espace de travail que ce connecteur doit utiliser, vous approuvez l'accès, et la connexion est établie. Il n'y a aucun jeton à copier ni à coller.

Ce choix d'espace de travail est définitif pour le connecteur. Si vous devez le faire pointer vers un autre espace de travail, révoquez le connecteur et reconnectez-le plutôt que d'essayer de le changer sur place. Les jetons d'accès émis de cette manière durent 30 jours et les jetons d'actualisation 90 jours. Claude les renouvelle en arrière-plan, vous ne devriez donc pas remarquer l'expiration une fois la configuration faite.

**Jeton d'accès personnel.** Créez-en un sur la page Jetons d'accès de Relaticle, choisissez son espace de travail et ses autorisations, puis copiez le jeton. Pour Claude Desktop, ajoutez ce serveur distant sous **Customize → Connectors** (Personnaliser, Connecteurs) avec OAuth. Le fichier `claude_desktop_config.json` de Claude Desktop sert aux serveurs locaux. Consultez [le guide d'Anthropic pour ajouter un connecteur par URL](https://claude.com/docs/connectors/custom/add-unlisted).

![La page Jetons d'accès dans les paramètres de Relaticle, avec le formulaire de création et la liste des connecteurs IA](https://relaticle.com/storage/ink/01M09FZ68X5A12WNH2DFGVRMKC.png)

Les connexions OAuth apparaissent sous **Jetons d'accès → Connecteurs IA**, où vous pouvez les révoquer. Les jetons d'accès personnels apparaissent dans la liste des jetons de cette page.

**ChatGPT**, en bref : ses connecteurs personnalisés prennent aussi en charge OAuth Dynamic Client Registration. La procédure de configuration est donc similaire à celle de Claude.ai. Les outils `search` et `fetch` de Relaticle sont conçus spécialement pour fonctionner avec la fonction Company Knowledge de ChatGPT. `search` renvoie des URL canoniques, et `fetch` retransforme l'une de ces URL en enregistrement complet. C'est exactement le contrat que cette fonction attend.

[](#se-connecter-depuis-claude-code "Permalink")Se connecter depuis Claude Code
-------------------------------------------------------------------------------

Claude Code se connecte via OAuth, comme Claude.ai. Ajoutez le serveur, puis connectez-vous :

```
claude mcp add relaticle --transport http https://mcp.relaticle.com
claude mcp login relaticle

```

`claude mcp login` ouvre l'écran de consentement de Relaticle dans votre navigateur, où vous choisissez l'espace de travail. Vous pouvez aussi lancer `/mcp` dans une session. Claude Code conserve lui-même les jetons OAuth, votre configuration MCP ne contient donc que l'URL du serveur. Claude Code affiche ensuite `relaticle` parmi ses MCP servers, avec les mêmes outils que Claude.ai et Desktop.

Un jeton d'accès personnel fonctionne toujours, par exemple un jeton en lecture seule pour les rapports. Référencez-le par une variable d'environnement pour que le jeton reste hors de la configuration :

```
claude mcp add relaticle \
  --transport http \
  https://mcp.relaticle.com \
  --header 'Authorization: Bearer ${RELATICLE_TOKEN}'

```

Un jeton saisi directement dans l'en-tête est stocké en clair dans `~/.claude.json`, ou dans `.mcp.json` à l'intérieur de votre dépôt avec `--scope project`. [Nous avons testé où il atterrit](https://relaticle.com/fr/blog/permissions-claude-code-ou-finit-votre-jeton-crm).

*Mis à jour le 9 novembre 2026 : cette section commence désormais par OAuth. Elle donnait auparavant la commande du jeton d'accès personnel.*

| Client | Méthode de connexion | Durée de configuration habituelle |
|---|---|---|
| Claude.ai (web) | Connecteur personnalisé OAuth, Dynamic Client Registration | ~2 minutes |
| Claude Desktop | Connecteur personnalisé OAuth via Customize → Connectors | ~2-5 minutes |
| Claude Code | `claude mcp add` puis connexion OAuth (`claude mcp login`) | ~2 minutes |
| ChatGPT | Connecteur personnalisé OAuth, Dynamic Client Registration | ~2 minutes |

[](#ce-que-claude-sait-faire-les-outils "Permalink")Ce que Claude sait faire (les outils)
-----------------------------------------------------------------------------------------

Chaque connexion reçoit 39 outils, vérifiés le 8 novembre 2026. Jusqu'à 11 outils d'e-mail s'y ajoutent quand le jeton donne accès aux e-mails, et ils sont listés à la fin de cette section. Un outil sert à l'identité (`who-ami-tool`). Il renvoie l'utilisateur authentifié, l'espace de travail courant, les membres de l'espace de travail et les capacités du jeton, ce qui en fait un premier appel utile pour vérifier une nouvelle connexion. Deux servent à la découverte entre entités (`search` et `fetch`, décrits plus haut). Cinq travaillent au niveau de l'espace de travail plutôt que sur un seul enregistrement : `get-crm-schema-tool` et `list-custom-fields-tool` pour découvrir les champs, `get-crm-summary-tool` pour le nombre d'enregistrements et les totaux du pipeline, `aggregate-opportunities-tool` pour les montants du pipeline groupés par étape ou par entreprise, et `list-activity-tool` pour savoir qui a modifié quel enregistrement et quelle était la différence champ par champ. Les outils de téléversement permettent de stocker des fichiers. `upload-file` renvoie du Markdown pour les champs d'éditeur enrichi, et `create-upload-url` prépare un téléversement signé. Les 29 outils restants couvrent le CRUD et les relations pour cinq entités :

- **Entreprises** : lister/rechercher, récupérer, créer (exige `name`), modifier, supprimer
- **Personnes (contacts)** : lister/rechercher, récupérer, créer (exige `name`, `company_id` facultatif), modifier, supprimer
- **Opportunités (affaires)** : lister/rechercher, récupérer, créer (exige `name`, `company_id`/`contact_id` facultatifs), modifier, supprimer
- **Tâches** : les cinq outils habituels, plus `attach-task-to-entities-tool` et `detach-task-from-entities-tool` pour lier une tâche à des entreprises, des personnes et des opportunités, ou pour assigner et désassigner des membres de l'espace de travail, sans effacer les liens existants
- **Notes** : les cinq outils habituels, plus la liaison des notes à des entreprises, des personnes et des opportunités, ou leur dissociation
- **E-mail** (uniquement avec l'accès aux e-mails) : lister et lire les e-mails et les boîtes mail connectées ; créer, modifier et supprimer des brouillons ; envoyer un brouillon ou un nouvel e-mail ; annuler, reprogrammer ou relancer un envoi en file d'attente. Chaque outil exige la capacité correspondante sur le jeton (`email:read`, `email:draft` ou `email:send`). L'envoi exige aussi un rôle dans l'espace de travail qui autorise les agents à envoyer.

Les outils de liste acceptent `search`, `filter` (y compris sur vos attributs personnalisés, avec des opérateurs comme `eq`, `gt`, `contains` et `in`), `sort`, `per_page` et `page`. Les outils de création et de modification acceptent un objet `custom_fields` pour tout ce qui dépasse les champs intégrés. Par exemple, les opportunités de Relaticle incluent par défaut les attributs personnalisés `stage`, `amount` et `close_date`. C'est exactement ce qu'une demande comme « passe mon pipeline en revue » doit pouvoir filtrer et trier.

C'est ici qu'interviennent les cinq ressources de schéma. Avant d'écrire dans une entité, Claude lit `relaticle://schema/company` (ou `/people`, `/opportunity`, `/task`, `/note`) pour connaître les codes de champ et les valeurs d'option exacts que votre équipe a configurés. Si ces valeurs sont fausses, l'écriture est rejetée d'emblée : les codes de champ inconnus ne sont pas ignorés en silence, ils échouent à la validation. Il existe aussi un prompt intégré, **CRM Overview**, qui renvoie le nombre d'enregistrements ainsi que les entreprises et personnes créées récemment. C'est une bonne façon de démarrer une session avant de demander quelque chose de plus précis.

![Ancienne réponse de who-ami montrant le contexte du compte et les capacités du jeton](https://relaticle.com/storage/ink/01M09E1XESK0RRWGZ0034YFEFJ.png)

[](#écritures-et-sécurité "Permalink")Écritures et sécurité
-----------------------------------------------------------

C'est la partie à bien comprendre avant de connecter quoi que ce soit avec un accès en écriture.

Relaticle offre deux endroits distincts où une IA peut écrire dans votre CRM, et ils se comportent différemment. Dans l'application, Rela, l'assistant IA intégré, ne fait que proposer des écritures : quand vous lui demandez de créer ou de modifier un enregistrement, il construit une carte de proposition et attend que vous cliquiez sur approuver avant d'enregistrer quoi que ce soit en base de données. C'est une `PendingAction`, une vraie ligne qui reste en attente tant qu'une personne n'agit pas.

MCP, c'est autre chose. Quand Claude appelle un outil d'écriture du CRM, Relaticle valide la requête et invoque l'action correspondante. Les écritures réussies sont enregistrées directement. Il n'y a ni proposition, ni carte, ni étape d'approbation distincte entre les deux. Le filet de sécurité des écritures MCP est celui que vous attendriez de toute API confiée à un agent : la validation, les contrôles d'autorisation selon les politiques habituelles de Relaticle, et la portée du jeton que vous lui avez donné. Aucune validation humaine n'est intégrée au protocole.

Cette différence compte pour décider comment connecter Claude. Quelques éléments l'atténuent dans la pratique :

- **La suppression est logique.** Chaque outil de suppression fait un soft delete : rien n'est perdu définitivement et les enregistrements peuvent être récupérés. Les outils de suppression sont aussi signalés comme destructeurs dans leurs métadonnées MCP, ce qu'un client bien conçu peut utiliser pour ajouter sa propre confirmation. Vérifiez les réglages de votre client si vous voulez cette demande supplémentaire.
- **Les enregistrements créés par MCP portent une source.** Les enregistrements créés par MCP reçoivent la source de création « Agent MCP ». Modifier un enregistrement existant ne remplace pas sa source de création.
- **C'est la portée du jeton qui vous permet réellement de contrôler ces opérations.** Les connecteurs OAuth (Claude.ai, le flux en un clic de Claude Desktop, Claude Code, ChatGPT) reçoivent une seule portée qui autorise l'ensemble des outils. Le contrôle plus fin porte alors sur l'espace de travail que le connecteur peut atteindre, choisi une fois au moment du consentement et fixe jusqu'à la révocation. Les jetons d'accès personnels sont plus granulaires : en en créant un, vous cochez les capacités qu'il reçoit (lire, créer, modifier, supprimer, `email:read`, `email:draft` et `email:send`). Un jeton destiné à un rapport en lecture seule peut donc être créé sans aucun accès en écriture, séparément d'un jeton auquel vous confiez le CRUD complet.

Si vous voulez que Claude ait un accès complet en lecture et en écriture pour exécuter de vrais workflows, c'est exactement ce pour quoi cela a été conçu. Si vous préférez qu'il regarde sans jamais toucher, créez un jeton limité à `read` et utilisez-le. Les mêmes outils fonctionnent, mais ceux qui écrivent sont rejetés.

[](#configuration-en-auto-hébergement "Permalink")Configuration en auto-hébergement
-----------------------------------------------------------------------------------

Rien de tout cela n'est réservé au cloud. Une installation Relaticle auto-hébergée exécute le même MCP server, avec les mêmes outils, sans étape de déploiement distincte ni fonction à activer. Si vous n'avez pas défini `MCP_DOMAIN`, le serveur est accessible par défaut à `{APP_URL}/mcp` avec l'image Docker. Définissez cette variable si vous préférez le servir sur son propre sous-domaine. Les jetons d'accès personnels fonctionnent exactement comme décrit plus haut, et OAuth utilise le même flux basé sur Passport sur votre propre domaine une fois que vous l'avez configuré.

Sur une instance auto-hébergée, seule l'URL vers laquelle vous dirigez votre client change. Remplacez `https://mcp.relaticle.com` par votre propre `{APP_URL}/mcp` dans les extraits de configuration ci-dessus, ou par votre `MCP_DOMAIN` si vous en avez défini un. Tout le reste, y compris le comportement d'écriture directe décrit dans la section précédente, est identique à l'offre hébergée de Relaticle. Pour le déroulé complet du déploiement, consultez le [guide d'auto-hébergement](https://relaticle.com/fr/developers/self-hosting), ou notre article de blog sur [l'auto-hébergement d'un CRM natif IA](https://relaticle.com/fr/blog/auto-heberger-un-crm-ia-en-2026), qui couvre Docker, Coolify et Dokploy.

[](#exemples-de-workflows "Permalink")Exemples de workflows
-----------------------------------------------------------

Quelques idées à essayer une fois connecté, toutes construites avec des outils que le serveur possède réellement :

1. **Revue du pipeline.** « Montre-moi toutes les opportunités à l'étape Négociation/Révision, triées par montant, et signale celles qui n'ont pas de date de clôture. » Utilisez `list-opportunities-tool` avec le filtre d'étape et le tri par montant. Suivez la pagination jusqu'à ce que `has_more` soit false, puis vérifiez la date de clôture de chaque résultat.
2. **Saisie de données après un appel.** « Je viens de raccrocher avec Acme Corp. Crée l'entreprise, ajoute Jane Doe comme contact avec le poste de vice-présidente des ventes et enregistre une note qui résume ce dont nous avons discuté. » Trois appels d'outils : `create-company-tool`, puis `create-people-tool` avec `company_id` et l'attribut personnalisé `job_title`, puis `create-note-tool` avec `company_ids` et `people_ids` renseignés directement, car la création d'une note accepte ces liens d'emblée et aucun appel de liaison distinct n'est nécessaire.
3. **Débloquer une affaire au point mort.** « Regarde les notes de l'opportunité Acme et dis-moi ce qui la bloque. Mets ensuite à jour la date de clôture si nous en avons convenu pendant l'appel. » Lecture via `list-notes-tool`/`get-note-tool`, écriture via `update-opportunity-tool`.
4. **Résumé hebdomadaire.** « Donne-moi une vue d'ensemble du CRM, puis liste les entreprises créées cette semaine et les tâches en retard. » Part du prompt intégré CRM Overview, puis enchaîne avec des appels filtrés à `list-companies-tool` et `list-tasks-tool`.
5. **Tâches de relance.** « Crée une tâche pour relancer John la semaine prochaine, assigne-la-moi et lie-la à l'entreprise et à l'opportunité Acme. » Un appel à `create-task-tool`, puis `attach-task-to-entities-tool` avec `assignee_ids`, `company_ids` et `opportunity_ids` dans la même requête.
6. **Réassigner le travail en retard.** « Trouve les tâches en retard de plus d'une semaine et passe-les de Sarah à moi. » Un appel filtré à `list-tasks-tool`, puis `detach-task-from-entities-tool` pour retirer l'ancien assigné et `attach-task-to-entities-tool` pour ajouter le nouveau.

![Une conversation avec Claude qui mène une revue du pipeline avec list-opportunities-tool](https://relaticle.com/storage/ink/01M09FZ7TGV628QD22MTKZER4N.png)

Aucun de ces cas ne vous oblige à expliquer d'abord votre schéma. Claude le lit dans les ressources de schéma la première fois qu'il a besoin d'un code de champ. Si quelque chose ne fonctionne pas comme prévu, ou si vous voulez la référence complète des outils, [relaticle.com/developers/mcp](https://relaticle.com/fr/developers/mcp) contient la liste complète. Les questions générales sur le compte et l'espace de travail qui ne concernent pas MCP trouvent leur réponse sur [relaticle.com/help](https://relaticle.com/fr/help).

 Tags [ #mcp ](https://relaticle.com/fr/blog/tag/mcp) [ #claude ](https://relaticle.com/fr/blog/tag/claude) 

 Sur cette page

 Continuer la lecture

 Articles associés. 
--------------------

- [  17 nov. 2026  Guides 

    ###  Un agent IA a supprimé des enregistrements CRM : peut-on les récupérer ? 

    Si un agent IA a supprimé des enregistrements CRM, la récupération dépend du CRM. Nous comparons HubSpot, Salesforce, Attio et Relaticle, et testons une restauration dans Relaticle.

     ![](https://relaticle.com/storage/ink/01M7T5H3D3XANHYC9H4395RVXA.png) 

     ](https://relaticle.com/fr/blog/un-agent-ia-a-supprime-des-enregistrements-crm-les-recuperer)
- [  13 nov. 2026  Guides 

    ###  Connecteurs ChatGPT pour votre CRM : configuration sûre 

    Les connecteurs ChatGPT sont désormais des apps dans des plugins. Connectez chaque espace de travail du CRM une seule fois, vérifiez ce que votre rôle permet et sachez comment révoquer la connexion.

     ![](https://relaticle.com/storage/ink/01M7T5CV1S0HWHTJZ93N8HGCVZ.png) 

     ](https://relaticle.com/fr/blog/connecteurs-chatgpt-pour-votre-crm-configuration-sure)
- [  9 nov. 2026  Guides 

    ###  Permissions de Claude Code : où finit votre jeton CRM 

    Les permissions de Claude Code peuvent enregistrer un secret en clair. Nos tests montrent où un jeton CRM est stocké et pourquoi OAuth évite son enregistrement dans vos fichiers de configuration.

     ![](https://relaticle.com/storage/ink/01M7T1DNP44ZS86YPZG635WEHS.png) 

     ](https://relaticle.com/fr/blog/permissions-claude-code-ou-finit-votre-jeton-crm)
