> 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/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, directement depuis votre outil IA. * **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](/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 « Settings », onglet « Integrations ». ![Onglet Integrations dans Settings, adresse du serveur MCP](https://3785996597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU54oKzNb3EyinriyUP5P%2Fuploads%2FO6P7oIzwSQFa9zMh0XOa%2F05-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. 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](/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](/interroger-et-analyser/ask-praiz.md) | | Faire ressortir des tendances, dans Praiz | [Insights](/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é](/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](/integrations/webhooks.md). Un administrateur les configure dans « Settings ». Praiz n'expose pas d'API publique.