Pipedrive MCP : interroger et modifier le CRM selon le niveau de sécurité

À qui cela s'adresse

Si vous voulez interroger, créer ou mettre à jour des données CRM Pipedrive directement dans Claude Code ou Claude Desktop, ce service correspond. C'est un serveur MCP pour un usage local ou auto-hébergé, authentifié par une clé API Pipedrive.

Pour qui a déjà un compte Pipedrive et une clé API, et dont le client peut exécuter un MCP STDIO. Le texte officiel indique que le transport actuel n'est que STDIO, sans OAuth hébergé. Si vous avez besoin d'un accès HTTP distant ou d'une connexion OAuth, cette page n'a pas de chemin utilisable.

Le nom de paquet doit être le @ckalima/pipedrive-mcp-server avec portée. Le texte officiel est explicite : si un ancien fragment cite le pipedrive-mcp-server sans portée, c'est un autre paquet sans rapport ; ne pas se tromper d'installation.

Première tentative en 3 minutes

Le chemin officiel recommandé est l'installation guidée. Prérequis : avoir une clé API Pipedrive, choisir Claude Code ou Claude Desktop, transport uniquement STDIO.

Dans un terminal, exécuter :

npx -y @ckalima/pipedrive-mcp-server init

Suivre le guide pour écrire le serveur dans la configuration du client. S'il faut modifier la configuration à la main, la commande est npx, les arguments sont -y et @ckalima/pipedrive-mcp-server, et définir PIPEDRIVE_API_KEY dans l'environnement. Ne pas écrire de chaîne de clé d'exemple, ni utiliser le nom de paquet sans portée.

Dès la première tentative, définir PIPEDRIVE_MODE sur read-only. Le texte officiel définit ce niveau comme lecture seule ; le niveau par défaut safe-write inclut déjà des écritures non destructives et ne convient pas à la première fois.

Puis faire un appel à faible risque : interroger des données CRM. Le texte officiel dit que vous pouvez Query, create, and update CRM data depuis l'assistant ; la première tentative ne fait que Query. Le texte officiel ne donne ni nom d'outil concret ni type d'objet. N'utiliser que les outils de type requête listés par le client pour ce serveur. Ne pas inventer de noms d'outils absents, ni créer ni mettre à jour des enregistrements.

Signal de succès : un résultat de requête d'enregistrements déjà dans Pipedrive revient, sans écriture. Si les outils d'écriture sont invisibles au niveau actuel, cela correspond au texte officiel : les outils hors niveau sont masqués, et un appel direct est refusé.

Cas d'usage

Cas 1 : requête CRM en lecture seule. Mettre PIPEDRIVE_MODE sur read-only, puis interroger des données existantes. Le texte officiel s'arrête à Query CRM data, sans objets, filtres ni pagination. En cas de succès, vous devez voir des enregistrements existants ; ne pas traiter une requête comme un export complet.

Cas 2 : créer ou mettre à jour des enregistrements au niveau par défaut safe-write. Le texte officiel dit que le niveau par défaut est lecture plus écritures non destructives, correspondant à create et update. Cela change le CRM ; avant l'appel, confirmer quel enregistrement métier vous allez changer. Le texte officiel ne donne ni liste de champs ni charge utile d'exemple. N'utiliser que la capacité de création ou de mise à jour montrée par le client, et reformuler le contenu à écrire avant d'exécuter. Deletes, conversions et autres irreversible writes ne sont pas dans ce niveau ; le texte officiel exige le niveau full pour les ouvrir.

Limites d'usage

PIPEDRIVE_MODE a read-only, safe-write (défaut) et full. Les outils hors niveau n'apparaissent pas dans la liste d'outils, et un appel direct est refusé. Deletes, conversions et autres irreversible writes exigent full ; ne pas ouvrir ce niveau dès la première tentative.

Le transport n'est pour l'instant que STDIO ; Streamable HTTP n'est qu'un drapeau prévu et ne peut pas être traité comme fourni sur cette page. L'authentification est une clé API Pipedrive, sans OAuth hébergé. La clé est dans une variable d'environnement locale ; requêtes et écritures sortent toutes deux vers Pipedrive.

Le texte officiel n'écrit ni limites de débit ni révocation. Une fois une écriture réussie, c'est à vous de la rétablir dans Pipedrive. Utiliser le nom de paquet sans portée pipedrive-mcp-server est, selon le texte officiel, un autre paquet sans rapport.