포워드 이메일 MCP 서버
요약: 우리의 오픈소스 MCP 서버는 Claude, ChatGPT, Cursor, Windsurf 같은 AI 어시스턴트가 자연어를 통해 이메일, 도메인, 별칭, 연락처, 캘린더를 관리할 수 있게 해줍니다. 68개의 모든 API 엔드포인트가 MCP 도구로 노출됩니다. npx @forwardemail/mcp-server로 로컬에서 실행되며, 자격 증명은 절대 기기를 벗어나지 않습니다.
MCP란 무엇인가?
Model Context Protocol (MCP)는 Anthropic에서 만든 오픈 표준으로, AI 모델이 외부 도구를 안전하게 호출할 수 있게 합니다. API 응답을 채팅창에 복사-붙여넣기 하는 대신, MCP는 모델에 서비스에 대한 직접적이고 구조화된 접근을 제공합니다.
우리의 MCP 서버는 전체 Forward Email API를 래핑하여 모든 엔드포인트와 매개변수를 MCP 호환 클라이언트가 사용할 수 있는 도구로 노출합니다. 서버는 stdio 전송을 사용해 로컬에서 실행되며, 자격 증명은 환경 변수에만 저장되고 AI 모델에 전송되지 않습니다.
빠른 시작
API 키 받기
- Forward Email 계정에 로그인합니다.
- 내 계정 → 보안 → API 키로 이동합니다.
- 새 API 키를 생성하고 복사합니다.
Claude Desktop
다음 내용을 Claude Desktop 구성 파일에 추가하세요:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"forwardemail": {
"command": "npx",
"args": ["-y", "@forwardemail/mcp-server"],
"env": {
"FORWARD_EMAIL_API_KEY": "your-api-key-here",
"FORWARD_EMAIL_ALIAS_USER": "you@example.com",
"FORWARD_EMAIL_ALIAS_PASSWORD": "your-generated-alias-password"
}
}
}
}
Claude Desktop을 재시작하세요. 도구 선택기에서 Forward Email 도구를 볼 수 있습니다.
참고:
FORWARD_EMAIL_ALIAS_USER및FORWARD_EMAIL_ALIAS_PASSWORD변수는 선택 사항이지만 메일박스 도구(메시지, 폴더, 연락처, 캘린더)에는 필요합니다. 자세한 내용은 인증을 참조하세요.
Cursor
Cursor 설정 → MCP → 서버 추가를 엽니다:
{
"mcpServers": {
"forwardemail": {
"command": "npx",
"args": ["-y", "@forwardemail/mcp-server"],
"env": {
"FORWARD_EMAIL_API_KEY": "your-api-key-here",
"FORWARD_EMAIL_ALIAS_USER": "you@example.com",
"FORWARD_EMAIL_ALIAS_PASSWORD": "your-generated-alias-password"
}
}
}
}
Windsurf
Windsurf 설정 → MCP → 위와 동일한 구성으로 서버를 추가하세요.
기타 MCP 클라이언트
MCP stdio 전송을 지원하는 모든 클라이언트가 작동합니다. 명령어는 다음과 같습니다:
FORWARD_EMAIL_API_KEY=your-api-key \
FORWARD_EMAIL_ALIAS_USER=you@example.com \
FORWARD_EMAIL_ALIAS_PASSWORD=your-generated-alias-password \
npx @forwardemail/mcp-server
인증
Forward Email API는 엔드포인트에 따라 두 가지 자격 증명 유형을 사용하는 HTTP 기본 인증을 사용합니다. MCP 서버가 이를 자동으로 처리하므로 올바른 자격 증명만 제공하면 됩니다.
API 키 인증
대부분의 관리 엔드포인트(도메인, 별칭, 발신 이메일, 로그)는 빈 비밀번호와 함께 Basic 인증 사용자 이름으로 API 키를 사용합니다.
이는 REST API에 사용하는 동일한 API 키입니다. FORWARD_EMAIL_API_KEY 환경 변수로 설정하세요.
별칭 인증
메일박스 엔드포인트(메시지, 폴더, 연락처, 캘린더, 별칭 범위의 sieve 스크립트)는 별칭 자격 증명을 사용합니다 — 별칭 이메일 주소를 사용자 이름으로, 생성된 비밀번호를 비밀번호로 사용합니다.
이 엔드포인트들은 IMAP, CalDAV, CardDAV 프로토콜을 통해 별칭별 데이터를 액세스합니다. API 키가 아닌 별칭 이메일과 생성된 비밀번호가 필요합니다.
별칭 자격 증명은 두 가지 방법으로 제공할 수 있습니다:
- 환경 변수 (기본 별칭에 권장):
FORWARD_EMAIL_ALIAS_USER및FORWARD_EMAIL_ALIAS_PASSWORD를 설정합니다. - 도구 호출별 매개변수: 별칭 인증 도구에
alias_username및alias_password를 인수로 전달합니다. 이는 환경 변수를 덮어쓰며, 여러 별칭을 사용할 때 유용합니다.
별칭 비밀번호 생성
별칭 인증 도구를 사용하기 전에 별칭 비밀번호를 생성해야 합니다. generateAliasPassword 도구 또는 API를 통해 생성할 수 있습니다:
curl -u "YOUR_API_KEY:" \
https://api.forwardemail.net/v1/domains/example.com/aliases/ALIAS_ID/generate-password \
-X POST
응답에는 username(별칭 이메일)과 password 필드가 포함됩니다. 이를 별칭 자격 증명으로 사용하세요.
팁: AI 어시스턴트에게도 요청할 수 있습니다: "example.com 도메인의 별칭 user@example.com에 대한 비밀번호를 생성해줘" — 그러면
generateAliasPassword도구를 호출하여 자격 증명을 반환합니다.
아래 표는 각 도구 그룹이 요구하는 인증 방법을 요약합니다:
| 도구 그룹 | 인증 방법 | 자격 증명 |
|---|---|---|
| 계정 | API 키 또는 별칭 인증 | 둘 중 하나 |
| 도메인, 별칭, 도메인 멤버, 초대, Catch-All 비밀번호 | API 키 | FORWARD_EMAIL_API_KEY |
| 발신 이메일 (목록, 조회, 삭제, 제한) | API 키 | FORWARD_EMAIL_API_KEY |
| 이메일 보내기 | API 키 또는 별칭 인증 | 둘 중 하나 |
| 메시지 (IMAP) | 별칭 인증 | FORWARD_EMAIL_ALIAS_USER + FORWARD_EMAIL_ALIAS_PASSWORD |
| 폴더 (IMAP) | 별칭 인증 | FORWARD_EMAIL_ALIAS_USER + FORWARD_EMAIL_ALIAS_PASSWORD |
| 연락처 (CardDAV) | 별칭 인증 | FORWARD_EMAIL_ALIAS_USER + FORWARD_EMAIL_ALIAS_PASSWORD |
| 캘린더 (CalDAV) | 별칭 인증 | FORWARD_EMAIL_ALIAS_USER + FORWARD_EMAIL_ALIAS_PASSWORD |
| 캘린더 이벤트 (CalDAV) | 별칭 인증 | FORWARD_EMAIL_ALIAS_USER + FORWARD_EMAIL_ALIAS_PASSWORD |
| Sieve 스크립트 (도메인 범위) | API 키 | FORWARD_EMAIL_API_KEY |
| Sieve 스크립트 (별칭 범위) | 별칭 인증 | FORWARD_EMAIL_ALIAS_USER + FORWARD_EMAIL_ALIAS_PASSWORD |
| 로그 | API 키 | FORWARD_EMAIL_API_KEY |
| 암호화 | 없음 | 자격 증명 불필요 |
모든 68개 도구
각 도구는 Forward Email API 엔드포인트에 직접 매핑됩니다. 매개변수는 API 문서와 동일한 이름을 사용합니다. 인증 방법은 각 섹션 제목에 명시되어 있습니다.
계정 (API 키 또는 별칭 인증)
API 키 인증 시, 사용자 계정 정보를 반환합니다. 별칭 인증 시, 저장 용량 및 설정을 포함한 별칭/메일박스 정보를 반환합니다.
| 도구 | API 엔드포인트 | 설명 |
|---|---|---|
getAccount |
GET /v1/account |
계정 정보를 가져옵니다 |
updateAccount |
PUT /v1/account |
계정 설정을 업데이트합니다 |
도메인 (API 키)
| 도구 | API 엔드포인트 | 설명 |
|---|---|---|
listDomains |
GET /v1/domains |
모든 도메인을 나열합니다 |
createDomain |
POST /v1/domains |
새 도메인을 추가합니다 |
getDomain |
GET /v1/domains/:domain_id |
도메인 세부 정보를 가져옵니다 |
updateDomain |
PUT /v1/domains/:domain_id |
도메인 설정을 업데이트합니다 |
deleteDomain |
DELETE /v1/domains/:domain_id |
도메인을 제거합니다 |
verifyDomainRecords |
GET /v1/domains/:domain_id/verify-records |
DNS 레코드를 검증합니다 |
verifySmtpRecords |
GET /v1/domains/:domain_id/verify-smtp |
SMTP 구성을 검증합니다 |
testS3Connection |
POST /v1/domains/:domain_id/test-s3-connection |
맞춤형 S3 저장소 연결을 테스트합니다 |
별칭 (API 키)
| 도구 | API 엔드포인트 | 설명 |
|---|---|---|
listAliases |
GET /v1/domains/:domain_id/aliases |
도메인의 별칭을 나열합니다 |
createAlias |
POST /v1/domains/:domain_id/aliases |
새 별칭을 생성합니다 |
getAlias |
GET /v1/domains/:domain_id/aliases/:alias_id |
별칭 세부 정보를 가져옵니다 |
updateAlias |
PUT /v1/domains/:domain_id/aliases/:alias_id |
별칭을 업데이트합니다 |
deleteAlias |
DELETE /v1/domains/:domain_id/aliases/:alias_id |
별칭을 삭제합니다 |
generateAliasPassword |
POST /v1/domains/:domain_id/aliases/:alias_id/generate-password |
별칭 인증용 IMAP/SMTP 비밀번호를 생성합니다 |
이메일 — 발신 SMTP (API 키; Send는 둘 다 지원)
| 도구 | API 엔드포인트 | 인증 | 설명 |
|---|---|---|---|
sendEmail |
POST /v1/emails |
API 키 또는 별칭 인증 | SMTP를 통해 이메일을 보냅니다 |
listEmails |
GET /v1/emails |
API 키 | 발신 이메일을 나열합니다 |
getEmail |
GET /v1/emails/:id |
API 키 | 이메일 세부 정보 및 상태를 가져옵니다 |
deleteEmail |
DELETE /v1/emails/:id |
API 키 | 대기 중인 이메일을 삭제합니다 |
getEmailLimit |
GET /v1/emails/limit |
API 키 | 발송 한도를 확인합니다 |
sendEmail 도구는 from, to, cc, bcc, subject, text, html, attachments를 받습니다. 이는 POST /v1/emails 엔드포인트와 동일합니다.
메시지 — IMAP (별칭 인증)
별칭 자격 증명이 필요합니다.
alias_username과alias_password를 전달하거나FORWARD_EMAIL_ALIAS_USER및FORWARD_EMAIL_ALIAS_PASSWORD환경 변수를 설정하세요. | 도구 | API 엔드포인트 | 설명 | | --------------- | ------------------------- | --------------------------------- | |listMessages|GET /v1/messages| 메일박스에서 메시지 목록 및 검색 | |createMessage|POST /v1/messages| 임시 저장 메시지 생성 또는 업로드 | |getMessage|GET /v1/messages/:id| ID로 메시지 가져오기 | |updateMessage|PUT /v1/messages/:id| 플래그 업데이트 (읽음, 별표 등) | |deleteMessage|DELETE /v1/messages/:id| 메시지 삭제 |
listMessages 도구는 subject, from, to, text, since, before, is_unread, has_attachment 등 15개 이상의 검색 매개변수를 지원합니다. 전체 목록은 API docs를 참조하세요.
폴더 — IMAP (별칭 인증)
별칭 자격 증명이 필요합니다.
alias_username과alias_password를 전달하거나FORWARD_EMAIL_ALIAS_USER및FORWARD_EMAIL_ALIAS_PASSWORD환경 변수를 설정하세요.
| 도구 | API 엔드포인트 | 설명 |
|---|---|---|
listFolders |
GET /v1/folders |
모든 메일박스 폴더 목록 |
createFolder |
POST /v1/folders |
새 폴더 생성 |
getFolder |
GET /v1/folders/:id |
폴더 세부 정보 가져오기 |
updateFolder |
PUT /v1/folders/:id |
폴더 이름 변경 |
deleteFolder |
DELETE /v1/folders/:id |
폴더 삭제 |
연락처 — CardDAV (별칭 인증)
별칭 자격 증명이 필요합니다.
alias_username과alias_password를 전달하거나FORWARD_EMAIL_ALIAS_USER및FORWARD_EMAIL_ALIAS_PASSWORD환경 변수를 설정하세요.
| 도구 | API 엔드포인트 | 설명 |
|---|---|---|
listContacts |
GET /v1/contacts |
모든 연락처 목록 |
createContact |
POST /v1/contacts |
새 연락처 생성 |
getContact |
GET /v1/contacts/:id |
연락처 세부 정보 가져오기 |
updateContact |
PUT /v1/contacts/:id |
연락처 업데이트 |
deleteContact |
DELETE /v1/contacts/:id |
연락처 삭제 |
캘린더 — CalDAV (별칭 인증)
별칭 자격 증명이 필요합니다.
alias_username과alias_password를 전달하거나FORWARD_EMAIL_ALIAS_USER및FORWARD_EMAIL_ALIAS_PASSWORD환경 변수를 설정하세요.
| 도구 | API 엔드포인트 | 설명 |
|---|---|---|
listCalendars |
GET /v1/calendars |
모든 캘린더 목록 |
createCalendar |
POST /v1/calendars |
새 캘린더 생성 |
getCalendar |
GET /v1/calendars/:id |
캘린더 세부 정보 가져오기 |
updateCalendar |
PUT /v1/calendars/:id |
캘린더 업데이트 |
deleteCalendar |
DELETE /v1/calendars/:id |
캘린더 삭제 |
캘린더 이벤트 — CalDAV (별칭 인증)
별칭 자격 증명이 필요합니다.
alias_username과alias_password를 전달하거나FORWARD_EMAIL_ALIAS_USER및FORWARD_EMAIL_ALIAS_PASSWORD환경 변수를 설정하세요.
| 도구 | API 엔드포인트 | 설명 |
|---|---|---|
listCalendarEvents |
GET /v1/calendar-events |
모든 이벤트 목록 |
createCalendarEvent |
POST /v1/calendar-events |
새 이벤트 생성 |
getCalendarEvent |
GET /v1/calendar-events/:id |
이벤트 세부 정보 가져오기 |
updateCalendarEvent |
PUT /v1/calendar-events/:id |
이벤트 업데이트 |
deleteCalendarEvent |
DELETE /v1/calendar-events/:id |
이벤트 삭제 |
Sieve 스크립트 (API 키)
이들은 도메인 범위 경로를 사용하며 API 키로 인증합니다.
| 도구 | API 엔드포인트 | 설명 |
|---|---|---|
listSieveScripts |
GET /v1/domains/:domain_id/aliases/:alias_id/sieve |
별칭에 대한 스크립트 목록 |
createSieveScript |
POST /v1/domains/:domain_id/aliases/:alias_id/sieve |
새 스크립트 생성 |
getSieveScript |
GET /v1/domains/:domain_id/aliases/:alias_id/sieve/:script_id |
스크립트 세부 정보 가져오기 |
updateSieveScript |
PUT /v1/domains/:domain_id/aliases/:alias_id/sieve/:script_id |
스크립트 업데이트 |
deleteSieveScript |
DELETE /v1/domains/:domain_id/aliases/:alias_id/sieve/:script_id |
스크립트 삭제 |
activateSieveScript |
POST /v1/domains/:domain_id/aliases/:alias_id/sieve/:script_id/activate |
스크립트 활성화 |
Sieve 스크립트 (별칭 인증)
이들은 별칭 수준 인증을 사용합니다. API 키 없이 별칭별 자동화에 유용합니다.
별칭 자격 증명 필요.
alias_username과alias_password를 전달하거나FORWARD_EMAIL_ALIAS_USER및FORWARD_EMAIL_ALIAS_PASSWORD환경 변수를 설정하세요.
| 도구 | API 엔드포인트 | 설명 |
|---|---|---|
listSieveScriptsAliasAuth |
GET /v1/sieve-scripts |
스크립트 목록 조회 |
createSieveScriptAliasAuth |
POST /v1/sieve-scripts |
스크립트 생성 |
getSieveScriptAliasAuth |
GET /v1/sieve-scripts/:script_id |
스크립트 상세 조회 |
updateSieveScriptAliasAuth |
PUT /v1/sieve-scripts/:script_id |
스크립트 업데이트 |
deleteSieveScriptAliasAuth |
DELETE /v1/sieve-scripts/:script_id |
스크립트 삭제 |
activateSieveScriptAliasAuth |
POST /v1/sieve-scripts/:script_id/activate |
스크립트 활성화 |
도메인 멤버 및 초대 (API 키)
| 도구 | API 엔드포인트 | 설명 |
|---|---|---|
updateDomainMember |
PUT /v1/domains/:domain_id/members/:member_id |
멤버 역할 변경 |
removeDomainMember |
DELETE /v1/domains/:domain_id/members/:member_id |
멤버 제거 |
acceptDomainInvite |
GET /v1/domains/:domain_id/invites |
대기 중인 초대 수락 |
createDomainInvite |
POST /v1/domains/:domain_id/invites |
도메인 초대 생성 |
removeDomainInvite |
DELETE /v1/domains/:domain_id/invites |
초대 취소 |
Catch-All 비밀번호 (API 키)
| 도구 | API 엔드포인트 | 설명 |
|---|---|---|
listCatchAllPasswords |
GET /v1/domains/:domain_id/catch-all-passwords |
Catch-all 비밀번호 목록 조회 |
createCatchAllPassword |
POST /v1/domains/:domain_id/catch-all-passwords |
Catch-all 비밀번호 생성 |
deleteCatchAllPassword |
DELETE /v1/domains/:domain_id/catch-all-passwords/:token_id |
Catch-all 비밀번호 삭제 |
로그 (API 키)
| 도구 | API 엔드포인트 | 설명 |
|---|---|---|
downloadLogs |
GET /v1/logs/download |
이메일 전달 로그 다운로드 |
암호화 (인증 없음)
| 도구 | API 엔드포인트 | 설명 |
|---|---|---|
encryptRecord |
POST /v1/encrypt |
DNS TXT 레코드 암호화 |
이 도구는 인증이 필요하지 않습니다. DNS TXT 레코드에 사용할 forward-email=user@example.com과 같은 전달 레코드를 암호화합니다.
20가지 실제 사용 사례
다음은 AI 어시스턴트와 함께 MCP 서버를 사용하는 실용적인 방법입니다:
1. 이메일 분류
AI에게 받은 편지함을 스캔하여 읽지 않은 메시지를 요약하도록 요청하세요. 긴급 이메일을 표시하고, 발신자별로 분류하며, 자연어로 답장 초안을 작성할 수 있습니다. (받은 편지함 접근을 위해 별칭 자격 증명 필요.)
2. 도메인 설정 자동화
새 도메인을 설정 중인가요? AI에게 도메인을 생성하고, 별칭을 추가하며, DNS 레코드를 확인하고, SMTP 구성을 테스트하도록 요청하세요. 보통 대시보드에서 10분 걸리는 작업이 한 번의 대화로 끝납니다.
3. 대량 별칭 관리
새 프로젝트를 위해 20개의 별칭을 만들어야 하나요? 필요한 내용을 설명하면 AI가 반복 작업을 처리합니다. 별칭 생성, 전달 규칙 설정, 비밀번호 생성까지 한 번에 할 수 있습니다.
4. 이메일 캠페인 모니터링
AI에게 발송 한도 확인, 최근 발신 이메일 목록 조회, 배달 상태 보고를 요청하세요. 트랜잭셔널 이메일 상태 모니터링에 유용합니다.
5. 연락처 동기화 및 정리
CardDAV 도구를 사용하여 모든 연락처를 나열하고, 중복을 찾고, 오래된 정보를 업데이트하거나 채팅에 붙여넣은 스프레드시트에서 연락처를 대량 생성하세요. (별칭 자격 증명 필요.)
6. 캘린더 관리
캘린더 생성, 이벤트 추가, 회의 시간 업데이트, 취소된 이벤트 삭제를 모두 대화로 처리하세요. CalDAV 도구는 캘린더와 이벤트 모두에 대해 완전한 CRUD를 지원합니다. (별칭 자격 증명 필요.)
7. Sieve 스크립트 자동화
Sieve 스크립트는 강력하지만 문법이 난해합니다. AI에게 Sieve 스크립트를 작성해 달라고 요청하세요: "모든 billing@example.com에서 온 이메일을 Billing 폴더로 필터링"은 RFC 5228 사양을 건드리지 않고도 작동하는 스크립트가 됩니다.
8. 팀 온보딩
새 팀원이 합류하면 AI에게 별칭 생성, 비밀번호 생성, 자격 증명이 포함된 환영 이메일 발송, 도메인 멤버 추가를 요청하세요. 한 번의 프롬프트로 네 번의 API 호출이 이루어집니다.
9. 보안 감사
AI에게 모든 도메인 목록, DNS 인증 상태 확인, 별칭 구성 검토, 인증되지 않은 레코드가 있는 도메인 식별을 요청하세요. 자연어로 빠른 보안 점검이 가능합니다.
10. 이메일 전달 설정
새 도메인에 이메일 전달을 설정하려면 AI에게 도메인 생성, 전달 별칭 추가, DNS 레코드 암호화, 모든 설정이 올바른지 확인을 요청하세요.
11. 받은편지함 검색 및 분석
메시지 검색 도구를 사용하여 특정 이메일을 찾으세요: "지난 30일간 john@example.com에서 온 첨부파일이 있는 모든 이메일 찾기." 15개 이상의 검색 매개변수로 강력한 검색이 가능합니다. (별칭 자격 증명 필요.)
12. 폴더 정리
AI에게 새 프로젝트용 폴더 구조 생성, 폴더 간 메시지 이동, 더 이상 필요 없는 오래된 폴더 정리를 요청하세요. (별칭 자격 증명 필요.)
13. 비밀번호 교체
일정에 따라 새 별칭 비밀번호를 생성하세요. AI에게 각 별칭에 대해 새 비밀번호를 생성하고 새 자격 증명을 보고하도록 요청하세요.
14. DNS 레코드 암호화
전달 레코드를 DNS에 추가하기 전에 암호화하세요. encryptRecord 도구는 인증 없이 이를 처리합니다 — 빠른 일회성 암호화에 유용합니다.
15. 배달 로그 분석
이메일 배달 로그를 다운로드하고 AI에게 반송률 분석, 문제 수신자 식별, 배달 시간 추적을 요청하세요.
16. 다중 도메인 관리
여러 도메인을 관리한다면 AI에게 상태 보고서를 요청하세요: 인증된 도메인, 문제 있는 도메인, 각 도메인의 별칭 수, 발송 한도 현황 등.
17. 캐치올 구성
모든 주소에서 이메일을 수신해야 하는 도메인에 대해 캐치올 비밀번호를 설정하세요. AI가 이 비밀번호를 생성, 나열, 관리할 수 있습니다.
18. 도메인 초대 관리
팀원을 도메인 관리자로 초대하고, 대기 중인 초대를 확인하며, 만료된 초대를 정리하세요. 여러 도메인 관리자가 있는 조직에 유용합니다.
19. S3 스토리지 테스트
이메일 백업용 맞춤 S3 스토리지를 사용하는 경우 AI에게 연결 테스트 및 정상 작동 여부 확인을 요청하세요.
20. 이메일 초안 작성
메일함에 이메일 초안을 생성하되 발송하지 마세요. 발송 전 검토가 필요한 이메일 준비나 이메일 템플릿 작성에 유용합니다. (별칭 자격 증명 필요.)
예제 프롬프트
AI 어시스턴트와 바로 사용할 수 있는 프롬프트 예시입니다:
이메일 발송:
"hello@mydomain.com에서 john@example.com으로 제목이 '내일 회의'이고 본문이 '안녕 John, 오후 2시에 만나는 거 맞지?'인 이메일을 보내줘" 도메인 관리:
"내 도메인 목록을 보여주고, 확인되지 않은 DNS 레코드가 있는 도메인을 알려줘."
별칭 생성:
"내 개인 이메일로 전달되는 새로운 별칭 support@mydomain.com을 만들어줘."
받은편지함 검색 (별칭 자격 증명 필요):
"지난주에 받은 읽지 않은 이메일 중 'invoice'가 언급된 모든 이메일을 찾아줘."
캘린더 (별칭 자격 증명 필요):
"'Work'라는 캘린더를 만들고, 내일 오후 2시에 'Team Standup'이라는 회의를 추가해줘."
Sieve 스크립트:
"info@mydomain.com에 대해 '문의해 주셔서 감사합니다. 24시간 내에 답변드리겠습니다.'라는 자동 회신을 하는 Sieve 스크립트를 작성해줘."
대량 작업:
"mydomain.com의 sales@, support@, billing@, info@ 별칭을 모두 team@mydomain.com으로 전달되도록 만들어줘."
보안 점검:
"내 모든 도메인의 DNS 및 SMTP 인증 상태를 확인하고, 주의가 필요한 부분이 있으면 알려줘."
별칭 비밀번호 생성:
"별칭 user@example.com의 비밀번호를 생성해서 받은편지함에 접근할 수 있게 해줘."
환경 변수
| 변수 | 필수 | 기본값 | 설명 |
|---|---|---|---|
FORWARD_EMAIL_API_KEY |
예 | — | Forward Email API 키 (API 키 엔드포인트용 Basic 인증 사용자 이름으로 사용) |
FORWARD_EMAIL_ALIAS_USER |
아니요 | — | 메일박스 엔드포인트용 별칭 이메일 주소 (예: user@example.com) |
FORWARD_EMAIL_ALIAS_PASSWORD |
아니요 | — | 메일박스 엔드포인트용 생성된 별칭 비밀번호 |
FORWARD_EMAIL_API_URL |
아니요 | https://api.forwardemail.net |
API 기본 URL (셀프 호스팅 또는 테스트용) |
보안
MCP 서버는 로컬 컴퓨터에서 실행됩니다. 보안 작동 방식은 다음과 같습니다:
- 자격 증명은 로컬에만 저장됩니다. API 키와 별칭 자격 증명은 환경 변수에서 읽혀 HTTP Basic 인증을 통해 API 요청에 사용됩니다. AI 모델로 전송되지 않습니다.
- stdio 통신. 서버는 stdin/stdout을 통해 AI 클라이언트와 통신하며, 네트워크 포트를 열지 않습니다.
- 데이터 저장 없음. 서버는 상태 비저장(stateless)이며, 이메일 데이터를 캐시, 기록, 저장하지 않습니다.
- 오픈 소스. 전체 코드베이스는 GitHub에 공개되어 있습니다. 모든 코드를 검토할 수 있습니다.
프로그래밍 방식 사용법
서버를 라이브러리로도 사용할 수 있습니다:
const { McpServer } = require('@forwardemail/mcp-server');
const server = new McpServer({
apiKey: 'your-api-key',
aliasUser: 'user@example.com',
aliasPassword: 'generated-alias-password',
});
server.listen();
오픈 소스
Forward Email MCP 서버는 BUSL-1.1 라이선스 하에 GitHub에서 오픈 소스로 제공됩니다. 우리는 투명성을 믿습니다. 버그를 발견하거나 기능 요청이 있으면 이슈를 열어주세요.