Google Workspace Admin Automatisierung via Rube MCP

Was macht Google Workspace Admin Automatisierung via Rube MCP?

Verwalte Google Workspace Benutzer, Gruppen, Mitgliedschaften und Organisationseinstellungen programmatisch mit Rube MCP (Composio).

Toolkit-Dokumentation: composio.dev/toolkits/google_admin

Voraussetzungen

• Rube MCP muss verbunden sein (RUBE_SEARCH_TOOLS verfügbar)
• Aktive Verbindung via RUBE_MANAGE_CONNECTIONS mit dem Toolkit google_admin
• Google Workspace Admin-Rechte für das authentifizierte Konto
• Rufe immer zuerst RUBE_SEARCH_TOOLS auf, um die aktuellen Tool-Schemata zu erhalten

Einrichtung

Rube MCP holen: Füge https://rube.app/mcp als MCP-Server in deiner Client-Konfiguration hinzu. Es werden keine API-Schlüssel benötigt – einfach den Endpunkt hinzufügen und es funktioniert.

1. Überprüfe, ob Rube MCP verfügbar ist, indem du bestätigst, dass RUBE_SEARCH_TOOLS antwortet
2. Rufe RUBE_MANAGE_CONNECTIONS mit dem Toolkit google_admin auf
3. Falls die Verbindung nicht AKTIV ist, folge dem zurückgegebenen Authentifizierungslink, um die Einrichtung abzuschließen
4. Bestätige, dass der Verbindungsstatus AKTIV anzeigt, bevor du Workflows ausführst

Kern-Workflows

1. Alle Benutzer auflisten

Verwende GOOGLE_ADMIN_LIST_USERS, um Google Workspace Benutzer mit optionaler Filterung und Paginierung abzurufen.

Tool: GOOGLE_ADMIN_LIST_USERS
Parameter:
  - customer: Kunden-ID oder "my_customer" (Standard)
  - domain: Domain, aus der Benutzer aufgelistet werden sollen
  - query: Filterstring (z. B. "orgName=Engineering", "isSuspended=false")
  - max_results: Maximale Ergebnisse (1-500, Standard 100)
  - order_by: Sortierung nach "email", "givenName" oder "familyName"
  - sort_order: "ASCENDING" oder "DESCENDING"
  - page_token: Paginierungs-Token

2. Neuen Benutzer erstellen

Verwende GOOGLE_ADMIN_CREATE_USER, um ein neues Google Workspace Konto zu provisionieren.

Tool: GOOGLE_ADMIN_CREATE_USER
Parameter:
  - primary_email (erforderlich): E-Mail des Benutzers (z. B. "[email protected]")
  - given_name (erforderlich): Vorname
  - family_name (erforderlich): Nachname
  - password (erforderlich): Passwort, das den Domain-Anforderungen entspricht
  - org_unit_path: Organisationseinheit (Standard: "/")
  - change_password_at_next_login: Passwortänderung erzwingen (Standard: true)
  - recovery_email: Wiederherstellungs-E-Mail-Adresse
  - recovery_phone: Wiederherstellungs-Telefonnummer
  - suspended: Ob das Konto gesperrt startet (Standard: false)

3. Gruppen auflisten und verwalten

Verwende GOOGLE_ADMIN_LIST_GROUPS, um Gruppen aufzulisten, und GOOGLE_ADMIN_CREATE_GROUP, um neue zu erstellen.

Tool: GOOGLE_ADMIN_LIST_GROUPS
Parameter:
  - customer: "my_customer" (Standard)
  - domain: Nach Domain filtern
  - query: Filter (z. B. "name=Engineering*")
  - max_results: Maximale Ergebnisse (1-200)
  - order_by: Sortierung nach "email"
  - page_token: Paginierungs-Token

Tool: GOOGLE_ADMIN_CREATE_GROUP
Parameter:
  - email (erforderlich): Gruppen-E-Mail-Adresse (z. B. "[email protected]")
  - name (erforderlich): Anzeigename (z. B. "Engineering Team")
  - description: Beschreibung des Gruppenverwendungszwecks

4. Benutzer zu Gruppen hinzufügen

Verwende GOOGLE_ADMIN_ADD_USER_TO_GROUP, um Gruppenmitgliedschaften zu verwalten.

Tool: GOOGLE_ADMIN_ADD_USER_TO_GROUP
Parameter:
  - group_key (erforderlich): Gruppen-E-Mail oder -ID
  - user_key (erforderlich): Benutzer-E-Mail oder -ID, die hinzugefügt werden soll
  - role: "MEMBER" (Standard), "MANAGER" oder "OWNER"

5. Benutzer sperren oder entsperren

Verwende GOOGLE_ADMIN_SUSPEND_USER, um die Kontosperrung eines Benutzers umzuschalten.

Tool: GOOGLE_ADMIN_SUSPEND_USER
Parameter:
  - user_key (erforderlich): E-Mail oder eindeutige ID des Benutzers
  - suspended: true zum Sperren, false zum Entsperren (Standard: true)
  - suspension_reason: Grund für die Sperrung (optional)

6. Benutzer- oder Gruppendetails abrufen

Verwende GOOGLE_ADMIN_GET_USER oder GOOGLE_ADMIN_GET_GROUP, um detaillierte Informationen abzurufen.

Tool: GOOGLE_ADMIN_GET_USER
Parameter:
  - user_key (erforderlich): E-Mail oder eindeutige ID des Benutzers

Tool: GOOGLE_ADMIN_GET_GROUP
Parameter:
  - group_key (erforderlich): E-Mail oder eindeutige ID der Gruppe

Häufige Muster

• Onboarding-Workflow: Verwende GOOGLE_ADMIN_CREATE_USER, um das Konto zu provisionieren, und dann GOOGLE_ADMIN_ADD_USER_TO_GROUP, um den Benutzer zu relevanten Gruppen hinzuzufügen.
• Offboarding-Workflow: Verwende GOOGLE_ADMIN_SUSPEND_USER, um den Zugriff zu deaktivieren, oder GOOGLE_ADMIN_DELETE_USER für die dauerhafte Entfernung.
• Gruppenmitgliedschaft prüfen: Verwende GOOGLE_ADMIN_LIST_GROUPS, um Gruppen zu finden, und dann GOOGLE_ADMIN_LIST_GROUP_MEMBERS, um Mitglieder zu überprüfen.
• Massenverwaltung von Benutzern: Liste Benutzer mit GOOGLE_ADMIN_LIST_USERS und Filterabfragen auf, und iteriere dann für Aktualisierungen.
• E-Mail-Aliase hinzufügen: Verwende GOOGLE_ADMIN_ADD_USER_ALIAS, um alternative E-Mail-Adressen für einen Benutzer hinzuzufügen.
• Benutzerdetails nachschlagen: Verwende GOOGLE_ADMIN_GET_USER, um das vollständige Profil vor Änderungen abzurufen.

Bekannte Fallstricke

• Admin-Rechte erforderlich: Alle Tools setzen voraus, dass der authentifizierte Benutzer Google Workspace Administratorrechte besitzt. Nicht-Admin-Konten erhalten Berechtigungsfehler.
• Löschen ist endgültig: GOOGLE_ADMIN_DELETE_USER entfernt ein Benutzerkonto dauerhaft. Diese Aktion kann nicht rückgängig gemacht werden.
• user_key akzeptiert E-Mail oder ID: Der Parameter user_key akzeptiert sowohl die primäre E-Mail-Adresse des Benutzers als auch seine eindeutige numerische Benutzer-ID.
• Gruppenmitgliedschaft ersetzt: Beim Hinzufügen zu Gruppen steuert der Parameter role die Rolle des Mitglieds. Es gibt keine „Rolle aktualisieren“ – um die Rolle zu ändern, muss das Mitglied entfernt und neu hinzugefügt werden.
• Kunden-ID: Verwende "my_customer" als customer-Parameter für die Organisation des authentifizierten Benutzers. Spezifische Kunden-IDs sehen aus wie C01abc123.
• Paginierung: Sowohl Benutzer- als auch Gruppenlisten-Endpunkte können paginierte Ergebnisse zurückgeben. Überprüfe immer auf page_token in den Antworten, um vollständige Ergebnisse zu erhalten.
• Passwortanforderungen: GOOGLE_ADMIN_CREATE_USER erfordert ein Passwort, das der Passwortrichtlinie der Domain entspricht. Schwache Passwörter werden abgelehnt.

Kurzreferenz

Aktion	Tool	Wichtige Parameter
Benutzer auflisten	GOOGLE_ADMIN_LIST_USERS	customer, domain, query, max_results
Benutzerdetails abrufen	GOOGLE_ADMIN_GET_USER	user_key
Benutzer erstellen	GOOGLE_ADMIN_CREATE_USER	primary_email, given_name, family_name, password
Benutzer löschen	GOOGLE_ADMIN_DELETE_USER	user_key
Benutzer sperren	GOOGLE_ADMIN_SUSPEND_USER	user_key, suspended
Benutzer-Alias hinzufügen	GOOGLE_ADMIN_ADD_USER_ALIAS	(vollständiges Schema via RUBE_SEARCH_TOOLS)
Gruppen auflisten	GOOGLE_ADMIN_LIST_GROUPS	customer, domain, query
Gruppendetails abrufen	GOOGLE_ADMIN_GET_GROUP	group_key
Gruppe erstellen	GOOGLE_ADMIN_CREATE_GROUP	email, name, description
Zu Gruppe hinzufügen	GOOGLE_ADMIN_ADD_USER_TO_GROUP	group_key, user_key, role
Gruppenmitglieder auflisten	GOOGLE_ADMIN_LIST_GROUP_MEMBERS	(vollständiges Schema via RUBE_SEARCH_TOOLS)

---

Bereitgestellt von Composio