Configurer et utiliser le MCP Modjo

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.

Comment se connecter au MCP Modjo
Outils disponibles dans le MCP Modjo
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
Rotation du token	Automatique	Manuelle

Démarrage rapide avec OAuth (recommandé)

Étape 1 : Ajouter un connecteur personnalisé à votre espace de travail

Cette étape doit être effectuée par l'administrateur de votre organisation pour Claude / ChatGPT / Dust…

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

Aller dans Personnaliser → Connecteurs → Ajouter un connecteur personnalisé
Nom : Modjo
URL : https://api.mcp.modjo.ai/v1/mcp
Cliquer sur Connecter, se connecter avec Modjo, 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é

Cursor

Paramètres → MCP → Ajouter un nouveau serveur
Coller https://api.mcp.modjo.ai/v1/mcp
Approuver l'OAuth dans le navigateur lorsque Cursor le demande

Dust

Dust prend en charge les serveurs MCP distants nativement.

Spaces → Outils → Ajouter des outils → Ajouter un serveur MCP
URL : https://api.mcp.modjo.ai/v1/mcp
Choisir OAuth comme méthode d'auth, finaliser la connexion
Assigner les outils Modjo aux agents dans l'Agent Builder

Pour les agents Dust de type automatisation où une seule clé API par workspace est acceptable, le Bearer Token est également pris en charge.

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.

Étape 2 : 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à installé le MCP Modjo avec le bearer token, nous vous recommandons de changer passer à l'authentification Oauth pour une utilisation plus simple par votre organisation.
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.

1. 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

2. Configurer votre client

Le bearer token utilise un endpoint légèrement différent qui accepte l'en-tête Authorization directement :

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

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

n8n (version 1.88.0+)

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

Mode A — 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)

Mode B — 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.

Outils disponibles

Douze outils, trois catégories. Les agents Modjo sont les plus puissants — ils produisent une analyse structurée plutôt que des données brutes.

Recherche et récupération

get_accounts — lister/rechercher des comptes (ID CRM, lien, etc.)
get_deals — lister/rechercher des deals (montant, dates, statut, source, raison de perte)
get_calls — lister/rechercher des appels (filtrer par deal, compte, contact, date, utilisateur)
get_contacts — lister/rechercher des contacts (ID CRM, email, téléphone, titre)
get_users — lister/rechercher des utilisateurs Modjo (rôle, département)
get_emails — lister/récupérer des emails avec leur contenu

Contenu

get_transcript — transcription complète d'un ou plusieurs appels, avec horodatage et intervenants

Analyse IA (agents en priorité)

ask_anything_on_call — question IA sur un seul appel
ask_anything_on_deal — question IA sur un deal
ask_anything_on_account — question IA sur un compte

Catalogue d'agents

get_agents — lister les agents disponibles (Modjo intégrés ou personnalisés)

Utiliser les agents Modjo via le MCP

Plutôt que des questions ouvertes, pointez les agents spécialisés de Modjo sur vos données. Vous obtenez le même output structuré à chaque fois, ce qui rend les résultats comparables entre commerciaux et deals.

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 get_calls
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 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

Récupérer l'ID CRM du deal avec get_deals
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."
Vous obtenez un document prêt pour une revue de forecast ou de deal desk

Autres informations utiles

Bonnes pratiques

Standardisez les questions par agent. Même formulation → outputs comparables dans toute l'équipe.
Ancrez la portée temporelle. "Au cours des 30 derniers jours" ou "depuis le dernier appel" — sinon l'agent analyse tout.
Demandez des preuves. Ajoutez "cite ce qui a été dit et par qui" pour forcer des citations horodatées.
Utilisez la pagination. Les outils de recherche sont limités à 50 résultats par page ; itérez avec nextCursor quand vous avez besoin de l'ensemble.
Combinez les filtres. get_calls accepte simultanément deal + dateRange + userIds — affinez avant d'analyser.
Documentez vos UUIDs d'agents. Un mémo interne équipe agent → cas d'usage accélère l'adoption.

Limites et contraintes

Format de date : YYYY-MM-DD pour tout filtre dateRange. Tout autre format génère une erreur.
Pas d'outil stats. Besoin du nombre d'appels ou de la durée totale ? Récupérez via get_calls, calculez côté client.
Pagination obligatoire. Maximum 50 résultats par page pour tous les outils de recherche.
UTF-8 dans les recherches. Utilisez é, è, à littéralement — pas d'échappements \uXXXX.
Latence IA. ask_anything_* peut prendre plusieurs secondes sur de longues transcriptions. Certains clients imposent un timeout de 60 secondes — à garder en tête pour les requêtes profondes au niveau d'un compte.
Périmètre d'accès aux appels : le MCP a accès à tous les appels indifféremment aux règles d'accès que vous avez pu mettre en place dans votre organisation. Cette limitation est entrain d'être adressé.

Dépannage

Boucle ou échec lors de la connexion OAuth Assurez-vous d'être déjà connecté sur app.modjo.ai dans le même navigateur avant de lancer le flux OAuth. Effacez les cookies pour modjo.ai si la boucle persiste.

Les outils n'apparaissent pas après la connexion Attendez 30 secondes et rafraîchissez. S'ils n'apparaissent toujours pas, vérifiez que l'URL est exactement https://api.mcp.modjo.ai/v1/mcp (sans slash final, sans faute de frappe) et que votre client supporte le MCP distant avec OAuth.

Erreurs 401 / 403 avec le bearer token Vérifiez que la clé est correcte et que l'en-tête est exactement Authorization: Bearer <clé> (avec l'espace). Testez avec curl :

curl -H "Authorization: Bearer votre-clé" https://api.mcp.modjo.ai/v1/mcp

ask_anything_on_deal ou _account expire Ces outils parcourent beaucoup de données. Deux causes possibles :

Le client impose un timeout de 60 secondes
Le deal/compte comporte des centaines d'appels

Réduisez la portée (plage de dates, IDs d'appels spécifiques) ou utilisez la variante au niveau de l'appel.

Les outils fonctionnent mais les données semblent obsolètes Les requêtes MCP sont quasi temps réel. Il y a généralement un délai de quelques secondes entre la fin d'un appel et sa disponibilité via MCP — attendez une minute et réessayez.