Sendmux Email MCP Server
oficialSendmux é uma API de caixa de entrada de e-mail e API de e-mail para agentes de IA.
Documentação
MCP
Conecte ferramentas de IA à documentação e às ferramentas de produto do Sendmux.
O Sendmux possui duas conexões MCP. Use o Doc Search MCP quando quiser que uma ferramenta de IA pesquise a documentação do Sendmux. Use o MCP quando quiser que um agente trabalhe com as ferramentas do Sendmux que você autorizar.
| Conexão | Usado para | Servidor |
|---|---|---|
| Doc Search MCP | Pesquisar guias e referências de API do Sendmux. | https://sendmux.ai/docs/mcp |
| MCP | Usar ferramentas de Gestão, Caixa de Correio e Envio. | https://mcp.sendmux.ai/mcp ou o pacote local sendmux-mcp |
Doc Search MCP
O Doc Search MCP expõe 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
O MCP expõe as superfícies de produto que você concede.
| Superfície | Usado para | Acesso |
|---|---|---|
| Caixa de Correio | Pesquisar, ler, organizar e enviar a partir das caixas de correio concedidas. | Concessão hospedada com acesso à Caixa de Correio, uma chave smx_mbx_ ou um token smx_agent_ com escopo localmente |
| Gestão | Gerenciar recursos da equipe, como domínios, caixas de correio, contas de envio, logs, métricas, cobrança e webhooks. | Concessão hospedada com acesso de Gestão ou uma chave smx_root_ localmente |
| Envio | Enviar e-mails únicos ou em lote. | Concessão hospedada com acesso de Envio, uma chave smx_mbx_ ou um token smx_agent_ de recurso de Envio aprovado pelo proprietário localmente |
O MCP hospedado é o padrão quando seu cliente suporta MCP remoto com OAuth no navegador. Ele mantém o Sendmux no fluxo de autorização, evita distribuir chaves de API manuais para agentes e mostra apenas as ferramentas permitidas pela concessão.
| Configuração | Valor |
|---|---|
| URL do Servidor | https://mcp.sendmux.ai/mcp |
| Servidor de autorização | https://app.sendmux.ai |
| Verificação de saúde | https://mcp.sendmux.ai/health |
Use a coleção do Postman quando quiser testar solicitações MCP a partir do Postman:
Ao conectar, o Sendmux solicita que você escolha uma equipe, superfícies de produto e acesso à caixa de correio, quando relevante. Os tokens de acesso têm vida curta. Os tokens de atualização rotacionam no uso e podem durar até 30 dias, a menos que a conexão seja desconectada ou expire.
Se você conceder mais de uma caixa de correio, inicie os fluxos de trabalho da caixa de correio com `mailbox_list_granted_mailboxes` e passe o `mailbox_id` retornado para as ferramentas que atuam em uma caixa de correio.Modos de conexão
Use quando seu cliente puder abrir um fluxo OAuth MCP baseado em navegador. Use quando seu agente de codificação puder iniciar um comando local em sua máquina. Use quando um cliente precisar de uma URL, mas você mesmo executa o pacote MCP.Pacote local
Instale o pacote local a partir do PyPI:
pip install sendmux-mcp
Execute uma superfície:
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-mailbox
SENDMUX_API_KEY=smx_root_... sendmux-mcp-management
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-sending
Execute todas as superfícies de produto:
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
O servidor valida os prefixos das chaves antes de iniciar. Gestão requer smx_root_. Envio aceita uma chave smx_mbx_ com capacidade de envio ou um token smx_agent_ de recurso de Envio aprovado pelo proprietário. Caixa de Correio aceita uma chave smx_mbx_ ou um token smx_agent_ com escopo.
HTTP Privado
O modo HTTP é útil quando seu cliente MCP se conecta a uma URL de servidor, mas você ainda deseja executar o pacote por conta própria.
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
O endpoint padrão é /mcp. /health retorna as superfícies selecionadas. O modo HTTP requer SENDMUX_MCP_HTTP_BEARER_TOKEN, a menos que você o inicie explicitamente com --allow-unauthenticated-http.
Referência de configuração
| Configuração | Variável de Ambiente | Padrão | | ----------------------------------- | ------------------------------- | -------------------------------- | | Superfícies de ferramenta | `SENDMUX_MCP_SURFACES` | Obrigatório para `sendmux-mcp` | | Chave de API substituta | `SENDMUX_API_KEY` | Nenhuma | | Chave de API da Caixa de Correio | `SENDMUX_MAILBOX_API_KEY` | Nenhuma | | Chave de API de Gestão | `SENDMUX_MANAGEMENT_API_KEY` | Nenhuma | | Chave de API de Envio | `SENDMUX_SENDING_API_KEY` | Nenhuma | | URL base da API de Gestão e Caixa de Correio | `SENDMUX_APP_BASE_URL` | `https://app.sendmux.ai/api/v1` | | URL base da API de Envio | `SENDMUX_SENDING_BASE_URL` | `https://smtp.sendmux.ai/api/v1` | | Transporte | `SENDMUX_MCP_TRANSPORT` | `stdio` | | Host HTTP | `SENDMUX_MCP_HOST` | `127.0.0.1` | | Porta HTTP | `SENDMUX_MCP_PORT` | `8765` | | Caminho HTTP | `SENDMUX_MCP_PATH` | `/mcp` | | Token de portador HTTP | `SENDMUX_MCP_HTTP_BEARER_TOKEN` | Obrigatório para HTTP | | Origens de navegador permitidas | `SENDMUX_MCP_ALLOWED_ORIGINS` | Nenhuma origem 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_... ```Descoberta de ferramentas
Os nomes das ferramentas são gerados a partir das superfícies atuais da API pública. Abra o seletor de ferramentas do seu cliente MCP após a autorização para ver as ferramentas disponíveis para essa conexão.Conexões hospedadas mostram apenas as ferramentas permitidas pelas superfícies de produto, permissões e concessão de caixa de correio selecionadas. Servidores locais mostram as ferramentas para as superfícies e chaves que você fornece na inicialização.