Rodz + Claude Desktop via MCP : intelligence par l'IA

En resume : Le Model Context Protocol (MCP) permet de connecter Claude Desktop directement a l’API Rodz. Resultat : vous interrogez vos signaux d’affaires en langage naturel, vous enrichissez vos contacts et vous generez des analyses sans ecrire une seule ligne de code. Ce guide vous accompagne de l’installation a vos premieres conversations productives avec Claude.

Qu’est-ce que le Model Context Protocol (MCP) ?

Le Model Context Protocol (MCP) est un standard ouvert, initie par Anthropic, qui permet aux assistants IA comme Claude d’interagir avec des outils et des API externes. Sans MCP, un modele de langage est limite a ses connaissances d’entrainement. Il ne peut pas acceder a vos donnees en temps reel, consulter votre CRM ou interroger une API tierce.

MCP change la donne. Il definit un protocole standardise pour que l’IA puisse appeler des outils, lire des ressources et executer des actions dans des systemes externes, le tout de maniere securisee et controlable. Concretement, un serveur MCP expose un ensemble de fonctionnalites (appelees “tools”) qu’un client MCP (comme Claude Desktop) peut invoquer a la demande de l’utilisateur.

L’interet pour la prospection B2B est immediat. En connectant l’API Rodz a Claude via MCP, vous transformez Claude en un assistant commercial intelligent qui a acces a vos signaux d’affaires en temps reel. Plus besoin d’ecrire des requetes HTTP manuellement ou de naviguer dans un dashboard : vous posez vos questions en francais, et Claude interroge l’API Rodz pour vous.

Cette approche s’inscrit dans la vision que nous avons detaillee dans notre article sur MCP et IA : le futur de la prospection par signaux. Aujourd’hui, nous passons de la theorie a la pratique.

Prerequisites

Avant de commencer, assurez-vous de disposer des elements suivants :

Un compte Rodz actif avec acces a l’API. Si vous n’avez pas encore de compte, rendez-vous sur la documentation API Rodz pour en creer un.
Une cle API Rodz valide. Consultez notre guide de demarrage API pour savoir comment la recuperer.
Claude Desktop installe sur votre machine (disponible sur macOS et Windows). Vous pouvez le telecharger depuis le site officiel d’Anthropic.
Node.js 18 ou superieur installe sur votre systeme. Le serveur MCP Rodz fonctionne en Node.js. Vous pouvez verifier votre version avec la commande node --version.
Un editeur de texte pour modifier le fichier de configuration de Claude Desktop (VS Code, Notepad++, ou tout autre editeur).
Des connaissances de base en JSON, puisque la configuration MCP utilise ce format.

Si vous n’etes pas familier avec l’API Rodz, nous vous recommandons de lire d’abord le guide de demarrage et la reference des endpoints pour comprendre les donnees disponibles.

Etape 1 : Installer Claude Desktop

Si ce n’est pas encore fait, telechargez et installez Claude Desktop depuis le site officiel d’Anthropic. L’application est disponible pour macOS et Windows.

Une fois installee, lancez l’application et connectez-vous avec votre compte Anthropic. Assurez-vous que l’application fonctionne correctement avant de passer a la configuration MCP.

Claude Desktop prend en charge le Model Context Protocol nativement. C’est cette fonctionnalite qui nous permet de connecter des outils externes comme l’API Rodz directement dans l’interface de conversation.

Etape 2 : Installer le serveur MCP Rodz

Le serveur MCP Rodz est un module Node.js qui fait le pont entre Claude Desktop et l’API Rodz. Pour l’installer, ouvrez un terminal et executez la commande suivante :

npm install -g @rodz/mcp-server

Cette commande installe le serveur MCP Rodz de maniere globale sur votre machine. Une fois l’installation terminee, vous pouvez verifier qu’il est correctement installe :

npx @rodz/mcp-server --version

Le serveur MCP expose les fonctionnalites de l’API Rodz sous forme de “tools” que Claude peut appeler. Il gere l’authentification, le formatage des requetes et la presentation des resultats.

Etape 3 : Configurer Claude Desktop pour utiliser le serveur MCP Rodz

La configuration de Claude Desktop se fait via le fichier claude_desktop_config.json. L’emplacement de ce fichier depend de votre systeme d’exploitation :

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Windows : %APPDATA%\Claude\claude_desktop_config.json

Ouvrez ce fichier dans votre editeur de texte (creez-le s’il n’existe pas) et ajoutez la configuration suivante :

{
  "mcpServers": {
    "rodz": {
      "command": "npx",
      "args": ["-y", "@rodz/mcp-server"],
      "env": {
        "RODZ_API_KEY": "votre_cle_api_rodz_ici"
      }
    }
  }
}

Remplacez votre_cle_api_rodz_ici par votre cle API Rodz reelle. Si vous ne la connaissez pas, consultez le guide de demarrage pour savoir comment la recuperer depuis votre tableau de bord Rodz.

Comprendre la configuration

Detaillons chaque element de cette configuration :

"rodz" : le nom du serveur MCP tel qu’il apparaitra dans Claude Desktop. Vous pouvez le nommer comme vous le souhaitez.
"command": "npx" : la commande utilisee pour lancer le serveur. npx execute le package Node.js sans necessiter une installation prealable.
"args": ["-y", "@rodz/mcp-server"] : les arguments passes a npx. Le flag -y accepte automatiquement l’installation si le package n’est pas encore en cache.
"env" : les variables d’environnement transmises au serveur. La variable RODZ_API_KEY est obligatoire pour l’authentification.

Si vous avez deja d’autres serveurs MCP configures, ajoutez simplement l’entree "rodz" dans l’objet mcpServers existant. Veillez a ne pas ecraser les configurations existantes.

Redemarrer Claude Desktop

Apres avoir modifie le fichier de configuration, redemarrez completement Claude Desktop pour que les changements prennent effet. Un simple rafraichissement de la fenetre ne suffit pas.

Une fois redemarree, vous devriez voir une icone d’outils (marteau) dans l’interface de conversation, indiquant que des serveurs MCP sont connectes. Cliquez dessus pour verifier que le serveur “rodz” apparait bien dans la liste.

Etape 4 : Les outils MCP disponibles

Une fois le serveur MCP Rodz connecte, Claude a acces a plusieurs outils pour interagir avec vos donnees. Voici les principaux :

Signaux d’affaires

list_signals : liste les signaux d’affaires detectes selon vos filtres (type de signal, secteur, zone geographique, periode). C’est l’outil le plus utilise.
get_signal_details : recupere les details complets d’un signal specifique, y compris les donnees brutes, les sources et le score Balance associe.
search_signals : recherche des signaux par mots-cles dans le contenu ou les noms d’entreprises.

Entreprises

search_companies : recherche des entreprises par nom, SIREN, secteur d’activite ou localisation.
get_company_profile : recupere le profil complet d’une entreprise, incluant les donnees firmographiques, les signaux recents et les contacts connus.
enrich_company : declenche un enrichissement firmographique et financier pour une entreprise donnee.

Contacts

search_contacts : recherche des contacts par nom, email ou entreprise.
enrich_contact : declenche un enrichissement de contact (email professionnel, poste actuel, profil LinkedIn).
get_contact_details : recupere les informations detaillees d’un contact specifique.

Configurations

list_configurations : liste vos configurations de signaux actives, avec leurs filtres et parametres.
get_configuration_stats : affiche les statistiques d’une configuration (nombre de signaux detectes, taux de correspondance).

Pour une reference complete des endpoints sous-jacents, consultez la documentation de reference de l’API Rodz.

Etape 5 : Vos premieres conversations avec Claude et Rodz

C’est le moment de passer a la pratique. Ouvrez une nouvelle conversation dans Claude Desktop et commencez a poser vos questions. Voici des exemples concrets pour vous inspirer.

Exemple 1 : Identifier les levees de fonds recentes

Tapez simplement dans Claude :

“Quelles entreprises ont leve des fonds cette semaine ?”

Claude va automatiquement appeler l’outil list_signals avec les filtres appropries (type de signal : levee de fonds, periode : 7 derniers jours) et vous presenter les resultats sous forme structuree. Pour chaque signal, vous obtiendrez le nom de l’entreprise, le montant leve, les investisseurs et la date de l’evenement.

Vous pouvez affiner votre recherche en ajoutant des criteres :

“Quelles startups SaaS de moins de 50 salaries ont leve des fonds cette semaine en France ?”

Claude ajustera les filtres en consequence et vous retournera des resultats plus cibles.

Exemple 2 : Enrichir un contact et analyser ses donnees

Supposons que vous avez identifie un prospect interessant. Demandez a Claude :

“Enrichis le profil de Jean Dupont chez Acme Corp et resume ses donnees”

Claude va d’abord rechercher le contact via search_contacts, puis declencher l’enrichissement avec enrich_contact. Il vous presentera ensuite un resume structure : poste actuel, email professionnel, profil LinkedIn, anciennete dans l’entreprise et historique des changements de poste.

Exemple 3 : Analyser les signaux RH d’un secteur

Pour une vue d’ensemble des mouvements RH dans un secteur donne :

“Quels signaux RH avons-nous pour le secteur SaaS ce mois-ci ?”

Claude interrogera l’outil list_signals filtre sur les signaux de type RH (offres d’emploi, changements de poste, recrutements massifs) pour le secteur SaaS. Il pourra vous fournir une synthese avec les tendances observees : quelles entreprises recrutent le plus, quels postes sont les plus recherches et quels mouvements de dirigeants ont eu lieu.

Exemple 4 : Generer un rapport de prospection

Combinez plusieurs outils pour creer un rapport complet :

“Genere un rapport de prospection pour le secteur fintech en Ile-de-France. Inclus les signaux recents, les entreprises en croissance et les contacts cles.”

Claude enchainera plusieurs appels : list_signals pour les signaux recents, search_companies pour identifier les entreprises actives, et search_contacts pour les decideurs. Il compilera le tout dans un rapport structure que vous pouvez copier-coller dans votre CRM ou envoyer a votre equipe commerciale.

Exemple 5 : Surveiller la concurrence

Gardez un oeil sur les mouvements de vos concurrents :

“Quels signaux avons-nous detectes sur [nom du concurrent] ces 30 derniers jours ?”

Claude utilisera search_signals et get_company_profile pour vous donner une vue complete : recrutements, levees de fonds, nouveaux produits, mentions dans la presse, changements de direction. C’est une veille concurrentielle automatisee en une seule question.

Conseils pour des prompts efficaces avec le MCP Rodz

Pour tirer le meilleur parti de la connexion Claude-Rodz, suivez ces bonnes pratiques :

Soyez specifique dans vos criteres

Plus vos criteres sont precis, plus les resultats seront pertinents. Plutot que de demander “Quels sont les signaux recents ?”, preferez “Quels signaux de levees de fonds ont ete detectes pour des entreprises SaaS B2B de 20 a 100 salaries en France cette semaine ?”.

Utilisez le vocabulaire metier de Rodz

Claude comprend mieux vos intentions lorsque vous utilisez les termes propres a la plateforme : “signaux d’affaires”, “score Balance”, “enrichissement”, “configurations”, “Deep Search”. Ces termes correspondent directement aux fonctionnalites de l’API.

Demandez des formats structures

N’hesitez pas a specifier le format de sortie souhaite : “Presente les resultats sous forme de tableau”, “Classe les entreprises par montant leve”, “Resume en 3 points cles”. Claude formatera les donnees en consequence.

Enchainez les questions

L’avantage du mode conversationnel est la continuite du contexte. Apres une premiere recherche, vous pouvez affiner sans tout repeter : “Parmi ces entreprises, lesquelles sont en Ile-de-France ?”, “Enrichis le contact principal de la troisieme entreprise”, “Redige un email de prospection base sur ce signal”.

Combinez avec les capacites natives de Claude

Le MCP Rodz fournit les donnees, mais Claude apporte ses capacites d’analyse et de redaction. Demandez-lui de synthetiser des tendances, de comparer des entreprises, de rediger des messages personnalises ou de suggerer des strategies d’approche basees sur les signaux detectes.

Sauvegardez vos prompts favoris

Lorsque vous trouvez une formulation qui produit exactement les resultats souhaites, notez-la. Vous pouvez creer une bibliotheque de prompts standards pour votre equipe commerciale, ce qui garantit la coherence et fait gagner du temps a tout le monde.

Limitations et bonnes pratiques

Limites de debit de l’API

Le serveur MCP Rodz respecte les limites de debit de l’API Rodz. Si vous enchainez de nombreuses requetes dans une meme conversation, vous pourriez atteindre ces limites. Dans ce cas, Claude vous en informera et vous suggerer d’attendre avant de poursuivre.

Pour les usages intensifs (rapports quotidiens automatises, enrichissements en masse), l’API directe reste plus adaptee que le MCP, qui est concu pour un usage interactif et exploratoire.

Securite de la cle API

Votre cle API est stockee en clair dans le fichier claude_desktop_config.json. Assurez-vous que ce fichier n’est pas accessible a d’autres utilisateurs de votre machine. Ne partagez jamais ce fichier tel quel. Si vous travaillez en equipe, chaque membre doit utiliser sa propre cle API.

En cas de compromission, regenerez immediatement votre cle depuis le tableau de bord Rodz. L’ancienne cle sera invalidee automatiquement.

Precision des resultats

Claude interprete vos questions en langage naturel et les traduit en appels API. Dans la grande majorite des cas, cette traduction est fidele. Cependant, pour des requetes tres complexes ou ambigues, il peut arriver que les filtres appliques ne correspondent pas exactement a votre intention. Dans ce cas, reformulez votre question de maniere plus explicite ou verifiez les parametres utilises en demandant a Claude de les afficher.

Donnees en temps reel

Les signaux retournes par le MCP sont les memes que ceux disponibles via l’API. Ils sont detectes en quasi temps reel par les scrapers Rodz. Neanmoins, un leger decalage (quelques minutes a quelques heures) peut exister entre la survenance d’un evenement et sa detection par le systeme.

Confidentialite des conversations

Les conversations avec Claude Desktop sont soumises aux conditions d’utilisation d’Anthropic. Les donnees echangees avec le serveur MCP Rodz transitent par votre machine locale. Le serveur MCP s’execute localement et communique directement avec l’API Rodz, sans intermediaire.

Le futur : vers des agents IA autonomes pour la prospection

La connexion Claude-Rodz via MCP n’est qu’une premiere etape. L’evolution naturelle de cette technologie pointe vers des agents IA autonomes capables de gerer une partie du cycle de prospection de maniere independante.

Traitement autonome des signaux

Imaginez un agent qui, chaque matin, analyse les nouveaux signaux detectes par Rodz, les classe par priorite en utilisant le scoring Balance, enrichit automatiquement les contacts des entreprises les plus prometteuses et genere des brouillons d’emails personnalises pour chaque signal.

Integration multi-outils

Le MCP ne se limite pas a Rodz. Un agent IA pourrait orchestrer plusieurs serveurs MCP simultanement : consulter les signaux dans Rodz, verifier les donnees dans votre CRM, programmer un email dans votre outil de sequencing et creer une tache de suivi dans votre gestionnaire de projets. Le tout en une seule instruction.

Apprentissage continu

En analysant les retours (taux de reponse, conversions, deals signes), un agent IA pourrait progressivement affiner ses criteres de selection, ses strategies d’approche et ses modeles de messages. Chaque interaction deviendrait une source d’apprentissage pour ameliorer les resultats futurs.

Ce qui existe deja, et ce qui arrive

Aujourd’hui, la connexion MCP vous permet un usage interactif : vous posez une question, Claude interroge Rodz et vous repond. Demain, les frameworks d’agents (comme le Computer Use d’Anthropic ou les agents autonomes) permettront d’automatiser des workflows complets de prospection, de la detection du signal a l’envoi du premier message.

Nous travaillons activement sur ces integrations chez Rodz. Si vous souhaitez etre informe des nouveautes, consultez regulierement notre documentation API ou contactez-nous directement.

Questions frequentes

Le MCP Rodz fonctionne-t-il avec d’autres clients que Claude Desktop ?

Le MCP est un standard ouvert. Tout client compatible MCP peut theoriquement se connecter au serveur MCP Rodz. Cela dit, Claude Desktop est aujourd’hui le client le plus mature et le mieux supporte. D’autres clients comme Cursor, Windsurf ou des IDE compatibles MCP peuvent egalement fonctionner, mais nous ne les testons pas officiellement pour l’instant.

Faut-il un abonnement Anthropic payant pour utiliser le MCP ?

Claude Desktop est disponible en version gratuite et en version Pro. La version gratuite permet d’utiliser le MCP, mais avec des limites de messages plus restrictives. Pour un usage regulier en prospection, l’abonnement Pro est recommande car il offre un volume de messages bien superieur et un acces prioritaire au modele.

Le serveur MCP Rodz consomme-t-il des credits API supplementaires ?

Oui. Chaque appel d’outil effectue par Claude via le MCP correspond a un appel API Rodz standard. Ces appels sont decomptes de votre quota API habituel. Surveillez votre consommation dans le tableau de bord Rodz, surtout si vous effectuez de nombreuses requetes dans une meme session.

Puis-je utiliser le MCP Rodz en equipe ?

Absolument. Chaque membre de l’equipe installe Claude Desktop sur sa machine, configure le serveur MCP avec sa propre cle API Rodz et peut interroger les donnees de maniere independante. Les droits d’acces sont determines par les permissions associees a chaque cle API.

Comment mettre a jour le serveur MCP Rodz ?

Le serveur est distribue via npm. Pour le mettre a jour, executez simplement :

npm update -g @rodz/mcp-server

Redemarrez ensuite Claude Desktop pour que la nouvelle version soit prise en compte. Nous publions regulierement des mises a jour avec de nouveaux outils et des ameliorations de performance.

Quels types de signaux puis-je interroger via le MCP ?

Tous les types de signaux disponibles dans l’API Rodz sont accessibles via le MCP. Cela inclut les signaux financiers (levees de fonds, fusions-acquisitions), les signaux RH (offres d’emploi, changements de poste), les signaux sociaux (mentions, reactions) et les signaux de concurrence (appels d’offres, mouvements concurrentiels). Pour une liste complete, consultez notre documentation sur les signaux financiers et les signaux RH.

Le MCP est-il securise ? Mes donnees passent-elles par un serveur tiers ?

Le serveur MCP s’execute localement sur votre machine. Les donnees transitent directement entre votre ordinateur et l’API Rodz, sans passer par un serveur intermediaire. L’authentification se fait via votre cle API, et toutes les communications avec l’API Rodz sont chiffrees en HTTPS. Vos requetes et resultats restent entre vous, Claude et l’API Rodz.

Puis-je automatiser des taches recurrentes avec le MCP ?

Pour l’instant, le MCP est concu pour un usage interactif. Vous posez des questions et Claude y repond en temps reel. Pour des automatisations recurrentes (rapport quotidien, enrichissement automatique), il est preferable d’utiliser l’API Rodz directement dans un script ou un workflow Make. Cela dit, les evolutions futures des agents IA pourraient rendre cette automatisation possible directement depuis Claude.

Conclusion

La connexion entre Rodz et Claude Desktop via MCP represente une avancee significative dans la maniere dont les equipes commerciales interagissent avec les signaux d’affaires. En supprimant la barriere technique entre l’utilisateur et l’API, le MCP rend l’intelligence commerciale accessible a tous les profils, pas seulement aux developpeurs.

En quelques minutes de configuration, vous transformez Claude en un assistant de prospection capable d’interroger vos signaux, d’enrichir vos contacts et de generer des analyses sur mesure. Le tout en langage naturel, sans ecrire une seule ligne de code.

Si vous n’avez pas encore de compte API Rodz, rendez-vous sur la documentation API pour demarrer. Et si vous souhaitez aller plus loin dans l’integration technique, consultez notre guide de demarrage API pour maitriser les fondamentaux.

L’IA et les signaux d’affaires convergent. Le MCP est le pont qui les relie. A vous de jouer.