techtv-mail — pete@techtv.live를 위한 Cowork 커넥터

이것은 cPanel로 호스팅되는 pete@techtv.live 메일함을 통해 Claude(Cowork)가 이메일을 읽고 보낼 수 있게 해주는 작은 MCP 서버입니다. 이미 Microsoft 365 및 Gmail 계정과 작동하는 방식과 동일하며, Anthropic에는 일반적인 IMAP/cPanel 메일용 사전 구축 커넥터가 없기 때문에 이 사서함 전용으로 만든 것입니다.

Claude에게 네 가지 도구를 제공합니다:

• list_folders — 어떤 메일 폴더가 있는지 확인

• search_emails — 발신자, 제목, 본문 텍스트 또는 최근 수신 여부로 폴더 검색

• get_email — 한 메시지의 전체 텍스트/HTML 가져오기

• send_email — pete@techtv.live 명의로 메일 보내기

1. 항상 켜져 있는 곳에 배포하기

이 서버는 공개 인터넷에서 24/7 접근할 수 있는 작은 서버에 있어야 합니다. 로컬 컴퓨터나 Claude 세션에서는 실행할 수 없습니다. 둘 다 오프라인이 되기 때문입니다. 이 정도 규모의 작업에 가장 저렴하고 간단한 선택지는 다음과 같습니다:

• Railway (railway.app) — 무료/저렴한 요금제, zip이나 GitHub 저장소에서 바로 배포할 수 있고 PORT를 자동으로 설정해 줍니다.

• Render (render.com) — 비슷하며 소규모 서비스용 무료 티어가 있습니다. (무료 티어에서는 유휴 상태일 때 절전 모드로 들어갈 수 있어, 일정 시간이 지난 후 첫 요청에 몇 초의 지연이 발생할 수 있습니다.)

• 이미 보유하고 있는 작은 VPS — 직접 실행하고 싶다면.

어느 것을 선택하든 단계는 동일합니다:

1. 이 폴더를 업로드하거나(또는 GitHub 저장소에 푸시하고 연결합니다) 저장소를 연결합니다.

2. npm install 후에 npm start(또는 node server.js)를 실행하도록 설정합니다.

3. 아래의 환경 변수를 해당 호스트의 대시보드에서 설정합니다. 절대 실저장 자격 증명을 코드에 넣거나 저장소에 커밋하지 마세요.

4. 배포가 완료되면 호스트에서 공용 URL(예: https://techtv-mail-production.up.railway.app)을 받게 됩니다.

Related MCP server: IMAP MCP Server

2. 호스트에 설정할 환경 변수

ACCESS_TOKEN을 잘 생성하려면 Node가 있는 어떤 기계에서든 다음을 실행하거나, 40자 이상의 임의 문자를 만드는 비밀번호 생성기를 사용하면 됩니다:

node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

이 토큰은 서버 URL의 일부가 되며, 공공 인터넷과 여러분의 메일함 사이의 유일한 보호벽입니다. 따라서 비밀번호와 똑같이 취급하세요 — 길고, 임의이며, 절대 공유하지 않고, 어떤 외부 공개 장소에도 올리지 마세요.

3. Cowork에 사용자 지정 커넥터로 추가

배포가 끝난 후 Claude 앱에서:

1. Customize > Connectors(또는 채팅에서 "+" 클릭 또는 "/"를 입력하고 "Manage connectors"를 선택)로 들어갑니다.

2. **+**를 클릭해 찾아본 다음 Add custom connector를 선택합니다.

3. 서버 URL에 다음을 입력합니다:

   https://<your-host-domain>/mcp/<ACCESS_TOKEN>

   (두 정보 모두 배포에서 얻습니다 — 호스트가 제공한 도메인과, 환경 변수로 설정한 토큰입니다.)

4. OAuth Client ID/Secret 필드는 공란으로 두세요 — 이 서버는 OAuth를 사용하지 않으며, URL에 포함된 토큰이 접근 제어 수단입니다.

5. Save/Connect 클릭합니다. 이 커넥터가 채팅에서 활성화되어 있을 때마다 Claude는 이제 list_folders, search_emails, get_email 및 send_email을 사용 가능한 도구로서 나열니다.

보안 메모

• 메일함 비밀번호는 오직 호스트의 환경 변수에만 존재합니다 — 코드에 절대 들어 있지 않으며, Claude와의 채팅에도 절대 입력되지 않습니다.

• 완전한 커넥터 URL(토큰 포함)을 손에 넣은 사람은 이 도구들을 해당 프로젝트를 위해 사용할 수 있습니다. 따라서 그 URL을 절대 공개된 장소(공유 문서, 공개 저장소, 다른 사람이 볼 수 있는 슬주 채널)에는 붙여넣지 마세요.

• URL이 유출된 것으로 의심되면, 새 ACCESS_TOKEN을 생성하고 호스트에 업데이트한 후 Cowork의 커넥터 설치에 그 새 URL을 다시 입력하세요 — 옛 URL은 즉시 작동이 중지됩니다.

• 이 메일함의 실제 비밀번호는 평상시처럼 당사 암호 관리자에만 보관하면 됩니다. 이 서버는 배포 시에 환경 변수로 한 번만 필요합니다.

로컬 테스트(선택사항, 배포 전)

로컬에서 먼저 실행해 실제 자격 증명이 동작하는지 확인할 수 있습니다:

npm install
MAIL_HOST=mail.techtv.live IMAP_PORT=993 SMTP_PORT=465 \
EMAIL_USER=pete@techtv.live EMAIL_PASS='<real password>' \
ACCESS_TOKEN=test123 PORT=3000 node server.js

그런 다음 다른 터미널에서:

curl -s -X POST http://localhost:3000/mcp/test123 \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

성공적인 응답은 서버 이름을 지정하는 result 블록처럼 보입니다. — 반대로 인증 오류가 발생했다면, EMAIL_PASS를 다시 확인하고 cPanel에서 이 메일함에 대한 IMAP/SMTP 접근이 차단되지 않았는지 확인하세요.