> ## Documentation Index
> Fetch the complete documentation index at: https://docs.piperai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP : connectez Piper à Claude, ChatGPT et d'autres assistants IA

> Connectez Piper AI à Claude, ChatGPT et à d'autres assistants IA compatibles MCP via le serveur MCP de Piper — pour interroger vos appels, deals et contacts depuis les outils que vous utilisez déjà.

MCP (Model Context Protocol) est un standard ouvert qui permet aux assistants IA de se connecter directement aux données de Piper. À la différence des autres intégrations de Piper, MCP ne se configure pas à l'intérieur de Piper — vous ajoutez Piper comme serveur MCP dans votre outil IA (Claude, ChatGPT, ou tout autre client compatible MCP), puis vous l'autorisez avec votre compte Piper. Une fois connecté, vous pouvez interroger votre assistant IA sur vos appels, deals et contacts sans quitter l'outil que vous utilisez déjà.

<Note>
  L'accès MCP est en lecture seule. Les assistants IA connectés peuvent consulter et lire vos appels, deals, contacts et données associées, mais ne peuvent pas effectuer de modifications dans Piper en votre nom.
</Note>

## Prérequis

* Un compte Piper connecté avec votre compte professionnel Google ou Microsoft
* Un assistant IA prenant en charge les serveurs MCP distants avec OAuth (par exemple Claude ou ChatGPT)

## Le serveur MCP de Piper

|                   |                                                                                                              |
| ----------------- | ------------------------------------------------------------------------------------------------------------ |
| **Server URL**    | `https://mcp.piperai.com/mcp`                                                                                |
| **Authorization** | OAuth — connectez-vous avec votre compte Piper lorsqu'on vous le demande ; aucune clé API à générer ou gérer |
| **Access level**  | Lecture seule, limité à votre équipe Piper                                                                   |

Vous pouvez retrouver cette URL à tout moment dans **Settings → Integrations → MCP & API Access** à l'intérieur de Piper.

## Connecter Claude

<Steps>
  <Step title="Ouvrez les paramètres Connector">
    Dans Claude, allez dans **Settings → Connectors** et choisissez d'ajouter un connecteur personnalisé.
  </Step>

  <Step title="Ajoutez l'URL du serveur Piper">
    Collez `https://mcp.piperai.com/mcp` et confirmez.
  </Step>

  <Step title="Autorisez avec votre compte Piper">
    Claude ouvre un écran de connexion Piper. Choisissez **Continue with Google** ou **Continue with Microsoft** avec votre compte professionnel Piper, puis approuvez l'accès.
  </Step>
</Steps>

<Tip>
  Les menus de connecteur de Claude évoluent de temps en temps — si les étapes ci-dessus ne correspondent pas à ce que vous voyez, consultez [la documentation d'Anthropic](https://docs.claude.com) pour le chemin actuel permettant d'ajouter un connecteur personnalisé.
</Tip>

## Connecter ChatGPT

<Steps>
  <Step title="Ouvrez les paramètres Connector">
    Dans ChatGPT, allez dans **Settings → Connectors** et choisissez d'ajouter un connecteur personnalisé.
  </Step>

  <Step title="Ajoutez l'URL du serveur Piper">
    Collez `https://mcp.piperai.com/mcp` et confirmez.
  </Step>

  <Step title="Autorisez avec votre compte Piper">
    ChatGPT ouvre un écran de connexion Piper. Choisissez **Continue with Google** ou **Continue with Microsoft** avec votre compte professionnel Piper, puis approuvez l'accès.
  </Step>
</Steps>

<Tip>
  Les menus de connecteur de ChatGPT évoluent de temps en temps — si les étapes ci-dessus ne correspondent pas à ce que vous voyez, consultez la documentation d'OpenAI pour le chemin actuel permettant d'ajouter un connecteur personnalisé.
</Tip>

## Connecter d'autres clients MCP

La plupart des outils compatibles MCP (par exemple Cursor ou Windsurf) permettent d'ajouter un serveur distant par URL depuis leurs paramètres MCP ou connecteur. Ajoutez `https://mcp.piperai.com/mcp` comme URL de serveur, et terminez l'invite de connexion OAuth avec votre compte Piper lorsqu'elle apparaît. Consultez la documentation de votre outil spécifique pour savoir exactement où se trouve ce paramètre.

## Ce à quoi votre assistant IA peut accéder

Une fois connecté, votre assistant IA peut interroger :

| Données            | Ce qu'il peut faire                                                                                                                                                                                                                                                                                                                                                          |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Transcriptions** | Lister et filtrer les appels de votre équipe (par utilisateur, période, deal, contact, tag, ou meeting type), et récupérer la transcription complète, les participants et le résumé d'un appel spécifique — en incluant, si besoin, son call score, ses notes récentes, les valeurs de champs CRM, l'e-mail de relance rédigé, et un lien permanent pour l'ouvrir dans Piper |
| **Deals**          | Rechercher des deals par nom, pour les référencer ou les filtrer dans une requête                                                                                                                                                                                                                                                                                            |
| **Contacts**       | Rechercher des contacts par nom ou e-mail, pour les référencer ou les filtrer dans une requête                                                                                                                                                                                                                                                                               |
| **Meeting Types**  | Lister les meeting types configurés sur votre équipe                                                                                                                                                                                                                                                                                                                         |
| **Tags**           | Lister les tags disponibles sur votre équipe                                                                                                                                                                                                                                                                                                                                 |
| **Users**          | Lister les utilisateurs de votre équipe                                                                                                                                                                                                                                                                                                                                      |

<Note>
  L'accès est limité à votre équipe Piper — votre assistant IA ne voit que les appels et enregistrements visibles pour votre compte, selon les mêmes règles de partage qui s'appliquent dans Piper lui-même.
</Note>

### Exemples de questions que vous pouvez poser

* "Quels appels ai-je eus récemment avec \[nom de contact ou d'entreprise] ?"
* "Résume mon dernier appel concernant \[nom du deal]."
* "Montre-moi tous les appels taggés '\[nom du tag]' ce trimestre."
* "Liste les meeting types de mon équipe."

## Se déconnecter

Pour révoquer l'accès d'un assistant IA, retirez la connexion Piper depuis les paramètres de connecteur ou d'intégration de votre outil IA.
