Resend MCP 서버

Resend 플랫폼을 위한 MCP 서버입니다. Claude Desktop, Cursor, Claude Code와 같은 모든 MCP 클라이언트에서 직접 이메일을 보내고 받고, 연락처, 브로드캐스트, 도메인 등을 관리하세요.

기능

• 이메일 — 이메일 발송, 목록 조회, 가져오기, 취소, 업데이트 및 대량 발송. HTML, 일반 텍스트, 첨부 파일(로컬 파일, URL 또는 base64), CC/BCC, 회신 주소(reply-to), 예약 발송, 태그 및 주제 기반 발송을 지원합니다.

• 수신 이메일 — 수신된 이메일 목록 조회 및 읽기. 수신된 이메일 첨부 파일 목록 조회 및 다운로드.

• 연락처 — 연락처 생성, 목록 조회, 가져오기, 업데이트 및 삭제. 세그먼트 멤버십 및 주제 구독 관리. 사용자 지정 연락처 속성 지원.

• 브로드캐스트 — 브로드캐스트 캠페인 생성, 발송, 목록 조회, 가져오기, 업데이트 및 삭제. 예약 발송, 개인화 플레이스홀더 및 미리보기 텍스트 지원.

• 도메인 — 발신자 도메인 생성, 목록 조회, 가져오기, 업데이트, 삭제 및 인증. 추적, TLS 및 발송/수신 기능 구성.

• 세그먼트 — 잠재 고객 세그먼트 생성, 목록 조회, 가져오기 및 삭제.

• 주제 — 구독 주제 생성, 목록 조회, 가져오기, 업데이트 및 삭제.

• 연락처 속성 — 사용자 지정 연락처 속성 생성, 목록 조회, 가져오기, 업데이트 및 삭제.

• API 키 — API 키 생성, 목록 조회 및 삭제.

• 웹훅 — 이벤트 알림을 위한 웹훅 생성, 목록 조회, 가져오기, 업데이트 및 삭제.

Related MCP server: blastengine-mailer

설정

무료 Resend 계정을 만들고 API 키를 생성하세요. 본인 이외의 주소로 이메일을 보내려면 도메인을 인증해야 합니다.

사용법

이 서버는 stdio(기본값)와 HTTP 두 가지 전송 모드를 지원합니다.

Stdio 전송 (기본값)

Claude Code

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

Cursor

명령 팔레트를 열고 "Cursor Settings" > "MCP" > "Add new global MCP server"를 선택하세요.

{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-mcp"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxx"
      }
    }
  }
}

Claude Desktop

Claude Desktop 설정 > "Developer" 탭 > "Edit Config"를 여세요.

{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-mcp"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxx"
      }
    }
  }
}

HTTP 전송

원격 또는 웹 기반 통합을 위해 HTTP를 통해 서버를 실행하세요. HTTP 모드에서는 각 클라이언트가 Authorization 헤더에 Bearer 토큰으로 Resend API 키를 전달하여 인증합니다.

서버 시작:

npx -y resend-mcp --http --port 3000

서버는 http://127.0.0.1:3000에서 수신 대기하며 Streamable HTTP를 사용하여 /mcp 엔드포인트를 노출합니다.

Claude Code

claude mcp add resend --transport http http://127.0.0.1:3000/mcp --header "Authorization: Bearer re_xxxxxxxxx"

Cursor

명령 팔레트를 열고 "Cursor Settings" > "MCP" > "Add new global MCP server"를 선택하세요.

{
  "mcpServers": {
    "resend": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": {
        "Authorization": "Bearer re_xxxxxxxxx"
      }
    }
  }
}

MCP_PORT 환경 변수를 통해 포트를 설정할 수도 있습니다:

MCP_PORT=3000 npx -y resend-mcp --http

옵션

서버를 구성하기 위해 추가 인수를 전달할 수 있습니다:

• --key: Resend API 키 (stdio 모드 전용; HTTP 모드는 클라이언트로부터 Bearer 토큰을 사용)

• --sender: 인증된 도메인의 기본 발신자 이메일 주소

• --reply-to: 기본 회신 이메일 주소 (여러 번 지정 가능)

• --http: stdio 대신 HTTP 전송 사용 (기본값: stdio)

• --port: --http 사용 시 HTTP 포트 (기본값: 3000 또는 MCP_PORT 환경 변수)

환경 변수:

• RESEND_API_KEY: Resend API 키 (stdio의 경우 필수, HTTP의 경우 클라이언트가 Bearer 토큰을 통해 전달하므로 선택 사항)

• SENDER_EMAIL_ADDRESS: 인증된 도메인의 기본 발신자 이메일 주소 (선택 사항)

• REPLY_TO_EMAIL_ADDRESSES: 쉼표로 구분된 회신 이메일 주소 (선택 사항)

• MCP_PORT: --http 사용 시 HTTP 포트 (선택 사항)

로컬 개발

1. 이 프로젝트를 복제하고 빌드합니다:

git clone https://github.com/resend/resend-mcp.git
pnpm install
pnpm run build

2. 로컬 빌드를 사용하려면 npx 명령을 로컬 빌드 경로로 대체하세요:

Claude Code (stdio):

claude mcp add resend -e RESEND_API_KEY=re_xxxxxxxxx -- node ABSOLUTE_PATH_TO_PROJECT/dist/index.js

Claude Code (HTTP):

claude mcp add resend --transport http http://127.0.0.1:3000/mcp --header "Authorization: Bearer re_xxxxxxxxx"

Cursor / Claude Desktop (stdio):

{
  "mcpServers": {
    "resend": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_PROJECT/dist/index.js"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxx"
      }
    }
  }
}

Cursor (HTTP):

{
  "mcpServers": {
    "resend": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": {
        "Authorization": "Bearer re_xxxxxxxxx"
      }
    }
  }
}

MCP 클라이언트로 실시간 테스트

개발 중에는 코드를 편집하는 동안 다른 MCP 클라이언트 세션에서 변경 사항을 테스트할 수 있습니다.

방법: tsc --watch를 실행하여 dist/를 지속적으로 다시 빌드하고, 별도의 MCP 클라이언트가 다른 디렉토리의 빌드된 dist/index.js를 가리키도록 합니다. 코드 변경 사항을 적용하려면 MCP 클라이언트 세션을 다시 시작하세요(MCP 서버는 핫 리로드가 되지 않는 장기 실행 stdio 프로세스입니다).

Claude Code 예시:

1. 저장 시 자동 재빌드되도록 TypeScript 감시자를 실행합니다:

   pnpm tsc --watch

2. 별도의 디렉토리에 빌드 출력을 가리키는 .mcp.json을 생성합니다:

   mkdir -p /tmp/mcp-test

   // /tmp/mcp-test/.mcp.json
   {
     "mcpServers": {
       "resend-dev": {
         "command": "node",
         "args": ["/absolute/path/to/resend-mcp/dist/index.js"],
         "env": {
           "RESEND_API_KEY": "re_xxxxxxxxx"
         }
       }
     }
   }

3. 해당 디렉토리에서 Claude Code를 시작하고 MCP 도구를 사용합니다. 코드 변경 후에는 새 빌드를 적용하기 위해 Claude Code 세션을 새로 시작하세요.

동일한 원리가 모든 MCP 클라이언트에 적용됩니다. 테스트 환경과 개발 환경을 분리하고, dist/index.js에 대한 절대 경로를 사용하며, 재빌드 후 MCP 서버를 다시 연결하세요.

MCP Inspector로 테스트

참고: 먼저 프로젝트를 빌드했는지 확인하세요(위의 로컬 개발 섹션 참조).

Stdio 전송 사용

1. API 키를 설정합니다:

   export RESEND_API_KEY=re_your_key_here

2. 인스펙터를 시작합니다:

   pnpm inspector

3. 브라우저(인스펙터 UI)에서:

   • stdio를 선택합니다(프로세스 시작).

   • Command: node

   • Args: dist/index.js (또는 dist/index.js의 전체 경로)

   • Env: RESEND_API_KEY=re_your_key_here (또는 동일한 터미널에서 이미 내보낸 경우 비워둠).

   • Connect를 클릭한 다음 "List tools"를 사용하여 서버가 작동하는지 확인합니다.

HTTP 전송 사용

1. 한 터미널에서 HTTP 서버를 시작합니다:

   node dist/index.js --http --port 3000

2. 다른 터미널에서 인스펙터를 시작합니다:

   pnpm inspector

3. 브라우저(인스펙터 UI)에서:

   • Streamable HTTP를 선택합니다(URL에 연결).

   • URL: http://127.0.0.1:3000/mcp

   • 사용자 지정 헤더 추가: Authorization: Bearer re_your_key_here 및 토글 활성화.

   • Connect를 클릭한 다음 "List tools"를 사용하여 서버가 작동하는지 확인합니다.