Usuarios empresariales

Los usuarios empresariales son las cuentas que posee un grupo de nivel superior, normalmente porque el dominio de su correo está verificado para el grupo. Estas acciones los listan y los leen, desactivan la autenticación en dos pasos de un usuario y borran uno.

Preguntas de ejemplo

• “Lista los usuarios empresariales del grupo acme”
• “Desactiva la autenticación en dos pasos del usuario empresarial 42”
• “Muestra el usuario empresarial alice”

Cómo llamarlo

• Dinámica, la superficie predeterminada: llama a gitlab_execute_action con action igual al ID de la acción, como enterprise_user.delete, y sus parámetros en params. gitlab_find_action encuentra un ID a partir de una descripción de la tarea.
• Meta (GITLAB_MCP_TOOL_SURFACE=meta): llama a gitlab_enterprise_user con action igual al nombre de la acción, como delete, y sus parámetros en params.
• Individual (GITLAB_MCP_TOOL_SURFACE=individual): llama a la herramienta propia de la acción, como gitlab_delete_enterprise_user, pasándole directamente sus parámetros.

Disponibilidad

Cuántas de estas acciones sirve una instancia en cada nivel, de un total de 4:

• Free: 0
• Premium: 4
• Ultimate: 4

Solo se lista para un token que tenga admin_mode: el servidor quita el grupo de todas las superficies a un token cuyos ámbitos conoce y que no lo tiene.

Acciones de solo lectura: 2 de 4, las que conserva un despliegue en modo de solo lectura. A un token con read_api y sin api se le sirven 2 de las 4.

Acciones

La descripción de cada acción, y la de cada uno de sus parámetros, es el texto que sirve el servidor para ella en la superficie predeterminada, citado tal cual; por eso está en inglés. Las líneas de token dicen lo que exige GitLab 19.4.1 a un token para las peticiones que envía cada acción; en una instancia con Admin Mode activado, una acción que solo puede ejecutar un administrador necesita además admin_mode. Una acción destructiva solo se ejecuta una vez confirmada, salvo que GITLAB_MCP_YOLO_MODE (o AUTOPILOT) se salte ese paso: la superficie dinámica necesita confirm: true en gitlab_execute_action, y las otras dos aceptan un parámetro confirm o la pregunta del cliente (Acciones destructivas).

Acción	Individual
enterprise_user.delete	gitlab_delete_enterprise_user
enterprise_user.disable_2fa	gitlab_disable_2fa_enterprise_user
enterprise_user.get	gitlab_get_enterprise_user
enterprise_user.list	gitlab_list_enterprise_users

enterprise_user.delete

Delete an enterprise user, optionally with hard_delete. Returns: a success confirmation naming the user and group. See also: enterprise_user.get, enterprise_user.list, enterprise_user.disable_2fa.

• Meta-herramienta: gitlab_enterprise_user, acción delete
• Herramienta individual: gitlab_delete_enterprise_user
• Nivel: Premium
• Token clásico u OAuth: api; este servidor solo lista el grupo a un token que lleve además admin_mode
• Token de grano fino: Enterprise User: Delete en grupo (página de permisos)
• Comportamiento: escribe, destructiva (necesita confirmación), idempotente

Parámetro	Tipo	Requerido	Descripción
group_id	string/integer	sí	Group ID or URL-encoded path
user_id	integer	sí	User ID
hard_delete	boolean	no	Permanently delete user instead of soft delete

enterprise_user.disable_2fa

Disable two-factor authentication for an enterprise user. Returns: a success confirmation naming the user and group. See also: enterprise_user.get, enterprise_user.list, enterprise_user.delete.

• Meta-herramienta: gitlab_enterprise_user, acción disable_2fa
• Herramienta individual: gitlab_disable_2fa_enterprise_user
• Nivel: Premium
• Token clásico u OAuth: api; este servidor solo lista el grupo a un token que lleve además admin_mode
• Token de grano fino: Enterprise User: Disable Two Factor en grupo (página de permisos)
• Comportamiento: escribe, destructiva (necesita confirmación), idempotente

Parámetro	Tipo	Requerido	Descripción
group_id	string/integer	sí	Group ID or URL-encoded path
user_id	integer	sí	User ID

enterprise_user.get

Get a single enterprise user by group_id and user_id. Returns: the full user profile (identities, SCIM identities, custom attributes, sign-in metadata, admin/auditor flags, license seat usage, and web URL). See also: enterprise_user.list, enterprise_user.disable_2fa, enterprise_user.delete.

• Meta-herramienta: gitlab_enterprise_user, acción get
• Herramienta individual: gitlab_get_enterprise_user
• Nivel: Premium
• Token clásico u OAuth: read_api (o api); este servidor solo lista el grupo a un token que lleve además admin_mode
• Token de grano fino: Enterprise User: Read en grupo (página de permisos)
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
group_id	string/integer	sí	Group ID or URL-encoded path
user_id	integer	sí	User ID

enterprise_user.list

List enterprise users for a top-level group with filtering and pagination. Returns: enterprise users with full profile fields (identities, SCIM identities, custom attributes, sign-in metadata, license seat usage) and pagination metadata. See also: enterprise_user.get, enterprise_user.disable_2fa, enterprise_user.delete.

• Meta-herramienta: gitlab_enterprise_user, acción list
• Herramienta individual: gitlab_list_enterprise_users
• Nivel: Premium
• Token clásico u OAuth: read_api (o api); este servidor solo lista el grupo a un token que lleve además admin_mode
• Token de grano fino: Enterprise User: Read en grupo (página de permisos)
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
group_id	string/integer	sí	Group ID or URL-encoded path
active	boolean	no	Filter for active users only
blocked	boolean	no	Filter for blocked users only
created_after	string	no	Filter users created after this date (ISO 8601)
created_before	string	no	Filter users created before this date (ISO 8601)
order_by	string	no	Column to order keyset-paginated results by (e.g. id)
page	integer	no	Page number to fetch, 1-based. Defaults to 1. Use the next_page field from the previous response to paginate forward.
page_token	string	no	Next page of a keyset listing: the next_page_token of the previous response of this action, passed back unchanged. It carries the position and every filter of the listing as GitLab read them, and those are what the next page is asked with, whatever filters are sent beside it. Leave it empty for the first page.
pagination	string	no	Pagination method: ‘keyset’ for keyset-based pagination on large ordered result sets, or ‘offset’ (the default). Keyset avoids deep-offset cost, and a keyset page names the next one in next_page_token rather than next_page.
per_page	integer	no	Items per page. Defaults to 20, minimum 1, maximum 100. Use 100 to minimize round trips when the result set is large.
search	string	no	Search by name or username or email
sort	string (asc, desc)	no	Sort order for keyset pagination: asc or desc
two_factor	string (enabled, disabled)	no	Filter by 2FA status: enabled or disabled
username	string	no	Filter by exact username