Comment Intégrer Hermes Agent avec Votre CRM : Guide Pratique des API MCP
· Hermes Agent Experts
L’un des principaux avantages qui pousse les entreprises à adopter Hermes Agent est sa capacité à se connecter aux systèmes qu’elles utilisent déjà — et le CRM arrive presque toujours en tête de liste. Dans ce guide, nous vous montrons comment intégrer Hermes Agent à votre CRM grâce au Model Context Protocol (MCP), le protocole standard développé par Nous Research.
1. Qu’est-ce que le Model Context Protocol (MCP) ?
Le Model Context Protocol (MCP) est un protocole standardisé conçu par Nous Research pour permettre aux agents d’IA — comme Hermes Agent — d’interagir avec des systèmes externes de manière fiable et sécurisée. Il agit comme une couche d’abstraction universelle entre l’agent et vos outils métier.
Les trois composants du MCP
- Serveur MCP — Un processus léger qui expose les API de votre CRM sous forme d’outils standardisés. C’est le pont entre votre CRM et Hermes Agent.
- Client MCP — Intégré dans Hermes Agent, il découvre et invoque les outils exposés par le serveur MCP. Il gère l’authentification, la sérialisation des requêtes et le routage des réponses.
- Skills — Des instructions personnalisées que vous rédigez en langage naturel pour dire à Hermes Agent quand et comment utiliser chaque outil MCP. C’est là que vous définissez la logique métier.
Flux de communication
CRM (API REST) ←→ Serveur MCP ←→ Client MCP ←→ Hermes Agent ←→ SkillsLe flux est simple : lorsqu’un utilisateur pose une question ou donne une instruction à Hermes Agent, celui-ci consulte ses skills, détermine quel outil MCP est nécessaire, envoie une requête via le client MCP au serveur, qui la traduit en appel API vers le CRM. La réponse suit le chemin inverse.
2. Pourquoi intégrer Hermes Agent à votre CRM ?
L’intégration de votre CRM avec Hermes Agent via MCP ouvre des possibilités considérables pour automatiser les tâches quotidiennes de vos équipes commerciales et marketing.
Recherche de contacts et comptes
Demandez simplement à Hermes Agent : « Trouve-moi tous les contacts de la région Île-de-France qui n’ont pas été relancés depuis plus de 30 jours ». L’agent interroge votre CRM, filtre les résultats et vous les présente en quelques secondes, sans que vous ayez à naviguer dans l’interface CRM.
Prise de notes et suivi
Hermes Agent peut lire, résumer et ajouter des notes aux fiches contacts et opportunités. À la fin d’un appel client, dictez vos notes à l’agent : il les structure, les enregistre dans le CRM et met à jour le statut de l’opportunité.
Qualification de leads
Configurez une skill qui, à chaque nouveau lead entrant, analyse son profil (secteur, taille d’entreprise, budget estimé) et le qualifie automatiquement — chaud, tiède ou froid — avec une note expliquant la décision.
Rapports et tableaux de bord
Générez des rapports commerciaux en langage naturel : « Donne-moi le chiffre d’affaires prévisionnel du premier trimestre ventilé par commercial ». Hermes Agent compile les données depuis votre CRM et vous les restitue sous forme de synthèse claire.
Envoi d’e-mails et relances
Hermes Agent peut rédiger et envoyer des e-mails de relance personnalisés depuis votre CRM, en respectant vos templates et vos délais. Plus besoin de chasser les notifications — l’agent suit le cycle de vente pour vous.
3. Configuration pas à pas
Voici comment intégrer Hermes Agent à votre CRM avec MCP en cinq étapes.
Étape 1 : Installer un serveur MCP
Le serveur MCP peut être un simple script Python ou Node.js. Hermes Agent dispose d’un kit de démarrage pour créer votre serveur.
# Créez un répertoire pour votre serveur MCP
mkdir ~/mcp-crm-server
cd ~/mcp-crm-server
# Initialisez un projet Python
python -m venv venv
source venv/bin/activate
pip install mcp httpxÉtape 2 : Configurer les identifiants CRM
Créez un fichier .env pour stocker en toute sécurité vos clés d’API CRM.
# .env
CRM_API_KEY=votre_cle_api
CRM_INSTANCE_URL=https://votreinstance.crm.com⚠️ Ne commitez jamais ce fichier. Utilisez un gestionnaire de secrets en production.
Étape 3 : Définir les outils MCP
Créez un fichier server.py qui expose les fonctions de votre CRM en tant qu’outils MCP. Voici un exemple pour HubSpot :
from mcp import Server, Tool
import httpx
import os
server = Server("crm-server")
@server.tool(
name="rechercher_contacts",
description="Recherche des contacts dans le CRM selon des critères"
)
async def rechercher_contacts(email: str = None, entreprise: str = None, statut: str = None):
"""Recherche des contacts avec filtres optionnels."""
headers = {"Authorization": f"Bearer {os.getenv('CRM_API_KEY')}"}
params = {}
if email: params["email"] = email
if entreprise: params["company"] = entreprise
if statut: params["lifecyclestage"] = statut
async with httpx.AsyncClient() as client:
resp = await client.get(
f"{os.getenv('CRM_INSTANCE_URL')}/crm/v3/objects/contacts",
headers=headers, params=params
)
return resp.json()
@server.tool(
name="ajouter_note",
description="Ajoute une note à un contact ou une opportunité"
)
async def ajouter_note(objet_id: str, contenu: str, type_objet: str = "contact"):
"""Ajoute une note à un enregistrement du CRM."""
headers = {
"Authorization": f"Bearer {os.getenv('CRM_API_KEY')}",
"Content-Type": "application/json"
}
payload = {"body": contenu}
async with httpx.AsyncClient() as client:
resp = await client.post(
f"{os.getenv('CRM_INSTANCE_URL')}/crm/v3/objects/{type_objet}s/{objet_id}/notes",
headers=headers, json=payload
)
return resp.json()
@server.tool(
name="mettre_a_jour_opportunite",
description="Met à jour le montant ou le statut d'une opportunité"
)
async def mettre_a_jour_opportunite(opportunite_id: str, montant: float = None, statut: str = None):
"""Met à jour une opportunité existante."""
headers = {
"Authorization": f"Bearer {os.getenv('CRM_API_KEY')}",
"Content-Type": "application/json"
}
payload = {}
if montant: payload["amount"] = montant
if statut: payload["dealstage"] = statut
async with httpx.AsyncClient() as client:
resp = await client.patch(
f"{os.getenv('CRM_INSTANCE_URL')}/crm/v3/objects/deals/{opportunite_id}",
headers=headers, json=payload
)
return resp.json()
if __name__ == "__main__":
server.run()Étape 4 : Démarrer le serveur MCP
Lancez votre serveur MCP :
python ~/mcp-crm-server/server.pyHermes Agent détecte automatiquement les outils exposés dès que le serveur répond aux requêtes de découverte MCP.
Étape 5 : Créer une skill Hermes Agent
Dans l’interface Hermes Agent ou via le fichier de configuration, créez une skill qui décrit en langage naturel comment utiliser les outils MCP :
# ~/.hermes/skills/crm-hubspot.yaml
name: "crm-hubspot"
description: "Interaction avec le CRM HubSpot via MCP"
instructions: |
Tu disposes d'outils MCP connectés à notre CRM HubSpot.
- Utilise `rechercher_contacts` pour trouver des contacts par email, entreprise ou statut.
- Utilise `ajouter_note` pour enregistrer des notes de réunion sur un contact ou une opportunité.
- Utilise `mettre_a_jour_opportunite` pour modifier le montant ou l'étape d'une affaire.
Quand un utilisateur te demande une action CRM, détermine l'outil approprié,
construis les paramètres nécessaires et exécute l'appel. Présente toujours
un résumé de l'action effectuée.Rechargez Hermes Agent, et votre intégration est opérationnelle.
4. Tâches automatisables
Une fois l’intégration en place, voici les tâches que vous pouvez automatiser dès le premier jour.
Recherche et enrichissement de contacts
« Liste tous les contacts du secteur import-export avec un chiffre d’affaires supérieur à 5 M€ ». Hermes Agent filtre, trie et exporte les données en une commande.
Gestion de pipeline
« Déplace l’opportunité Dupont SARL de l’étape ‘Proposition’ à l’étape ‘Négociation’ et programme une relance dans 7 jours ». L’agent met à jour le CRM et crée une tâche de suivi.
Automatisation des communications
Configurez un déclencheur : lorsqu’un lead entre dans une nouvelle étape de qualification, Hermes Agent peut envoyer un e-mail personnalisé, créer une note de suivi et notifier le commercial responsable.
Rapports et analyses
« Quel est le taux de conversion moyen de l’équipe commerciale ce trimestre ? ». L’agent calcule les métriques directement depuis les données CRM et vous livre une synthèse actionnable.
5. Cas d’usage concrets
Agence marketing — Paris (12 collaborateurs, HubSpot)
Une agence parisienne spécialisée dans le marketing digital a intégré Hermes Agent à son CRM HubSpot pour automatiser la qualification des leads entrants. Résultat : le temps de réponse aux nouveaux prospects est passé de 4 heures à moins de 15 minutes, et le taux de qualification a augmenté de 35 %.
« Avant, notre équipe passait 2 heures par jour à trier des leads. Hermes Agent le fait en 30 secondes, et nos commerciaux se concentrent sur l’essentiel : vendre. » — Responsable marketing, Paris
Cabinet de conseil — Lyon (25 collaborateurs, Salesforce)
Un cabinet de conseil lyonnais a connecté Hermes Agent à Salesforce pour automatiser la génération de rapports d’activité hebdomadaires. L’agent compile automatiquement les données de la semaine (appels, rendez-vous, opportunités closes) et produit un rapport formaté prêt à être présenté en réunion d’équipe.
« Nous gagnons environ 3 heures par semaine par consultant sur la partie reporting. C’est un gain de productivité considérable à notre échelle. » — Directeur associé, Lyon
Studio commercial — Marseille (6 personnes, Zoho CRM)
Un petit studio commercial marseillais a choisi Zoho CRM et souhaitait un assistant capable de gérer les relances clients sans intervention humaine. Hermes Agent, via MCP, suit désormais le cycle de vente et déclenche des e-mails de relance personnalisés selon des règles définies par l’équipe.
« Nous sommes une petite équipe, chaque minute compte. Hermes Agent nous a libérés des tâches administratives répétitives. » — Gérant, Marseille
6. FAQ
Qu’est-ce que MCP et pourquoi l’utiliser pour mon CRM ?
MCP (Model Context Protocol) est un protocole standardisé de Nous Research qui permet à Hermes Agent de dialoguer avec n’importe quel système externe via une interface unifiée. L’utiliser pour votre CRM garantit une intégration propre, sécurisée et maintenable.
Dois-je savoir coder pour configurer l’intégration ?
Un minimum de connaissances en Python ou Node.js est nécessaire pour configurer le serveur MCP. Toutefois, une fois le serveur en place, la création des skills Hermes Agent se fait entièrement en langage naturel. Si vous ne disposez pas de ressources techniques en interne, notre équipe peut réaliser l’intégration pour vous.
Quels CRM sont compatibles avec Hermes Agent et MCP ?
Tous les CRM dotés d’une API REST sont compatibles. Cela inclut HubSpot, Salesforce, Zoho CRM, Pipedrive, Freshsales, SugarCRM, et la plupart des CRM open source. Le serveur MCP agit comme un adaptateur universel.
Combien de temps faut-il pour mettre en place l’intégration ?
Pour un développeur expérimenté, la configuration initiale prend entre 1 et 3 heures. L’essentiel du temps est consacré à la définition des outils MCP pertinents pour votre métier et à la rédaction des skills.
Comment sont gérées la sécurité et la confidentialité des données ?
Les clés d’API CRM sont stockées localement dans un fichier .env ou un gestionnaire de secrets. Le serveur MCP communique exclusivement en HTTPS avec votre CRM. Hermes Agent n’accède aux données que via les outils que vous exposez explicitement. Aucune donnée sensible n’est transmise à des tiers.
Puis-je connecter plusieurs CRM en même temps ?
Oui. Il suffit de lancer un serveur MCP distinct pour chaque CRM. Hermes Agent peut basculer entre les serveurs selon les instructions de vos skills. Par exemple, une skill peut être configurée pour interroger HubSpot pour les leads marketing et Salesforce pour le suivi commercial.
L’intégration fonctionne-t-elle sans accès Internet ?
Le serveur MCP nécessite un accès réseau à l’API de votre CRM. En revanche, Hermes Agent lui-même peut être exécuté localement. Si votre CRM est hébergé sur site (on-premise), l’intégration fonctionne sans passer par le cloud.
7. Conclusion
Intégrer Hermes Agent à votre CRM via le Model Context Protocol n’est pas seulement une question de productivité — c’est un changement de paradigme dans la manière dont votre équipe interagit avec ses données commerciales. En remplaçant des heures de navigation dans des interfaces CRM par des commandes en langage naturel, vous libérez vos talents pour ce qui compte vraiment : développer votre activité.
Que vous soyez une start-up de 5 personnes ou une entreprise de 200 collaborateurs, l’intégration MCP s’adapte à votre échelle et à vos outils. Et parce que MCP est un protocole ouvert, vous n’êtes jamais enfermé dans une solution propriétaire.
Prêt à connecter Hermes Agent à votre CRM ? Écrivez-nous à [email protected] — nous vous accompagnons dans l’installation, la configuration des skills et la montée en charge.