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 가져오기: 클라이언트 구성에 https://rube.app/mcp를 MCP 서버로 추가하세요. API 키는 필요하지 않습니다. 엔드포인트만 추가하면 작동합니다.
RUBE_SEARCH_TOOLS가 응답하는지 확인하여 Rube MCP가 사용 가능한지 확인합니다.RUBE_MANAGE_CONNECTIONS를 호출하고 툴킷을google_admin으로 지정합니다.- 연결이 ACTIVE 상태가 아니라면 반환된 인증 링크를 따라 설정을 완료합니다.
- 워크플로를 실행하기 전에 연결 상태가 ACTIVE인지 확인합니다.
핵심 워크플로
1. 모든 사용자 나열
GOOGLE_ADMIN_LIST_USERS를 사용하여 선택적 필터링 및 페이징과 함께 Google Workspace 사용자를 검색합니다.
Tool: GOOGLE_ADMIN_LIST_USERS
Parameters:
- 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 계정을 프로비저닝합니다.
Tool: GOOGLE_ADMIN_CREATE_USER
Parameters:
- 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으로 새 그룹을 생성합니다.
Tool: GOOGLE_ADMIN_LIST_GROUPS
Parameters:
- customer: "my_customer" (기본값)
- domain: 도메인별 필터
- query: 필터 (예: "name=Engineering*")
- max_results: 최대 결과 수 (1-200)
- order_by: "email"로 정렬
- page_token: 페이징 토큰
Tool: GOOGLE_ADMIN_CREATE_GROUP
Parameters:
- email (필수): 그룹 이메일 주소 (예: "[email protected]")
- name (필수): 표시 이름 (예: "Engineering Team")
- description: 그룹 목적 설명
4. 그룹에 사용자 추가
GOOGLE_ADMIN_ADD_USER_TO_GROUP을 사용하여 그룹 멤버십을 관리합니다.
Tool: GOOGLE_ADMIN_ADD_USER_TO_GROUP
Parameters:
- group_key (필수): 그룹 이메일 또는 ID
- user_key (필수): 추가할 사용자 이메일 또는 ID
- role: "MEMBER" (기본값), "MANAGER" 또는 "OWNER"
5. 사용자 정지 또는 정지 해제
GOOGLE_ADMIN_SUSPEND_USER를 사용하여 사용자 계정 정지 상태를 전환합니다.
Tool: GOOGLE_ADMIN_SUSPEND_USER
Parameters:
- user_key (필수): 사용자 이메일 또는 고유 ID
- suspended: true는 정지, false는 정지 해제 (기본값: true)
- suspension_reason: 정지 사유 (선택 사항)
6. 사용자 또는 그룹 상세 정보 보기
GOOGLE_ADMIN_GET_USER 또는 GOOGLE_ADMIN_GET_GROUP을 사용하여 상세 정보를 검색합니다.
Tool: GOOGLE_ADMIN_GET_USER
Parameters:
- user_key (필수): 사용자 이메일 또는 고유 ID
Tool: GOOGLE_ADMIN_GET_GROUP
Parameters:
- 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로 확인) |
Composio 제공