Apps IA (MCP)
Authentification
Connectez-vous avec OAuth et choisissez les permissions, ou utilisez une API key. Dans les deux cas, l'app n'obtient que ce que vous autorisez, et vous pouvez le retirer à tout moment.
- OAuth 2.1 + PKCE
- Accès d'1 heure, renouvelé par l'app
- Révocation dans Connected apps
Lequel utiliser
OAuth
RecommandéPour Claude (claude.ai et bureau) et tout client compatible. Vous vous connectez, choisissez les permissions et cliquez sur Authorize. Aucune key à copier ni à stocker.
API key
DéveloppeursPour Claude Code, Cursor, VS Code et les scripts. Envoyez la key en Authorization: Bearer. Les scopes de la key déterminent les tools affichés.
OAuth
Votre app fait tout cela toute seule. Vous ne voyez que la fenêtre Sendcorex.
- 1
L'app appelle le serveur sans token et reçoit une 401 avec un lien vers les métadonnées d'autorisation de Sendcorex.
- 2
L'app s'enregistre (dynamic client registration) et ouvre une fenêtre Sendcorex.
- 3
Vous vous connectez au dashboard si besoin, choisissez les permissions (ou la boîte mail) et cliquez sur Authorize.
- 4
L'app obtient un access token (1 heure) et un refresh token (30 jours, renouvelé à chaque utilisation) et commence à appeler les tools.
Les membres d'une organisation ne peuvent accorder que les permissions qu'ils ont eux-mêmes.
Permissions
Sur l'écran Authorize, chaque domaine est en No access, Read ou Full. Les mêmes scopes fonctionnent avec les API keys. La gestion du compte, de la facturation, de l'équipe et des API keys n'est jamais accessible aux apps IA.
| Domaine | Lecture | Full ajoute |
|---|---|---|
| Domaines | domain:read | domain:create, domain:delete |
| Expéditeurs | sender:read | sender:create, sender:update, sender:delete |
| Templates | template:read | template:create, template:update, template:delete |
| Contacts | contact:read | contact:create, contact:update, contact:delete |
| Logs | logs:read | — |
| Bounces et plaintes | feedback:read | — |
| Compteurs | counters:read | — |
| Préférences de suivi | privacy:read | privacy:write |
| Validation d'e-mails | — | tools:validate |
| Envoi d'e-mails | — | email:send |
API key
Créez une key dans le dashboard avec uniquement les scopes nécessaires à l'app, et envoyez-la à chaque requête.
POST https://g.sendcorex.com/mcp/account
Authorization: Bearer SENDCOREX_API_KEY
Content-Type: application/json- La liste des tools suit la key. Une key avec uniquement
logs:readne voit que les tools de logs. - Les IP autorisées restent appliquées. Les apps cloud appellent depuis leurs propres serveurs : une key limitée à vos IP y sera donc refusée. Utilisez OAuth pour celles-ci.
Accès à la boîte mail
Le serveur de boîte mail fonctionne sur une boîte à la fois. Avec OAuth, vous choisissez la boîte sur l'écran Authorize (la recherche aide quand vous en avez beaucoup). Depuis le code, le token de boîte mail de l'API Receive Emails fonctionne aussi. Les API keys générales n'ouvrent jamais une boîte mail.
Accès en lecture seule
Quand vous connectez une boîte, vous choisissez Accès complet ou Lecture seule. Lecture seule est le choix par défaut pour les applications et le plus sûr pour les assistants IA qui n’ont besoin que de lire vos e-mails.
Un token créé en Lecture seule, ou une application autorisée en Lecture seule, ne peut que lire la boîte.
Toute commande d’écriture renvoie READ_ONLY_ACCESS (HTTP 403 à l’envoi de pièce jointe).
Dans le MCP, les tools d’écriture n’apparaissent pas : l’application ne voit que les tools qu’elle peut utiliser.
Commandes autorisées
whoamilist_foldersget_counterslist_threadsget_threadlist_messagesget_messagessearchget_attachmentget_raw_sourcelist_draftsget_draftget_trackinglist_activityactivity_countslist_contactscount_contactsget_mailbox_contactlist_segmentsget_audiencecheck_recipientsget_delivery_statusget_contact_eventsget_trustlist_trustlist_junkblocked_junk_countlist_top_sendersget_filter_modelist_signaturesget_conversationlist_assigneeslist_conversationslist_conversation_noteslist_rulesget_rulerule_optionstest_rulelist_templatesget_templatelist_labelsget_contactlist_followupsget_unsubscribe_optionslist_unsubscribedRévoquer l'accès
Connected apps, dans le dashboard, liste toutes les apps que vous avez autorisées, ce à quoi elles ont accès et leur dernière utilisation. Révoquez, et l'app perd l'accès en moins d'une minute. Pour l'utiliser à nouveau, connectez-la et autorisez-la une nouvelle fois.
Ouvrir Connected apps