corresync

시작하기

설치부터 첫 질문까지, 네 단계면 됩니다.

Corresync는 먼저 로그인하지 않습니다. 주소에서 공개 연결 정보를 찾고, 사용자가 경로를 고른 다음, 별도의 명령으로 그 계정만 로그인합니다.

1단계

Corresync 설치

운영체제에 맞는 방법을 하나 선택하세요. 공식 설치 프로그램은 공개 릴리스의 체크섬과 출처 증명을 확인합니다.

macOS · Linux

curl -LsSf https://corresync.org/install.sh | sh

Windows · PowerShell

powershell -NoProfile -Command "irm https://corresync.org/install.ps1 | iex"

Windows · WinGet

winget install --id nkiyohara.Corresync --exact

Homebrew

brew install nkiyohara/corresync/corresync

Windows · Scoop

scoop bucket add corresync https://github.com/nkiyohara/scoop-corresync
scoop install corresync/corresync

설치 후 버전을 확인하세요.

corr --version

2단계

메일과 캘린더 계정 설정

처음에는 명령 하나만 실행하면 됩니다. 안내 화면이 이메일 주소를 묻고, 자격 증명 없이 메일과 캘린더 서비스를 찾은 뒤 계정을 추가하기 전에 선택한 경로를 보여 줍니다. 

corr setup

현재 로컬 상태를 먼저 확인하고, 필요하면 셸 자동 완성을 설치한 뒤 끝나지 않은 단계부터 이어갑니다. 계정 경로는 저장 전에 미리 보여 주며, 로그인이나 외부 자격 증명 접근은 별도 선택입니다. 여러 계정을 추가한 다음 감지된 에이전트를 복수 선택하고, 로컬 통합 계획을 한 번 확인한 뒤 호스트별로 적용하고 검증합니다. corr settings에서도 같은 흐름을 열 수 있습니다. 화면 읽기 프로그램을 사용한다면 CORRESYNC_ACCESSIBLE=true로 줄 단위 안내를 켤 수 있으며, 입력 단계에서 안전하게 나가려면 :cancel을 입력하세요.

고급 사용 또는 스크립트: 기존 명령은 대화 없이 그대로 동작합니다. 

corr setup you@example.com --alias personal

3단계

선택한 계정에 로그인

안내 화면에서 로그인을 선택하거나 아래 명령을 직접 실행할 수 있습니다. 어느 쪽이든 탐색이나 계정 추가만으로 브라우저, 키체인, 관리자 동의가 시작되지는 않습니다. 

corr auth login --account personal
  • Outlook Web: 전용으로 보이는 브라우저가 로그인과 사이트 데이터를 소유합니다.
  • Microsoft Graph: 사용 권한이 있는 공개 OAuth 클라이언트를 명시적으로 선택하고, 권한은 운영체제 키체인에 둡니다.
  • iCloud: 앱 암호는 운영체제 자격 증명 저장소에 직접 입력합니다. Mail과 캘린더는 메시지 본문이나 일정 내용을 읽지 않고 마지막으로 인증된 상태를 각각 표시합니다.
  • JMAP · IMAP/SMTP · CalDAV: 비밀 정보는 키체인 또는 승인한 자격 증명 도우미가 보관하며 설정에는 참조만 남습니다.
  • Google: 직접 소유한 데스크톱 OAuth 클라이언트와 키체인에 가져온 자격 증명을 사용합니다.

연결된 계정과 관찰된 기능을 확인합니다.

corr account list

4단계

MCP 클라이언트 연결

아래 명령은 로컬 stdio MCP 서버를 해당 클라이언트에 등록합니다. 원격 MCP URL이나 호스팅 중계는 만들지 않습니다.

Codex

corr mcp setup codex

Claude Code

corr mcp setup claude-code

GitHub Copilot CLI

corr mcp setup github-copilot

Gemini CLI

corr mcp setup gemini-cli

Qwen Code

corr mcp setup qwen-code

Qoder

corr mcp setup qoder

Kimi Code CLI

corr mcp config kimi-code

기타 MCP 클라이언트

corr mcp serve

클라이언트를 한 번 다시 시작한 뒤 메일이나 일정을 물어보세요. 계정을 넘나드는 읽기는 합칠 수 있지만, 모든 쓰기는 먼저 하나의 정확한 계정과 대상을 선택합니다.

완료

첫 작업 실행

CLI와 MCP가 같은 애플리케이션 작업을 사용하므로 어느 쪽에서 시작해도 정책은 같습니다. 

corr mail search --all-accounts --query 'is:unread'
corr agenda list --all-accounts \
  --start 2026-08-12T00:00:00Z \
  --end 2026-08-13T00:00:00Z

보내기, 삭제, 참석자 초대 같은 작업은 검토 결과와 승인 토큰을 먼저 반환합니다. 미리 본 계정·대상·내용이 바뀌면 기존 승인을 사용할 수 없습니다.

막혔을 때

추측하지 말고 상태를 확인하세요.

다음 단계

지원 경로와 안전장치를 더 살펴보세요.

에이전트별 직접 MCP, Skill, 네이티브 패키지와 실제 등록 상태는 AI 연동 표에서 구분해 볼 수 있습니다.

지원 서비스 비교보안 모델 읽기