Resend Email

공식

에디터에서 Resend API를 사용하여 이메일을 직접 보냅니다.

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

  • 이메일 전송 및 예약 — 어시스턴트에게 참조/숨은 참조, 회신 주소, 첨부 파일, 태그, 예약 전송을 포함한 HTML 또는 일반 텍스트 이메일을 보내도록 요청하세요.
  • 연락처 및 세그먼트 관리 — 연락처를 생성, 업데이트, 삭제하고 세그먼트 멤버십과 주제 구독을 관리하며 CSV 가져오기를 실행하세요.
  • 브로드캐스트 캠페인 실행 — 브로드캐스트를 생성, 예약, 전송 또는 취소한 다음 이벤트 유형과 클릭한 링크별로 수신자를 검토하세요.
  • 수신 이메일 및 받은 편지함 처리 — 수신한 이메일을 나열하고 읽으며 첨부 파일을 다운로드하고 받은 편지함의 스레드, 라벨, 임시 보관함을 관리하세요.
  • 도메인 및 수신 거부 관리 — 발신자 도메인을 생성, 확인, 구성하고 수신 거부 목록 항목을 추가하거나 삭제하세요.
  • 로그 및 사용량 확인 — 전체 요청 및 응답 본문이 포함된 API 요청 로그를 검토하고 계정 사용량과 할당량을 확인하세요.

호스팅형 MCP 서버

npx add-mcp 'https://mcp.resend.com/mcp'

Claude Code, Codex, Cursor 등에 설치됩니다

문서

Resend MCP Server

npm version

AI 에이전트를 Resend 플랫폼에 연결하세요. Claude, Cursor, Claude Code와 같은 MCP 클라이언트에서 직접 이메일을 보내고 받고, 연락처, 브로드캐스트, 도메인 등을 관리할 수 있습니다.

Resend에서 호스팅하는 원격 MCP 서버와 로컬 MCP 서버(이 패키지)를 모두 제공합니다.

원격 MCP 서버

Resend는 다음 주소에서 MCP 서버를 호스팅합니다.

https://mcp.resend.com/mcp

원격 서버(Streamable HTTP)를 지원하는 MCP 클라이언트를 연결하세요. 설치하거나 로컬 프로세스를 실행할 필요가 없으므로 Claude와 호스팅 에이전트 플랫폼 같은 웹 기반 클라이언트에 가장 적합합니다.

연결하면 클라이언트가 브라우저 창을 열어 Resend에 로그인하고 OAuth를 사용해 액세스를 승인합니다.

Claude Code

claude mcp add --transport http resend https://mcp.resend.com/mcp

그런 다음 Claude Code에서 /mcp을 실행하고 resend를 선택해 OAuth 로그인을 완료하세요.

Claude

Claude(웹 또는 데스크톱)에서 Settings > Connectors > Add custom connector를 열고 다음을 입력하세요.

https://mcp.resend.com/mcp

Cursor

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

{
  "mcpServers": {
    "resend": {
      "url": "https://mcp.resend.com/mcp"
    }
  }
}

Codex

codex mcp add resend --url https://mcp.resend.com/mcp

Copilot

VS Code에서 GitHub Copilot을 사용하려면 다음을 settings.json에 추가하세요.

{
  "mcp": {
    "servers": {
      "resend": {
        "type": "http",
        "url": "https://mcp.resend.com/mcp"
      }
    }
  }
}

Windsurf

{
  "mcpServers": {
    "resend": {
      "serverUrl": "https://mcp.resend.com/mcp"
    }
  }
}

Warp

Warp의 Settings에서 Agents > MCP servers로 이동한 다음 +Add를 클릭해 새 서버를 추가하세요.

{
  "resend": {
    "serverUrl": "https://mcp.resend.com/mcp"
  }
}

API 키로 인증하기

클라이언트가 브라우저 로그인을 사용할 수 없는 환경(서버, CI 또는 헤드리스 에이전트)에서 실행되는 경우 OAuth 대신 Resend API 키를 Bearer 토큰으로 전달하세요.

Claude Code:

claude mcp add --transport http resend https://mcp.resend.com/mcp --header "Authorization: Bearer re_xxxxxxxxx"

JSON config(Cursor, Windsurf 등)에서는 Authorization 헤더를 추가하세요.

{
  "mcpServers": {
    "resend": {
      "url": "https://mcp.resend.com/mcp",
      "headers": {
        "Authorization": "Bearer re_xxxxxxxxx"
      }
    }
  }
}

로컬 MCP 서버

호스팅 서버는 NPM에서 resend-mcp로 제공되는 것과 동일한 오픈 소스 코드를 실행합니다. 서버를 직접 실행하려면 npx를 사용해 지원되는 MCP 클라이언트에 통합할 수 있습니다. 다음이 필요합니다.

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

아래에서 원하는 모드와 클라이언트를 선택해 시작하세요. re_xxxxxxxxx를 실제 API 키로 바꾸세요.

Stdio 전송(기본값)

빠른 설정

감지되거나 선택된 모든 에이전트와 편집기에 설치합니다.

npx add-mcp resend-mcp --name resend --env "RESEND_API_KEY=re_xxxxxxxxx"

Claude Code

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

Codex

codex mcp add resend \
  --env 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"
      }
    }
  }
}

Copilot

VS Code에서 GitHub Copilot을 사용하려면 다음을 settings.json에 추가하세요.

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

Gemini CLI

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

OpenCode

opencode.json config에 다음을 추가하세요.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "resend": {
      "type": "local",
      "command": ["npx", "-y", "resend-mcp"],
      "enabled": true,
      "environment": {
        "RESEND_API_KEY": "re_xxxxxxxxx"
      }
    }
  }
}

Windsurf

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

Devin

Devin에서 Settings > Connections > MCP Servers를 열고 Add a custom MCP를 클릭하세요. 전체 단계별 안내는 Devin 가이드를 참조하세요.

{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-mcp"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxx",
        "SENDER_EMAIL_ADDRESS": "onboarding@resend.dev"
      }
    }
  }
}

HTTP 전송

Resend의 호스팅 원격 MCP 서버를 사용하는 대신, 자체 터널이나 리버스 프록시 뒤에서 실행하는 경우처럼 원격 또는 웹 기반 통합을 위해 서버를 HTTP로 실행하세요. HTTP 모드에서는 각 클라이언트가 Authorization 헤더에 Resend API 키를 Bearer 토큰으로 전달해 인증합니다.

서버를 시작하세요.

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

서버는 http://127.0.0.1:3000에서 수신 대기하고 Streamable HTTP를 사용해 /mcp에 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

라이브러리로 사용하기

HTTP 전송은 CLI로 실행하는 대신 다른 서비스에 임베드할 수 있도록 내보내기도 합니다. 연결하는 각 클라이언트는 자체 Resend API 키를 Bearer 토큰으로 전달해 인증합니다.

import { runHttp } from 'resend-mcp/http';

// Options are optional — pass `senderEmailAddress` / `replierEmailAddresses`
// to set defaults. Binds the port and returns the Node http.Server, exposing
// the MCP endpoint at POST/GET/DELETE /mcp and a GET /health check.
const server = await runHttp({}, 3000);

기본적으로 서버는 localhost 전용 Host 검증(DNS 리바인딩 보호)을 적용합니다. 서버가 요청별 Bearer API 키로 보호되는 리버스 프록시나 로드 밸런서 뒤에 배포되는 경우, 프록시가 전달하는 Host와 로드 밸런서 상태 확인이 403 Invalid Host으로 거부되지 않도록 host을 0.0.0.0로 설정하세요.

const server = await runHttp({}, 3000, { host: '0.0.0.0' });
// or pin specific hostnames instead of disabling validation:
const server = await runHttp({}, 3000, { allowedHosts: ['mcp.example.com'] });

CLI에서는 --host / --allowed-hosts(또는 MCP_HOST / MCP_ALLOWED_HOSTS)에 해당합니다.

옵션

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

  • --key: Resend API 키(HTTP 모드는 클라이언트의 Bearer 토큰을 사용하므로 stdio 모드에서만 사용)
  • --sender: 확인된 도메인의 기본 발신자 이메일 주소
  • --reply-to: 기본 회신 주소(여러 번 지정 가능)
  • --http: stdio 대신 HTTP 전송 사용(기본값: stdio)
  • --port: --http 사용 시 HTTP 포트(기본값: 3000 또는 MCP_PORT env var)
  • --host: --http 사용 시 DNS 리바인딩 보호를 위한 호스트(기본값: 127.0.0.1 또는 MCP_HOST). 프록시/로드 밸런서 뒤에서 Host 검증을 비활성화하려면 0.0.0.0로 설정하세요.
  • --allowed-hosts: --http(또는 MCP_ALLOWED_HOSTS) 사용 시 쉼표로 구분된 Host 허용 목록
  • --allowed-file-dirs: 로컬 파일 첨부 및 CSV 가져오기를 읽을 수 있는 디렉터리(쉼표로 구분, 또는 MCP_ALLOWED_FILE_DIRS). 설정하지 않으면 stdio에서는 제한이 없으며, --http에서는 설정하지 않는 한 항상 비활성화됩니다.

환경 변수:

  • RESEND_API_KEY: Resend API 키(stdio에서는 필수, HTTP에서는 클라이언트가 Bearer 토큰으로 전달하므로 선택 사항)
  • SENDER_EMAIL_ADDRESS: 확인된 도메인의 기본 발신자 이메일 주소(선택 사항)
  • REPLY_TO_EMAIL_ADDRESSES: 쉼표로 구분된 회신 주소(선택 사항)
  • MCP_PORT: --http 사용 시 HTTP 포트(선택 사항)
  • MCP_HOST: --http 사용 시 DNS 리바인딩 보호를 위한 호스트(선택 사항)
  • MCP_ALLOWED_HOSTS: --http 사용 시 쉼표로 구분된 Host 허용 목록(선택 사항)
  • MCP_ALLOWED_FILE_DIRS: 로컬 파일을 읽을 수 있는 디렉터리(쉼표로 구분, 선택 사항)

[!NOTE] 발신자 이메일 주소를 제공하지 않으면 MCP 서버가 도구를 호출할 때마다 주소를 입력하라고 요청합니다.

[!WARNING] send-email (attachments[].filePath) 및 create-contact-import (filePath)는 로컬 파일을 읽습니다. --http에서는 원격 클라이언트가 서버 디스크를 읽지 못하도록 기본적으로 비활성화되어 있습니다. 특정 디렉터리에 대해 사용하려면 --allowed-file-dirs을 사용하세요. stdio에서는 프롬프트 인젝션을 받은 에이전트가 선택한 폴더 밖의 파일을 첨부하지 못하도록 --allowed-file-dirs을 설정하세요.

MCP 서버 도구

Resend의 MCP 서버는 단일 통합을 통해 AI 에이전트에 전체 Resend 플랫폼에 대한 기본 액세스를 제공합니다. 자연어를 사용해 이메일 인프라의 모든 측면을 관리할 수 있습니다.

  • 이메일: 이메일 보내기, 목록 조회, 가져오기, 취소, 업데이트, 공유 및 일괄 전송. 전달 및 참여 지표를 가져옵니다. HTML, 일반 텍스트, 첨부 파일(로컬 파일, URL 또는 base64), CC/BCC, 회신 주소, 예약 전송, 태그, 사용자 지정 헤더, 주제 기반 전송 및 멱등성 키를 지원합니다.
  • 수신 이메일: 수신 이메일을 목록으로 조회하고 읽습니다. 수신 이메일 첨부 파일을 목록으로 조회하고 다운로드합니다.
  • 받은 편지함: 받은 편지함을 만들고, 목록 조회하고, 가져오고, 업데이트하고, 제거합니다. 받은 편지함 에이전트 설정을 읽고 업데이트합니다. 스레드를 목록 조회하고, 검색하고, 가져오고, 업데이트하고, 제거하며 라벨을 추가, 설정 또는 제거합니다. 스레드 이메일을 목록 조회하고 가져오며, 첨부 파일과 사용자 지정 헤더를 포함해 답장하거나 전달합니다. 라벨을 만들고, 목록 조회하고, 업데이트하고, 제거합니다. 초안을 만들고, 목록 조회하고, 가져오고, 업데이트하고, 제거하고, 전송합니다. 첨부 파일은 base64 콘텐츠 또는 URL을 사용할 수 있습니다. 받은 편지함에서 새 이메일을 보내 스레드를 시작합니다. 답장, 전달, 초안 만들기, 초안 전송 및 새 이메일 전송 시 멱등성 키를 지원합니다.
  • 템플릿: 이메일 템플릿을 만들고, 목록 조회하고, 가져오고, 업데이트하고, 게시하고, 복제하고, 제거합니다. 템플릿 콘텐츠 작성과 {{{VARIABLE}}} 자리 표시자를 지원합니다.
  • 연락처: 연락처를 만들고, 목록 조회하고, 가져오고, 업데이트하고, 제거합니다. 세그먼트 멤버십, 주제 구독 및 CSV 연락처 가져오기를 관리합니다. 사용자 지정 연락처 속성을 지원합니다.
  • 브로드캐스트: 브로드캐스트 캠페인을 만들고, 전송하고, 취소하고, 복제하고, 목록 조회하고, 가져오고, 업데이트하고, 제거합니다. 브로드캐스트에서 클릭된 링크와 이벤트 유형별 수신자(전송됨, 전달됨, 열림, 클릭됨, 반송됨, 불만 제기, 구독 취소, 억제됨)를 목록으로 조회합니다. 예약 전송, 개인화 자리 표시자 및 미리보기 텍스트를 지원합니다.
  • 자동화: 자동화를 만들고, 목록 조회하고, 가져오고, 업데이트하고, 복제하고, 제거합니다. 자동화 실행 내역을 확인합니다.
  • 이벤트: 연락처의 자동화를 트리거하는 이벤트를 전송합니다. 이벤트 정의를 만들고, 업데이트하고, 제거합니다.
  • 도메인: 발신 도메인을 만들고, 목록 조회하고, 가져오고, 업데이트하고, 제거하고, 확인합니다. 추적, TLS, 전송 및 수신 기능을 구성합니다. 도메인 클레임을 만들고 확인합니다.
  • 세그먼트: 대상 세그먼트를 만들고, 목록 조회하고, 가져오고, 업데이트하고, 제거합니다.
  • 억제 목록: 억제 목록 항목을 개별 또는 일괄로 목록 조회하고, 가져오고, 추가하고, 제거합니다. 하드 바운스와 스팸 불만은 자동으로 억제됩니다. 연락 금지 요청을 준수하려면 주소를 수동으로 추가하세요.
  • 주제: 구독 주제를 만들고, 목록 조회하고, 가져오고, 업데이트하고, 제거합니다.
  • 연락처 속성: 사용자 지정 연락처 속성을 만들고, 목록 조회하고, 가져오고, 업데이트하고, 제거합니다.
  • API 키: API 키를 만들고, 목록 조회하고, 업데이트하고, 제거합니다.
  • 웹훅: 이벤트 알림용 웹훅을 만들고, 목록 조회하고, 가져오고, 업데이트하고, 제거하며 전달 기록을 확인합니다. 전달 기록에는 웹훅으로 전송된 이벤트, 이벤트 페이로드, 전달 시도가 포함됩니다. 이벤트를 재생해 추가 전달을 대기열에 넣고 웹훅 서명 비밀을 교체합니다.
  • 로그: 전체 요청 및 응답 본문을 포함해 API 요청 로그를 목록 조회하고 확인합니다.
  • 사용량: 이메일, 연락처, 세그먼트, 브로드캐스트, AI 크레딧, 자동화 실행, 도메인 및 API 속도 제한 등 계정 수준의 사용량과 할당량 정보를 가져옵니다.
  • 편집기: Resend 대시보드의 시각적 편집기에 연결하거나 연결을 해제하고, 브로드캐스트와 템플릿을 공동 작업하는 동안 초안 콘텐츠를 읽습니다.

로컬 개발

  1. 이 프로젝트를 복제하고 빌드합니다.
git clone https://github.com/resend/resend-mcp.git
pnpm install
pnpm run build
  1. 로컬 빌드를 사용하려면 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"를 사용해 서버가 작동하는지 확인합니다.