WordPress での AI メールボックス操作

MCP Abilities – Google Workspace:すべての AI メールボックス操作を選択したオブジェクトに結び付ける

「そのメールを探して」という指示だけでは重要なメールボックス作業に曖昧さが残る場合、AIクライアントは、構成済みの1つのGoogle Workspaceメールボックスと、依頼された操作の明確な対象を使ってWordPress経由で作業できます。

MCP Abilities - Google Workspace を表すアールデコ調の工業用メールボックス制御コンソール

解決する問題

AI クライアントに正確な操作対象のメールボックスを与える

メール作業は、指示がカテゴリだけを示し、Gmailオブジェクトを示していないと危険になります。MCP Abilities – Google Workspaceは、1つのなりすましWorkspaceメールボックスに対して登録済みのWordPress Abilitiesを公開し、AIクライアントが特定のメッセージ、スレッド、ラベル、添付ファイルを検索、確認、変更、送信できるようにします。

プラグインは依頼された操作を実行します。何を確認、変更、送信するか、また送信メッセージが適切かどうかは、権限を持つオペレーターが判断します。

メールボックスを守る判断

3つの境界が各操作を説明可能にする

セットアップ、オブジェクトの選択、Gmailの状態が変わる時点を分けるには、次のルールを使います。

使用前に接続を確認する

必要な読み取り、送信、変更、ラベルのスコープを使ってドメイン全体の委任を設定し、使用前にメールボックスが構成済みで接続されていることを確認します。

対象と変更を正確に扱う

必要な場合は、対象のメッセージ、スレッド、添付ファイル、ラベルの識別子を使います。ラベルの変更、メールボックス状態のショートカット、送信、返信は、別の確認段階なしで直ちに適用されます。

設定から操作までの実用的な経路

メールボックスを接続し、対象を確認してから操作する

これは推奨されるオペレーターの実践です。Abilitiesは指定された操作を実行し、実行するかどうかの判断はオペレーターが担います。

委任メールボックスを認証

ドメイン全体の委任を設定したGoogle service accountを用意し、対象のWorkspaceメールボックスに必要な読み取り、送信、変更、ラベルのスコープを付与します。

設定して状態を確認する

raw service account JSONと、なりすますWorkspaceメールボックスを送信します。構成が認証を検証・テストし、状態が接続の構成済み・接続済みの状況を報告します。

変更前に確認する

メッセージやスレッドを検索して結果をページングし、ラベルを一覧表示するか、特定のメッセージ、スレッド、ラベル、添付ファイルを取得します。変更または送信操作を選ぶ前に、対象の識別子を選択します。

明示的な操作を 1つ適用する

選択した操作には、対象のメッセージ、ラベル、スレッド、受信者、件名、本文の各フィールドを明示的に指定します。Gmailの送信、返信、ラベル変更、メールボックス状態のショートカットは直ちに反映されます。

先に読み、次に判断する

実際に意図したメッセージ、スレッド、添付ファイルを見つける

選択したオブジェクトと既読化の効果を明確に保つため、メールボックスの検出と確認を分けます。

メッセージを検索

Gmailのメッセージを検索し、結果をページングして候補メッセージを特定します。

スレッドを検索

1つのメッセージではなく会話が作業単位になる場合は、Gmailのスレッドを検索して結果をページングします。

1つのメッセージを確認

識別子で特定のメッセージを1件取得します。明示的に要求された場合だけ既読にします。

1つのスレッドを確認

識別子で特定のスレッドを1件取得し、判断や返信に正しい会話の文脈を与えます。

1つの添付ファイルを取得

識別子で特定の添付ファイルを1件取得します。応答の上限は1バイトから20 MBまでに設定します。

ラベルを意図的に保つ

対象を失わずに Gmail ラベルを管理する

ラベルの確認と変更を分けます。すべての変更は1つの特定のラベルを指定し、直ちに適用されます。

ラベルを一覧表示

システムラベルとユーザーラベルを一覧表示し、操作前に利用可能なラベル識別子を確認します。

1つのラベルを確認

識別子で特定のラベルを1件取得し、変更するかどうかを判断する前に現在の名前と表示状態を確認します。

1つのラベルを作成

指定された名前、表示状態、任意の色フィールドでラベルを作成します。

1つのラベルを更新

識別子と変更するフィールドを指定して、特定のラベルを1件更新します。

1つのラベルを削除

特定のラベル識別子を1件削除します。削除は直ちに実行され、別の確認段階はありません。

メールボックスの状態

対象を失わずに 1つのメッセージを変更する

特定のGmailメッセージ1件に対して、メールボックス状態の操作は指定されたラベルを追加または削除します。明示的なショートカットで、そのメッセージを既読・未読にしたり、アーカイブしたり、ゴミ箱へ移動したりできます。

これらの変更は直ちに反映され、別の確認段階はありません。変更を依頼する前に、メッセージ識別子と意図する状態を明示的に選択します。manage_optionsを持つ認証済みWordPressユーザーが必要です。

送信経路を選ぶ

メッセージに合うトランスポートから送信する

各経路は、指定した対象と内容を使います。呼び出しが成功すると直ちに送信され、これらのAbilitiesに別の確認段階はありません。

Gmail 経由で送信

構成済みのGmail identityを通じて新しいメッセージを送信します。特定の受信者、件名、本文を指定し、任意でCCとBCCの受信者も指定します。

Gmail で返信

既存の特定のメッセージとスレッドに、指定した本文で返信します。「全員に返信」は明示的に要求されない限り無効です。

WordPress メール経由で送信

必要な配信経路がサイトのWordPressメール transportである場合は、それを使います。構成済みのGmail identityとは別に扱われます。

必要な実行環境

MCP Abilities – Google Workspace の依存関係

これらのソース所有の依存関係を、権威ある提供元で利用できる状態に保ちます。

WordPress 6.9 以降

WordPress 6.9+

WordPress runtimeと登録済みのAbilities APIを提供します。

PHP 8.0 以降

PHP 8.0+

必要なserver runtimeを提供します。

有効な WordPress Abilities API

WordPress Abilities API

Abilityの登録、スキーマ、アノテーション、認可コールバックを管理します。

有効な MCP Adapter

WordPress MCP Adapter

登録済みのWordPress abilitiesを認証済みMCPクライアントに公開します。

有効な MCP Expose Abilities プラグイン

MCP Expose Abilities

登録済みabilitiesのためのDevenia transport policyを提供します。

Google Workspace の委任 ID に対して有効

Google Workspace Gmail API

構成済みのWorkspace identityを通じて使われる、メールボックス、メッセージ、スレッド、添付ファイル、ラベル、送信の各操作を提供します。

メールボックスを役立てる

1つのメールボックスに WordPress 経路を用意する

AIクライアントが、構成済みの1つのGoogle Workspaceメールボックスを使ってWordPress経由で作業する必要がある場合は、MCP Abilities – Google Workspaceをダウンロードします。委任されたservice accountを構成し、そのメールボックスのAbilitiesを使う前に、接続が構成済みで接続されていることを確認してください。