Pourquoi connecter votre propre assistant ?

Si votre équipe utilise déjà un assistant IA comme Claude, vous pouvez lui donner accès à vos appels. Vous l'interrogez alors exactement comme l'assistant intégré, mais depuis l'outil que vous utilisez au quotidien, et vous pouvez croiser vos appels avec vos autres documents et connecteurs.

Cette connexion repose sur le MCP (Model Context Protocol), le standard ouvert qui permet aux assistants IA d'utiliser des outils externes. Vous n'avez pas besoin de connaître le MCP pour l'utiliser : il suffit de suivre les étapes ci-dessous.

Ce que votre assistant peut faire

Une fois connecté, votre assistant peut :

• Compter et comparer les appels : par sujet, thème, agent, file d'attente, sentiment, jour, semaine ou mois
• Comprendre les motifs d'appel et de frustration à partir d'échantillons d'analyses
• Évaluer un agent par rapport au reste de l'équipe
• Rechercher des appels par période, direction, agent, sujet, thème ou contenu
• Lire la transcription complète d'un appel

L'accès est en lecture seule : votre assistant ne peut rien modifier dans CX-Engine.

Étape 1 : créer un jeton d'accès

1. Dans CX-Engine, sélectionnez votre compte puis ouvrez Connecteur CRM > Insights AI (MCP)
2. Cliquez sur Nouveau jeton d'accès
3. Donnez-lui un nom pour vous y retrouver (par exemple le nom de votre assistant), choisissez le PBX à analyser, puis validez
4. Copiez le jeton affiché : pour des raisons de sécurité, il ne sera plus jamais affiché

La fenêtre qui s'ouvre vous indique aussi l'adresse du serveur et les valeurs exactes à saisir à l'étape suivante.

Un jeton donne accès aux appels d'un seul PBX. Créez un jeton par PBX si votre compte est lié à plusieurs PBX.

Étape 2 : ajouter le connecteur à votre assistant

Tout assistant compatible MCP peut se connecter à Insights AI. Dans les paramètres de votre assistant, recherchez la section dédiée aux connecteurs (ou serveurs MCP), puis ajoutez un connecteur personnalisé avec les informations suivantes :

Choisissez une connexion sans OAuth (souvent appelée « aucune connexion » ou « aucune authentification ») et transmettez le jeton dans un en-tête : la connexion OAuth n'est pas encore disponible.

Exemple : Claude

1. Dans Claude (site web ou application), ouvrez Personnaliser > Connecteurs, puis cliquez sur Ajouter un connecteur personnalisé
2. Renseignez le nom (Insights AI) et l'adresse du serveur affichée dans CX-Engine, puis cliquez sur Continuer
3. Dans Authentification, sélectionnez Aucune connexion
4. Dans En-têtes de requête, choisissez x-api-key, collez votre jeton d'accès comme valeur et laissez Requis coché
5. Cliquez sur Ajouter

Sélectionnez bien Aucune connexion : avec les options « Se connecter maintenant » ou « Se connecter en cas de besoin », Claude tente une connexion OAuth qui échoue.

Les en-têtes de requête sont en cours de déploiement chez Claude : si la section En-têtes de requête n'apparaît pas, votre organisation n'y a pas encore accès. Sur les offres Team et Enterprise, c'est un propriétaire de l'organisation Claude qui ajoute le connecteur.

ChatGPT

ChatGPT n'accepte pour l'instant que les connecteurs utilisant une connexion OAuth. La connexion à Insights AI depuis ChatGPT sera possible prochainement.

Étape 3 : utiliser Insights AI dans une conversation

1. Ouvrez une nouvelle conversation dans votre assistant
2. Activez le connecteur Insights AI depuis le menu + > Connecteurs
3. Posez votre question, par exemple : « Quels sujets ont généré le plus de frustration chez nos clients ce mois-ci ? »

Votre assistant peut vous demander l'autorisation la première fois qu'il utilise un outil Insights AI. Vous pouvez généralement l'autoriser une fois ou pour toutes les conversations.

Gérer vos jetons

Depuis Connecteur CRM > Insights AI (MCP), vous pouvez à tout moment :

La colonne Dernière utilisation vous indique quand un jeton a servi pour la dernière fois.

Un jeton cesse aussi de fonctionner si son propriétaire perd l'accès au compte ou le droit d'utiliser Insights AI.

Vous avez perdu votre jeton ? Il ne peut pas être réaffiché : créez-en un nouveau et révoquez l'ancien.

Confidentialité

Lorsque vous connectez votre propre assistant, les informations nécessaires pour répondre à vos questions (statistiques, résumés, extraits de transcriptions) sont transmises à cet assistant et traitées selon les conditions de son éditeur. Vérifiez que son utilisation est conforme à la politique de votre entreprise.

Pour les équipes techniques

Insights AI est un serveur MCP standard (transport Streamable HTTP), utilisable avec n'importe quel client MCP : Claude Code, Cursor, Claude Desktop, etc.

• URL : https://votre-espace.cx-engine.com/mcp/insights
• Authentification : jeton d'accès dans l'en-tête X-API-Key (ou Authorization: Bearer)

Avec Claude Code :

claude mcp add --transport http insights-ai https://votre-espace.cx-engine.com/mcp/insights --header "X-API-Key: votre-jeton"

Configuration JSON (Cursor, Claude Desktop…) :

{
  "mcpServers": {
    "insights-ai": {
      "type": "http",
      "url": "https://votre-espace.cx-engine.com/mcp/insights",
      "headers": { "X-API-Key": "votre-jeton" }
    }
  }
}

Outils exposés : get_context, count_calls, search_calls, sample_call_insights, agent_report, get_call et find_similar_tags. Tous sont en lecture seule.

Droits d'accès

La gestion des jetons nécessite les droits Jetons MCP (crm-mcp-token.*). Les administrateurs y ont accès par défaut. Chaque utilisateur voit ses propres jetons ; le droit crm-mcp-token.manage-any permet de gérer les jetons de tous les utilisateurs du compte.