권한 통제 아래에서 어시스턴트가 메일과 캘린더를 쓰게 하기

누구에게 맞나

권한 모델 아래에서 어시스턴트가 메일, 캘린더, 로컬 지식 파일에 닿아야 하는 사람에게 맞다. GigaMail 은 MCP 를 쓰며, 문서는 Claude, Codex, OpenClaw, Hermes 와 다른 MCP 호스트를 지명한다. 기능은 다중 계정(Microsoft Graph + IMAP), 캘린더, 로컬 검색 인덱스, 발신자 기억, 어시스턴트용 권한 통제다. 자체 모델은 없고, 지능은 당신 어시스턴트에서 온다.

필수 전제는 두 층이다. 먼저 pip 으로 extras 가 포함된 패키지를 설치한 뒤, 사람이 자기 터미널에서 메일함 접속을 마친다. 어시스턴트가 대신하면 안 된다. 접속 명령은 gigamail login 과 gigamail accounts add-imap 이며 자격 증명을 요구한다. 사람이 먼저 로그인하지 않으면 이후 읽기·쓰기에는 가리킬 계정이 없다.

어시스턴트 스스로 OAuth 나 IMAP 비밀번호 입력을 끝내게 하려는 사람에게는 맞지 않고, 「stdio 는 포트를 듣지 않는다」를 「로컬 서비스가 전혀 없다」로 읽는 사람에게도 맞지 않다. 선택적 사람용 콘솔은 127.0.0.1 에서 HTTP 를 연다.

3 분 만에 첫 시도 끝내기

공식 설치:

pip install "gigamail[all]"

설정 위치는 Claude Desktop / Claude Code 의 mcpServers 다. command 는 gigamail-server 이며 포트를 더 쓸 필요는 없다. MCP 자체는 stdio 만 쓰고 네트워크 포트를 듣지 않는다.

설치 후 먼저 어시스턴트를 떠나 자기 shell 에서 gigamail login 을 실행한다(IMAP 이면 gigamail accounts add-imap). 문서는 이를 사람이 해야 하며, 어시스턴트를 통해서는 못 하도록 설계되었다고 적는다. 자격 증명을 채팅에 붙이지 말 것.

호스트가 gigamail-server 를 올린 뒤 첫 번째는 읽기만 한다. 문서는 도구를 읽기 전용, 감사 가능한 안전 쓰기, 그리고 6 개의 위험 동작으로 나눈다. 위험 그룹은 send, reply, delete message, delete folder, create/delete calendar event 를 포함하며 대역 외 사람 승인이 필요하다. 첫 시도에서 이 6 개에 손대지 말 것. 성공 신호는 읽기 전용 호출이 계정에서 보이는 메일 또는 캘린더 요약을 돌려주는 것이지, 보내기 확인이 뜨는 것이 아니다. 읽기 전용도 실제 받은편지함을 보므로 위험이 영은 아니다.

사용 사례

사례 1: 이미 로그인한 계정에서 메일 또는 캘린더를 찾는다. 문서는 로컬 검색 인덱스와 통제된 메일함 접근을 강조하고, 읽기 전용 도구 묶음이 있다고 적는다. 「먼저 한 통을 찾는다」「오늘 일정을 먼저 본다」에 맞다. 기존 문서는 읽기 전용 도구의 구체 이름과 인자를 적지 않는다. search 나 list 명령을 스스로 만들지 말 것. 확인할 수 있는 것은 다중 계정, Graph 와 IMAP, 그리고 로컬 인덱스가 존재한다는 점이다.

사례 2: 보내기, 답장, 메일 삭제, 폴더 삭제, 또는 캘린더 이벤트 만들기/삭제. 이들은 Dangerous 로 표시되며 모두 6 개이고 대역 외 사람 승인이 필수다. 정말 메일이나 일정을 바꾸고 옆에 사람이 확인할 수 있는 장면에 맞다. 호출 전에 확인 지점을 고정한다: 사람이 대역 외로 승인하기 전에 메일은 나가면 안 되고 이벤트도 쓰이면 안 된다. 기존 문서는 승인 화면이나 시간 초과를 주지 않고, 이미 보낸 메일을 취소하는 단계도 없다.

사용 경계

메일함 로그인은 어시스턴트를 통해 끝낼 수 없다. MCP 는 stdio 만 말하고 포트를 듣지 않는다고 하지만, 선택 콘솔은 127.0.0.1 의 HTTP 에 묶인다. 「네트워크 없음, 로컬 인터페이스 없음」으로 읽으면 안 된다. 메일, 캘린더, 지식 파일은 실제 데이터다. 권한 모델이 줄이는 것은 오조작이지 읽기를 없애는 것이 아니다.

위험 동작은 그 6 종으로 고정되며 대역 외 승인이 필요하다. 나머지 쓰기는 감사 가능한 안전 쓰기로 묶여 서술되며 하나하나 이름을 대지 않는다. 내장 모델은 없고 품질은 어시스턴트에 달렸다. 기존 문서에는 할당량, 공급자 제한, 계정 제거의 완전한 단계가 없다. 자격 증명을 gigamail login 에 넘긴 뒤, 이 MCP 를 구동할 수 있는 호스트는 모두 같은 메일함을 읽을 수 있다.