---
title: Connecter votre assistant (MCP)
excerpt: "Analysez vos appels directement depuis votre assistant IA (Claude, Claude Code, Cursor…) grâce au serveur MCP Insights AI."
order: 4
---

## 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é](/fr/docs/insights-ai/assistant), 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 :

| Information | Valeur |
|---|---|
| **Nom** | `Insights AI` |
| **URL du serveur** | L'adresse affichée dans CX-Engine, de la forme `https://votre-espace.cx-engine.com/mcp/insights` |
| **Authentification** | Votre jeton d'accès, envoyé dans l'en-tête `x-api-key` (ou comme jeton `Bearer`) |

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

| Action | Effet |
|---|---|
| **Désactiver** un jeton | Coupe l'accès immédiatement, réactivable plus tard |
| **Révoquer** un jeton | Supprime définitivement le jeton : tous les assistants qui l'utilisent perdent l'accès |
| **Connecter** | Réaffiche les instructions de connexion (sans le jeton) |

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 :

```bash
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…) :

```json
{
  "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.