Sendmux Email MCP
공식Sendmux는 AI 에이전트를 위한 이메일 인박스 API 및 이메
Sendmux Email MCP(으)로 무엇을 할 수 있나요?
- Sendmux 문서 검색 — AI에게
search_sendmux를 사용하여 Doc Search MCP에서 가이드나 API 참조를 찾도록 요청하세요. - 사서함 관리 —
mailbox_list_granted_mailboxes로 부여된 사서함을 나열한 후, 특정 사서함에서 이메일을 검색, 읽기 또는 정리하세요. - 트랜잭션 이메일 보내기 — 전송 가능한 연결을 승인한 후 Sending surface를 통해 단일 또는 일괄 이메일을 보내세요.
- 팀 리소스 관리 — Management surface를 통해 도메인, 사서함, 전송 계정, 로그, 메트릭, 결제 및 웹훅을 관리하세요.
- 로컬 MCP 서버 실행 — 사서함, 관리 또는 전송 도구에 대한 surface별 API 키를 사용하여 로컬에서
sendmux-mcp패키지를 시작하세요.
문서
MCP
AI 도구를 Sendmux 문서 및 제품 도구에 연결하세요.
Sendmux에는 두 가지 MCP 연결이 있습니다. AI 도구가 Sendmux 문서를 검색하도록 하려면 Doc Search MCP를 사용하세요. 에이전트가 승인한 Sendmux 도구로 작업하도록 하려면 MCP를 사용하세요.
| 연결 | 사용 목적 | 서버 |
|---|---|---|
| Doc Search MCP | Sendmux 가이드 및 API 참조 검색. | https://sendmux.ai/docs/mcp |
| MCP | 관리, 메일함, 발송 도구 사용. | 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는 사용자가 부여한 제품 영역을 노출합니다.
| 영역 | 사용 목적 | 액세스 |
|---|---|---|
| 메일함 | 부여된 메일함에서 검색, 읽기, 정리 및 발송. | 메일함 액세스 권한이 있는 호스팅 권한 부여, smx_mbx_ 키 또는 로컬에서 범위가 지정된 smx_agent_ 토큰 |
| 관리 | 도메인, 메일함, 발송 계정, 로그, 지표, 청구, 웹훅과 같은 팀 리소스 관리. | 관리 액세스 권한이 있는 호스팅 권한 부여 또는 로컬에서 smx_root_ 키 |
| 발송 | 단일 또는 배치 이메일 발송. | 발송 액세스 권한이 있는 호스팅 권한 부여, smx_mbx_ 키 또는 소유자가 승인한 발송 리소스 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
서버는 시작하기 전에 키 접두사를 검증합니다. 관리에는 smx_root_이 필요합니다. 발송은 발송 가능 smx_mbx_ 키 또는 소유자가 승인한 발송 리소스 smx_agent_ 토큰을 허용합니다. 메일함은 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` | 없음 | | 메일함 API 키 | `SENDMUX_MAILBOX_API_KEY` | 없음 | | 관리 API 키 | `SENDMUX_MANAGEMENT_API_KEY` | 없음 | | 발송 API 키 | `SENDMUX_SENDING_API_KEY` | 없음 | | 관리 및 메일함 API 기본 URL | `SENDMUX_APP_BASE_URL` | `https://app.sendmux.ai/api/v1` | | 발송 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 클라이언트의 도구 선택기를 열어 해당 연결에 사용 가능한 도구를 확인하세요.호스팅 연결은 선택한 제품 영역, 권한 및 메일함 부여로 허용된 도구만 표시합니다. 로컬 서버는 시작 시 제공한 영역 및 키에 대한 도구를 표시합니다.