README

接続のしくみ

AI アシスタントは OAuth でリモートMCPサーバーに接続します。esa のパスワードや API トークンを AI アシスタントに渡す必要はありません。

認可の画面で、利用者本人がチームを選んで許可したときだけ接続できます。
AI アシスタントに発行するトークンは、リモートMCPサーバー専用です。esa API にそのまま渡すことはなく、リモートMCPサーバーの中で API 用の短命なトークンに交換してから esa にアクセスします。
トークンの有効期限は、アクセストークンが 2 時間、リフレッシュトークンが 30 日です。

  sequenceDiagram
   actor U as 利用者
   participant AI as AI アシスタント
   participant MCP as esa リモートMCPサーバー
   participant esa as esa（認可・API）

   U->>AI: esa のリモートMCPサーバーを設定
   AI->>esa: アプリの自動登録（リダイレクト先を申告）
   esa-->>AI: 許可ホストなら登録、それ以外は拒否
   AI->>esa: OAuth 認可リクエスト
   esa->>U: 認可画面（チームを選んで許可）
   U->>esa: 許可
   esa-->>AI: リモートMCPサーバー専用トークン

   U->>AI: 例「〇〇の記事を探して」
   AI->>MCP: ツール呼び出し（専用トークン）
   MCP->>esa: 専用トークンを API 用の短命トークンに交換
   esa-->>MCP: 短命トークン
   MCP->>esa: esa API（短命トークン）
   esa-->>MCP: 結果
   MCP-->>AI: 結果

アクセスの制御

接続できる AI アシスタント

リモートMCPサーバーへの接続は、AI アシスタントが esa にアプリとして自動登録(Dynamic Client Registration)してから始まります。登録できるのは、認可後に戻る先(リダイレクト先)が次のいずれかの場合です。

サービス	リダイレクト先のホスト
Claude	`claude.ai`
ChatGPT	`chatgpt.com`
Devin	`api.devin.ai`
Linear	`linear.app`
Muse	`agent.meta.ai`
手元の PC で動く AI アシスタント	`localhost` / `127.0.0.1` / `[::1]`

チームの Owner による制御

SETTINGS > API・アプリ・MCP > アクセス設定 の リモートMCP・esa CLI の OAuth で、チームでの利用を次のいずれかに設定できます。

設定	内容
すべてのアクセスを許可する	すべてのメンバーが制限なく利用できます
ポリシーにより制限する	利用できるスコープやカテゴリをアプリアクセスポリシーで制限します
ポリシーにより制限し、Owner の承認を必要とする	ポリシーで制限したうえで、Owner が承認したメンバーだけが利用できます。承認は後から取り消せます
すべてのアクセスをブロックする	チームでの利用を禁止します。設定した時点で、接続済みのアクセスも止まります

利用者本人による取り消し

個人設定 > その他 > PAT / OAuth Apps の 認可済み外部アプリ から、許可を取り消せます。

メンバーの削除・退会

メンバーをチームから削除した時点で、そのメンバーのトークン（リフレッシュトークンを含む）は無効になります。esa のアカウントを削除した場合も同じです。

データの取り扱い

リモートMCPサーバーは、AWS の東京リージョンで動いています。
AI アシスタントとのやり取りの本文（リクエストとレスポンスの中身）は保存しません。
利用状況の統計のため、呼び出されたツールの名前・ユーザー ID・User-Agent をログに記録し、2 年間保存します。
リモートMCPサーバーを通じて受け取ったデータを、サービスの提供以外の目的に使うことはありません。
リモートMCPサーバーの中で、外部の LLM API などのサービスにデータを送ることはありません。

プライバシー情報全般の取り扱いは、プライバシーポリシーをご覧ください。

監査ログ

リモートMCPサーバーを通じた esa への操作は、SETTINGS > API・アプリ・MCP > API監査ログ に記録されます。

記録されるのは、操作の種類と対象の記事（記事番号・記事名）です。ツールの名前や検索語は記録されません。
保存期間は 180 日です。
CSV 形式でエクスポートできます。

提供しているツール

リモートMCPサーバーは、公開している esa MCP サーバーと同じツールを提供しています。ツールの追加や変更は Releases で確認できます。