読み取り専用接続では、AIはメールの読み取りと検索だけを行えます。このページでは、できること、できないこと、そして各制限がどのように適用されるかを説明します。
read:email 権限を持ち、オプションで search:email も持ちます。search:email で追加される操作はありません。insufficient_scope で拒否されます。SELECT の読み取り専用版である EXAMINE で開きます。そのため、当社のコードの動作にかかわらず、そのセッションでのフラグ変更、移動、削除はメールプロバイダー自身が拒否します。BODY.PEEK で取得するため、読んでも既読になりません。これは読み取り専用に限らず、すべての接続に当てはまります。mark_as_read オプションは削除されました。既読にする操作は別のアクションで、manage:folders 権限が必要です。SEARCH を使ってプロバイダーのサーバー上で実行されます。ダウンロードするのは要求された結果の1ページ分(最大100件)だけで、残りはAIがページ単位で取得します。MCPEmailsはオープンソースです。このページで説明している内容は、次のファイルで実装とテストが行われています。
imap-read-only.ts 読み取り専用接続でのEXAMINEimap-read-only.test.ts EXAMINEのテスト(プロバイダーがフラグ変更を拒否するケースを含む)scopes.ts 権限の一覧argument-aliases.ts 読み取りツールからのmark_as_readの削除imap-client.ts IMAPクライアント: 本文の取得にはすべてBODY.PEEKを使用