corresync

スタートガイド

インストールから最初の回答まで、迷わない4ステップ。

corrを入れ、仕事用や個人用のアカウントを追加し、ローカルMCPをエージェントに登録します。 横断検索してもアカウントの本人性と認可は別々です。Outlook Webのサインインはブラウザ、APIや標準経路の認可情報はOSキーチェーンが管理し、MCPは端末上のstdioだけで動きます。

ステップ1から始める先に対応状況を確認

  1. corrをインストール

    ここではソフトウェアを入れるだけです。アカウント追加もサインインも、まだ行いません。

    macOS · Linux

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

    現在のユーザー向けに検証済み安定版版を入れます。実行前にスクリプト本体も確認できます。

    Windows · PowerShell

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

    管理者権限を使わず、ユーザーのPATHだけを更新します。スクリプト本体を先に読めます。

    パッケージマネージャーから入れる

    更新と削除も同じツールに任せられます。

    Windows · WinGet

    winget install --id nkiyohara.Corresync --exact

    Microsoft審査済みのmanifestを使います。

    macOS · Linux · Homebrew

    brew install nkiyohara/corresync/corresync

    最新の安定版タグからHomebrewがビルドします。

    Windows · Scoop

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

    チェックサム固定済みのbucketを使います。

    Linux向け.deb、.rpm、.apk、直接配布アーカイブ、チェックサム、Sigstore 来歴、Claude Desktop用.mcpbは最新リリースにあります。

    動作確認

    corr --version

    任意 · 単体版版を自動更新

    corr config set updates.auto_install true

    署名・検証済みの単体版リリースだけを自動導入します。MCPツール呼び出し中や機械可読出力中には更新しません。

    任意 · 署名済みプレビューを使う

    corr config set updates.channel preview
corr update

    既定は安定版です。戻すときはcorr config set updates.channel stable。自動downgradeはしません。

    macOS版はDeveloper ID署名とApple notarization済みです。Windows版はまだAuthenticode未署名なので、警告を無視せずチェックサムと署名済み来歴を確認してください。

  2. メールとカレンダーのアカウントを設定

    はじめに実行するのは1コマンドだけです。ガイドがメールアドレスを尋ね、認証情報なしでメールとカレンダーの候補を探し、内容を確認してからアカウントを追加します。

    サインインや外部認証情報へのアクセスは、追加後に改めて選ぶ別の操作です。接続確認や2つ目のアカウント追加も続けて案内します。corr settingsからも同じ画面を開けます。スクリーンリーダーではCORRESYNC_ACCESSIBLE=trueを指定すると行単位で操作できます。入力途中で安全に戻るには:cancelと入力してください。

    Outlook Webはプロバイダー所有のブラウザでサインインできます。Microsoft Graph、JMAP、IMAP/SMTP、CalDAVも、プロバイダーが対応していて必要な経路や認証情報の保管先を明示的に選んだ場合に利用できます。候補検索だけでブラウザやキーチェーンを開いたり、管理者の同意を求めたりすることはありません。

    iCloudを使う場合：corr setupは@icloud.com、@me.com、@mac.com、または必要なサービス記録がすべて確認できたカスタムiCloudドメインから、メールとカレンダーをまとめて提案します。アカウント追加後にAppleの2ファクタ認証とアプリ用パスワードを案内し、パスワードはOSの資格情報画面が直接受け取ります。Corresyncには渡りません。

    Googleを使う場合：自分で管理するGoogle Cloudプロジェクトに デスクトップOAuthクライアントを作ります。ガイド付き設定がダウンロードしたJSONを検証し、 生成された認証情報をOSキーチェーンへ保存します。

    アドレスを送らずに対応確認 · 認証の持ち主を確認

    ガイド付き設定 · おすすめ

    corr setup

    現在のローカル状態を確認し、必要ならシェル補完を追加して、未完了のところから再開します。アカウント経路は保存前に確認でき、認証は別の操作です。検出した複数のエージェントを選び、ローカル設定の変更内容を一度確認してから、接続先ごとに適用・検証します。

    上級者向け・スクリプトでの設定

    corr setup you@example.com --alias personal
corr auth login --account personal
corr doctor --account personal

    従来のコマンドは非対話のままなので、自動化にも利用できます。

    iCloudメール＋カレンダー · 現在利用可能

    ガイド付きプリセットで両方のサービスを追加し、確認済みの認証情報ハンドルを共有できます。本文を読まず、最後に認証できた状態も確認できます。接続前にApple公式のアプリ用パスワードの案内を確認してください。

    Gmail · Googleカレンダー · Google Tasks

    Google OAuthの画面付きガイドで、 必要なAPIだけを選び、認証情報と認可を端末の外へ出さずに設定できます。

  3. いつものエージェントにつなぐ

    クライアント自身の設定に、ローカルstdio MCPの絶対パスを登録します。遠隔エンドポイントは作りません。登録後にクライアントを再起動してください。

    Codex

    corr mcp setup codex

    codex mcp get corresyncで確認。

    Claude Code

    corr mcp setup claude-code

    ユーザー単位・プロジェクト単位に対応。

    GitHub Copilot CLI

    corr mcp setup github-copilot

    copilot mcp get corresyncで確認。

    Gemini CLI

    corr mcp setup gemini-cli

    gemini mcp listで確認。

    Qwen Code

    corr mcp setup qwen-code

    qwen mcp listで確認。

    Qoder

    corr mcp setup qoder

    qodercli mcp listで確認。

    Kimi Code CLI

    corr mcp config kimi-code

    追加するMCP設定を表示します。

    その他のMCPクライアント

    corr mcp serve

    汎用stdio 通信経路として登録できます。

    どのクライアントも同じ型付きツールと同じポリシーチェックを使います。CodexとClaude Code向けにはPluginとAgent Skillも同梱しています。

  4. 複数アカウントをまたいで質問

    読み取りはアカウントを混ぜずに横断できます。書き込みは、必ず別の確認段階を通ります。

    • 「Anaから来た四半期計画のメールを、全アカウントから探して」
    • 「明日の午前中の予定を、すべてのカレンダーから教えて」
    • 「Anaへの返信を下書きして。送る前に自分で確認する」

    結果にはアカウントとプロバイダーが残ります。一部の経路が失敗しても、成功分を隠さず部分失敗として示します。

    送信では、正確な本文を含むレビューが先に返ります。同じアカウント・宛先・バイト列に一致する操作だけを、CLIの--approveまたはMCPの実行ツールで確定できます。承認は短時間・一回限りです。

    実行前レビュー 
    $ corr mail send --account work \
    --to ana@example.invalid \
    --subject 'Quarterly plan' \
    --body-file reply.txt

REVIEW · send new message
  account   work · microsoft-owa
  to        ana@example.invalid
  body      text/plain · 412 B

まだ送信されていません。

$ corr mail send … --approve
SENT · one attempt · review 9f2c1a…

次に読むなら

必要になったところから、詳しく。

安全設計

認証情報、分離、プレビュー→実行を確認。安全性を読む。

できること

メール、予定、agent、script、モニタリングを一覧。機能を見る。

機密性の高いアカウントをつなぐ前に：各経路には決定的な合成データによる契約テストがあります。合成テストだけの経路は、実環境で確認済みとは表現しません。

根拠の読み方

操作はこれだけ

入れる。サインインする。つなぐ。質問する。

細かな仕様は、必要になったときに読めます。

安全設計を読むできることを見る