Resend MCP Server – 빠른 개요

정의 – AI 기반 "MCP" 클라이언트(Claude, Cursor, Copilot 또는 **MCP (Message-Control-Protocol)**를 지원하는 모든 도구)가 Resend 이메일 전송 플랫폼과 직접 통신할 수 있게 해주는 소형 Node-JS 서비스(resend-mcp NPM 패키지로 제공)입니다. 실질적으로 언어 모델을 이메일 전송, 연락처 관리, 브로드캐스트 실행, 수신 메시지 처리 등을 수행하는 완전한 기능의 이메일 자동화 어시스턴트로 변환합니다.

중요성 – 이 브리지가 없으면 프롬프트 내에 사용자 지정 API 호출을 작성하거나 별도의 스크립트를 작성해야 합니다. MCP 서버는 모델이 자연어 지시를 통해 호출할 수 있는 안정적이고 언어 모델 친화적인 명령 세트(README의 MCP Server Tools 목록)를 노출하여 모델이 이메일 운영 관리자 역할을 수행할 수 있게 합니다.

두 가지 실행 방법

모드	작동 방식	사용 시기
원격 MCP 서버 (Resend 호스팅)	클라이언트를 `https://mcp.resend.com/mcp`로 지정합니다. 클라이언트가 OAuth를 위해 브라우저를 열거나 Resend API 키를 제공합니다.	설정이 가장 빠르며, 로컬 프로세스를 원하지 않는 웹 기반 에이전트(Claude, Cursor 등)에 적합합니다.
로컬 MCP 서버 (본 패키지)	`npx resend-mcp`(기본값 stdio) 또는 `npx resend-mcp --http`를 통해 서버를 직접 실행합니다. Resend API 키와 선택적으로 기본 발신자 주소를 제공합니다.	완전한 제어가 필요하거나, 방화벽 뒤에서 실행하거나, 비공개 CI/에이전트 환경에 통합해야 할 때 필요합니다.

두 모드 모두 동일한 도구 세트를 노출하며, 유일한 차이점은 전송 방식(stdio 대 Streamable HTTP)입니다.

시작하기 (로컬, stdio – 기본값)

# 감지된 모든 MCP 클라이언트에 서버를 등록하는 한 줄 명령어
npx add-mcp resend-mcp --name resend --env "RESEND_API_KEY=re_XXXXX"

re_XXXXX를 본인의 Resend API 키로 교체하세요.

그 후, Claude Code와 같은 클라이언트에서 간단히 다음을 실행할 수 있습니다:

claude mcp add resend -e RESEND_API_KEY=re_XXXXX -- npx -y resend-mcp

클라이언트가 서버를 자식 프로세스로 시작하고 stdio를 통해 통신하며, 이메일 도구를 사용할 수 있게 됩니다.

HTTP 모드 (헤드리스 에이전트 또는 사용자 지정 프록시에 유용)

# 3000 포트에서 수신 대기하는 서버 시작
npx -y resend-mcp --http --port 3000

클라이언트는 http://127.0.0.1:3000/mcp에 연결하고 자신의 Resend API 키가 포함된 Bearer 헤더를 전송합니다.

서버를 다른 Node 서비스에 포함할 수도 있습니다:

import { runHttp } from 'resend-mcp/http';
const server = await runHttp({ senderEmailAddress: "me@mydomain.com" }, 3000);

서버는 기본적으로 Host 헤더를 검증합니다(DNS 리바인딩 보호). 리버스 프록시 뒤에 있는 경우 --host 0.0.0.0 또는 --allowed-hosts를 설정하세요.

MCP 서버 기능 (도구 목록)

Emails – 전송, 목록 조회, 취소, 업데이트, 대량 전송, 파일 첨부(로컬, URL, base64), 예약, 태그, 사용자 지정 헤더, 멱등성.
Received mail – 수신 메시지 목록 조회, 첨부 파일 다운로드.
Templates – {{{VARIABLE}}} 플레이스홀더를 사용한 CRUD 작업.
Contacts & Segments – 주소록 관리, CSV 가져오기, 사용자 지정 속성, 토픽 구독.
Broadcasts & Automations – 캠페인 생성, 열람/클릭 추적, 예약, 미리보기, 복제.
Events & Topics – 자동화 트리거, 구독 토픽 관리.
Domains – 검증, 추적/TLS 구성, 클레임 관리.
Suppressions – 바운스/불만 항목 추가/제거, 수동 수신 거부 목록.
Webhooks – CRUD, 전송 기록 보기, 이벤트 재실행, 서명 시크릿 교체.
Logs & Usage – API 요청 로그 검사, 할당량/사용 통계 보기.
Editor integration – Resend의 시각적 편집기에 연결하여 공동 초안 편집.

이 모든 기능은 MCP 도구로 노출되어 LLM이 간단한 JSON 형태의 페이로드로 호출할 수 있으므로, 이메일 워크플로우 자동화가 모델 기능의 자연스러운 확장이 됩니다.

구성 옵션

플래그 / 환경 변수	목적
`--key` / `RESEND_API_KEY`	stdio 모드용 API 키(HTTP 모드는 클라이언트의 Bearer 토큰에서 가져옴).
`--sender` / `SENDER_EMAIL_ADDRESS`	기본 "From" 주소(검증된 도메인에 속해야 함).
`--reply-to` / `REPLY_TO_EMAIL_ADDRESSES`	기본 회신 주소(반복 가능).
`--http`	HTTP 전송으로 전환.
`--port` / `MCP_PORT`	HTTP 모드용 포트(기본값 3000).
`--host` / `MCP_HOST`	HTTP용 호스트 검증(기본값 127.0.0.1).
`--allowed-hosts` / `MCP_ALLOWED_HOSTS`	프록시 뒤에 있을 때의 Host 헤더 화이트리스트.
`--allowed-file-dirs` / `MCP_ALLOWED_FILE_DIRS`	서버가 로컬 첨부 파일을 읽을 수 있는 디렉토리(HTTP에서는 설정하지 않으면 비활성화됨).

누가 사용하나요?

AI 에이전트를 구축하는 개발자: 원시 HTTP 호출을 작성하지 않고 트랜잭션 또는 마케팅 이메일을 보내야 하는 경우.
Claude, Cursor, Copilot 또는 기타 MCP 호환 편집기를 사용하는 팀: LLM이 뉴스레터, 지원 티켓 또는 자동 응답을 관리하기를 원하는 경우.
기업: 규정 준수를 위해 브리지를 자체 호스팅하거나 기업 프록시 뒤에서 실행하려는 경우.

일반적인 클라이언트를 위한 빠른 치트 시트

// Cursor / Claude Desktop (stdio)
{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-mcp"],
      "env": { "RESEND_API_KEY": "re_XXXXX" }
    }
  }
}

// HTTP 모드 (모든 클라이언트)
{
  "mcpServers": {
    "resend": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": { "Authorization": "Bearer re_XXXXX" }
    }
  }
}

결론 – resend-mcp는 최신 LLM 기반 어시스턴트가 Resend의 이메일 플랫폼을 일류 명령 기반 서비스로 취급할 수 있게 해주는 가벼운 오픈 소스 접착제 계층으로, 호스팅된 엔드포인트나 자체 실행 Node 서버를 통해 사용할 수 있습니다.

resend/resend-mcp