mcp-server

MCP(Model Context Protocol) 서버는 MinuteMail 공개 API를 도구(tool)로 노출합니다. AI 에이전트와 MCP 클라이언트는 mm-api-gateway를 통해 MinuteMail 사서함, 이메일, 첨부 파일, 도메인, 팀, 모의 OAuth 신원을 다룰 수 있습니다.

• 엔드포인트: https://mcp.minutemail.co/mcp (Streamable HTTP, 프로토콜 리비전 2025-06-18)

• 인증: MCP 클라이언트의 Authorization: Bearer mmak_... 헤더는 api-gateway에 그대로 전달됩니다. 이 서버는 자격 증명을 보관하지 않습니다. 스코프와 할당량은 일반 API 클라이언트와 동일하게 게이트웨이에서 적용됩니다.

• 무상태(Stateless): 세션은 없으며 서버 푸시 SSE도 없습니다(GET /mcp와 DELETE /mcp는 405 반환). 상태 확인: GET /health.

제공 도구(39개)

모든 도구는 api-gateway의 /v1 라우트와 1:1로 매핑됩니다. 모든 호출에는 Bearer API 키가 필요하며, 쓰기 작업에는 해당 스코프(mailboxes, domains, team, identities)가 필요합니다.

사서함 (mailboxes 스코프)

보관된 사서함 (mailboxes 스코프)

mm_list_archived_mailboxes, mm_get_archived_mailbox, mm_delete_archived_mailbox, mm_reactivate_archived_mailbox.

도메인 (domains 스코프)

mm_list_domains, mm_register_domain, mm_verify_domain, mm_delete_domain.

팀 (team 스코프)

mm_list_members, mm_add_member, mm_get_member, mm_delete_member, mm_create_invitation, mm_list_invitations, mm_delete_invitation.

모의 신원 (identities 스코프)

mm_list_identities, mm_create_identity, mm_get_identity, mm_delete_identity, mm_list_oauth_clients, mm_create_oauth_client, mm_get_oauth_client, mm_delete_oauth_client, mm_rotate_client_secret.

노출되지 않는 항목

• /v1/api-keys CRUD — API 키 관리는 MCP를 통해 노출되지 않습니다. 키는 웹 앱에서 관리하세요.

• /internal/* — 내부 전용. /metrics는 스크래핑을 위해 Prometheus 메트릭(런타임 go_*/process_* 카운터)을 제공합니다. 자세한 내용은 METRICS.md를 참조하세요.

Related MCP server: ldm-email-deliverability

예제

curl -s https://mcp.minutemail.co/mcp \
  -H 'Authorization: Bearer mmak_XXXXXXXX' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"mm_create_mailbox","arguments":{"expiresIn":30}}}'

도구 결과는 게이트웨이의 JSON 응답을 담은 MCP 텍스트 콘텐츠로 반환됩니다. 2xx가 아닌 게이트웨이 응답은 HTTP 상태와 본문이 포함된 isError: true 결과가 됩니다(401 잘못된 키, 403 스코프/도메인, 429 잔여 횟수가 포함된 할당량 초과, 502 업스트림 다운).

구성

개발

Go 1.23. /metrics를 위해 표준 라이브러리와 prometheus/client_golang을 사용합니다. MinuteMail 서비스 표준을 따릅니다(mm-mailbox-service 참조).

go test ./...     # unit tests
go vet ./...
go run .          # local server on :8080