3단계로 빠르게 시작하기
- 1
에이전트에 서버 추가
https://merge.email/mcp를 커스텀 커넥터(ChatGPT, Claude.ai) 또는 원격 MCP 서버(Claude Code, Cursor)로 붙여넣으세요. 별도의 API 키를 생성할 필요가 없습니다. 서버는 동적 클라이언트 등록이 포함된 OAuth 2.1을 사용합니다.
- 2
Google로 로그인
에이전트가 Google 로그인 페이지를 엽니다. 한 번만 승인하면 Mail Merge가 에이전트 전용 토큰을 발급하며, 설정에서 언제든지 취소할 수 있습니다.
- 3
필요한 작업 요청
예: "내일 오전 9시에 '투자자' 시트에 있는 모든 사람에게 뉴스레터 템플릿을 보내줘." 에이전트가 시트를 읽고 머지 결과를 미리 보여주며, 발송 전 확인을 요청합니다.
이미 사용 중인 MCP 클라이언트와 호환
OAuth를 지원하는 Streamable HTTP MCP 방식의 모든 클라이언트를 연결할 수 있습니다. 주요 클라이언트에서 URL을 입력하는 위치는 다음과 같습니다.
Claude.ai 및 Claude Desktop
설정(Settings), 커넥터(Connectors), 커스텀 커넥터 추가(Add custom connector)로 이동합니다. 서버 URL을 붙여넣고 Claude가 요청할 때 Google 로그인을 완료하세요.
Claude Code
터미널에서 다음 명령어를 입력한 후 /mcp를 통해 인증하세요:
claude mcp add --transport http mailmerge https://merge.email/mcpChatGPT
설정(Settings), 커넥터(Connectors, 개발자 모드), 생성(Create)으로 이동합니다. 서버 URL을 입력하고 인증 방식으로 OAuth를 선택한 뒤 Google로 로그인하세요.
Cursor
.cursor/mcp.json에 서버를 추가한 후 MCP 패널에서 로그인을 승인하세요:
{ "mcpServers": { "mailmerge": { "url": "https://merge.email/mcp" } } }기타 MCP 클라이언트
https://merge.email/mcp를 가리키도록 설정하세요. 검색 문서는 /.well-known/oauth-authorization-server 및 /.well-known/oauth-protected-resource에 있으며, 서버 카드는 /.well-known/mcp/server-card.json에 있습니다.
웹 앱의 모든 기능을 도구로 활용
서버는 도메인별로 그룹화된 전체 Mail Merge 기능 세트를 제공합니다. 에이전트가 사용자의 요청에 따라 적절한 도구를 선택합니다.
계정 및 결제
플랜, 할당량, 구독 및 팀 시트 관리.
예시
get_accountget_subscriptionassign_team_seat
Google Sheets
스프레드시트를 탐색하고 캠페인에 병합할 행을 읽어옵니다.
예시
list_spreadsheetslist_sheetsread_sheet
템플릿
템플릿 생성, 편집, 복제, 생성 또는 Google Docs 가져오기.
예시
create_templategenerate_templateimport_google_doc
연락처
연락처 추가, 가져오기, 차단 및 목록 구성.
예시
import_contactsblock_contactscreate_contact_list
캠페인
팔로우업 및 자동 조종(Autopilot) 기능을 포함하여 캠페인 발송, 예약, 일시 중지, 재개, 중단 및 재예약.
예시
send_campaignreschedule_campaignupdate_autopilot
분석
이메일 열람, 클릭, 답장 및 계정 활동 피드 확인.
예시
get_analyticsget_activityget_account_events
이메일 웜업
웜업 시작, 일시 중지, 설정 조정 및 발신자 평판 확인.
예시
enable_warmupupdate_warmup_settingscheck_email_reputation
설정
이메일 발송 간격 조정.
예시
set_throttle
모든 플랜에서 사용 가능
Free, Personal, Professional 계정 모두 에이전트를 연결할 수 있습니다. 에이전트는 사용자의 플랜이 웹 앱에서 허용하는 범위 내에서 작업을 수행합니다. 자동 조종, 팔로우업, 이메일 웜업과 같은 프리미엄 전용 작업의 경우, 실패 대신 업그레이드 링크를 제공하여 에이전트가 사용자에게 필요한 기능을 안내할 수 있도록 합니다.
자주 묻는 질문
AI 에이전트를 Gmail에 연결해도 안전한가요?
네. 서버는 PKCE가 포함된 OAuth 2.1을 사용합니다. 사용자는 Google의 공식 페이지에서 로그인하며, 에이전트는 비밀번호를 절대 볼 수 없습니다. Mail Merge는 에이전트에게 Mail Merge 계정으로 제한된 토큰을 발급하며, 웹 앱 설정에서 언제든지 취소할 수 있습니다.
에이전트가 확인 없이 이메일을 보낼 수 있나요?
아니요. 캠페인은 send_campaign을 통해 발송되며, 서버는 에이전트에게 수신자와 병합된 미리보기를 먼저 보여주도록 요청합니다. Claude와 ChatGPT에서 발송 도구는 실행 전 확인 메시지를 트리거하므로, 사용자가 승인하기 전까지는 Gmail에서 아무것도 발송되지 않습니다.
어떤 플랜이 필요한가요?
모든 플랜에서 가능합니다. Free, Personal, Professional 계정 모두 에이전트를 연결할 수 있습니다. 에이전트는 웹 앱에서 사용자의 플랜이 제공하는 기능을 그대로 수행하며, 프리미엄 전용 도구는 오류 대신 업그레이드 링크를 반환합니다.
Google Sheets와 함께 사용할 수 있나요?
네. 에이전트는 스프레드시트 목록을 불러오고 시트를 읽어 캠페인의 수신자 소스로 사용할 수 있습니다. Mail Merge 상태 열은 평소처럼 시트에 표시되므로, 에이전트뿐만 아니라 Google Sheets에서도 캠페인 진행 상황을 확인할 수 있습니다.
Mail Merge 연락처와 목록을 사용할 수 있나요?
네. 연락처, 연락처 목록, 차단 목록 및 수신 거부자 정보를 모두 사용할 수 있습니다. 에이전트는 연락처 추가/가져오기, 목록 생성 및 캠페인 발송이 가능하며, 차단되거나 수신 거부된 연락처는 웹 앱과 동일하게 자동으로 제외됩니다.
MCP 서버 사용 시 추가 비용이 발생하나요?
아니요. 서버는 Free 플랜을 포함한 모든 플랜에 포함되어 있습니다. 기존 발송 할당량과 플랜 기능이 그대로 적용되며, 에이전트 연결에 대한 별도의 추가 요금은 없습니다.