연결 가이드

내 이메일을 Claude Code(터미널과 IDE)에 연결하기

업데이트 2026년 10월 22일

Claude Code와 Mailopoly: 세 단계면 Claude Code가 내 이메일을, 내가 가진 모든 계정을 함께 검색하고 이미 정리된 채로, 내가 정한 권한 아래에서 받아요. claude mcp add --transport http mailopoly https://fastapi.prod.aws.mailopoly.com/mcp-server/를 실행하고, /mcp를 입력해 로그인하고, 읽기·변경·보내기에 체크하면, Claude Code가 Gmail, Outlook, Yahoo, iCloud, 모든 IMAP 메일함을 오가며 검색하고, 초안을 쓰고, 보낼 수 있어요. 요금제에 비즈니스 채널을 추가하면 Slack, Teams, WhatsApp까지요. Google Cloud 프로젝트도, 로컬 서버도, 설정 파일 속 비밀번호도 없어요. 탭 한 번으로 취소할 수 있어요.

무료 체험 시작하기

7일 무료 체험, 신용카드 필요 없음.

이 페이지는 Anthropic의 터미널·IDE 에이전트인 Claude Code에 대한 거예요. claude-code나 claude cli라고 쓰는 사람도 있어요. claude.ai, 데스크톱, 모바일의 Claude 앱은 내 이메일을 Claude에 연결하기에 따로 가이드가 있고, Cowork는 같은 등록을 써요.

Mailopoly 없이도 Claude Code가 Gmail을 지원하나요?

일부만요. claude.ai 계정으로 Claude Code에 로그인하면, claude.ai에서 추가한 커넥터(Gmail, 회사·학교 계정용 Microsoft 365)를 Claude Code 안에서도 쓸 수 있어요. Gmail 커넥터는 Pro, Max, Team, Enterprise 요금제에 있고, Google 계정 하나에 닿으며, Anthropic 자체 문서에 따르면 *읽고 검색만 하고, 메시지를 만들거나 보내거나 수정할 수 없어요*. claude mcp add로는 추가할 수 없고(Anthropic이 호스팅하고 로컬 OAuth를 지원하지 않아요), Claude Code를 API 키, Bedrock, Vertex로 돌릴 때는 아예 쓸 수 없어요.

Mailopoly는 API 키나 Bedrock을 포함해 모든 Claude Code 환경에서 작동하는 길이고, 커넥터가 다루지 못하는 것을 다 다뤄요. Outlook.com과 Hotmail, Yahoo, iCloud, IMAP, 질문 하나로 여러 Gmail 계정, 초안 작성과 보내기, 그리고 Cleanbox로 이미 걸러지고 청구서, 일정, 배송 정보가 추출된 채 도착하는 메일까지요. 읽기, 변경, 보내기는 별도 허용이에요.

시작하기 전에

Claude Code, 설치하고 로그인까지 마친 상태. 이 가이드는 그 이후의 일을 다뤄요.
Mailopoly 계정 — 여기서 시작하세요, 7일 무료 체험, 신용카드 필요 없음.
에이전트가 볼 수 있게 하려는 메일함을 Mailopoly에 연결해 둔 상태. Gmail과 Outlook은 Google 또는 Microsoft 로그인으로 연결하고, Yahoo, iCloud, AOL, IMAP 메일함은 채팅이나 설정 파일이 아니라 Mailopoly 자체 페이지에 입력하는 앱 비밀번호를 써요. 서비스별 정확한 방법은 연결 가이드에 있어요.

세 단계로 내 이메일에 Claude Code 연결하기

1 메일함을 Mailopoly에 연결하기

mailopoly.com/sign-up에서 Mailopoly 계정을 만드세요 — 7일 무료 체험, 신용카드 필요 없음.
Claude Code에서 닿게 하고 싶은 메일함을 하나씩 연결하세요. Gmail과 Outlook은 Google 또는 Microsoft 로그인으로, 나머지는 서비스의 보안 설정에서 받은 앱 비밀번호로요. 계정마다 같은 받은편지함에 한 줄씩 들어와요 — Gmail, Outlook, Yahoo, iCloud, 모든 IMAP 메일함.
Claude Code에게 전용 주소를 주고 싶다면, 요금제에 포함된 @mly.life 주소 중 하나를 골라 에이전트의 연락용으로 쓰세요. 그래도 내 계정에 있는 내 주소라서, 오가는 모든 것을 볼 수 있어요.

2 Claude Code에 Mailopoly 추가하기

터미널에서 claude mcp add --transport http mailopoly https://fastapi.prod.aws.mailopoly.com/mcp-server/를 실행하세요. 모든 프로젝트에 넣으려면 --scope user를, .mcp.json으로 팀과 공유하려면 --scope project를 더하세요.
Claude Code를 시작하고 /mcp를 입력한 뒤 mailopoly와 Authenticate를 고르세요. 브라우저가 열리면 Mailopoly 계정으로 로그인하세요. (SSH로 원격 기기에 있다면 claude mcp login mailopoly --no-browser가 링크를 대신 출력해요.)
Claude Code에게 허용할 작업에 체크하세요. 검색과 요약에는 읽기, 초안, 라벨, 할 일, 알림에는 변경, 보내기는 보내길 원할 때만 체크하세요. 연결한 어느 주소에서든, 아니면 @mly.life 주소에서 보내요. 토큰은 Claude Code가 보관하고 자동으로 갱신해요.
물어보세요. What did the client send about the deadline, across all my accounts?는 어느 프로젝트에서든 돼요.

파일을 선호한다면 .mcp.json 형식은 이래요: { "mcpServers": { "mailopoly": { "type": "http", "url": "https://fastapi.prod.aws.mailopoly.com/mcp-server/" } } }. 비대화형 claude -p 실행은 OAuth 로그인을 마칠 수 없으니, 먼저 대화형 세션에서 한 번 로그인하세요.

공식 문서: Anthropic: MCP로 Claude Code를 도구에 연결하기 ↗

3 일을 맡기기

Mailopoly에 연결한 것은 무엇이든 Claude Code에서 닿을 수 있어요. 첫날 사람들이 많이 맡기는 일들이에요.

모든 계정에서 이번 분기 Stripe 청구서를 찾아서 합계를 표로 정리해 줘.
개인 주소로 집주인에게 답장 초안을 써 줘. 배관공이 화요일에 와도 된다는 내용으로, 초안함에 남겨 둬.
My Day에서 나를 기다리는 게 뭐야? 그중에 아직 열어 보지 않은 이메일은 뭐고?

Mailopoly를 통해 Claude Code에서 내 이메일로 할 수 있는 일

모든 계정을 질문 하나로 검색해요. Gmail, Outlook, Yahoo, iCloud, IMAP을 함께, 또는 계정 이름을 지정해서요. 보낸 사람, 날짜, 주제로, 아니면 본문 어딘가에 있던 어렴풋한 문구로요.
Cleanbox에서 일해요. 개인 메일이자 프로모션이 아닌 메일이 뉴스레터, 프로모션, 자동 발송 잡음과 이미 분리되어 있어서, 요약이 곧 중요한 것의 요약이에요.
원본 메시지가 아니라 요약을 읽어요. 모든 이메일이 이미 요약된 채 도착하고, 청구서, 일정, 배송 정보는 금액, 날짜, 상태와 함께 추출돼요.
My Day를 챙겨요. 모든 받은편지함에서 뽑은 할 일과 약속을 보고, 할 일과 알림을 추가하고, 완료 표시를 해요.
초안 작성과 보내기. 검토할 수 있게 Mailopoly에 임시 보관함으로 저장하거나, 보내기 권한이 있으면 대화에 맞는 연결된 주소나 @mly.life 주소로 보내요.
비용을 파악해요. 청구서를 찾아보고, 한 주의 청구서를 합산하고, 구독료가 모두 얼마인지 확인해요.
정리해요. 시키면 메일을 한꺼번에 라벨 붙이고, 분류하고, 치워요.
비즈니스 채널도요. 요금제에 추가하면 Slack, Teams, WhatsApp, Instagram, Messenger, TikTok 메시지가 같은 연결 안에 들어오고, 답장은 메시지가 도착한 채널로 나가요.

그래도 에이전트에게 내 이메일 계정을 줘도 될까요?

흔히 보이는 경고가 맞는 점이 하나 있어요. 내가 통제하지 못하는 기기에서 에이전트가 내 비밀번호로 내 Gmail에 로그인하는 건 나쁜 생각이에요. Mailopoly는 그렇게 동작하지 않아요. Google과 Microsoft 계정은 각 서비스의 로그인으로 Mailopoly에 연결되고, 다른 서비스는 Mailopoly 페이지에 입력하는 앱 비밀번호로 연결돼요. Claude Code 쪽에서는 비밀번호를 손에 쥘 일이 없고, 내 서비스에 로그인조차 하지 않아요.

Claude Code에서는 범위가 정해진 OAuth 로그인으로 Mailopoly에 연결해요. 읽기, 변경, 보내기는 각각 별도 허용이고, 보내기는 프로토콜 자체에서 먼저 확인을 받는 동작으로 표시돼요. 모든 도구 호출은 내 계정에 감사 기록으로 남고, Mailopoly 앱의 설정 → 보안 → 연결된 AI 어시스턴트에서 Claude Code 연결을 취소할 수 있어요. 접근은 즉시 끝나요. Mailopoly는 TAC Security로부터 CASA Tier 2 기준의 독립적인 보안 평가를 받았어요. 선을 확실히 긋고 싶다면 Claude Code에게 읽기만 허용하거나, 보내기용으로 @mly.life 주소 하나를 주세요. 그러면 내가 말하지 않는 한 아무것도 내 이름으로 나가지 않아요. AI에 이메일 접근을 허용해도 안전한지와 보안 페이지에서 더 알아보세요.

Claude Code에서 자주 생기는 문제와 해결법

`/mcp`가 매번 서버에 인증이 필요하다고 해요. 브라우저에서 로그인이 끝나지 않은 거예요. /mcp를 다시 실행해서 절차를 마치세요. 화면이 없는 기기에서는 claude mcp login mailopoly --no-browser를 쓰세요.
Team이나 Enterprise에서는 관리자만 서버를 추가할 수 있어요. 관리자에게 user나 project 범위로 Mailopoly를 추가해 달라고 요청하세요. 조직이 프로젝트 서버를 허용한다면 .mcp.json에 추가해도 돼요.
프롬프트를 줄 때만 메일을 읽어요. Claude Code는 한 턴 안에서 움직여요. Mailopoly가 Claude Code에게 *메시지를 보내고*, 긴 작업이 끝나면 Claude Code가 휴대폰으로 나에게 메시지를 보내게 하려면 Claude Code 에이전트 가이드를 보세요.
연결은 됐는데 도구가 답하지 않아요. Mailopoly의 도구는 구독이나 체험이 활성 상태일 때 응답해요. 체험이 끝났다면 연결은 남아 있지만, 요금제가 다시 활성화될 때까지 호출해도 쓸 만한 결과가 나오지 않아요.
읽기는 되는데 초안 작성이나 보내기는 안 돼요. 별도 권한이라서 그래요. Claude Code에서 다시 로그인하고 변경이나 보내기에 체크하세요. 또는 Mailopoly의 설정 → 보안 → 연결된 AI 어시스턴트에서 어떤 권한이 있는지 확인하세요.

무료 체험 시작하기

7일 무료 체험, 신용카드 필요 없음. 메일함을 연결하고, 1분이면 Claude Code에 Mailopoly를 추가할 수 있어요.

자주 묻는 질문

claude.ai의 Gmail 커넥터를 대체하나요?

Google 계정이 하나뿐이고 읽기만 하면 된다면 claude.ai Gmail 커넥터로 충분하고, claude.ai 계정으로 로그인했을 때 Claude Code 안에서도 작동해요. 계정이 둘 이상이거나, Google이 아닌 서비스를 쓰거나, Claude Code가 초안을 쓰고 보내게 하고 싶거나, 커넥터를 쓸 수 없는 API 키·Bedrock·Vertex로 Claude Code를 돌린다면 Mailopoly를 쓰세요.

Claude Code가 끝나면 알려 주거나 Codex에 일을 넘길 수 있나요?

Claude Code가 내 Gmail을 읽을 수 있나요?

Claude Code용 이메일 MCP 서버가 있나요?

Claude Code를 Gmail에 어떻게 연결하나요?

Claude Code에 내 Gmail 비밀번호가 전달되나요?

아니요. Gmail과 Outlook은 Google과 Microsoft 자체 로그인으로 Mailopoly에 연결되고, 다른 서비스는 채팅이나 설정 파일이 아니라 Mailopoly 페이지에 입력하는 앱 비밀번호로 연결돼요. Claude Code에서는 범위가 정해져 있고 취소할 수 있는 OAuth 로그인으로 Mailopoly에 연결하고, 내가 체크한 권한만 받아요. 읽기, 변경, 보내기는 각각 별도예요.

Claude Code에 전용 이메일 주소를 줄 수 있나요?

내 @mly.life 주소 중 하나로 일할 수 있어요. 모든 Mailopoly 요금제에 포함되어 있고, Single은 1개, Duo와 Pro는 2개, Unlimited는 3개예요. 에이전트가 보내는 메일은 그 주소로 나가고, 돌아오는 것(답장, 가입 확인, 인증 코드)은 내 Mailopoly 받은편지함에 도착해서, Claude Code에서도 다른 메일처럼 읽을 수 있고 나도 볼 수 있어요. 내 계정에 있는 내 주소라서, 어떤 봇도 내 이름으로 어딘가에 로그인하지 않고, 내가 못 보는 것도 없어요.