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 키가 필요하지 않으며, 엔드포인트만 추가하면 작동합니다.
RUBE_SEARCH_TOOLS가 응답하는지 확인하여 Rube MCP가 작동 중인지 확인google_admin툴킷으로RUBE_MANAGE_CONNECTIONS호출- 연결이 ACTIVE 상태가 아니면 반환된 인증 링크를 따라 설정 완료
- 워크플로우를 실행하기 전에 연결 상태가 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 (필수): 표시 이름 (예: "엔지니어링 팀")
- 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 참조) |
Composio 제공