# Connecter votre assistant IA

La messagerie de Simafri Suite se branche sur votre assistant IA par **MCP** (Model Context Protocol), le protocole ouvert que Claude, ChatGPT et les principaux assistants parlent. Une fois branché, votre assistant tient votre courrier pour vous : il lit, cherche, répond, écrit, classe et programme vos envois, dans vos boîtes, sous votre nom.

|                                  |                                                         |
| -------------------------------- | ------------------------------------------------------- |
| **Serveur MCP de la messagerie** | `https://suite-mcp.simafri.com/mcp`                     |
| **Transport**                    | HTTP streamable                                         |
| **Connexion**                    | votre compte Simafri Suite (connecteur), ou une clé API |

## Ce que votre assistant fait de vos e-mails

| Geste                       | Ce que fait l'assistant                                                                                                       |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **Lire**                    | parcourt vos boîtes et leurs dossiers, les messages non lus, un fil entier avec ses pièces jointes                            |
| **Lire les pièces jointes** | le texte d'un PDF, d'un document Word, d'un tableur Excel, d'une présentation, d'un fichier zippé ; les images, qu'il regarde |
| **Chercher**                | dans une boîte, par objet, texte, correspondant ou nom de fichier joint                                                       |
| **Répondre et écrire**      | répond dans un fil, à l'expéditeur ou à tous, écrit un nouveau message, avec copies, copies invisibles et pièces jointes      |
| **Transférer**              | fait suivre un message à quelqu'un d'autre, pièces jointes comprises                                                          |
| **Programmer**              | fixe l'heure de départ d'un message, liste les envois programmés et en rappelle un                                            |
| **Classer**                 | range un fil dans l'archive, la corbeille ou la réception, le marque comme lu ou non lu                                       |
| **Trier les indésirables**  | signale un spam et bloque son expéditeur, se désabonne d'une lettre d'information                                             |
| **Brouillons**              | enregistre un message à finir, le reprend, le supprime                                                                        |
| **Signature et contacts**   | règle la signature d'une adresse, consulte et tient le carnet de contacts                                                     |
| **Relever**                 | va chercher le courrier tout de suite                                                                                         |

Ce que votre assistant envoie part de vos adresses, avec la signature DKIM de votre domaine, et se range dans **Envoyés**, exactement comme un message écrit sur [suite.simafri.com](https://suite.simafri.com/).

### Ce que vous pouvez lui demander

* « Résume les messages non lus de `contact@` depuis lundi, et dis-moi lesquels attendent une réponse. »
* « Réponds à Camille que le devis part demain, joins le PDF reçu hier, et programme l'envoi à 8 h. »
* « Range dans l'archive toutes les notifications de livraison de ce mois-ci. »
* « Retrouve le contrat que Julien m'a envoyé au printemps et donne-moi sa date d'échéance. »
* « Désabonne-moi de cette lettre d'information et signale les deux derniers spams. »

## Se connecter par connecteur

C'est la voie la plus simple : rien à copier, rien à coller. Elle sert les assistants qui ajoutent un serveur MCP par son adresse, comme les connecteurs de Claude et de ChatGPT.

1. Dans votre assistant, ajoutez un **connecteur personnalisé** et donnez-lui l'adresse `https://suite-mcp.simafri.com/mcp`.
2. L'assistant ouvre [suite.simafri.com](https://suite.simafri.com/) : connectez-vous comme d'habitude, avec l'adresse de votre boîte ou votre identité Simafri.
3. La page d'autorisation affiche l'application qui demande l'accès : confirmez l'autorisation.
4. Les outils de votre messagerie apparaissent dans votre assistant. Demandez-lui, par exemple, de lister vos derniers messages.

Chaque personne de l'équipe branche son propre assistant, quel que soit son rôle sur le compte, et cette connexion agit pour elle.

## Se connecter par clé

Pour un assistant où vous posez vous-même les en-têtes (Claude Code, Claude Desktop, un client MCP de votre entreprise), la connexion se fait par **clé API**.

1. Le titulaire du compte ouvre [suite.simafri.com](https://suite.simafri.com/), **Réglages**, **Clés d'API**, et crée une clé.
2. **Copiez la clé tout de suite** : elle s'affiche une seule fois.
3. Ajoutez le serveur à votre assistant, la clé dans l'en-tête `Authorization`. Avec Claude Code :

```
claude mcp add --transport http --scope user simafri-suite https://suite-mcp.simafri.com/mcp --header "Authorization: Bearer VOTRE_CLE"
```

Une clé agit pour le compte entier : elle sert l'automatisation de l'entreprise, comme un programme qui trie le courrier de toutes les boîtes. Pour l'assistant d'une personne, le connecteur est la voie toute tracée.

## Ce que votre assistant atteint

Un assistant branché par connecteur travaille **avec vos droits** : il voit ce que votre écran vous montre.

* **Vos boîtes** : celles que vous relevez, la vôtre et les boîtes partagées qui vous sont confiées, comme `contact@`. Chaque boîte se lit par les personnes qui la relèvent, et par leur assistant avec elles.
* **Vos envois** : ils partent d'une adresse que vous relevez.
* **Les réglages du compte** (qui relève quelle boîte, les invitations, le carnet commun) suivent votre rôle, comme à l'écran.
* **Votre lu et non lu** reste le vôtre : sur une boîte partagée, ce que votre assistant marque comme lu le reste pour vous seul.

## Voir et couper une connexion

L'écran **Applications connectées** liste vos connexions : ouvrez-le depuis le menu de votre compte, en haut à droite de [suite.simafri.com](https://suite.simafri.com/). Chaque ligne indique l'application, la date de l'autorisation et la dernière fois qu'elle a servi.

Déconnecter une application coupe sa connexion immédiatement et entièrement : l'assistant perd l'accès à la seconde.

* Chaque personne voit et coupe **les connexions qu'elle a autorisées**.
* Le **titulaire du compte** voit et coupe **toutes les connexions du compte**, avec le nom de la personne qui a autorisé chacune. Au départ d'un collaborateur, un seul geste ferme l'accès de son assistant.
* Une clé API se retire depuis **Réglages**, **Clés d'API**.

## Le serveur MCP du compte : adresses, domaines, stockage

Un second serveur MCP porte le **compte** Simafri lui-même, ce que vous faites sur [my.simafri.com](https://my.simafri.com/). Il se branche de la même façon, par connecteur, avec votre identité Simafri :

|                           |                                  |
| ------------------------- | -------------------------------- |
| **Serveur MCP du compte** | `https://mcp.simafri.com/v1/mcp` |

Le titulaire du compte y confie à son assistant la tenue de Simafri Suite :

* **les adresses** : relire la réserve et les adresses, créer une adresse avec son mot de passe, donner un nouveau mot de passe, fermer une adresse. La fiche de connexion s'affiche une fois, pour que le titulaire la remette à la personne ;
* **les domaines** : les lignes DNS de l'acheminement du courrier, leur vérification, et le passage de DMARC à une politique plus stricte ;
* **le stockage** : l'estimation d'un ajout, puis la proforma, que le titulaire règle comme d'habitude.

Le même serveur porte aussi vos [sites Serenity](https://docs.simafri.com/fr/serenity/) et vos VPS. Branchez les deux serveurs sur le même assistant : il tient alors votre compte et votre courrier.

## Un coup de main

Écrivez à <support@simafri.com> en indiquant l'assistant que vous utilisez : nous vous accompagnons dans le branchement.
