Sendmux Email MCP Server
공식Sendmux는 AI 에이전트를 위한 이메일 인박스 API 및 이메
문서
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 패키지 |
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 키를 배포하지 않으며, 권한 부여로 허용된 도구만 표시합니다.
| 설정 | 값 |
|---|---|
| 서버 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_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 \ --mailbox-api-key smx_mbx_... \ --management-api-key smx_root_... \ --sending-api-key smx_mbx_... ```도구 검색
도구 이름은 현재 공개 API 영역에서 생성됩니다. 인증 후 MCP 클라이언트의 도구 선택기를 열어 해당 연결에 사용 가능한 도구를 확인하세요.호스팅 연결은 선택한 제품 영역, 권한 및 메일함 부여로 허용된 도구만 표시합니다. 로컬 서버는 시작 시 제공한 영역과 키에 대한 도구를 표시합니다.