ComposioHQ/google-admin-automation-e-admin-automation

Rube MCP による Google Workspace 管理自動化

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

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

前提条件

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

セットアップ

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

1. RUBE_SEARCH_TOOLS が応答することを確認して、Rube MCP が利用可能であることを確認します。
2. ツールキット google_admin を指定して RUBE_MANAGE_CONNECTIONS を呼び出します。
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