Le serveur MCP (Model Context Protocol) de Modjo permet à votre assistant IA : Claude, ChatGPT, Cursor, Dust, n8n et tout autre client compatible MCP : de lire et analyser les données de votre espace de travail Modjo : appels, deals, comptes, contacts, transcriptions et agents IA. Posez vos questions en langage naturel, Modjo répond à partir de vos données réelles.

N'hésitez pas à vous inspirer des cas d'usages du MCP Modjo de nos clients.

Comment se connecter au MCP Modjo
Les outils MCP : ce qui change avec la V2
Utiliser les agents Modjo via le MCP
Autres informations utiles (bonnes pratiques, limites, dépannage)

Comment se connecter au MCP Modjo ?

Deux méthodes d'authentification sont disponibles. Le choix a des implications en matière de sécurité et de déploiement en équipe, lisez ceci avant de commencer.

OAuth 2.0 (recommandé : à utiliser par défaut)

Chaque utilisateur se connecte avec son propre compte Modjo.

Utilisez OAuth pour toute l'équipe, managers et admins inclus, dans 99 % des cas.

Bearer token via en-tête HTTP (admin / utilisateurs avancés uniquement)

Une clé API d'espace de travail transmise via un en-tête Authorization. Le token a une portée globale sur votre organisation : quiconque le détient peut lire tous les appels, tous les deals et tous les comptes de l'espace de travail, quel que soit son rôle dans Modjo.

C'est le bon outil quand vous avez réellement besoin d'un accès à l'ensemble du workspace : pipelines n8n, automatisations programmatiques, ou scripts gérés par un admin. Ce n'est pas l'outil pour les commerciaux individuels. Si un commercial peut utiliser OAuth, il doit l'utiliser.

	OAuth	Bearer token
Pour qui	Tous les utilisateurs : commerciaux, CSM, managers	Admins, ops, propriétaires d'automatisations
Configuration	Cliquer sur "Connecter", se connecter	Générer une clé API, coller l'en-tête
Idéal pour	Usage quotidien dans Claude, ChatGPT, Cursor	Workflows n8n, scripts, jobs côté serveur
Sécurité	Respecte les règles d'accès aux activités paramétrées dans Modjo	Donne accès à toutes les activités sans restriction
Rotation du token	Automatique	Manuelle

Démarrage rapide avec OAuth (recommandé)

Connecter Modjo à votre espace de travail

Pour Claude et Dust, Modjo est directement disponible dans leur catalogue de connecteurs/outils : il n'est plus nécessaire de configurer manuellement un connecteur MCP personnalisé.

Pour les autres clients compatibles MCP, un administrateur peut avoir besoin d'ajouter manuellement le MCP Modjo à l'aide de l'URL indiquée ci-dessous.

Claude (claude.ai web, applications Claude, Claude Code)

Modjo est directement disponible dans le catalogue de connecteurs de Claude :

Aller dans Personnaliser → Connecteurs
Rechercher Modjo
Cliquer sur Connecter, se connecter avec Modjo et approuver l'accès

Les outils Modjo sont immédiatement disponibles dans Claude. Vous pouvez les délimiter par projet dans les Projets Claude.

ChatGPT

Ouvrir Paramètres → Connecteurs → Nouveau connecteur (nécessite ChatGPT Plus ou supérieur, selon le déploiement)
URL : https://api.mcp.modjo.ai/v1/mcp
Se connecter avec Modjo lorsque demandé

Dust

Modjo est directement disponible dans le catalogue d'outils de Dust :

Aller dans Spaces → Outils → Ajouter des outils
Rechercher Modjo
Sélectionner Modjo et finaliser la connexion OAuth
Assigner les outils Modjo aux agents dans l'Agent Builder

Autres clients compatibles MCP

Tout client supportant la spec OAuth 2.0 MCP (Authorization Code + PKCE avec découverte des métadonnées de ressource protégée) fonctionnera. Pointez-le vers https://api.mcp.modjo.ai/v1/mcp et laissez-le gérer le reste : le serveur publie ses métadonnées OAuth aux chemins .well-known standards.

Se connecter en tant qu'utilisateur

Une fois le connecteur personnalisé ajouté à votre workspace, il suffit d'aller dans les connecteurs de votre espace de travail (le chemin dépend du client utilisé, voir ci-dessus), de sélectionner Modjo et de vous connecter. Aussi simple que ça.

Bon à savoir: Si vous aviez déjà configuré le MCP Modjo avec le bearer token, nous vous recommandons de passer à la méthode OAuth pour une utilisation plus simple et plus sûre par toute votre équipe : avec une connexion OAuth, chaque utilisateur ne récupère que les calls, deals et comptes auxquels il a accès dans l'app : les mêmes règles s'appliquent à la recherche, à la récupération de données et aux résultats des tools ask_anything_*. Les connexions par bearer token restent, elles, workspace-wide par nature et ne sont pas restreintes par ces règles.

Si vous avez configuré des agents qui utilisent le MCP, n'oubliez pas de les modifier également après ce changement !

Configuration du Bearer token (admins et automatisations)

À utiliser uniquement quand OAuth ne convient pas : typiquement workflows n8n, scripts planifiés, pipelines serveur-à-serveur, ou requêtes admin ponctuelles nécessitant un accès à l'ensemble du workspace.

Obtenir votre clé API

Aller dans Paramètres → Intégrations → Clé API Modjo dans l'application Modjo
Générer une clé et la stocker en lieu sûr : vous ne la reverrez plus

Configurer votre client

La connexion par bearer token utilise la même URL MCP. Transmettez votre clé API dans l’en-tête Authorization :

https://api.mcp.modjo.ai/v1/mcp

Transmettez votre clé sous la forme Authorization: Bearer <votre-clé-api>.

n8n (version 1.88.0+)

Vous automatisez des analyses dans n8n ? Privilégiez l’API des agents Modjo plutôt qu’une dépendance aux outils MCP, dont le catalogue peut évoluer. Appelez directement l’analyse avec vos instructions et la structure de réponse attendue. Consultez la documentation API et contactez votre interlocuteur Modjo pour demander plus d’informations.

n8n supporte nativement MCP depuis la v1.88.0 : pas de nœud communautaire, pas d'installation supplémentaire.

Avec un AI Agent (appels d'outils autonomes) :

Ajouter un nœud AI Agent avec vos credentials LLM
Ajouter un nœud MCP Client Tool, le connecter à l'entrée Tools de l'Agent
Configurer le MCP Client Tool :
- URL de l'endpoint MCP : https://api.mcp.modjo.ai/v1/mcp
- Authentification : Header Auth
- Nom de l'en-tête : Authorization
- Valeur de l'en-tête : Bearer votre-clé-api-modjo-ici
Sous Outils à inclure, choisir Tous (ou Sélectionnés pour des outils spécifiques)

Standalone (appels d'outils déterministes) :

Ajouter un nœud MCP Client
Configurer :
- Transport serveur : Streamable HTTP
- URL de l'endpoint MCP : https://api.mcp.modjo.ai/v1/mcp
- Même Header Auth que le Mode A
Sélectionner l'Outil à exécuter dans le menu déroulant
Mapper les paramètres d'entrée

Make / Zapier / Codex CLI / Gemini CLI / tout client MCP HTTP

Même pattern partout :

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

Rappels de sécurité pour les bearer tokens

Ne partagez pas les clés API dans git. Utilisez des variables d'environnement ou votre gestionnaire de secrets.
Ne partagez pas les clés entre utilisateurs. Une clé par automatisation ou admin, renouvelée régulièrement.
Une clé bearer est à portée de workspace. Quiconque la détient peut voir tous les appels, tous les deals, tous les comptes : y compris les données d'équipes auxquelles il n'a pas normalement accès. Traitez-la comme un mot de passe admin.
Privilégiez OAuth pour les individus. Même les admins qui font de l'analyse quotidienne dans Claude ou ChatGPT devraient se connecter avec OAuth : réservez le bearer token aux systèmes, pas aux utilisateurs.

Les outils MCP : ce qui change avec la V2

Les outils V1 restent accessibles pendant la transition et seront marqués deprecated. Aucune date de retrait n’est annoncée ici. Si vos prompts mentionnent ces outils, utilisez les correspondances ci-dessous lorsque la V2 est activée pour votre espace de travail. L’URL de connexion reste https://api.mcp.modjo.ai/v1/mcp.

Votre besoin	MCP V1	MCP V2
Retrouver des comptes	`get_accounts` : rechercher les comptes et leurs références CRM.	`search_accounts` : retrouver les comptes et leurs indicateurs d’activité, avec leurs identifiants Modjo.
Retrouver des deals	`get_deals` : rechercher les deals par montant, dates, statut, source ou raison de perte.	`search_deals` : retrouver les deals, leurs contacts et leurs informations CRM. Vérifier les filtres disponibles en V2.
Retrouver des contacts	`get_contacts` : retrouver les contacts, avec leur identifiant CRM, email, téléphone et titre.	`search_contacts` : retrouver les contacts clients et prospects et les comptes auxquels ils sont liés.
Retrouver des collègues	`get_users` : rechercher les utilisateurs Modjo, avec leur rôle et leur département.	`search_users` : retrouver les collègues et leurs équipes. Utiliser `search_teams` pour explorer les équipes et leurs membres.
Rechercher des appels	`get_calls` : rechercher les appels par deal, compte, contact, date ou utilisateur.	`search_activities`, avec le type `call` : sélectionner les appels par entité, date, équipe, tag ou sujet, puis lire leur contenu avec `get_activity_content`.
Rechercher et lire des emails	`get_emails` : rechercher les emails et récupérer leur contenu.	`search_activities`, avec le type `email`, puis `get_activity_content` pour lire leur contenu.
Rechercher par sujet	`semantic_search_activities` : retrouver les appels ou emails qui traitent d’un sujet, comme les objections ou le pricing.	`search_activities`, en mode `semantic` : rechercher par sujet et combiner les filtres disponibles. Lire les résultats sélectionnés avec `get_activity_content`.
Lire une transcription	`get_transcript` : récupérer la transcription complète d’un ou plusieurs appels, avec horodatage et intervenants.	`get_activity_content`, avec le niveau `transcript` : lire les transcriptions à partir des identifiants d’activités obtenus avec `search_activities`. Le niveau `summary` permet de lire le résumé complet d’un appel.
Retrouver les agents disponibles	`get_agents` : lister les agents intégrés et personnalisés.	Pas de remplaçant V2 direct identifié. Le statut de cet outil pendant la transition reste à confirmer.

Si vos prompts mentionnent les anciens outils, adaptez-les avec les correspondances ci-dessus et vérifiez le résultat. Pour construire des automatisations, privilégiez l’API des agents Modjo.

Une recherche par sujet renvoie une sélection de conversations pertinentes, sans garantir de retrouver toutes les conversations du périmètre.

Les outils qui gardent leur nom

Les trois outils suivants gardent leur nom en V2 : ask_anything_on_call pour une question IA sur un appel, ask_anything_on_deal sur un deal et ask_anything_on_account sur un compte. Consultez la section « Utiliser les agents Modjo via le MCP V2 » ci-dessous pour les exemples.

Les outils complémentaires en V2

search_teams : retrouver les équipes et leurs membres.
search_tags : retrouver les tags d’appels.
search_calendar_events : retrouver les réunions à venir.
resolve_ids : convertir les identifiants de contacts, comptes et deals entre Modjo et votre CRM.

Exemple : « Retrouve les appels d’onboarding de la semaine dernière pour l’équipe BDR, lis leurs résumés et liste les objections récurrentes. »

💡 Si les nouveaux outils n’apparaissent pas, demandez à votre administrateur de rafraîchir la connexion MCP dans les réglages de votre outil IA.

Utiliser les agents Modjo via le MCP (MCP V2)

Utilisez les agents spécialisés de Modjo pour analyser vos données avec des instructions réutilisables. Une consigne commune facilite la comparaison entre commerciaux et deals ; le contenu et la forme des réponses IA peuvent varier.

Agents intégrés

Agent	UUID	Idéal pour
CallSummary	`741e9ffc-87be-4bca-bb0d-f167be8b963e`	Compte-rendu d'appel prêt pour le CRM
NextStepper	`09715241-0cdd-44c9-a386-92a1340bdf4a`	Actions et engagements (nous vs eux)
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 executive du deal + risques
EmailFollowUp	`b2a9ae1b-2026-4dfa-9c67-101733a87a04`	Rédaction d'email de suivi

Exemple : extraire les prochaines étapes d'un appel

Trouver l’appel avec search_activities, en définissant filters.type sur call, puis relever son call_id numérique.
Demander à Claude : "Utilise l'agent NextStepper sur l'appel [ID] pour extraire chaque engagement. Sépare nos actions des leurs, avec les dates."
L’assistant appelle ask_anything_on_call avec id égal au call_id numérique et agentUuid: "09715241-0cdd-44c9-a386-92a1340bdf4a".
Vous obtenez les actions structurées côté client et côté équipe avec horodatage

Exemple : briefing exécutif d'un deal

Retrouver le deal avec search_deals. Pour utiliser son identifiant CRM dans cet exemple, convertir l’id Modjo renvoyé avec resolve_ids : entity: "deal", direction: "modjo_to_crm".
Demander : "Utilise DealBriefing sur le deal [CRM_ID] pour un briefing actionnable : statut, parties prenantes, signaux des derniers appels, risques, décisions attendues, plan de closing." L’assistant appelle ask_anything_on_deal avec cet identifiant dans crmId et l’UUID de DealBriefing dans agentUuid.
Vous obtenez un document prêt pour une revue de forecast ou de deal desk

Autres informations utiles (MCP V2)

Bonnes pratiques

Réutilisez les instructions par agent. Une consigne commune facilite la comparaison des analyses, sans garantir des réponses identiques.
Précisez la période et combinez les filtres. Avec search_activities, utilisez filters.date_range, deal_ids, account_ids ou user_ids pour sélectionner les conversations avant de les analyser.
Lisez le contenu adapté à votre question. Commencez par le résumé complet avec get_activity_content. Demandez la transcription si le résumé ne suffit pas, ou pour retrouver une formulation exacte, un intervenant ou un horodatage.
Demandez des preuves. Demandez à votre assistant de citer les sources et les passages pertinents, puis vérifiez les citations dans le contenu renvoyé.
Parcourez les pages disponibles. Pour les recherches paginées, transmettez pagination.nextCursor renvoyé dans pagination.cursor à l’appel suivant, en conservant les mêmes filtres. Arrêtez lorsque pagination.hasNextPage vaut false.
Conservez les références de vos agents. Documentez le nom, l’UUID et les instructions associés à chaque usage.

Dépannage

Boucle ou échec lors de la connexion OAuth

Assurez-vous d’être connecté sur app.modjo.ai dans le même navigateur avant de relancer le flux OAuth. Si la boucle persiste, effacez les cookies pour modjo.ai et reconnectez-vous.

Les outils n’apparaissent pas après la connexion

Rafraîchissez la connexion MCP dans votre outil IA. Vérifiez l’URL https://api.mcp.modjo.ai/v1/mcp, la prise en charge d’OAuth par votre client et le catalogue activé pour votre espace de travail.

Erreurs 401 / 403 avec le bearer token

Vérifiez la clé API et l’en-tête Authorization: Bearer <clé>, avec un espace après Bearer. Si l’erreur persiste, contactez votre administrateur Modjo.

Une analyse de deal ou de compte expire

Vérifiez le délai maximal configuré dans votre client MCP. Pour analyser un ensemble plus limité de conversations, sélectionnez-les avec search_activities et lisez-les avec get_activity_content. Si votre question porte sur un seul appel, utilisez ask_anything_on_call.

Les données semblent obsolètes ou incomplètes

Vérifiez vos filtres, vos droits d’accès et les pages restantes. Pour un appel récent, vérifiez aussi sa disponibilité dans Modjo, puis relancez la recherche. Les métadonnées de recherche ne remplacent pas le contenu complet obtenu avec get_activity_content.

Configurer et utiliser le MCP Modjo