Sendmux Email MCP Server
officielSendmux est une API de boîte de réception email et une API email pour les agents IA.
Documentation
MCP
Connectez les outils d'IA à la documentation et aux outils produits de 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 par 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, les surfaces produit et l'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 le `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 par 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 | Variable d'environnement | Valeur 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 des outils
Les noms des outils sont générés à partir des surfaces actuelles de l'API publique. 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 sélectionnées, les permissions et l'octroi de boîte mail. Les serveurs locaux affichent les outils correspondant aux surfaces et clés que vous fournissez au démarrage.