Smarties peut être relié à un assistant IA (Claude ou ChatGPT) grâce à MCP, un standard ouvert qui permet à l'assistant d'utiliser Smarties pour vous. Une fois connecté, vous pouvez demander en langage courant « quels courriels urgents ai-je reçus cette semaine ? » ou « classe ce courriel sous le client Ferro », et l'assistant le fait avec votre propre compte Smarties.
- Adresse du serveur :
https://apigmail.apigoat.com/api/v1/mcp - Connexion : votre nom d'utilisateur et votre mot de passe Smarties habituels. Aucune clé ni jeton à copier.
Ce que l'assistant peut voir et faire
L'assistant a exactement vos droits, pas plus :
- Vos boîtes aux lettres seulement. Il voit le courrier des boîtes que vous avez ajoutées vous-même, jamais la boîte d'un collègue ni celle d'une autre entreprise.
- Ni pièces jointes, ni mots de passe. Les pièces jointes ne sont jamais transmises à l'assistant, pas plus que les mots de passe ou clés des boîtes aux lettres.
- Le texte des courriels n'est disponible que si votre entreprise conserve le contenu des messages (sinon l'assistant voit l'expéditeur, l'objet, un court extrait et le classement de l'IA).
- Aucun paramètre d'entreprise. L'assistant ne peut ni lire ni modifier les paramètres de votre entreprise, les autres utilisateurs ou la configuration des boîtes aux lettres.
- Toute modification demande votre accord. Les deux actions qui changent quelque chose (reclasser un courriel, relancer l'IA) vous montrent d'abord ce qu'elles vont faire ; elles n'ont lieu qu'après votre confirmation.
- Vous pouvez vous déconnecter à tout moment (voir Se déconnecter plus bas).
Les actions
Votre courrier
| Action | Ce qu'elle fait | Exemple de demande |
|---|---|---|
gmx_inbox |
Liste vos courriels récents, du plus récent au plus ancien, avec le dossier choisi par l'IA. Filtres : boîte, client, mandat, dossier, date. | « Montre mes 20 derniers courriels dans À traiter. » |
gmx_find |
Cherche dans votre courrier en langage courant (par le sens, pas seulement par mot-clé). | « Trouve le courriel où le client demandait une soumission pour des chaises. » |
gmx_email |
Ouvre un courriel : en-têtes, classement de l'IA, tâches repérées et texte. | « Ouvre ce courriel et résume-le. » |
gmx_correct_triage |
Corrige le dossier, la catégorie ou la priorité d'un courriel. L'IA apprend de vos corrections. Demande confirmation. | « Cette infolettre n'est pas urgente, mets-la dans Référence. » |
gmx_retriage |
Demande à l'IA de reclasser des courriels. Utilise votre forfait IA. Demande confirmation. | « Relance l'IA sur les courriels non lus d'aujourd'hui. » |
État
| Action | Ce qu'elle fait | Exemple de demande |
|---|---|---|
gmx_mailbox_status |
Vos boîtes aux lettres : connectées ou en erreur, dernière vérification, nombre de messages. | « Ma boîte Outlook se synchronise-t-elle encore ? » |
gmx_triage_queue |
Combien de courriels attendent encore l'IA. | « Combien de courriels attendent d'être triés ? » |
gmx_triage_stats |
La justesse du tri de l'IA (d'après vos corrections). | « Combien de fois ai-je corrigé l'IA ce mois-ci ? » |
gmx_inference_status |
Si le service d'IA fonctionne normalement en ce moment. | « L'IA fonctionne-t-elle ? » |
Tâches de connecteur
Le travail récurrent que Smarties prépare pour vos clients (par exemple les reçus manquants). Vous voyez les exécutions des tâches qui vous appartiennent : vous êtes l'un des approbateurs de la tâche, une étape de l'une de ses exécutions vous est assignée, ou vous avez lancé l'une de ses exécutions. L'application Smarties vous montre les mêmes tâches.
| Action | Ce qu'elle fait | Exemple de demande |
|---|---|---|
gmx_task_queue |
Les exécutions en attente : à approuver, à confirmer, preuve requise, en cours. | « Quelles tâches attendent une approbation ? » |
gmx_task_run |
Une exécution en détail : ce qui a été trouvé, les éléments, les vérifications et ce que vous pouvez faire. | « Montre-moi l'exécution des reçus manquants de Safran. » |
gmx_task_list |
Les tâches configurées pour vos clients et leur prochaine échéance. | « Quand est la prochaine vérification des reçus de Lauv ? » |
Les approbateurs et les gestionnaires peuvent aussi agir sur une exécution, toujours après confirmation : accepter
ou refuser une valeur suggérée par l'IA (gmx_task_confirm_value), inclure ou exclure des éléments
(gmx_task_toggle_items), rejeter (gmx_task_reject), relancer une exécution bloquée (gmx_task_retry) et lancer
une tâche maintenant (gmx_task_start). L'approbation et l'annulation d'une exécution se font uniquement dans
l'application Smarties, jamais par un assistant.
Gestionnaires et administrateurs
Les utilisateurs ayant le rôle Gestionnaire (Manager) ou Admin ont aussi les actions sur les fiches
(crm_describe, crm_list, crm_get, crm_create, crm_update, crm_delete) pour les fiches de l'entreprise,
comme les clients et les mandats, et peuvent lier un courriel à un client ou à un mandat avec gmx_correct_triage.
La création et la suppression de fiches demandent toujours confirmation.
Connecter Claude
Fonctionne avec les forfaits Claude Pro, Max, Team et Enterprise (en Team/Enterprise, un propriétaire doit parfois d'abord autoriser les connecteurs personnalisés).
claude.ai ou l'application Claude pour ordinateur
- Ouvrez Paramètres › Connecteurs (Settings › Connectors).
- Cliquez sur Ajouter un connecteur personnalisé (Add custom connector).
- Nom :
Smarties. URL :https://apigmail.apigoat.com/api/v1/mcp. Laissez vides les paramètres avancés (identifiant / secret client). - Cliquez sur Ajouter, puis sur Connecter.
- Une page Smarties s'ouvre : connectez-vous avec votre nom d'utilisateur et votre mot de passe Smarties, puis autorisez l'accès.
- Dans une conversation, vérifiez que Smarties est activé dans le menu des outils (bouton + / outils) et posez votre question.
Un connecteur ajouté sur claude.ai apparaît aussi dans l'application pour ordinateur (même compte).
Claude Code (terminal)
claude mcp add --transport http smarties https://apigmail.apigoat.com/api/v1/mcp
Tapez ensuite /mcp, choisissez smarties › Authenticate, puis connectez-vous dans la fenêtre du navigateur qui s'ouvre.
Connecter ChatGPT
Les connecteurs personnalisés demandent un forfait ChatGPT payant avec le mode développeur (les noms des menus peuvent changer selon la version de ChatGPT).
- Ouvrez Paramètres › Applications et connecteurs › Paramètres avancés (Settings › Apps & Connectors › Advanced settings) et activez le Mode développeur (Developer mode).
- De retour dans Applications et connecteurs, cliquez sur Créer (Create).
- Nom :
Smarties. URL du serveur MCP :https://apigmail.apigoat.com/api/v1/mcp. Authentification : OAuth. - Acceptez l'avertissement sur les connecteurs personnalisés et cliquez sur Créer.
- Connectez-vous avec votre nom d'utilisateur et votre mot de passe Smarties et autorisez l'accès.
- Dans une discussion, choisissez Mode développeur dans le menu +, activez Smarties et posez votre question.
Le mode Recherche approfondie (Deep research) de ChatGPT n'est pas pris en charge (il exige des outils de recherche que Smarties n'offre pas) ; les discussions normales fonctionnent.
Niveaux d'accès
En autorisant l'accès, vous accordez :
- Lecture (
crm:read) : consulter votre courrier et vos fiches. - Écriture (
crm:write) : corriger le tri de l'IA et le relancer (gestionnaires : aussi modifier des fiches). Toujours avec votre confirmation. - Rester connecté (
offline_access) : l'assistant garde la connexion sans vous redemander de vous connecter à chaque fois.
Se déconnecter
- Claude : Paramètres › Connecteurs › Smarties › Déconnecter (ou supprimer).
- ChatGPT : Paramètres › Applications et connecteurs › Smarties › Déconnecter (ou supprimer).
- Claude Code :
claude mcp remove smarties.
Dépannage
| Problème | Que faire |
|---|---|
| « Connexion impossible » / « autorisation échouée » | Vérifiez que l'adresse est exactement https://apigmail.apigoat.com/api/v1/mcp (avec https), puis réessayez. |
| La page de connexion refuse votre mot de passe | Utilisez le même nom d'utilisateur et le même mot de passe que dans l'application Smarties. |
| L'assistant répond sans utiliser Smarties | Activez Smarties dans le menu des outils de la conversation, ou dites « utilise Smarties ». |
| « Non autorisé » (Not permitted) | Votre rôle Smarties ne permet pas cette action ; adressez-vous à l'administrateur de votre entreprise. |
| Un courriel s'affiche sans texte | Votre entreprise ne conserve pas le contenu des messages, ou le texte n'a pas encore été récupéré. |
Mis à jour le 21 octobre 2026