> 接続のしくみ接続のしくみ
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 アシスタント接続できる 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 による制御チームの 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 で確認できます。
