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

Automação de Administração do Google Workspace via Rube MCP

Gerencie usuários, grupos, associações e configurações organizacionais do Google Workspace programaticamente usando Rube MCP (Composio).

Documentação do toolkit: composio.dev/toolkits/google_admin

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa via RUBE_MANAGE_CONNECTIONS com o toolkit google_admin
• Privilégios de administrador do Google Workspace para a conta autenticada
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas atuais das ferramentas

Configuração

Obter Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Não são necessárias chaves de API — basta adicionar o endpoint e ele funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o toolkit google_admin
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para concluir a configuração
4. Confirme que o status da conexão mostra ATIVO antes de executar qualquer fluxo de trabalho

Fluxos de Trabalho Principais

1. Listar Todos os Usuários

Use GOOGLE_ADMIN_LIST_USERS para recuperar usuários do Google Workspace com filtragem e paginação opcionais.

Ferramenta: GOOGLE_ADMIN_LIST_USERS
Parâmetros:
  - customer: ID do cliente ou "my_customer" (padrão)
  - domain: Domínio para listar usuários
  - query: String de filtro (ex.: "orgName=Engineering", "isSuspended=false")
  - max_results: Máximo de resultados (1-500, padrão 100)
  - order_by: Ordenar por "email", "givenName" ou "familyName"
  - sort_order: "ASCENDING" ou "DESCENDING"
  - page_token: Token de paginação

2. Criar um Novo Usuário

Use GOOGLE_ADMIN_CREATE_USER para provisionar uma nova conta do Google Workspace.

Ferramenta: GOOGLE_ADMIN_CREATE_USER
Parâmetros:
  - primary_email (obrigatório): E-mail do usuário (ex.: "[email protected]")
  - given_name (obrigatório): Primeiro nome
  - family_name (obrigatório): Sobrenome
  - password (obrigatório): Senha que atenda aos requisitos do domínio
  - org_unit_path: Unidade organizacional (padrão: "/")
  - change_password_at_next_login: Forçar troca de senha (padrão: true)
  - recovery_email: E-mail de recuperação
  - recovery_phone: Telefone de recuperação
  - suspended: Se a conta inicia suspensa (padrão: false)

3. Listar e Gerenciar Grupos

Use GOOGLE_ADMIN_LIST_GROUPS para listar grupos e GOOGLE_ADMIN_CREATE_GROUP para criar novos.

Ferramenta: GOOGLE_ADMIN_LIST_GROUPS
Parâmetros:
  - customer: "my_customer" (padrão)
  - domain: Filtrar por domínio
  - query: Filtro (ex.: "name=Engenharia*")
  - max_results: Máximo de resultados (1-200)
  - order_by: Ordenar por "email"
  - page_token: Token de paginação

Ferramenta: GOOGLE_ADMIN_CREATE_GROUP
Parâmetros:
  - email (obrigatório): Endereço de e-mail do grupo (ex.: "[email protected]")
  - name (obrigatório): Nome de exibição (ex.: "Equipe de Engenharia")
  - description: Descrição do propósito do grupo

4. Adicionar Usuários a Grupos

Use GOOGLE_ADMIN_ADD_USER_TO_GROUP para gerenciar associações a grupos.

Ferramenta: GOOGLE_ADMIN_ADD_USER_TO_GROUP
Parâmetros:
  - group_key (obrigatório): E-mail ou ID do grupo
  - user_key (obrigatório): E-mail ou ID do usuário a ser adicionado
  - role: "MEMBER" (padrão), "MANAGER" ou "OWNER"

5. Suspender ou Reativar Usuários

Use GOOGLE_ADMIN_SUSPEND_USER para alternar a suspensão da conta do usuário.

Ferramenta: GOOGLE_ADMIN_SUSPEND_USER
Parâmetros:
  - user_key (obrigatório): E-mail ou ID único do usuário
  - suspended: true para suspender, false para reativar (padrão: true)
  - suspension_reason: Motivo da suspensão (opcional)

6. Obter Detalhes de Usuário ou Grupo

Use GOOGLE_ADMIN_GET_USER ou GOOGLE_ADMIN_GET_GROUP para recuperar informações detalhadas.

Ferramenta: GOOGLE_ADMIN_GET_USER
Parâmetros:
  - user_key (obrigatório): E-mail ou ID único do usuário

Ferramenta: GOOGLE_ADMIN_GET_GROUP
Parâmetros:
  - group_key (obrigatório): E-mail ou ID único do grupo

Padrões Comuns

• Fluxo de integração: Use GOOGLE_ADMIN_CREATE_USER para provisionar a conta, depois GOOGLE_ADMIN_ADD_USER_TO_GROUP para adicioná-la aos grupos relevantes.
• Fluxo de desligamento: Use GOOGLE_ADMIN_SUSPEND_USER para desabilitar o acesso, ou GOOGLE_ADMIN_DELETE_USER para remoção permanente.
• Auditar associações a grupos: Use GOOGLE_ADMIN_LIST_GROUPS para encontrar grupos, depois GOOGLE_ADMIN_LIST_GROUP_MEMBERS para revisar membros.
• Gerenciamento em massa de usuários: Liste usuários com GOOGLE_ADMIN_LIST_USERS e consultas de filtro, depois itere para atualizações.
• Adicionar aliases de e-mail: Use GOOGLE_ADMIN_ADD_USER_ALIAS para adicionar endereços de e-mail alternativos para um usuário.
• Consultar detalhes do usuário: Use GOOGLE_ADMIN_GET_USER para recuperar o perfil completo antes de fazer alterações.

Armadilhas Conhecidas

• Privilégios de administrador necessários: Todas as ferramentas exigem que o usuário autenticado tenha privilégios de administrador do Google Workspace. Contas sem privilégios de administrador receberão erros de permissão.
• Exclusão é permanente: GOOGLE_ADMIN_DELETE_USER remove permanentemente uma conta de usuário. Esta ação não pode ser desfeita.
• user_key aceita e-mail ou ID: O parâmetro user_key aceita tanto o e-mail principal do usuário quanto seu ID numérico único.
• Associação a grupo substitui: Ao adicionar a grupos, o parâmetro role controla a função do membro. Não há "atualizar função" — remova e adicione novamente para alterar funções.
• ID do cliente: Use "my_customer" como parâmetro customer para a organização do usuário autenticado. IDs de clientes específicos têm a aparência C01abc123.
• Paginação: Tanto os endpoints de listagem de usuários quanto de grupos podem retornar resultados paginados. Sempre verifique se há page_token nas respostas para obter resultados completos.
• Requisitos de senha: GOOGLE_ADMIN_CREATE_USER exige uma senha que atenda à política de senhas do domínio. Senhas fracas serão rejeitadas.

Referência Rápida

Ação	Ferramenta	Parâmetros Principais
Listar usuários	GOOGLE_ADMIN_LIST_USERS	customer, domain, query, max_results
Obter detalhes do usuário	GOOGLE_ADMIN_GET_USER	user_key
Criar usuário	GOOGLE_ADMIN_CREATE_USER	primary_email, given_name, family_name, password
Excluir usuário	GOOGLE_ADMIN_DELETE_USER	user_key
Suspender usuário	GOOGLE_ADMIN_SUSPEND_USER	user_key, suspended
Adicionar alias de usuário	GOOGLE_ADMIN_ADD_USER_ALIAS	(veja esquema completo via RUBE_SEARCH_TOOLS)
Listar grupos	GOOGLE_ADMIN_LIST_GROUPS	customer, domain, query
Obter detalhes do grupo	GOOGLE_ADMIN_GET_GROUP	group_key
Criar grupo	GOOGLE_ADMIN_CREATE_GROUP	email, name, description
Adicionar ao grupo	GOOGLE_ADMIN_ADD_USER_TO_GROUP	group_key, user_key, role
Listar membros do grupo	GOOGLE_ADMIN_LIST_GROUP_MEMBERS	(veja esquema completo via RUBE_SEARCH_TOOLS)

---

Desenvolvido por Composio