google-admin-automation

Google Workspace 管理者自動化（Rube MCP 経由）

Rube MCP（Composio）を使用して、Google Workspace のユーザー、グループ、メンバーシップ、組織設定をプログラムで管理します。

ツールキットドキュメント: composio.dev/toolkits/google_admin

前提条件

• Rube MCP が接続されていること（RUBE_SEARCH_TOOLS が利用可能であること）
• RUBE_MANAGE_CONNECTIONS でツールキット google_admin を使用したアクティブな接続
• 認証アカウントに Google Workspace 管理者権限があること
• 最初に必ず RUBE_SEARCH_TOOLS を呼び出して現在のツールスキーマを取得すること

セットアップ

Rube MCP の入手: クライアント設定に MCP サーバーとして https://rube.app/mcp を追加します。API キーは不要で、エンドポイントを追加するだけで動作します。

1. RUBE_SEARCH_TOOLS が応答することを確認して、Rube MCP が利用可能であることを確認します
2. RUBE_MANAGE_CONNECTIONS をツールキット google_admin で呼び出します
3. 接続が ACTIVE でない場合は、返された認証リンクに従ってセットアップを完了します
4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します

コアワークフロー

1. すべてのユーザーを一覧表示

GOOGLE_ADMIN_LIST_USERS を使用して、オプションのフィルタリングとページネーションで Google Workspace ユーザーを取得します。

ツール: GOOGLE_ADMIN_LIST_USERS
パラメータ:
  - customer: 顧客 ID または "my_customer"（デフォルト）
  - domain: ユーザーを一覧表示するドメイン
  - query: フィルター文字列（例: "orgName=Engineering", "isSuspended=false"）
  - max_results: 最大結果数（1〜500、デフォルト 100）
  - order_by: "email"、"givenName"、"familyName" でソート
  - sort_order: "ASCENDING" または "DESCENDING"
  - page_token: ページネーショントークン

2. 新しいユーザーを作成

GOOGLE_ADMIN_CREATE_USER を使用して、新しい Google Workspace アカウントをプロビジョニングします。

ツール: GOOGLE_ADMIN_CREATE_USER
パラメータ:
  - primary_email（必須）: ユーザーのメールアドレス（例: "[email protected]"）
  - given_name（必須）: 名
  - family_name（必須）: 姓
  - password（必須）: ドメインの要件を満たすパスワード
  - org_unit_path: 組織ユニット（デフォルト: "/"）
  - change_password_at_next_login: 次回ログイン時にパスワード変更を強制（デフォルト: true）
  - recovery_email: 回復用メールアドレス
  - recovery_phone: 回復用電話番号
  - suspended: アカウントを停止状態で開始するかどうか（デフォルト: false）

3. グループの一覧表示と管理

GOOGLE_ADMIN_LIST_GROUPS を使用してグループを一覧表示し、GOOGLE_ADMIN_CREATE_GROUP を使用して新しいグループを作成します。

ツール: GOOGLE_ADMIN_LIST_GROUPS
パラメータ:
  - customer: "my_customer"（デフォルト）
  - domain: ドメインでフィルター
  - query: フィルター（例: "name=Engineering*"）
  - max_results: 最大結果数（1〜200）
  - order_by: "email" でソート
  - page_token: ページネーショントークン

ツール: GOOGLE_ADMIN_CREATE_GROUP
パラメータ:
  - email（必須）: グループのメールアドレス（例: "[email protected]"）
  - name（必須）: 表示名（例: "Engineering Team"）
  - description: グループの目的の説明

4. ユーザーをグループに追加

GOOGLE_ADMIN_ADD_USER_TO_GROUP を使用してグループメンバーシップを管理します。

ツール: GOOGLE_ADMIN_ADD_USER_TO_GROUP
パラメータ:
  - group_key（必須）: グループのメールアドレスまたは ID
  - user_key（必須）: 追加するユーザーのメールアドレスまたは ID
  - role: "MEMBER"（デフォルト）、"MANAGER"、または "OWNER"

5. ユーザーを一時停止または再開

GOOGLE_ADMIN_SUSPEND_USER を使用してユーザーアカウントの停止状態を切り替えます。

ツール: GOOGLE_ADMIN_SUSPEND_USER
パラメータ:
  - user_key（必須）: ユーザーのメールアドレスまたは一意の ID
  - suspended: true で停止、false で再開（デフォルト: true）
  - suspension_reason: 停止理由（オプション）

6. ユーザーまたはグループの詳細を取得

GOOGLE_ADMIN_GET_USER または GOOGLE_ADMIN_GET_GROUP を使用して詳細情報を取得します。

ツール: GOOGLE_ADMIN_GET_USER
パラメータ:
  - user_key（必須）: ユーザーのメールアドレスまたは一意の ID

ツール: GOOGLE_ADMIN_GET_GROUP
パラメータ:
  - group_key（必須）: グループのメールアドレスまたは一意の ID

一般的なパターン

• オンボーディングワークフロー: GOOGLE_ADMIN_CREATE_USER でアカウントをプロビジョニングし、GOOGLE_ADMIN_ADD_USER_TO_GROUP で関連グループに追加します。
• オフボーディングワークフロー: GOOGLE_ADMIN_SUSPEND_USER でアクセスを無効にするか、GOOGLE_ADMIN_DELETE_USER で完全に削除します。
• グループメンバーシップの監査: GOOGLE_ADMIN_LIST_GROUPS でグループを検索し、GOOGLE_ADMIN_LIST_GROUP_MEMBERS でメンバーを確認します。
• 一括ユーザー管理: GOOGLE_ADMIN_LIST_USERS とフィルタークエリを使用してユーザーを一覧表示し、反復処理で更新します。
• メールエイリアスの追加: GOOGLE_ADMIN_ADD_USER_ALIAS を使用して、ユーザーに代替メールアドレスを追加します。
• ユーザー詳細の参照: 変更を加える前に GOOGLE_ADMIN_GET_USER を使用して完全なプロファイル情報を取得します。

既知の落とし穴

• 管理者権限が必要: すべてのツールは、認証されたユーザーに Google Workspace 管理者権限が必要です。管理者以外のアカウントは権限エラーを受け取ります。
• 削除は永続的: GOOGLE_ADMIN_DELETE_USER はユーザーアカウントを完全に削除します。この操作は元に戻せません。
• user_key はメールアドレスまたは ID を受け入れる: user_key パラメータは、ユーザーのプライマリメールアドレスと一意の数値ユーザー ID の両方を受け入れます。
• グループメンバーシップは置き換え: グループに追加する際、role パラメータがメンバーの役割を制御します。「役割の更新」はありません。役割を変更するには、削除して再追加します。
• 顧客 ID: 認証されたユーザーの組織には、customer パラメータとして "my_customer" を使用します。特定の顧客 ID は C01abc123 のように見えます。
• ページネーション: ユーザーとグループの一覧表示エンドポイントは、ページネーションされた結果を返す場合があります。完全な結果を得るには、応答内の page_token を常に確認してください。
• パスワード要件: GOOGLE_ADMIN_CREATE_USER には、ドメインのパスワードポリシーを満たすパスワードが必要です。弱いパスワードは拒否されます。

クイックリファレンス

アクション	ツール	主要パラメータ
ユーザーを一覧表示	GOOGLE_ADMIN_LIST_USERS	customer, domain, query, max_results
ユーザー詳細を取得	GOOGLE_ADMIN_GET_USER	user_key
ユーザーを作成	GOOGLE_ADMIN_CREATE_USER	primary_email, given_name, family_name, password
ユーザーを削除	GOOGLE_ADMIN_DELETE_USER	user_key
ユーザーを停止	GOOGLE_ADMIN_SUSPEND_USER	user_key, suspended
ユーザーエイリアスを追加	GOOGLE_ADMIN_ADD_USER_ALIAS	（完全なスキーマは RUBE_SEARCH_TOOLS を参照）
グループを一覧表示	GOOGLE_ADMIN_LIST_GROUPS	customer, domain, query
グループ詳細を取得	GOOGLE_ADMIN_GET_GROUP	group_key
グループを作成	GOOGLE_ADMIN_CREATE_GROUP	email, name, description
グループに追加	GOOGLE_ADMIN_ADD_USER_TO_GROUP	group_key, user_key, role
グループメンバーを一覧表示	GOOGLE_ADMIN_LIST_GROUP_MEMBERS	（完全なスキーマは RUBE_SEARCH_TOOLS を参照）

---

Powered by Composio