Sendmux Email MCP Server
oficialSendmux es una API de bandeja de entrada de correo electrónico y API de correo electrónico para agentes de IA.
Documentación
MCP
Conecta herramientas de IA a la documentación y herramientas de producto de Sendmux.
Sendmux tiene dos conexiones MCP. Usa Doc Search MCP cuando quieras que una herramienta de IA busque en la documentación de Sendmux. Usa MCP cuando quieras que un agente trabaje con las herramientas de Sendmux que autorices.
| Conexión | Usarla para | Servidor |
|---|---|---|
| Doc Search MCP | Buscar guías de Sendmux y referencias de API. | https://sendmux.ai/docs/mcp |
| MCP | Usar herramientas de Gestión, Buzón y Envío. | https://mcp.sendmux.ai/mcp o el paquete local sendmux-mcp |
Doc Search MCP
Doc Search MCP expone 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 expone las superficies de producto que concedas.
| Superficie | Usarla para | Acceso |
|---|---|---|
| Buzón | Buscar, leer, organizar y enviar desde los buzones concedidos. | Concesión alojada con acceso a Buzón, una clave smx_mbx_ o un token smx_agent_ con alcance local |
| Gestión | Gestionar recursos del equipo como dominios, buzones, cuentas de envío, registros, métricas, facturación y webhooks. | Concesión alojada con acceso a Gestión, o una clave smx_root_ local |
| Envío | Enviar correos individuales o por lotes. | Concesión alojada con acceso a Envío, una clave smx_mbx_ o un token smx_agent_ de recurso de Envío aprobado por el propietario local |
MCP alojado es la opción predeterminada cuando tu cliente admite MCP remoto con OAuth de navegador. Mantiene a Sendmux en el flujo de autorización, evita distribuir claves API manuales a los agentes y muestra solo las herramientas permitidas por la concesión.
| Configuración | Valor |
|---|---|
| URL del servidor | https://mcp.sendmux.ai/mcp |
| Servidor de autorización | https://app.sendmux.ai |
| Verificación de estado | https://mcp.sendmux.ai/health |
Usa la colección de Postman cuando quieras probar solicitudes MCP desde Postman:
Cuando te conectes, Sendmux te pedirá que elijas un equipo, superficies de producto y acceso al buzón cuando corresponda. Los tokens de acceso son de corta duración. Los tokens de actualización rotan con cada uso y pueden durar hasta 30 días a menos que la conexión se desconecte o expire.
Si concedes más de un buzón, inicia los flujos de trabajo del buzón con `mailbox_list_granted_mailboxes` y pasa el `mailbox_id` devuelto a las herramientas que actúan sobre un solo buzón.Modos de conexión
Úsalo cuando tu cliente pueda abrir un flujo OAuth MCP basado en navegador. Úsalo cuando tu agente de codificación pueda ejecutar un comando local en tu máquina. Úsalo cuando un cliente necesite una URL pero tú mismo ejecutes el paquete MCP.Paquete local
Instala el paquete local desde PyPI:
pip install sendmux-mcp
Ejecuta una superficie:
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-mailbox
SENDMUX_API_KEY=smx_root_... sendmux-mcp-management
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-sending
Ejecuta todas las superficies de producto:
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
El servidor valida los prefijos de clave antes de iniciar. Gestión requiere smx_root_. Envío acepta una clave smx_mbx_ con capacidad de envío o un token smx_agent_ de recurso de Envío aprobado por el propietario. Buzón acepta una clave smx_mbx_ o un token smx_agent_ con alcance.
HTTP privado
El modo HTTP es útil cuando tu cliente MCP se conecta a una URL de servidor pero aún quieres ejecutar el paquete tú mismo.
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
El endpoint predeterminado es /mcp. /health devuelve las superficies seleccionadas. El modo HTTP requiere SENDMUX_MCP_HTTP_BEARER_TOKEN a menos que lo inicies explícitamente con --allow-unauthenticated-http.
Referencia de configuración
| Configuración | Entorno | Predeterminado | | ----------------------------------- | ------------------------------ | -------------------------------- | | Superficies de herramientas | `SENDMUX_MCP_SURFACES` | Requerido para `sendmux-mcp` | | Clave API de respaldo | `SENDMUX_API_KEY` | Ninguna | | Clave API de Buzón | `SENDMUX_MAILBOX_API_KEY` | Ninguna | | Clave API de Gestión | `SENDMUX_MANAGEMENT_API_KEY` | Ninguna | | Clave API de Envío | `SENDMUX_SENDING_API_KEY` | Ninguna | | URL base de API de Gestión y Buzón | `SENDMUX_APP_BASE_URL` | `https://app.sendmux.ai/api/v1` | | URL base de API de Envío | `SENDMUX_SENDING_BASE_URL` | `https://smtp.sendmux.ai/api/v1` | | Transporte | `SENDMUX_MCP_TRANSPORT` | `stdio` | | Host HTTP | `SENDMUX_MCP_HOST` | `127.0.0.1` | | Puerto HTTP | `SENDMUX_MCP_PORT` | `8765` | | Ruta HTTP | `SENDMUX_MCP_PATH` | `/mcp` | | Token de portador HTTP | `SENDMUX_MCP_HTTP_BEARER_TOKEN` | Requerido para HTTP | | Orígenes de navegador permitidos | `SENDMUX_MCP_ALLOWED_ORIGINS` | Sin orígenes de navegador | ```bash theme={null} sendmux-mcp \ --surfaces mailbox,management,sending \ --mailbox-api-key smx_mbx_... \ --management-api-key smx_root_... \ --sending-api-key smx_mbx_... ```Descubrimiento de herramientas
Los nombres de las herramientas se generan a partir de las superficies actuales de la API pública. Abre el selector de herramientas de tu cliente MCP después de la autorización para ver las herramientas disponibles para esa conexión.Las conexiones alojadas muestran solo las herramientas permitidas por las superficies de producto, permisos y concesión de buzón seleccionados. Los servidores locales muestran las herramientas para las superficies y claves que proporciones al inicio.