解決する問題
AI クライアントに正確な操作対象のメールボックスを与える
指示がカテゴリだけを示し、Gmail オブジェクトを示さないと、メール作業は危険になります。MCP Abilities – Google Workspace は、偽装した Google Workspace メールボックス用に登録済みの WordPress 能力を公開し、AI クライアントが正確なメッセージ、スレッド、ラベル、添付ファイルを検索、確認、変更、送信できるようにします。
プラグインは要求された操作を実行します。認証されたオペレーターが、何を確認、変更、送信するか、また送信メッセージが適切かどうかを決定します。
メールボックスを守る判断
3つの境界が各操作を説明可能にする
次のルールで、設定、オブジェクトの選択、Gmail の状態が変わる時点を分けます。
01
委任された ID を 1つ設定する
生の service account JSON を使い、ローカルファイルのパスは使わないでください。設定はクライアントメールと秘密鍵を検証し、設定を保存して、偽装する 1つの Google Workspace メールボックスの認証をテストします。
02
使用前に接続を確認する
読み取り、送信、変更、ラベルに必要なスコープでドメイン全体の委任を設定し、メールボックスを使う前に設定済みで接続されていることを確認します。
03
対象と変更を正確に扱う
必要な場合は、メッセージ、スレッド、添付ファイル、ラベルの識別子を使います。ラベル変更、メールボックス状態のショートカット、送信、返信は、別の確認段階なしで直ちに適用されます。
設定から操作までの実用的な経路
メールボックスを接続し、対象を確認してから操作する
これは推奨されるオペレーターの実践方法です。能力が指定された操作を実行し、続行する判断はオペレーターが行います。
01
委任メールボックスを認証
ドメイン全体の委任を備えた Google service account を設定し、対象の Google Workspace メールボックスに読み取り、送信、変更、ラベルの必要なスコープを付与します。
02
設定して状態を確認する
生の service account JSON と、偽装するメールボックスを送信します。設定が認証を検証・テストし、状態が接続の設定済み・接続済みの別を報告します。
03
変更前に確認する
メッセージやスレッドを検索してページングし、ラベルを一覧表示するか、正確なメッセージ、スレッド、ラベル、添付ファイルを取得します。変更または送信操作を選ぶ前に、対象の識別子を選択します。
04
明示的な操作を 1つ適用する
選択した操作に対して、正確なメッセージ、ラベル、スレッド、受信者、件名、本文のフィールドを使います。Gmail の送信、返信、ラベル変更、メールボックス状態のショートカットは直ちに適用されます。
先に読み、次に判断する
実際に意図したメッセージ、スレッド、添付ファイルを見つける
メールボックスの発見と確認を分け、選択したオブジェクトと既読化の効果を明確に保ちます。
メッセージを検索
Gmail のメッセージを検索し、結果をページングして候補を特定します。
スレッドを検索
Gmail のスレッドを検索し、1つのメッセージではなく会話を作業単位にする場合は結果をページングします。
1つのメッセージを確認
識別子で正確なメッセージを取得します。明示的に要求された場合だけ既読にします。
1つのスレッドを確認
識別子で正確なスレッドを取得し、判断や返信に正しい会話のコンテキストを与えます。
1つの添付ファイルを取得
識別子で正確な添付ファイルを取得します。応答上限は 1 バイトから 20 MB に設定します。
ラベルを意図的に保つ
対象を失わずに Gmail ラベルを管理する
ラベルの確認と変更を分けます。すべての変更は正確なラベルを指定し、直ちに適用されます。
ラベルを一覧表示
操作前に利用可能なラベル識別子を確認するため、システムラベルとユーザーラベルを一覧表示します。
1つのラベルを確認
識別子で正確なラベルを取得し、変更するか判断する前に現在の名前と表示状態を確認します。
1つのラベルを作成
指定された名前、表示状態、任意の色フィールドでラベルを作成します。
1つのラベルを更新
識別子と変更するフィールドを使って正確なラベルを更新します。
1つのラベルを削除
正確なラベル識別子を削除します。削除は直ちに行われ、別の確認段階はありません。
メールボックスの状態
対象を失わずに 1つのメッセージを変更する
正確な Gmail メッセージに対して、メールボックス状態操作は指定したラベルを追加または削除します。明示的なショートカットで既読・未読にしたり、アーカイブしたり、ゴミ箱に移動したりできます。
変更は直ちに行われ、別の確認段階は追加されません。変更を要求する前に、メッセージ識別子と意図する状態を明示的に選択します。manage_options を持つ認証済み WordPress ユーザーが必要です。
送信経路を選ぶ
メッセージに合うトランスポートから送信する
各経路は指定した対象と内容を使います。呼び出しが成功すると直ちに送信され、これらの能力は別の確認段階を追加しません。
Gmail 経由で送信
設定済みの Gmail ID から新しいメッセージを送信します。正確な受信者、件名、本文を指定し、任意で CC と BCC の受信者を追加します。
Gmail で返信
正確な既存メッセージとスレッドに、指定した本文で返信します。明示的に要求されない限り全員への返信は無効です。
WordPress メール経由で送信
必要な配信経路がサイトの WordPress メールトランスポートである場合に使います。設定済みの Gmail ID とは分離されています。
必要な実行環境
MCP Abilities – Google Workspace の依存関係
次のソース所有依存関係を、それぞれの権威ある宛先で利用可能にします。
WordPress 6.9 以降
WordPress 6.9+WordPress の実行環境と登録済み Abilities API を提供します。
PHP 8.0 以降
PHP 8.0+必要なサーバー実行環境を提供します。
有効な WordPress Abilities API
WordPress Abilities API能力の登録、スキーマ、アノテーション、認証コールバックを管理します。
有効な MCP Adapter
WordPress MCP Adapter登録済み WordPress 能力を認証済み MCP クライアントに公開します。
有効な MCP Expose Abilities プラグイン
MCP Expose Abilities登録済み能力の Devenia トランスポートポリシーを提供します。
Google Workspace の委任 ID に対して有効
Google Workspace Gmail API設定済みの Google Workspace ID から使用するメールボックス、メッセージ、スレッド、添付ファイル、ラベル、送信操作を提供します。
メールボックスを役立てる
1つのメールボックスに WordPress 経路を用意する
AI クライアントが設定済みの Google Workspace メールボックスを WordPress 経由で操作する必要がある場合は、MCP Abilities – Google Workspace をダウンロードします。まず委任された service account を設定し、メールボックスの能力を使う前に接続が設定済みで接続されていることを確認します。