Sendmux Email MCP
officielSendmux est une API de boîte de réception email et une API email pour les agents IA.
Que pouvez-vous faire avec Sendmux Email MCP ?
- Rechercher la documentation Sendmux — demandez à votre IA de trouver des guides ou des références API en utilisant
search_sendmux. - Gérer les boîtes aux lettres — rechercher, lire, organiser et envoyer des e-mails depuis les boîtes aux lettres autorisées via l'interface Mailbox.
- Gérer les ressources de l'équipe — gérer les domaines, les boîtes aux lettres, les comptes d'envoi, les journaux, les métriques, la facturation et les webhooks via l'interface Management.
- Envoyer des e-mails — envoyer des e-mails individuels ou en lot via l'interface Sending.
- Lister les boîtes aux lettres disponibles — utilisez
mailbox_list_granted_mailboxespour découvrir quelles boîtes aux lettres sont accessibles avant d'agir sur l'une d'elles.
Documentation
MCP
Connectez les outils d'IA à la documentation et aux outils produits Sendmux.
Sendmux propose deux connexions MCP. Utilisez Doc Search MCP lorsque vous souhaitez qu'un outil d'IA recherche dans la documentation Sendmux. Utilisez MCP lorsque vous souhaitez qu'un agent travaille avec les outils Sendmux que vous autorisez.
| Connexion | Utilisation | Serveur |
|---|---|---|
| Doc Search MCP | Rechercher dans les guides et références API Sendmux. | https://sendmux.ai/docs/mcp |
| MCP | Utiliser les outils de gestion, boîte mail et envoi. | https://mcp.sendmux.ai/mcp ou le package local sendmux-mcp |
Doc Search MCP
Doc Search MCP expose search_sendmux.
```json theme={null}
{
"mcpServers": {
"sendmux-docs": {
"url": "https://sendmux.ai/docs/mcp"
}
}
}
```
```json theme={null}
{
"servers": {
"sendmux-docs": {
"type": "http",
"url": "https://sendmux.ai/docs/mcp"
}
}
}
```
```toml theme={null}
[mcp_servers.sendmux_docs]
url = "https://sendmux.ai/docs/mcp"
```
MCP
MCP expose les surfaces produit que vous accordez.
| Surface | Utilisation | Accès |
|---|---|---|
| Boîte mail | Rechercher, lire, organiser et envoyer depuis les boîtes mail autorisées. | Autorisation hébergée avec accès Boîte mail, une clé smx_mbx_, ou un jeton smx_agent_ limité localement |
| Gestion | Gérer les ressources d'équipe telles que domaines, boîtes mail, comptes d'envoi, logs, métriques, facturation et webhooks. | Autorisation hébergée avec accès Gestion, ou une clé smx_root_ localement |
| Envoi | Envoyer des emails uniques ou par lots. | Autorisation hébergée avec accès Envoi, une clé smx_mbx_, ou un jeton smx_agent_ de ressource d'envoi approuvé par le propriétaire localement |
Le MCP hébergé est le mode par défaut lorsque votre client prend en charge le MCP distant avec OAuth navigateur. Il maintient Sendmux dans le flux d'autorisation, évite de distribuer des clés API manuelles aux agents et n'affiche que les outils autorisés par l'octroi.
| Paramètre | Valeur |
|---|---|
| URL du serveur | https://mcp.sendmux.ai/mcp |
| Serveur d'autorisation | https://app.sendmux.ai |
| Vérification de santé | https://mcp.sendmux.ai/health |
Utilisez la collection Postman lorsque vous souhaitez tester les requêtes MCP depuis Postman :
Lors de la connexion, Sendmux vous demande de choisir une équipe, des surfaces produit et un accès aux boîtes mail le cas échéant. Les jetons d'accès sont de courte durée. Les jetons de rafraîchissement tournent à chaque utilisation et peuvent durer jusqu'à 30 jours, sauf si la connexion est déconnectée ou expire.
Si vous accordez plus d'une boîte mail, démarrez les flux de travail de boîte mail avec `mailbox_list_granted_mailboxes` et passez l'`mailbox_id` retourné aux outils qui agissent sur une seule boîte mail.Modes de connexion
À utiliser lorsque votre client peut ouvrir un flux OAuth MCP basé navigateur. À utiliser lorsque votre agent de codage peut lancer une commande locale sur votre machine. À utiliser lorsqu'un client a besoin d'une URL mais que vous exécutez vous-même le package MCP.Package local
Installez le package local depuis PyPI :
pip install sendmux-mcp
Exécutez une surface :
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-mailbox
SENDMUX_API_KEY=smx_root_... sendmux-mcp-management
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-sending
Exécutez toutes les surfaces produit :
SENDMUX_MCP_SURFACES=mailbox,management,sending \
SENDMUX_MAILBOX_API_KEY=smx_mbx_... \
SENDMUX_MANAGEMENT_API_KEY=smx_root_... \
SENDMUX_SENDING_API_KEY=smx_mbx_... \
sendmux-mcp
Le serveur valide les préfixes de clé avant de démarrer. La gestion nécessite smx_root_. L'envoi accepte une clé smx_mbx_ capable d'envoyer ou un jeton smx_agent_ de ressource d'envoi approuvé par le propriétaire. La boîte mail accepte une clé smx_mbx_ ou un jeton smx_agent_ limité.
HTTP privé
Le mode HTTP est utile lorsque votre client MCP se connecte à une URL de serveur mais que vous souhaitez toujours exécuter le package vous-même.
SENDMUX_API_KEY=smx_mbx_... \
SENDMUX_MCP_HTTP_BEARER_TOKEN=local-mcp-token \
sendmux-mcp-mailbox --transport http --host 127.0.0.1 --port 8765
Le endpoint par défaut est /mcp. /health retourne les surfaces sélectionnées. Le mode HTTP nécessite SENDMUX_MCP_HTTP_BEARER_TOKEN sauf si vous le démarrez explicitement avec --allow-unauthenticated-http.
Référence de configuration
| Paramètre | Environnement | Par défaut | | ----------------------------------- | ------------------------------- | ------------------------------- | | Surfaces d'outils | `SENDMUX_MCP_SURFACES` | Requis pour `sendmux-mcp` | | Clé API de secours | `SENDMUX_API_KEY` | Aucune | | Clé API boîte mail | `SENDMUX_MAILBOX_API_KEY` | Aucune | | Clé API gestion | `SENDMUX_MANAGEMENT_API_KEY` | Aucune | | Clé API envoi | `SENDMUX_SENDING_API_KEY` | Aucune | | URL de base API gestion et boîte mail | `SENDMUX_APP_BASE_URL` | `https://app.sendmux.ai/api/v1` | | URL de base API envoi | `SENDMUX_SENDING_BASE_URL` | `https://smtp.sendmux.ai/api/v1` | | Transport | `SENDMUX_MCP_TRANSPORT` | `stdio` | | Hôte HTTP | `SENDMUX_MCP_HOST` | `127.0.0.1` | | Port HTTP | `SENDMUX_MCP_PORT` | `8765` | | Chemin HTTP | `SENDMUX_MCP_PATH` | `/mcp` | | Jeton porteur HTTP | `SENDMUX_MCP_HTTP_BEARER_TOKEN` | Requis pour HTTP | | Origines navigateur autorisées | `SENDMUX_MCP_ALLOWED_ORIGINS` | Aucune origine navigateur | ```bash theme={null} sendmux-mcp \ --surfaces mailbox,management,sending \ --mailbox-api-key smx_mbx_... \ --management-api-key smx_root_... \ --sending-api-key smx_mbx_... ```Découverte d'outils
Les noms d'outils sont générés à partir des surfaces d'API publiques actuelles. Ouvrez le sélecteur d'outils de votre client MCP après autorisation pour voir les outils disponibles pour cette connexion.Les connexions hébergées n'affichent que les outils autorisés par les surfaces produit, permissions et octroi de boîte mail sélectionnés. Les serveurs locaux affichent les outils pour les surfaces et clés que vous fournissez au démarrage.