Sendmux Email MCP

MCP

Conecte ferramentas de IA à documentação e às ferramentas de produto do Sendmux.

O Sendmux tem 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	Use para	Servidor
Doc Search MCP	Pesquisar guias e referências de API do Sendmux.	https://sendmux.ai/docs/mcp
MCP	Usar ferramentas de Management, Mailbox e Sending.	https://mcp.sendmux.ai/mcp ou o pacote local sendmux-mcp

[!NOTE]

O MCP expõe um conjunto selecionado de ferramentas para agentes, não todos os endpoints da API. Use os SDKs, a CLI ou a referência da API quando precisar de cobertura completa dos endpoints.

Doc Search MCP

O Doc Search MCP expõe search_sendmux.

[accordion] Claude Code

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

[accordion] Cursor

Adicione este servidor a .cursor/mcp.json para um projeto ou a ~/.cursor/mcp.json para todos os projetos.

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

[accordion] VS Code

Adicione este servidor ao seu mcp.json de usuário ou de espaço de trabalho.

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

[accordion] Codex

Adicione este servidor a ~/.codex/config.toml ou a um projeto confiável .codex/config.toml.

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

MCP

O MCP expõe as áreas do produto às quais você concede acesso.

Área	Use para	Acesso
Mailbox	Pesquisar, ler, organizar e enviar mensagens das caixas de correio autorizadas.	Autorização hospedada com acesso a Mailbox, uma chave smx_mbx_ ou um token smx_agent_ com escopo local
Management	Gerenciar recursos da equipe, como domínios, caixas de correio, contas de envio, registros, métricas, faturamento e webhooks.	Autorização hospedada com acesso a Management ou uma chave smx_root_ local
Sending	Enviar e-mails individuais ou em lote.	Autorização hospedada com acesso a Sending, uma chave smx_mbx_ ou um token smx_agent_ de recurso Sending aprovado pelo proprietário, localmente

O MCP hospedado é a opção padrão quando seu cliente oferece suporte a MCP remoto com OAuth pelo navegador. Ele mantém o Sendmux no fluxo de autorização, evita distribuir chaves de API manuais aos agentes e mostra apenas as ferramentas permitidas pela autorização.

[!NOTE]

Pacote PyPI: sendmux-mcp

Versão PyPI: 2.1.3

Pacote npm: sendmux-mcp

Versão npm: 1.0.0

Versão dos metadados do registro: 2.1.4

Recurso hospedado: https://mcp.sendmux.ai/mcp

Transporte hospedado: Streamable HTTP

Número de ferramentas selecionadas: 54

Versões certificadas do protocolo: 2025-11-25, 2026-07-28

Versões do protocolo aceitas pelo runtime: 2024-11-05, 2025-03-26, 2025-06-18, 2025-11-25, 2026-07-28. A aceitação pelo runtime oferece compatibilidade; ela não certifica cada versão.

Configuração	Valor
URL do servidor	https://mcp.sendmux.ai/mcp
Servidor de autorização	https://app.sendmux.ai
Verificação de integridade	https://mcp.sendmux.ai/health

Use a coleção do Postman quando quiser testar solicitações MCP no Postman:

Ao se conectar, o Sendmux solicita que você escolha uma equipe, as áreas do produto e, quando relevante, o acesso às caixas de correio. Os tokens de acesso têm curta duração. Os tokens de atualização são alternados a cada uso e podem durar até 30 dias, a menos que a conexão seja desconectada ou expire.

[!NOTE]

Se você conceder acesso a mais de uma caixa de correio, inicie os fluxos de trabalho de caixa de correio com mailbox_list_granted_mailboxes e passe o mailbox_id retornado às ferramentas que atuam em uma única caixa de correio.

Modos de conexão

[card] OAuth hospedado

Use quando seu cliente puder abrir um fluxo OAuth do MCP baseado no navegador.

[card] stdio local

Use quando seu agente de programação puder executar um comando local na sua máquina.

[card] HTTP privado

Use quando um cliente precisar de uma URL, mas você executar o pacote MCP por conta própria.

Ponte npm

Requer Node.js 22 ou posterior. Execute a ponte npm:

npx -y sendmux-mcp

A ponte conecta clientes stdio ao servidor hospedado por meio do OAuth pelo navegador. As ferramentas seguem a autorização hospedada.

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

Pacote local

Instale o pacote local do PyPI:

pip install sendmux-mcp

Execute uma área:

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 áreas do 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. Management requer smx_root_. Sending aceita uma chave smx_mbx_ com capacidade de envio ou um token smx_agent_ de recurso Sending aprovado pelo proprietário. Mailbox 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 quer 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 usa /mcp por padrão. /health retorna as áreas 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

[accordion] Variáveis de ambiente

Configuração	Ambiente	Padrão
Áreas de ferramentas	SENDMUX_MCP_SURFACES	Obrigatório para sendmux-mcp
Alternativa de chave de API	SENDMUX_API_KEY	Nenhuma
Chave de API do Mailbox	SENDMUX_MAILBOX_API_KEY	Nenhuma
Chave de API do Management	SENDMUX_MANAGEMENT_API_KEY	Nenhuma
Chave de API do Sending	SENDMUX_SENDING_API_KEY	Nenhuma
URL base da API de Management e Mailbox	SENDMUX_APP_BASE_URL	https://app.sendmux.ai/api/v1
URL base da API de Sending	SENDMUX_SENDING_BASE_URL	https://smtp.sendmux.ai/api/v1
Limite de tempo para novas tentativas, em segundos	SENDMUX_MCP_RETRY_MAX_ELAPSED_SECONDS	Não definido
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 bearer HTTP	SENDMUX_MCP_HTTP_BEARER_TOKEN	Obrigatório para HTTP
Origens de navegador permitidas	SENDMUX_MCP_ALLOWED_ORIGINS	Nenhuma origem de navegador

[accordion] Entrada de ambiente protegida

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

Descoberta de ferramentas

[accordion] Como funciona a descoberta de ferramentas

Os nomes das ferramentas são gerados a partir das áreas públicas atuais da API. Abra o seletor de ferramentas do seu cliente MCP após a autorização para ver as ferramentas disponíveis para essa conexão.

As conexões hospedadas mostram apenas as ferramentas permitidas pelas áreas do produto, pelas permissões e pela autorização de caixa de correio selecionadas. Os servidores locais mostram as ferramentas das áreas e chaves fornecidas na inicialização.

Solução de problemas

[accordion] Nenhuma ferramenta aparece

Confirme as áreas do produto selecionadas e as permissões concedidas. As conexões hospedadas mostram apenas as ferramentas permitidas pela autorização.

[accordion] O servidor local falha antes de iniciar

Verifique o prefixo da chave de API. Management requer smx_root_; Sending aceita smx_mbx_ ou um token smx_agent_ de recurso Sending aprovado pelo proprietário; Mailbox aceita smx_mbx_ ou smx_agent_ com escopo.

[accordion] O servidor HTTP retorna 401

Envie Authorization: Bearer <SENDMUX_MCP_HTTP_BEARER_TOKEN> para o HTTP privado ou conclua o OAuth para o MCP hospedado.

[accordion] O servidor HTTP retorna 403 origin_forbidden

Adicione a origem do cliente do navegador a SENDMUX_MCP_ALLOWED_ORIGINS para o HTTP privado.

[accordion] Muitas ferramentas em um único cliente

Conecte apenas as áreas necessárias ou desative no cliente as ferramentas que não usa.

Próximas etapas

[card] A2A

Use o Sendmux por meio de um endpoint de agente A2A 1.0 com OAuth hospedado.

[card] Clientes MCP

Configure o MCP do Sendmux no Claude Code, Cursor, Codex, Gemini CLI, Qwen Code, Zed e outros.

[card] SDKs

Use clientes gerenciados por pacotes no código da aplicação.

[card] CLI

Instale a CLI com Snap, Homebrew ou npm quando precisar de acesso pelo terminal.

[card] Chaves de API

Crie credenciais com escopo para configurações locais do MCP.

Esta documentação é criada e hospedada no Mintlify, uma plataforma de documentação para desenvolvedores.