Sendmux Email MCP
공식Sendmux는 AI 에이전트를 위한 이메일 인박스 API 및 이메
Sendmux Email MCP(으)로 무엇을 할 수 있나요?
- Sendmux 문서 검색 — AI 어시스턴트에게
search_sendmux를 통해 Sendmux 가이드와 API 참조를 조회하도록 요청하세요. - 사서함 관리 — AI 어시스턴트가 Mailbox 화면을 사용하여 승인된 사서함에서 이메일을 검색, 읽기, 정리, 전송하도록 하세요.
- 팀 리소스 관리 — AI 어시스턴트에게 Management 화면을 통해 도메인, 사서함, 발신 계정, 로그, 지표, 결제, 웹훅을 관리하도록 지시하세요.
- 이메일 전송 — AI 어시스턴트에게 Sending 화면 도구를 사용하여 단일 또는 대량 이메일을 전송하도록 지시하세요.
문서
MCP
AI 도구를 Sendmux 문서 및 제품 도구에 연결하세요.
Sendmux에는 두 개의 MCP 연결이 있습니다. AI 도구가 Sendmux 문서를 검색하게 하려면 Doc Search MCP를 사용하세요. 에이전트가 승인한 Sendmux 도구로 작업하게 하려면 MCP를 사용하세요.
| 연결 | 용도 | 서버 |
|---|---|---|
| Doc Search MCP | Sendmux 가이드 및 API 참조 검색 | https://sendmux.ai/docs/mcp |
| MCP | Management, Mailbox, Sending 도구 사용 | https://mcp.sendmux.ai/mcp 또는 로컬 sendmux-mcp 패키지 |
정보
MCP는 모든 API 엔드포인트가 아닌 선별된 에이전트 도구 세트를 제공합니다. 전체 엔드포인트 범위가 필요하면 SDK, CLI 또는 API 참조를 사용하세요.
Doc Search MCP
Doc Search MCP는 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는 승인한 제품 표면을 제공합니다.
| 표면 | 용도 | 액세스 |
|---|---|---|
| Mailbox | 승인된 사서함에서 검색, 읽기, 정리, 보내기 | Mailbox 액세스 권한이 있는 호스팅 승인, smx_mbx_ 키 또는 로컬 범위 지정 smx_agent_ 토큰 |
| Management | 도메인, 사서함, 발송 계정, 로그, 메트릭, 청구, 웹훅 등 팀 리소스 관리 | Management 액세스 권한이 있는 호스팅 승인 또는 로컬 smx_root_ 키 |
| Sending | 단일 또는 일괄 이메일 보내기 | Sending 액세스 권한이 있는 호스팅 승인, smx_mbx_ 키 또는 소유자 승인 Sending 리소스 smx_agent_ 토큰(로컬) |
호스팅 MCP는 클라이언트가 브라우저 OAuth를 통한 원격 MCP를 지원할 때 기본값입니다. Sendmux를 인증 흐름에 유지하고, 에이전트에 수동 API 키를 배포하지 않으며, 승인에서 허용한 도구만 표시합니다.
정보
패키지 ID:
sendmux-mcp패키지 버전:
2.1.2호스팅 리소스:
https://mcp.sendmux.ai/mcp호스팅 전송: Streamable HTTP
선별된 도구 수: 54
인증된 프로토콜 버전:
2025-11-25,2026-07-28런타임 허용 프로토콜 버전:
2024-11-05,2025-03-26,2025-06-18,2025-11-25,2026-07-28. 런타임 허용은 호환성을 제공하며 각 버전을 인증하지는 않습니다.
| 설정 | 값 |
|---|---|
| 서버 URL | https://mcp.sendmux.ai/mcp |
| 인증 서버 | https://app.sendmux.ai |
| 상태 확인 | https://mcp.sendmux.ai/health |
Postman에서 MCP 요청을 테스트하려면 Postman 컬렉션을 사용하세요:
연결 시 Sendmux는 팀, 제품 표면 및 관련 사서함 액세스를 선택하도록 요청합니다. 액세스 토큰은 수명이 짧습니다. 새로 고침 토큰은 사용 시 순환되며 연결이 끊기거나 만료되지 않는 한 최대 30일 동안 유지될 수 있습니다.
참고
둘 이상의 사서함을 승인한 경우
mailbox_list_granted_mailboxes으로 사서함 워크플로를 시작하고 반환된mailbox_id을 단일 사서함에서 작동하는 도구에 전달하세요.
연결 모드
클라이언트가 브라우저 기반 MCP OAuth 흐름을 열 수 있을 때 사용하세요. 코딩 에이전트가 컴퓨터에서 로컬 명령을 실행할 수 있을 때 사용하세요. 클라이언트가 URL을 필요로 하지만 MCP 패키지를 직접 실행할 때 사용하세요.로컬 패키지
PyPI에서 로컬 패키지를 설치하세요:
pip install sendmux-mcp
단일 표면 실행:
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-mailbox
SENDMUX_API_KEY=smx_root_... sendmux-mcp-management
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-sending
모든 제품 표면 실행:
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
서버는 시작 전에 키 접두사를 검증합니다. Management에는 smx_root_이 필요합니다. Sending은 발송 가능한 smx_mbx_ 키 또는 소유자 승인 Sending 리소스 smx_agent_ 토큰을 허용합니다. Mailbox는 smx_mbx_ 키 또는 범위 지정 smx_agent_ 토큰을 허용합니다.
프라이빗 HTTP
HTTP 모드는 MCP 클라이언트가 서버 URL에 연결하지만 패키지를 직접 실행하려는 경우 유용합니다.
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
엔드포인트 기본값은 /mcp입니다. /health는 선택한 표면을 반환합니다. HTTP 모드는 --allow-unauthenticated-http으로 명시적으로 시작하지 않는 한 SENDMUX_MCP_HTTP_BEARER_TOKEN이 필요합니다.
구성 참조
| 설정 | 환경 변수 | 기본값 | | - | - | - | | 도구 표면 | `SENDMUX_MCP_SURFACES` | `sendmux-mcp`에 필요 | | API 키 대체 | `SENDMUX_API_KEY` | 없음 | | Mailbox API 키 | `SENDMUX_MAILBOX_API_KEY` | 없음 | | Management API 키 | `SENDMUX_MANAGEMENT_API_KEY` | 없음 | | Sending API 키 | `SENDMUX_SENDING_API_KEY` | 없음 | | Management 및 Mailbox API 기본 URL | `SENDMUX_APP_BASE_URL` | `https://app.sendmux.ai/api/v1` | | Sending API 기본 URL | `SENDMUX_SENDING_BASE_URL` | `https://smtp.sendmux.ai/api/v1` | | 재시도 시간 예산(초) | `SENDMUX_MCP_RETRY_MAX_ELAPSED_SECONDS` | 설정 안 됨 | | 전송 | `SENDMUX_MCP_TRANSPORT` | `stdio` | | HTTP 호스트 | `SENDMUX_MCP_HOST` | `127.0.0.1` | | HTTP 포트 | `SENDMUX_MCP_PORT` | `8765` | | HTTP 경로 | `SENDMUX_MCP_PATH` | `/mcp` | | HTTP 베어러 토큰 | `SENDMUX_MCP_HTTP_BEARER_TOKEN` | HTTP에 필요 | | 허용된 브라우저 출처 | `SENDMUX_MCP_ALLOWED_ORIGINS` | 브라우저 출처 없음 | ```bash theme={null} 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 ```도구 검색
도구 이름은 현재 공개 API 표면에서 생성됩니다. 인증 후 MCP 클라이언트의 도구 선택기를 열어 해당 연결에서 사용 가능한 도구를 확인하세요.호스팅 연결은 선택한 제품 표면, 권한 및 사서함 승인에서 허용한 도구만 표시합니다. 로컬 서버는 시작 시 제공한 표면과 키에 대한 도구를 표시합니다.