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

# Connexions IA / MCP

> Brancher Claude ou ChatGPT sur vos données Assurevo : adresse du serveur, autorisation, outils disponibles et révocation.

Assurevo expose un serveur **MCP** (Model Context Protocol). Vous ajoutez une
adresse dans votre assistant, vous autorisez l'accès, et il interroge vos fiches
clients, contrats, commissions et pipeline depuis votre outil habituel.

Il n'y a **aucune clé à générer** ni fichier de configuration à écrire :
l'autorisation passe par OAuth 2.1, comme quand vous connectez une application à
votre compte Google.

## Avant de commencer

<Steps>
  <Step title="Un abonnement Pro">
    Le connecteur suit la même règle que l'assistant Elias. Sans offre Pro,
    l'adresse répond mais aucun outil n'est exposé.
  </Step>

  <Step title="Le connecteur activé pour le cabinet">
    Il expose des données clients à une application tierce, donc **seul le
    titulaire du cabinet** peut l'activer, dans **Paramètres → Modules**. Il doit
    accepter l'avenant « Connecteur IA » au passage.
  </Step>

  <Step title="Votre adresse de serveur">
    Dans **Paramètres → Intégrations → Connexions IA (MCP)**, le champ
    « Adresse du serveur MCP ». Elle est la même pour tous les cabinets :

    ```
    https://api.assurevo.fr/api/mcp
    ```
  </Step>
</Steps>

## Connecter votre assistant

<Tabs>
  <Tab title="Claude Code">
    Une commande dans votre terminal :

    ```bash theme={null}
    claude mcp add --transport http assurevo https://api.assurevo.fr/api/mcp
    ```

    Lancez ensuite `claude`, puis `/mcp` : Claude Code ouvre la page
    d'autorisation Assurevo dans votre navigateur. Une fois validée, la
    connexion s'affiche en `connected`.
  </Tab>

  <Tab title="Claude Desktop">
    **Réglages → Connecteurs → Ajouter un connecteur personnalisé**, collez
    l'adresse, validez.

    Claude ouvre la fenêtre d'autorisation Assurevo. Connectez-vous avec votre
    compte habituel, choisissez ce que vous autorisez, confirmez. Le connecteur
    apparaît alors dans la liste, activable conversation par conversation.
  </Tab>

  <Tab title="ChatGPT">
    **Réglages → Connecteurs → Ajouter**, choisissez un connecteur MCP, collez
    l'adresse, puis autorisez l'accès.

    Le connecteur MCP de ChatGPT demande un plan payant côté OpenAI.
  </Tab>

  <Tab title="Autre client MCP">
    Tout client qui parle **MCP en HTTP streamable** et sait suivre un flux
    OAuth 2.1 fonctionne, sans configuration particulière côté Assurevo : le
    serveur publie sa découverte et enregistre les clients dynamiquement.

    ```json theme={null}
    {
      "mcpServers": {
        "assurevo": {
          "type": "http",
          "url": "https://api.assurevo.fr/api/mcp"
        }
      }
    }
    ```

    Les points de découverte, si votre client les demande explicitement :

    ```
    https://api.assurevo.fr/.well-known/oauth-authorization-server
    https://api.assurevo.fr/.well-known/oauth-protected-resource/api/mcp
    ```
  </Tab>
</Tabs>

## Ce qui se passe à l'autorisation

Votre assistant s'enregistre tout seul auprès d'Assurevo, puis vous renvoie sur
une page de consentement à nos couleurs. Vous y voyez quelle application demande
l'accès et ce qu'elle demande, parmi deux périmètres :

| Périmètre   | Ce qu'il ouvre                                        |
| ----------- | ----------------------------------------------------- |
| `mcp:read`  | Lecture de vos données, dans votre périmètre habituel |
| `mcp:write` | Actions, uniquement si le cabinet les a autorisées    |

Le jeton d'accès vit **une heure** et se renouvelle tout seul pendant **60
jours**. Au bout de **90 jours**, le renouvellement s'arrête et vous
reconfirmez : c'est volontaire, un consentement ne doit pas être éternel.

<Note>
  Vos droits ne changent pas. Un conseiller voit son portefeuille, un manager son
  équipe, un courtier son cabinet. Le connecteur réutilise exactement le même
  filtrage que l'application, il n'ouvre rien de plus.
</Note>

## Ce que l'assistant peut faire

<AccordionGroup>
  <Accordion title="Lecture, disponible dès l'activation" icon="book-open">
    Votre identité et votre périmètre (`whoami`), la recherche transverse
    (`search`), les fiches clients et les contrats (`list_leads`,
    `get_lead_details`, `list_contracts`, `get_contract_details`), l'agenda
    (`list_appointments`), les bordereaux (`get_bordereau_summary`), le tableau
    de bord et les commissions (`get_dashboard_summary`,
    `get_commissions_summary`, `get_top_performers`), les relances à faire
    (`find_leads_to_follow_up`), le référentiel réglementaire
    (`get_regulatory_info`) et le catalogue de modèles Assurevo.
  </Accordion>

  <Accordion title="Appels et documents clients, sur option" icon="triangle-exclamation">
    Transcriptions et analyses d'entretiens, documents des fiches clients,
    pièces du coffre-fort.

    Fermé par défaut. Ces contenus peuvent comporter des **données de santé** :
    ne les ouvrez qu'avec une base légale au titre de l'article 9 du RGPD.

    Tant que cette option est fermée, le connecteur retire aussi les champs
    libres (`notes`, commentaires, verbatims) et les liens de téléchargement
    signés des réponses qu'il renvoie.
  </Accordion>

  <Accordion title="Actions, sur option" icon="bolt">
    Créer et modifier un client, changer son statut, planifier un rendez-vous,
    lire et envoyer un e-mail à un client, générer un devoir de conseil ou un
    bordereau certifié, envoyer un document en signature ou à une compagnie.

    L'assistant demande confirmation avant chaque action, et les quatre qui
    sortent d'Assurevo ou produisent un document opposable sont marquées comme
    telles pour que votre client redemande à chaque fois.

    **La gestion des membres et des rôles reste hors du connecteur**, quoi qu'il
    arrive : c'est le chemin le plus direct qu'une injection de prompt pourrait
    prendre, et c'est deux clics dans l'application.
  </Accordion>
</AccordionGroup>

## Exemples de questions

Une fois connecté, parlez normalement à votre assistant :

* « Résume-moi la situation de M. Durand avant mon rendez-vous de 15h. »
* « Quels contrats arrivent à échéance ce trimestre ? »
* « Quelles compagnies ont sous-payé mes commissions ce trimestre ? »
* « Liste les clients que je n'ai pas relancés depuis 15 jours. »
* « Prépare une note de synthèse pour mes quatre rendez-vous de demain. »

<Frame caption="Connexions IA (MCP) : adresse du serveur, assistants connectés et révocation">
  <img src="https://mintcdn.com/thomasbres/4wvF7ATCA0M1MKJq/images/docs-mcp.png?fit=max&auto=format&n=4wvF7ATCA0M1MKJq&q=85&s=a8c3cb0401c4e81b600ab9db99877066" alt="Connexions IA (MCP) : adresse du serveur, assistants connectés et révocation" width="1920" height="1077" data-path="images/docs-mcp.png" />
</Frame>

## Suivre et révoquer

**Paramètres → Intégrations → Connexions IA** liste les applications autorisées.
Révoquez d'un clic : l'accès tombe immédiatement, sans toucher aux autres
assistants.

Côté cabinet, **Paramètres → Modules** porte les trois interrupteurs, le
connecteur lui-même et les deux options, et coupe tout d'un coup au besoin.

Chaque appel est journalisé et l'historique est conservé **un an** : un accès à
des données sensibles doit rester traçable.

<Warning>
  **Ce qui sort d'Assurevo ne revient pas**

  Les données transmises quittent notre infrastructure pour l'application que
  vous autorisez, et entrent dans son historique de conversation. N'autorisez
  que des assistants dont vous connaissez la politique de conservation, et
  ouvrez les appels et documents clients seulement si vous en avez réellement
  besoin.
</Warning>
