# environment — gitlab

> 18 acciones
> Esta página en markdown. Índice: https://mcp.jmrp.io/llms.txt

Canonical: https://mcp.jmrp.io/es/servers/gitlab/actions/environment/
Language: es
Alternate: https://mcp.jmrp.io/servers/gitlab/actions/environment/index.md
Updated: 2026-09-22T21:41:36+02:00
License: https://mcp.jmrp.io/es/license/

Contado con un token Free contra gitlab.com, que es el único host con el que habla este endpoint: para usarlo contra una instancia self-managed, levanta tú el servidor — su documentación lo cubre. El catálogo depende del token que pregunta, así que el recuento se mueve con su tier y con sus permisos: los tiers superiores exponen más acciones, y los dominios de administración solo aparecen a tokens autorizados a usarlos. Por eso las cifras difieren en otros sitios: el proyecto upstream cataloga 1.006 acciones en 162 dominios, y 851 en la superficie Free/CE, mientras que este despliegue publica 765 porque es solo-OAuth y actúa con tu token, así que los dominios de administración que una cuenta sin admin no puede llamar no aparecen nunca. Las tres describen el mismo catálogo, contado desde tres sitios distintos.

## Acciones

### `environment.create` — Environment Create

Create an environment in a project. Use when introducing new runtime targets such as review, staging, or production environments.

**Parámetros obligatorios:** `name (string)`, `project_id (string|integer)`

### `environment.delete` — Environment Delete

_destructiva_

Delete a stopped environment from a project. Returns: a success confirmation naming the deleted environment. See also: environment.stop, environment.list, environment.get.

**Parámetros obligatorios:** `environment_id (integer)`, `project_id (string|integer)`

### `environment.deployment_approve_or_reject` — Deployment Approve Or Reject

Approve or reject a blocked deployment awaiting protected-environment approval, optionally with a comment and an approval rule to represent. Returns: a confirmation message naming the deployment and the applied status. See also: environment.deployment_get, environment.deployment_update.

**Parámetros obligatorios:** `deployment_id (integer)`, `project_id (string|integer)`, `status (string)`

### `environment.deployment_create` — Deployment Create

Create a deployment record for an environment at a given ref and sha with an initial status. Returns: the created deployment with id, iid, ref, sha, status, and nested user, environment, and deployable objects. See also: environment.get, environment.deployment_list, environment.deployment_update.

**Parámetros obligatorios:** `environment (string)`, `project_id (string|integer)`, `ref (string)`, `sha (string)`

### `environment.deployment_delete` — Deployment Delete

_destructiva_

Delete a deployment record by deployment_id within a project. Returns: a confirmation that the deployment was deleted. See also: environment.deployment_get, environment.deployment_list.

**Parámetros obligatorios:** `deployment_id (integer)`, `project_id (string|integer)`

### `environment.deployment_get` — Deployment Get

_solo lectura_

Get one deployment by deployment_id for a project. Use when investigating a specific deployment state, environment, or actor metadata.

**Parámetros obligatorios:** `deployment_id (integer)`, `project_id (string|integer)`

### `environment.deployment_list` — Deployment List

_solo lectura_

List deployments in a project with environment, status, and date filters plus offset or keyset pagination. Returns: matching deployments with ref, sha, status, user, environment, and deployable (CI job) objects, and pagination metadata. See also: environment.deployment_get, environment.list, pipeline.get.

**Parámetros obligatorios:** `project_id (string|integer)`

### `environment.deployment_merge_requests` — List Deployment Merge Requests

_solo lectura_

List the merge requests associated with a deployment, with merge-request filtering (state, approval, author, assignee, draft, created date) and offset or keyset pagination. Returns: matching merge requests with full metadata (author, assignees, reviewers, labels, milestone, pipelines, time stats, timestamps) and pagination metadata. See also: merge_request.get, merge_request.list, environment.deployment_list.

**Parámetros obligatorios:** `deployment_id (integer)`, `project_id (string|integer)`

### `environment.deployment_update` — Deployment Update

Update a deployment's status by deployment_id within a project. Returns: the updated deployment with id, iid, ref, sha, status, and nested user, environment, and deployable objects. See also: environment.deployment_get, environment.deployment_list, environment.deployment_approve_or_reject.

**Parámetros obligatorios:** `deployment_id (integer)`, `project_id (string|integer)`, `status (string)`

### `environment.freeze_create` — Create Freeze Period

Create a deploy freeze period for a project. Returns: the created freeze period with id, freeze_start/freeze_end cron expressions, and cron_timezone.

**Parámetros obligatorios:** `freeze_end (string)`, `freeze_start (string)`, `project_id (string|integer)`

### `environment.freeze_delete` — Delete Freeze Period

_destructiva_

Delete a deploy freeze period. Returns: no content on success (HTTP 204).

**Parámetros obligatorios:** `freeze_period_id (integer)`, `project_id (string|integer)`

### `environment.freeze_get` — Get Freeze Period

_solo lectura_

Get a specific deploy freeze period. Returns: the freeze period's id, freeze_start/freeze_end cron expressions, cron_timezone, and created/updated timestamps.

**Parámetros obligatorios:** `freeze_period_id (integer)`, `project_id (string|integer)`

### `environment.freeze_list` — List Freeze Periods

_solo lectura_

List deploy freeze periods for a project. Returns: each freeze period's id, freeze_start/freeze_end cron expressions, cron_timezone, and created/updated timestamps.

**Parámetros obligatorios:** `project_id (string|integer)`

### `environment.freeze_update` — Update Freeze Period

Update an existing deploy freeze period. Returns: the updated freeze period with id, freeze_start/freeze_end cron expressions, and cron_timezone.

**Parámetros obligatorios:** `freeze_period_id (integer)`, `project_id (string|integer)`

### `environment.get` — Environment Get

_solo lectura_

Get one environment by environment_id. Use when inspecting state, tier, external URL, and stop behavior of a specific environment.

**Parámetros obligatorios:** `environment_id (integer)`, `project_id (string|integer)`

### `environment.list` — Environment List

_solo lectura_

List environments in one project with filters and pagination. Use this to discover environment IDs before get/update/stop/delete operations.

**Parámetros obligatorios:** `project_id (string|integer)`

### `environment.stop` — Environment Stop

_destructiva_

Stop an active environment. This is modeled as a delete-style action but intentionally marked non-destructive because it changes runtime state without deleting the environment resource.

**Parámetros obligatorios:** `environment_id (integer)`, `project_id (string|integer)`

### `environment.update` — Environment Update

Update an existing environment in a project. Returns: the updated environment with state, tier, external URL, cluster agent, Kubernetes namespace, Flux resource path, and auto-stop settings. See also: environment.get, environment.list, environment.stop.

**Parámetros obligatorios:** `environment_id (integer)`, `project_id (string|integer)`