Comprobaciones de estado externas

Una comprobación de estado externa envía los merge requests de un proyecto a un servicio externo, que responde con un estado de aprobado o fallido que puede condicionar el merge. Estas acciones gestionan las comprobaciones de un proyecto (listar, crear, actualizar, borrar), listan el estado de cada comprobación en un merge request, fijan ese estado y reintentan una comprobación que falló.

Preguntas de ejemplo

• “¿Qué comprobaciones de estado externas tiene el proyecto 42?”
• “Muestra las comprobaciones de estado del merge request !15”
• “Reintenta la comprobación de cumplimiento fallida del merge request !15”

Cómo llamarlo

• Dinámica, la superficie predeterminada: llama a gitlab_execute_action con action igual al ID de la acción, como external_status_check.create_project, 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_external_status_check con action igual al nombre de la acción, como create_project, y sus parámetros en params.
• Individual (GITLAB_MCP_TOOL_SURFACE=individual): llama a la herramienta propia de la acción, como gitlab_create_project_external_status_check, pasándole directamente sus parámetros.

Disponibilidad

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

• Free: 0
• Premium: 0
• Ultimate: 8

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

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
external_status_check.create_project	gitlab_create_project_external_status_check
external_status_check.delete_project	gitlab_delete_project_external_status_check
external_status_check.list_project	gitlab_list_project_external_status_checks
external_status_check.list_project_checks	gitlab_list_project_status_checks
external_status_check.list_project_mr_checks	gitlab_list_project_mr_external_status_checks
external_status_check.retry_project	gitlab_retry_failed_external_status_check_for_project_mr
external_status_check.set_project_mr_status	gitlab_set_project_mr_external_status_check_status
external_status_check.update_project	gitlab_update_project_external_status_check

external_status_check.create_project

Create an external status check service for a project. Returns: the created check with id, name, external_url, hmac, and protected branches. See also: external_status_check.list_project, external_status_check.update_project, external_status_check.delete_project.

• Meta-herramienta: gitlab_external_status_check, acción create_project
• Herramienta individual: gitlab_create_project_external_status_check
• Nivel: Ultimate
• Token clásico u OAuth: api
• Token de grano fino: External Status Check Service: Create en proyecto (página de permisos)
• Comportamiento: escribe, no idempotente

Parámetro	Tipo	Requerido	Descripción
external_url	string	sí	External URL for the status check
name	string	sí	Name of the external status check
project_id	string/integer	sí	Project ID or URL-encoded path
protected_branch_ids	integer[]	no	IDs of protected branches to scope the check to
shared_secret	string	no	Shared secret for HMAC verification

external_status_check.delete_project

Delete a project external status check service permanently. Returns: a success confirmation. See also: external_status_check.list_project, external_status_check.create_project, external_status_check.update_project.

• Meta-herramienta: gitlab_external_status_check, acción delete_project
• Herramienta individual: gitlab_delete_project_external_status_check
• Nivel: Ultimate
• Token clásico u OAuth: api
• Token de grano fino: External Status Check Service: Delete en proyecto (página de permisos)
• Comportamiento: escribe, destructiva (necesita confirmación), idempotente

Parámetro	Tipo	Requerido	Descripción
check_id	integer	sí	External status check ID to delete
project_id	string/integer	sí	Project ID or URL-encoded path

external_status_check.list_project

List a project’s external status check services. Returns: each check with id, name, external_url, hmac, protected branches, and pagination metadata. See also: external_status_check.create_project, external_status_check.update_project, external_status_check.delete_project, external_status_check.list_project_mr_checks.

• Meta-herramienta: gitlab_external_status_check, acción list_project
• Herramienta individual: gitlab_list_project_external_status_checks
• Nivel: Ultimate
• Token clásico u OAuth: read_api (o api)
• Token de grano fino: External Status Check Service: Read en proyecto (página de permisos)
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
project_id	string/integer	sí	Project ID or URL-encoded path
order_by	string	no	Column to order by for keyset pagination (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.
sort	string (asc, desc)	no	Sort direction: asc or desc

external_status_check.list_project_checks

List a project’s external status check services (deprecated endpoint). Returns: each check with id, name, external_url, hmac, protected branches, and pagination metadata. See also: external_status_check.list_project, external_status_check.create_project, external_status_check.list_project_mr_checks.

• Meta-herramienta: gitlab_external_status_check, acción list_project_checks
• Herramienta individual: gitlab_list_project_status_checks
• Nivel: Ultimate
• Token clásico u OAuth: read_api (o api)
• Token de grano fino: External Status Check Service: Read en proyecto (página de permisos)
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
project_id	string/integer	sí	Project ID or URL-encoded path
order_by	string	no	Column to order by for keyset pagination (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.
sort	string (asc, desc)	no	Sort direction: asc or desc

external_status_check.list_project_mr_checks

List the external status checks for a merge request and their status. Returns: each check with id, name, external_url, status, and pagination metadata. See also: external_status_check.list_project, external_status_check.set_project_mr_status, external_status_check.retry_project.

• Meta-herramienta: gitlab_external_status_check, acción list_project_mr_checks
• Herramienta individual: gitlab_list_project_mr_external_status_checks
• Nivel: Ultimate
• Token clásico u OAuth: read_api (o api)
• Token de grano fino: External Status Check: Read en proyecto (página de permisos)
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
merge_request_iid	integer	sí	Merge request internal ID
project_id	string/integer	sí	Project ID or URL-encoded path
order_by	string	no	Column to order by for keyset pagination (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.
sort	string (asc, desc)	no	Sort direction: asc or desc

external_status_check.retry_project

Retry a failed external status check for a merge request. Returns: a success confirmation. See also: external_status_check.list_project_mr_checks, external_status_check.set_project_mr_status.

• Meta-herramienta: gitlab_external_status_check, acción retry_project
• Herramienta individual: gitlab_retry_failed_external_status_check_for_project_mr
• Nivel: Ultimate
• Token clásico u OAuth: api
• Token de grano fino: External Status Check: Retry en proyecto (página de permisos)
• Comportamiento: escribe, idempotente

Parámetro	Tipo	Requerido	Descripción
check_id	integer	sí	External status check ID to retry
merge_request_iid	integer	sí	Merge request internal ID
project_id	string/integer	sí	Project ID or URL-encoded path

external_status_check.set_project_mr_status

Set the status of an external status check for a merge request. Returns: a success confirmation. See also: external_status_check.list_project_mr_checks, external_status_check.retry_project.

• Meta-herramienta: gitlab_external_status_check, acción set_project_mr_status
• Herramienta individual: gitlab_set_project_mr_external_status_check_status
• Nivel: Ultimate
• Token clásico u OAuth: api
• Token de grano fino: External Status Check: Update en proyecto (página de permisos)
• Comportamiento: escribe, idempotente

Parámetro	Tipo	Requerido	Descripción
external_status_check_id	integer	sí	External status check ID to update
merge_request_iid	integer	sí	Merge request internal ID
project_id	string/integer	sí	Project ID or URL-encoded path
sha	string	sí	Head SHA of the merge request source branch
status	string	sí	Status value (e.g. passed, failed)

external_status_check.update_project

Update a project external status check service. Returns: the updated check with id, name, external_url, hmac, and protected branches. See also: external_status_check.list_project, external_status_check.create_project, external_status_check.delete_project.

• Meta-herramienta: gitlab_external_status_check, acción update_project
• Herramienta individual: gitlab_update_project_external_status_check
• Nivel: Ultimate
• Token clásico u OAuth: api
• Token de grano fino: External Status Check Service: Update en proyecto (página de permisos)
• Comportamiento: escribe, idempotente

Parámetro	Tipo	Requerido	Descripción
check_id	integer	sí	External status check ID to update
project_id	string/integer	sí	Project ID or URL-encoded path
external_url	string	no	Updated external URL
name	string	no	Updated name
protected_branch_ids	integer[]	no	Updated protected branch IDs
shared_secret	string	no	Updated shared secret for HMAC verification