Sendmux Email MCP

MCP

Connectez les outils d’IA à la documentation et aux outils produit de Sendmux.

Sendmux propose deux connexions MCP. Utilisez Doc Search MCP lorsqu’un outil d’IA doit rechercher dans la documentation Sendmux. Utilisez MCP lorsqu’un agent doit utiliser les outils Sendmux que vous l’autorisez à utiliser.

Connexion	Utilisation	Serveur
Doc Search MCP	Rechercher dans les guides et les références API de Sendmux.	https://sendmux.ai/docs/mcp
MCP	Utiliser les outils Management, Mailbox et Sending.	https://mcp.sendmux.ai/mcp ou le package local sendmux-mcp

[!NOTE]

MCP expose un ensemble sélectionné d’outils pour agents, et non tous les points de terminaison de l’API. Utilisez les SDK, la CLI ou la référence API lorsque vous avez besoin d’une couverture complète des points de terminaison.

Doc Search MCP

Doc Search MCP expose search_sendmux.

[accordion] Claude Code

claude mcp add sendmux-docs --transport http https://sendmux.ai/docs/mcp

[accordion] Cursor

Ajoutez ce serveur à .cursor/mcp.json pour un projet ou à ~/.cursor/mcp.json pour tous les projets.

{
  "mcpServers": {
    "sendmux-docs": {
      "url": "https://sendmux.ai/docs/mcp"
    }
  }
}

[accordion] VS Code

Ajoutez ce serveur à votre mcp.json utilisateur ou espace de travail.

{
  "servers": {
    "sendmux-docs": {
      "type": "http",
      "url": "https://sendmux.ai/docs/mcp"
    }
  }
}

[accordion] Codex

Ajoutez ce serveur à ~/.codex/config.toml ou à un projet approuvé .codex/config.toml.

[mcp_servers.sendmux_docs]
url = "https://sendmux.ai/docs/mcp"

MCP

MCP expose les fonctionnalités produit auxquelles vous accordez l’accès.

Fonctionnalité	Utilisation	Accès
Mailbox	Rechercher, lire, organiser et envoyer des messages depuis les boîtes aux lettres autorisées.	Autorisation hébergée avec accès Mailbox, une clé smx_mbx_ ou un jeton smx_agent_ à portée limitée en local
Management	Gérer les ressources de l’équipe, telles que les domaines, les boîtes aux lettres, les comptes d’envoi, les journaux, les métriques, la facturation et les webhooks.	Autorisation hébergée avec accès Management ou une clé smx_root_ en local
Sending	Envoyer des e-mails individuels ou par lots.	Autorisation hébergée avec accès Sending, une clé smx_mbx_ ou un jeton smx_agent_ de ressource Sending approuvé par le propriétaire en local

MCP hébergé est l’option par défaut lorsque votre client prend en charge MCP distant avec OAuth dans le navigateur. Sendmux reste ainsi dans le flux d’autorisation, évite de distribuer manuellement des clés API aux agents et n’affiche que les outils autorisés par l’octroi.

[!NOTE]

Package PyPI : sendmux-mcp

Version PyPI : 2.1.3

Package npm : sendmux-mcp

Version npm : 1.0.0

Version des métadonnées du registre : 2.1.4

Ressource hébergée : https://mcp.sendmux.ai/mcp

Transport hébergé : HTTP avec flux continu

Nombre d’outils sélectionnés : 54

Versions de protocole certifiées : 2025-11-25, 2026-07-28

Versions de protocole acceptées à l’exécution : 2024-11-05, 2025-03-26, 2025-06-18, 2025-11-25, 2026-07-28. L’acceptation à l’exécution assure la compatibilité ; elle ne certifie pas chaque version.

Paramètre	Valeur
URL du serveur	https://mcp.sendmux.ai/mcp
Serveur d’autorisation	https://app.sendmux.ai
Vérification de l’état	https://mcp.sendmux.ai/health

Utilisez la collection Postman pour tester les requêtes MCP depuis Postman :

Lors de la connexion, Sendmux vous demande de choisir une équipe, des fonctionnalités produit et, le cas échéant, l’accès aux boîtes aux lettres. Les jetons d’accès sont de courte durée. Les jetons d’actualisation sont renouvelés à chaque utilisation et peuvent rester valides jusqu’à 30 jours, sauf si la connexion est déconnectée ou expire.

[!NOTE]

Si vous accordez l’accès à plusieurs boîtes aux lettres, commencez les flux de travail de boîte aux lettres avec mailbox_list_granted_mailboxes et transmettez le mailbox_id renvoyé aux outils qui agissent sur une seule boîte aux lettres.

Modes de connexion

[card] OAuth hébergé

À utiliser lorsque votre client peut ouvrir un flux OAuth MCP dans le navigateur.

[card] stdio local

À utiliser lorsque votre agent de programmation peut lancer une commande locale sur votre machine.

[card] HTTP privé

À utiliser lorsqu’un client a besoin d’une URL, mais que vous exécutez vous-même le package MCP.

Pont npm

Nécessite Node.js 22 ou une version ultérieure. Exécutez le pont npm :

npx -y sendmux-mcp

Le pont connecte les clients stdio au serveur hébergé via OAuth dans le navigateur. Les outils suivent les autorisations de votre octroi hébergé.

{
  "mcpServers": {
    "sendmux": {
      "command": "npx",
      "args": ["-y", "sendmux-mcp"]
    }
  }
}

Package local

Installez le package local depuis PyPI :

pip install sendmux-mcp

Exécutez une seule fonctionnalité :

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 fonctionnalités 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 des clés avant de démarrer. Management nécessite smx_root_. Sending accepte une clé smx_mbx_ autorisée à envoyer ou un jeton smx_agent_ de ressource Sending approuvé par le propriétaire. Mailbox accepte une clé smx_mbx_ ou un jeton smx_agent_ à portée limitée.

HTTP privé

Le mode HTTP est utile lorsque votre client MCP se connecte à une URL de serveur, mais que vous souhaitez tout de même 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 point de terminaison est /mcp par défaut. /health renvoie les fonctionnalités 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

[accordion] Variables d’environnement

Paramètre	Environnement	Valeur par défaut
Fonctionnalités des outils	SENDMUX_MCP_SURFACES	Obligatoire pour sendmux-mcp
Clé API de secours	SENDMUX_API_KEY	Aucune
Clé API Mailbox	SENDMUX_MAILBOX_API_KEY	Aucune
Clé API Management	SENDMUX_MANAGEMENT_API_KEY	Aucune
Clé API Sending	SENDMUX_SENDING_API_KEY	Aucune
URL de base de l’API Management et Mailbox	SENDMUX_APP_BASE_URL	https://app.sendmux.ai/api/v1
URL de base de l’API Sending	SENDMUX_SENDING_BASE_URL	https://smtp.sendmux.ai/api/v1
Budget de temps pour les nouvelles tentatives, en secondes	SENDMUX_MCP_RETRY_MAX_ELAPSED_SECONDS	Non défini
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 Bearer HTTP	SENDMUX_MCP_HTTP_BEARER_TOKEN	Obligatoire pour HTTP
Origines de navigateur autorisées	SENDMUX_MCP_ALLOWED_ORIGINS	Aucune origine de navigateur

[accordion] Saisie protégée des variables d’environnement

SENDMUX_MCP_SURFACES=mailbox,management,sending \
SENDMUX_MAILBOX_API_KEY="$SENDMUX_MAILBOX_KEY" \
SENDMUX_MANAGEMENT_API_KEY="$SENDMUX_ROOT_KEY" \
SENDMUX_SENDING_API_KEY="$SENDMUX_SENDING_KEY" \
sendmux-mcp

Découverte des outils

[accordion] Fonctionnement de la découverte des outils

Les noms des outils sont générés à partir des fonctionnalités actuelles de l’API publique. Après l’autorisation, ouvrez le sélecteur d’outils de votre client MCP pour voir les outils disponibles pour cette connexion.

Les connexions hébergées n’affichent que les outils autorisés par les fonctionnalités produit, les permissions et l’accès aux boîtes aux lettres sélectionnés. Les serveurs locaux affichent les outils correspondant aux fonctionnalités et aux clés que vous fournissez au démarrage.

Dépannage

[accordion] Aucun outil n’apparaît

Vérifiez les fonctionnalités produit sélectionnées et les permissions accordées. Les connexions hébergées n’affichent que les outils autorisés par l’octroi.

[accordion] Le serveur local échoue avant de démarrer

Vérifiez le préfixe de la clé API. Management nécessite smx_root_ ; Sending accepte smx_mbx_ ou un jeton smx_agent_ de ressource Sending approuvé par le propriétaire ; Mailbox accepte smx_mbx_ ou un jeton smx_agent_ à portée limitée.

[accordion] Le serveur HTTP renvoie 401

Envoyez Authorization: Bearer <SENDMUX_MCP_HTTP_BEARER_TOKEN> au serveur HTTP privé ou terminez le flux OAuth pour MCP hébergé.

[accordion] Le serveur HTTP renvoie 403 origin_forbidden

Ajoutez l’origine du client navigateur à SENDMUX_MCP_ALLOWED_ORIGINS pour le serveur HTTP privé.

[accordion] Trop d’outils dans un même client

Connectez uniquement les fonctionnalités dont vous avez besoin ou désactivez les outils inutilisés dans le client.

Étapes suivantes

[card] A2A

Utilisez Sendmux via un point de terminaison d’agent A2A 1.0 avec OAuth hébergé.

[card] Clients MCP

Configurez Sendmux MCP dans Claude Code, Cursor, Codex, Gemini CLI, Qwen Code, Zed et d’autres clients.

[card] SDK

Utilisez des clients gérés par des packages depuis le code de votre application.

[card] CLI

Installez la CLI avec Snap, Homebrew ou npm lorsque vous avez besoin d’un accès au terminal.

[card] Clés API

Créez des identifiants à portée limitée pour les configurations MCP locales.

Cette documentation est créée et hébergée sur Mintlify, une plateforme de documentation pour développeurs.