Connectez votre assistant IA à Unbox

Aperçu

Unbox MCP est destiné aux propriétaires de comptes personnels qui souhaitent un assistant IA — dans Cursor, Workbuddy, OpenClaw ou tout hôte compatible MCP — pour travailler avec leur courrier hébergé. Il ne s'agit pas d'une API développeur pour créer des applications sur Unbox ; pour l'envoi transactionnel depuis votre domaine, consultez notre documentation API HTTP.

Ce que les agents peuvent faire

Après votre connexion, votre agent peut appeler les outils Unbox en votre nom :

• Lire la boîte de réception et les fils de discussion — Lister les conversations, ouvrir un fil et récupérer des messages individuels.
• Rechercher du courrier — Trouver des messages dans votre boîte de réception avec des requêtes en langage naturel.
• Envoyer et répondre — Rédiger un nouveau courrier ou répondre à un fil depuis vos adresses Unbox, sous réserve des limites d'envoi de votre forfait.
• Organiser — Marquer comme spam, restaurer depuis le spam, déplacer vers la corbeille ou restaurer — un message à la fois.

Vider en masse le spam ou la corbeille, la génération de clés API et les actions d'espace de travail d'équipe ne sont pas disponibles via MCP dans la v1.

Comment ça fonctionne

Votre client IA se connecte au serveur Unbox MCP. Le serveur appelle les API du compte Unbox en utilisant une session web normale — du même type que celle que vous obtenez lorsque vous vous connectez sur unbox.im.

1. Ajoutez Unbox à la configuration de votre client MCP (voir la configuration ci-dessous).
2. Demandez à votre agent de se connecter — il ouvre un lien dans le navigateur où vous approuvez l'accès avec votre compte Unbox.
3. Une fois connecté, demandez à votre agent de lire le courrier, rédiger des réponses ou organiser les messages.

Se connecter

Unbox utilise la connexion via navigateur pour que vous approuviez toujours l'accès. Votre agent démarre le flux avec les outils de connexion, puis vous finalisez la connexion dans le navigateur :

1. Votre agent appelle unbox_login_start et vous affiche une URL de navigateur.
2. Ouvrez le lien, connectez-vous à Unbox si nécessaire, et copiez le code de lien unique affiché sur la page.
3. Collez le code à votre agent (unbox_login_complete).
4. Votre session reste active pendant la période normale de session web Unbox — reconnectez-vous lorsqu'elle expire.

URL de connexion (pour référence)

https://unbox.im/fr/auth/desktop/link?source=mcp

Vous n'avez pas encore de compte ? Créez votre identifiant Unbox, puis revenez connecter votre assistant.

Configuration

Ajoutez Unbox comme serveur MCP dans votre client IA. Le transport HTTP distant est le moyen le plus simple de se connecter au cloud Unbox :

HTTP distant (recommandé)

Configurez votre client MCP sur le point de terminaison MCP d'Unbox. Après avoir ajouté le serveur, utilisez les outils de connexion pour vous authentifier :

{
  "mcpServers": {
    "unbox": {
      "url": "https://unbox.im/api/mcp"
    }
  }
}

Le MCP HTTP peut être désactivé sur certains déploiements jusqu'à ce qu'il soit activé par l'opérateur. Si la connexion échoue, réessayez plus tard ou contactez le support.

Outils courants

Une fois connecté, votre assistant peut utiliser des outils tels que :

• unbox_login_start — ouvrir la connexion dans le navigateur
• unbox_login_complete — échanger le code de lien contre une session
• unbox_list_threads — flux de la boîte de réception
• unbox_search_inbox — rechercher des messages
• unbox_reply_to_email — répondre à un message
• unbox_send_email — envoyer un nouveau courriel

Clients pris en charge

Tout hôte d'assistant compatible MCP peut se connecter à Unbox. Nous testons et documentons :

• Cursor — Ajoutez Unbox sous les serveurs MCP dans les paramètres de Cursor, puis connectez-vous via le flux du navigateur.
• Workbuddy — Configurez une URL de serveur MCP distant pointant vers Unbox, puis authentifiez-vous avec votre compte.
• OpenClaw — Connectez OpenClaw au point de terminaison MCP HTTP d'Unbox et terminez la connexion via le navigateur.

Sécurité

• Connexion via le navigateur — Vous vous connectez via Unbox dans votre navigateur — les assistants ne voient jamais votre mot de passe.
• Propriétaire du compte uniquement — L'accès MCP est limité au propriétaire du compte personnel, pas aux membres de l'équipe ni aux espaces de travail partagés.
• Mêmes limites que l'application web — Les quotas d'envoi, les règles anti-spam et la politique transactionnelle s'appliquent aux actions de l'assistant de la même manière que dans l'interface de la boîte de réception.
• Pas de suppression en masse — Les agents ne peuvent pas vider les spams, vider la corbeille ni faire pivoter les clés API via MCP dans la v1.