Présentation

Le MCP Modjo est une interface qui connecte votre assistant IA (tel que Claude Desktop ou Cursor) directement à vos données Modjo. Il vous permet d'interroger vos appels, deals, comptes et contacts en langage naturel, sans changer d'outil ni effectuer de recherche manuelle.

Concrètement : vous posez une question, votre assistant y répond en quelques secondes en s'appuyant sur vos données réelles.

💡 Le MCP Modjo est actuellement en bêta publique. Les fonctionnalités, noms d'outils et comportements sont susceptibles d'évoluer.

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

Un compte Modjo actif avec le rôle Administrateur
Une clé API Modjo — à récupérer depuis vos Paramètres → Intégrations
Un assistant IA compatible MCP, c'est-à-dire une des applications suivantes qui sert d'interface pour interagir avec vos données : Claude Desktop, Cursor, Dust, n8n, Zapier, Make, Codex CLI ou Gemini CLI

La fonctionnalité est disponible sur tous les plans Modjo. En cas de doute, rapprochez-vous de votre Customer Success Manager.

Étape 1 — Récupérer votre clé API

Connectez-vous à votre workspace Modjo
Accédez à Paramètres → Intégrations
Localisez la section Modjo API Key
Cliquez sur Générer une clé (ou copiez la clé existante si elle a déjà été créée)
🚨 Conservez cette clé immédiatement dans un gestionnaire de mots de passe sécurisé

⚠️ Modjo ne stocke pas votre clé API et ne pourra pas vous la communiquer ultérieurement. Copiez-la dès sa génération. Cette clé donne accès à l'ensemble des données de votre workspace — elle ne doit jamais être partagée ni intégrée dans un dépôt de code.

Étape 2 — Configurer votre assistant IA

Le serveur MCP Modjo est accessible à l'adresse https://api.mcp.modjo.ai/v1/mcp via le protocole HTTP Streamable, avec une authentification par Bearer token.

La configuration varie selon l'application utilisée. Suivez la section correspondante ci-dessous.

Claude Desktop

Claude Desktop ne supporte que le transport stdio. Pour se connecter à un serveur HTTP distant comme Modjo, un proxy mcp-remote est nécessaire.

⚠️ Prérequis : accès Administrateur à Claude Desktop et Node.js installé sur votre poste.

Ouvrez Claude Desktop et accédez à Paramètres → Développeur → Modifier la config
Ajoutez le bloc suivant dans le fichier claude_desktop_config.json :

json

{   "mcpServers": {     "modjo": {       "command": "npx",       "args": [         "-y",         "mcp-remote",         "https://api.mcp.modjo.ai/v1/mcp",         "--header",         "Authorization:${MODJO_AUTH_HEADER}"       ],       "env": {         "MODJO_AUTH_HEADER": "Bearer votre-cle-api-modjo-ici"       }     }   } }

Remplacez votre-cle-api-modjo-ici par votre clé API
Sauvegardez le fichier
Quittez complètement Claude Desktop (Cmd+Q sur macOS) puis relancez-le

Vérification : une icône en forme de marteau doit apparaître en bas à droite de la zone de saisie. Cliquez dessus pour confirmer que les outils Modjo sont bien listés.

Utilisateurs Windows : en raison d'un bug de Claude Desktop sur Windows, ne mettez aucun espace après les deux-points dans le paramètre --header. Placez la valeur complète Bearer <clé> dans le bloc env où les espaces sont correctement gérés.

Dust

Dust supporte nativement les serveurs MCP distants via son interface — aucune ligne de commande nécessaire.

Dans votre workspace Dust, accédez à Spaces → Tools → Add Tools
Cliquez sur Add MCP Server
Renseignez l'URL : https://api.mcp.modjo.ai/v1/mcp
Pour l'authentification, sélectionnez Bearer Token et collez votre clé API Modjo
Dust synchronise automatiquement les outils disponibles
Assignez les outils Modjo à vos agents depuis l'Agent Builder

n8n

Depuis la version 1.88.0, n8n supporte nativement le MCP — aucun package communautaire n'est nécessaire. Deux modes sont disponibles.

Mode A — avec un AI Agent (recommandé)

Ajoutez un node AI Agent avec vos credentials LLM (OpenAI, Anthropic, etc.)
Ajoutez un node MCP Client Tool et connectez-le à l'entrée Tools de l'Agent
Configurez le node :
- MCP Endpoint URL : https://api.mcp.modjo.ai/v1/mcp
- Authentication : Header Auth
- Header name : Authorization
- Header value : Bearer votre-cle-api-modjo-ici
Sous Tools to Include, choisissez All ou sélectionnez les outils Modjo souhaités

Mode B — autonome (étape déterministe)

Ajoutez un node MCP Client à votre workflow
Configurez :
- Server Transport : Streamable HTTP
- MCP Endpoint URL : https://api.mcp.modjo.ai/v1/mcp
- Authentication : Header Auth, même format que ci-dessus
Sélectionnez l'outil à exécuter dans le menu déroulant auto-rempli
Mappez les paramètres d'entrée et connectez aux nodes suivants

Autres clients compatibles (Claude Code, Cursor, Zapier, Make…)

Pour tout client MCP supportant l'authentification par header, utilisez la configuration générique suivante :

json

{   "mcpServers": {     "modjo": {       "type": "http",       "url": "https://api.mcp.modjo.ai/v1/mcp",       "headers": {         "Authorization": "Bearer votre-cle-api-modjo-ici"       }     }   } }

Les 12 outils disponibles

Une fois configuré, votre assistant dispose de 12 outils répartis en quatre catégories.

Recherche et exploration

Outil	Description
`get_accounts`	Rechercher des comptes (filtre `name` requis)
`get_deals`	Rechercher des deals (statut, montant, dates, raison de perte…)
`get_calls`	Rechercher des appels (par deal, compte, contact, date, utilisateur…)
`get_contacts`	Rechercher des contacts (email, téléphone, poste…)
`get_users`	Rechercher des utilisateurs internes (rôle, département…)
`get_emails`	Récupérer les emails associés, contenu inclus

Transcriptions

Outil	Description
`get_transcript`	Transcription complète d'un ou plusieurs appels, avec horodatage et identification des interlocuteurs

Analyse assistée par IA

Outil	Description
`ask_anything_on_call`	Question IA sur un appel, avec option agent Modjo
`ask_anything_on_deal`	Question IA sur un deal, avec option agent Modjo
`ask_anything_on_account`	Question IA sur un compte, avec option agent Modjo

Catalogue d'agents

Outil	Description
`get_agents`	Lister les agents disponibles (natifs Modjo ou personnalisés)

Les agents Modjo

Le MCP est conçu pour une approche agent-first : plutôt que de poser des questions ouvertes, vous sélectionnez un agent spécialisé qui produit un output structuré et cohérent.

Agents natifs disponibles

Agent	UUID	Idéal pour
CallSummary	`741e9ffc-87be-4bca-bb0d-f167be8b963e`	Résumé d'appel prêt pour le CRM
NextStepper	`09715241-0cdd-44c9-a386-92a1340bdf4a`	Actions et engagements (vos tâches vs les leurs)
MeetingPrepper	`c0a76fd7-3f56-4a03-b2e7-7765da10c457`	Brief pré-réunion + questions à poser
CallQualifier	`3a7753e1-d21e-4cb7-a990-7820291274cd`	Qualification structurée + lacunes
DealBriefing	`1204e84f-6edd-4782-bbdf-e5e070b400cf`	Synthèse exécutive du deal + risques
EmailFollowUp	`b2a9ae1b-2026-4dfa-9c67-101733a87a04`	Brouillon d'email de suivi personnalisé

Des agents personnalisés sont également disponibles : CallScorer, ChurnInspector, SalesCoach, MEDDPICC Validator, QuickBANT, et d'autres. Utilisez get_agents pour les découvrir.

Exemples d'utilisation

Préparer une réunion client "Brief me on Contoso — last calls, open deal, sentiment, next steps" L'agent MeetingPrepper génère un résumé structuré de la situation avant votre prise de contact.

Identifier les deals à risque "Quels deals Q2 n'ont pas évolué depuis 10 jours et ont fait l'objet d'une objection pricing au dernier appel ?" Le MCP identifie les deals concernés et extrait automatiquement les objections relevées.

Obtenir un retour post-démo "Qu'est-ce que j'ai bien géré, quels sont les points d'amélioration, et quels sujets nécessitent un suivi ?" L'agent SalesCoach produit un feedback structuré en moins de 20 secondes.

Rédiger un email de suivi personnalisé "Rédige un email de suivi pour Jean en faisant référence au problème d'intégration évoqué à la 14e minute." L'agent EmailFollowUp analyse la transcription et rédige un message adapté au contexte.

Analyser les raisons de perte commerciale "J'ai perdu 7 deals au dernier trimestre. Quelles raisons ont été évoquées lors des appels de clôture ?" Le MCP récupère les deals concernés et regroupe les causes par thème.

Recommandations d'utilisation

Privilégiez les agents plutôt que les transcriptions brutes. Utiliser ask_anything_on_call avec l'agent approprié est systématiquement plus efficace que d'analyser une transcription brute. Réservez get_transcript uniquement lorsque des citations verbatim sont indispensables.

Consultez d'abord le résumé existant. get_calls retourne un champ summary pré-généré pour la plupart des appels. Lisez-le avant de faire appel à ask_anything_on_call pour des questions simples.

Délimitez précisément le périmètre de vos requêtes. Précisez "sur les 30 derniers jours" ou "depuis le dernier appel" pour éviter d'analyser un historique trop large. Utilisez les filtres combinés disponibles sur get_deals et get_calls.

Utilisez get_agents de manière proactive. Avant de poser une question générique, vérifiez s'il existe un agent spécialisé correspondant à votre besoin (coaching, analyse concurrentielle, détection de churn…).

Respectez la pagination. Les outils de liste retournent au maximum 50 résultats par page. Utilisez limit: 50 et itérez avec le paramètre nextCursor lorsque des résultats exhaustifs sont nécessaires.

Définissez la langue si besoin. Pour des données ou utilisateurs francophones, ajoutez language: "fr" dans vos appels ask_anything_on_* pour obtenir des réponses en français.

Limites à connaître

Accès en lecture seule : le MCP ne peut pas modifier de données dans Modjo ni dans votre CRM.
Format de date strict : les filtres dateRange requièrent le format AAAA-MM-JJ (ex. 2026-03-12). Tout autre format provoquera une erreur.
Pas de statistiques agrégées natives : pour calculer des métriques en volume (nombre d'appels, durée totale…), récupérez les résultats via get_calls et calculez côté client. Utilisez l'API Modjo pour les tableaux de bord.
Pagination requise : les outils de recherche sont limités à 50 résultats par requête. Utilisez nextCursor pour itérer sur l'ensemble complet.
Latence sur les analyses IA : ask_anything_on_deal et ask_anything_on_account peuvent prendre plusieurs secondes selon la longueur des transcriptions. Les clients LLM imposent souvent une limite de 60 secondes — réduisez le périmètre si vous rencontrez des timeouts.
Accès scopé par tenant : toute personne utilisant votre clé API peut accéder à l'ensemble des appels, deals et comptes du workspace.
Encodage des caractères : utilisez les vrais caractères UTF-8 (é, è, à) dans les recherches textuelles.

Dépannage

Le serveur MCP n'apparaît pas après la configuration: Relancez complètement l'application (quittez, ne fermez pas simplement la fenêtre). Vérifiez également que votre fichier JSON est correctement formaté.

Erreur d'authentification (401 ou 403): Vérifiez que votre clé API est correctement renseignée et que le format respecte la syntaxe Bearer votre-cle-api.

Testez via echo $MODJO_AUTH_HEADER (Unix) ou echo %MODJO_AUTH_HEADER% (Windows). Si le problème persiste, régénérez une nouvelle clé.

Timeout sur une requête: Réduisez le périmètre analysé — par exemple, limitez l'analyse aux 5 derniers appels plutôt qu'à tout l'historique.

Sécurité

Ne codez jamais votre clé API en dur dans un fichier de configuration versionné
Ne partagez votre clé avec personne — toute personne la possédant peut accéder à toutes les données de votre workspace
En cas de compromission, révoquez-la immédiatement depuis Paramètres → Intégrations. La révocation est instantanée et une nouvelle clé peut être générée sans délai.

FAQ

Je ne suis pas un profil technique. L'installation est-elle accessible ? Oui. Si vous êtes en mesure de copier-coller une clé dans un écran de paramètres, vous pouvez effectuer la configuration en moins de 5 minutes.

Le MCP peut-il mettre à jour mes données dans Salesforce ou un autre CRM ? Non. Le MCP est limité à la lecture des données Modjo. Pour des actions en écriture vers d'autres outils, combinez-le avec n8n, Zapier ou Make.

Puis-je personnaliser les réponses des agents natifs ? Les agents natifs fonctionnent avec des prompts standardisés. En revanche, vous pouvez créer des agents personnalisés dans l'interface Modjo et les appeler via leur UUID dans ask_anything_on_*.

Comment obtenir des statistiques agrégées (ex. nombre d'appels par mois) ? Le MCP ne dispose pas d'outil dédié aux statistiques. Récupérez les appels via get_calls filtré par période et calculez les métriques côté client, ou utilisez l'API Modjo v2.

Puis-je accéder aux transcriptions de tous les appels d'un compte en une seule requête ? Non. Récupérez d'abord les IDs d'appels via get_calls (filtré par compte), puis appelez get_transcript pour chaque appel ou par lots d'IDs.

Les données sont-elles en temps réel ? Quasi temps-réel. Un léger délai (quelques secondes à quelques minutes) peut exister entre la fin d'un appel et sa disponibilité via le MCP.

J'utilise déjà l'API Modjo v2. Dois-je migrer vers le MCP ? Non, les deux sont complémentaires. Conservez votre pipeline existant et utilisez le MCP pour les interactions conversationnelles.

Ma clé API a été compromise. Que faire ? Révoquez-la immédiatement depuis Paramètres → Intégrations. La nouvelle clé est active instantanément.

Voir aussi

MCP Modjo: Guide de prise en main