Sendmux Email MCP

공식

Sendmux는 AI 에이전트를 위한 이메일 인박스 API 및 이메

sendmux.ai에서 보기

Sendmux Email MCP(으)로 무엇을 할 수 있나요?

Sendmux 문서 검색 — AI 어시스턴트에게 search_sendmux를 통해 Sendmux 가이드와 API 참조를 찾아보도록 요청하세요.
권한이 부여된 메일함 사용 — 권한을 부여한 메일함에서 검색, 읽기, 정리, 발송을 할 수 있습니다. 여러 메일함에 권한이 부여된 경우 mailbox_list_granted_mailboxes부터 시작하세요.
팀 리소스 관리 — Management 액세스 권한으로 도메인, 메일함, 발송 계정, 로그, 지표, 결제, 웹훅을 관리하세요.
단일 또는 일괄 이메일 발송 — 발송 기능이 있는 키 또는 승인된 에이전트 토큰을 사용해 Sending 인터페이스에서 메시지 하나 또는 여러 개를 발송하세요.
호스팅 또는 로컬 설정 선택 — https://mcp.sendmux.ai/mcp에서 호스팅 OAuth로 연결하거나, 인터페이스별 키를 사용해 로컬 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	Management, Mailbox, Sending 도구를 사용합니다.	`https://mcp.sendmux.ai/mcp` 또는 로컬 `sendmux-mcp` 패키지

[!NOTE]

MCP는 모든 API 엔드포인트가 아니라 엄선된 에이전트 도구 모음을 제공합니다. 전체 엔드포인트를 사용해야 하는 경우 SDK, CLI 또는 API 참조를 사용하세요.

Doc Search MCP

Doc Search MCP는 search_sendmux을 제공합니다.

[accordion] Claude Code

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

[accordion] Cursor

이 서버를 한 프로젝트에만 적용하려면 .cursor/mcp.json에, 모든 프로젝트에 적용하려면 ~/.cursor/mcp.json에 추가하세요.
{
  "mcpServers": {
    "sendmux-docs": {
      "url": "https://sendmux.ai/docs/mcp"
    }
  }
}

[accordion] VS Code

이 서버를 사용자 또는 작업 영역 mcp.json에 추가하세요.
{
  "servers": {
    "sendmux-docs": {
      "type": "http",
      "url": "https://sendmux.ai/docs/mcp"
    }
  }
}

[accordion] Codex

이 서버를 ~/.codex/config.toml 또는 신뢰하는 프로젝트 .codex/config.toml에 추가하세요.
[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_` 토큰(로컬)

클라이언트가 브라우저 OAuth를 사용하는 원격 MCP를 지원한다면 호스팅 MCP를 기본으로 사용하세요. 호스팅 MCP는 Sendmux를 권한 부여 흐름에 포함하고, 에이전트에 수동 API 키를 배포하지 않아도 되며, 권한 부여로 허용된 도구만 표시합니다.

[!NOTE]

PyPI 패키지: sendmux-mcp

PyPI 버전: 2.1.3

npm 패키지: sendmux-mcp

npm 버전: 1.0.0

레지스트리 메타데이터 버전: 2.1.4

호스팅 리소스: 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일 동안 유효할 수 있습니다.

[!NOTE]

둘 이상의 메일함에 권한을 부여한 경우 메일함 워크플로를 mailbox_list_granted_mailboxes로 시작하고, 단일 메일함에서 작동하는 도구에 반환된 mailbox_id을 전달하세요.

연결 모드

[card] 호스팅 OAuth

클라이언트에서 브라우저 기반 MCP OAuth 흐름을 열 수 있을 때 사용합니다.

[card] 로컬 stdio

코딩 에이전트가 컴퓨터에서 로컬 명령을 실행할 수 있을 때 사용합니다.

[card] 비공개 HTTP

클라이언트에 URL이 필요하지만 MCP 패키지는 직접 실행하려는 경우 사용합니다.

npm 브리지

Node.js 22 이상이 필요합니다. npm 브리지를 실행하세요.

npx -y sendmux-mcp

브리지는 stdio 클라이언트를 브라우저 OAuth를 통해 호스팅 서버에 연결합니다. 도구는 호스팅 권한 부여를 따릅니다.

{
  "mcpServers": {
    "sendmux": {
      "command": "npx",
      "args": ["-y", "sendmux-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 모드에는 SENDMUX_MCP_HTTP_BEARER_TOKEN이 필요합니다. 단, --allow-unauthenticated-http로 명시적으로 시작한 경우는 예외입니다.

구성 참조

[accordion] 환경 변수

설정 환경 변수 기본값
도구 영역 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 bearer 토큰 SENDMUX_MCP_HTTP_BEARER_TOKEN HTTP에 필요
허용된 브라우저 출처 SENDMUX_MCP_ALLOWED_ORIGINS 브라우저 출처 없음

설정	환경 변수	기본값
도구 영역	`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 bearer 토큰	`SENDMUX_MCP_HTTP_BEARER_TOKEN`	HTTP에 필요
허용된 브라우저 출처	`SENDMUX_MCP_ALLOWED_ORIGINS`	브라우저 출처 없음

[accordion] 보호된 환경 입력

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

도구 검색

[accordion] 도구 검색 작동 방식

도구 이름은 현재 공개 API 영역을 기준으로 생성됩니다. 권한을 부여한 후 MCP 클라이언트의 도구 선택기를 열어 해당 연결에서 사용할 수 있는 도구를 확인하세요.

호스팅 연결에는 선택한 제품 영역, 권한 및 메일함 권한 부여로 허용된 도구만 표시됩니다. 로컬 서버에는 시작 시 제공한 영역 및 키에 해당하는 도구가 표시됩니다.

문제 해결

[accordion] 도구가 표시되지 않음

선택한 제품 영역과 부여된 권한을 확인하세요. 호스팅 연결에는 권한 부여로 허용된 도구만 표시됩니다.

[accordion] 로컬 서버가 시작 전에 실패함

API 키 접두사를 확인하세요. Management에는 smx_root_가 필요합니다. Sending은 smx_mbx_ 또는 소유자가 승인한 Sending 리소스 smx_agent_을 허용합니다. Mailbox는 smx_mbx_ 또는 범위가 지정된 smx_agent_을 허용합니다.

[accordion] HTTP 서버에서 401을 반환함

비공개 HTTP에 Authorization: Bearer <SENDMUX_MCP_HTTP_BEARER_TOKEN>을 전송하거나 호스팅 MCP의 OAuth를 완료하세요.

[accordion] HTTP 서버에서 403 origin_forbidden을 반환함

비공개 HTTP의 경우 브라우저 클라이언트 출처를 SENDMUX_MCP_ALLOWED_ORIGINS에 추가하세요.

[accordion] 한 클라이언트에 도구가 너무 많음

필요한 영역만 연결하거나 클라이언트에서 사용하지 않는 도구를 비활성화하세요.

다음 단계

[card] A2A

호스팅 OAuth를 사용하는 A2A 1.0 에이전트 엔드포인트를 통해 Sendmux를 사용합니다.

[card] MCP 클라이언트

Claude Code, Cursor, Codex, Gemini CLI, Qwen Code, Zed 등에서 Sendmux MCP를 구성합니다.

[card] SDK

애플리케이션 코드에서 패키지로 관리되는 클라이언트를 사용합니다.

[card] CLI

터미널 액세스가 필요할 때 Snap, Homebrew 또는 npm으로 CLI를 설치합니다.

[card] API 키

로컬 MCP 설정을 위한 범위 지정 자격 증명을 만듭니다.

이 문서는 개발자 문서 플랫폼인 Mintlify에서 빌드 및 호스팅됩니다.