> For the complete documentation index, see [llms.txt](https://docs.praiz.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.praiz.io/documentation/fr/interroger-et-analyser/serveur-mcp.md).

# Serveur MCP

Connectez votre base de données conversationnelle à Claude, ChatGPT ou tout outil compatible MCP, et interrogez tous vos appels en langage naturel.

Vous interrogez vos appels depuis votre outil IA, sans passer par l'interface Praiz.

{% hint style="info" %}
Prérequis : un compte Praiz avec des appels transcrits, et un compte sur un outil IA compatible MCP.
{% endhint %}

## Ce qu'est le MCP

MCP (Model Context Protocol) est un standard qui permet à un outil IA d'accéder à une source de données externe. Le serveur MCP de Praiz expose vos conversations : appels, transcriptions, participants et résultats d'agents. L'outil IA répond à partir du contenu de vos appels, pas seulement à partir de ses connaissances générales.

## Ce que le connecteur sait faire

* **Chercher et lire vos appels** : recherche par mots-clés, participant ou période ; lecture d'une transcription complète ou d'un extrait autour d'un moment précis ; participants et commentaires d'un appel.
* **Exploiter la donnée de vos agents** : liste de vos agents et de leurs champs, valeurs extraites sur un appel, export en masse des valeurs d'un agent avec filtres.
* **Configurer des agents** (admins) : créer un agent, ajouter ou modifier ses champs, choisir leur position et les réordonner, et régler ou retirer le remplissage CRM de chaque champ, directement depuis votre outil IA.
* **Lire votre CRM connecté** : les objets et les propriétés de votre CRM, avec leur type et leurs valeurs possibles, pour mapper un champ sans ouvrir votre CRM.
* **Explorer votre espace de travail** : utilisateurs, équipes, playlists, tags, webhooks (admins) et statistiques d'usage.

Des exemples prêts à copier sont sur la page [Que demander au connecteur MCP](https://docs.praiz.io/documentation/fr/interroger-et-analyser/serveur-mcp/que-demander-au-connecteur-mcp.md).

## Connecter le serveur MCP

L'adresse du serveur est la même pour tous les utilisateurs : `https://mcp.praiz.io/mcp`. Aucune clé ni token à générer. Vous vous authentifiez avec votre compte Praiz au moment de la connexion. Cette adresse est aussi affichée dans Praiz, dans « Réglages », onglet « Intégrations ».

![Onglet Intégrations dans Réglages, adresse du serveur MCP](https://3785996597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU54oKzNb3EyinriyUP5P%2Fuploads%2FmnAztzmjJKrxph18S4C0%2Ffr-05-settings-integrations.png?alt=media)

{% tabs %}
{% tab title="Claude" %}

1. Dans Claude, ouvrez les paramètres puis « Connectors » (claude.ai/customize/connectors).
2. Cliquez sur « Add custom connector ».
3. Collez `https://mcp.praiz.io/mcp` et validez.
4. Connectez-vous avec votre compte Praiz dans la fenêtre qui s'ouvre et choisissez votre workspace.

Si l'ajout de connecteurs est bloqué dans votre organisation, demandez à votre administrateur Claude de l'autoriser.
{% endtab %}

{% tab title="ChatGPT" %}

1. Dans ChatGPT, ouvrez les paramètres puis « Connectors ».
2. Activez le mode développeur (« Developer mode »), nécessaire pour les connecteurs MCP personnalisés.
3. Créez un connecteur avec l'adresse `https://mcp.praiz.io/mcp`.
4. Connectez-vous avec votre compte Praiz.
   {% endtab %}

{% tab title="Cursor" %}

1. Ouvrez « Settings », puis « Tools & MCP », puis « New MCP Server ».
2. Déclarez un serveur avec l'URL `https://mcp.praiz.io/mcp`.
3. Cliquez sur « Needs login » et connectez-vous avec votre compte Praiz.
   {% endtab %}

{% tab title="Autres outils" %}
Ajoutez un serveur MCP distant avec l'URL `https://mcp.praiz.io/mcp` et authentifiez-vous avec votre compte Praiz. Le serveur fonctionne avec n8n (nœud MCP Client) et tout client MCP qui prend en charge l'authentification par connexion. Codex CLI : déclarez le serveur avec cette adresse, puis lancez `codex mcp login praiz` (praiz étant le nom donné au serveur) pour vous connecter avec votre compte Praiz. Pour Gemini et Microsoft Copilot, la configuration est plus longue : contactez le support.
{% endtab %}
{% endtabs %}

Résultat attendu : Praiz apparaît dans la liste des outils connectés. Votre outil IA peut chercher dans vos appels.

## Ce que vous pouvez demander

* Quelles objections reviennent le plus souvent sur nos deals perdus ?
* Que disent nos prospects de tel concurrent ?
* Quels retours produit sont remontés ce trimestre ?
* Prépare une synthèse des échanges avec ce client avant mon rendez-vous.
* Exporte les transcriptions des 30 derniers jours.

Plus d'exemples, classés par usage : [Que demander au connecteur MCP](https://docs.praiz.io/documentation/fr/interroger-et-analyser/serveur-mcp/que-demander-au-connecteur-mcp.md).

Vous pouvez combiner le serveur MCP de Praiz avec d'autres serveurs MCP dans le même outil, par exemple celui de votre CRM. Vous croisez ainsi conversations et données CRM.

## Périmètre

Le serveur MCP donne accès à l'ensemble de vos conversations, dans la limite de vos droits dans Praiz et du workspace choisi à la connexion. La lecture ne modifie jamais vos données ; seuls les admins peuvent créer ou modifier des agents. Les listes sont paginées par 100 éléments au maximum.

| Vous voulez                                       | Utilisez                                                                                |
| ------------------------------------------------- | --------------------------------------------------------------------------------------- |
| Creuser un point sur un appel précis              | [Ask Praiz](https://docs.praiz.io/documentation/fr/interroger-et-analyser/ask-praiz.md) |
| Faire ressortir des tendances, dans Praiz         | [Insights](https://docs.praiz.io/documentation/fr/interroger-et-analyser/insights.md)   |
| Interroger toute votre base depuis votre outil IA | Serveur MCP                                                                             |

## Résoudre un problème

* L'outil IA demande de nouveau l'autorisation : la session a expiré. Reconnectez-vous.
* Les résultats sont vides : vérifiez que vous êtes connecté au bon workspace Praiz. Déconnectez et reconnectez le connecteur si besoin.
* Un appel n'apparaît pas : vérifiez qu'il est visible pour vous dans Praiz. Le serveur MCP respecte le [mode privé](https://docs.praiz.io/documentation/fr/administration/mode-prive.md).
* Un outil récent n'apparaît pas : rafraîchissez la liste des outils du connecteur dans votre client IA.

## Webhooks

Pour recevoir automatiquement les résultats d'agents, la transcription et les métadonnées d'un appel dans votre propre système, utilisez les [webhooks](https://docs.praiz.io/documentation/fr/integrations/webhooks.md). Un administrateur les configure dans « Réglages ». Praiz n'expose pas d'API publique.
