> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/devops/devops-es/servidor-mcp/uso-de-las-herramientas-mcp-de-devops.md).

# Uso de las herramientas MCP de DevOps

{% hint style="warning" %}

#### Beta

El servidor MCP de DevOps está en beta. Es posible que algunas herramientas aún no funcionen como se espera y que esta documentación no refleje los cambios más recientes en el servidor.
{% endhint %}

## ![](https://2574462044-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FG5ZbxX918xOHwbAwAJ4n%2FSummary2-Small-Icon.svg?alt=media\&token=da26a67f-ff7f-47b3-8669-06be960dc2d7) Descripción general

Este artículo explica cómo usar las herramientas de DevOps MCP después de que conectes tu asistente de IA al servidor DevOps MCP. Cubre dónde encontrar tu ID de topología, cómo pedirle al asistente que trabaje con tus datos de DevOps y las herramientas que proporciona el servidor DevOps MCP.

El artículo enumera cada herramienta con una breve descripción, pero no necesitas conocer los nombres de las herramientas para usarlas. Pídele al asistente lo que quieras en lenguaje natural, y él elegirá qué herramientas usar. El asistente trabaja en DevOps como el usuario de Flosum con el que iniciaste sesión cuando lo conectaste.

{% hint style="info" %}

#### Antes de empezar

Conecta primero tu asistente de IA al servidor DevOps MCP. Consulta los siguientes artículos.

* [Conectando ChatGPT al Servidor MCP de DevOps](https://docs.flosum.com/devops/devops-es/servidor-mcp/conectando-chatgpt-al-servidor-mcp-de-devops.md)
* [Conectando Claude al Servidor MCP de DevOps](https://docs.flosum.com/devops/devops-es/servidor-mcp/conectando-claude-al-servidor-mcp-de-devops.md)
  {% endhint %}

## Dónde encontrar tu ID de topología

Casi todas las herramientas de DevOps MCP funcionan dentro de una sola topología, por lo que el asistente necesita el ID de tu topología. El ID aparece en la barra de direcciones cuando abres la topología en Global Settings.

{% stepper %}
{% step %}

### Iniciar sesión en Global Settings

Inicia sesión en Global Settings. Para obtener instrucciones de inicio de sesión, consulta el siguiente artículo.

* [Iniciar sesión en Configuración global](https://docs.flosum.com/global-settings/global-settings-docs-es/primeros-pasos/iniciar-sesion-en-configuracion-global.md)
  {% endstep %}

{% step %}

### Abrir la topología

1. Haz clic en **Topologías** en el menú de la barra lateral izquierda.
2. Haz clic en la topología en la que trabajas.

   <div align="left"><figure><img src="https://content.gitbook.com/content/RpUu5iMlzMFAudyBvMOl/blobs/xWdziKIFSqQTpfZZVItJ/UsingDevOpsMCPTools-001.png" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Copiar el ID de la topología

1. Copia el número al final de la URL en la barra de direcciones de tu navegador. Este es el ID de la topología.

   <div align="left"><figure><img src="https://content.gitbook.com/content/RpUu5iMlzMFAudyBvMOl/blobs/uhldb3nWUZW2fPbogALT/UsingDevOpsMCPTools-002.png" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
Por ejemplo, en `https://global-us.flosum.app/topologies/123`, el ID de la topología es `123`.
{% endhint %}
{% endstep %}
{% endstepper %}

## Uso de las herramientas

Inicia un nuevo chat con tu asistente de IA e incluye tu ID de topología en tu solicitud. El asistente lo usa para el resto del chat. Por ejemplo:

* Enumera las ramas en la topología `<Topology ID>` usando el Flosum DevOps MCP.
* Muéstrame las solicitudes de extracción abiertas en la topología `<Topology ID>`.
* Enumera las últimas cinco implementaciones en la topología `<Topology ID>`.
* Muestra los pasos en la canalización llamada `<pipeline name>` en la topología `<Topology ID>`.

El siguiente ejemplo muestra a Claude enumerando las últimas cinco implementaciones en una topología.

<div align="left"><figure><img src="https://content.gitbook.com/content/RpUu5iMlzMFAudyBvMOl/blobs/7MSFYA9Mjp84OsQH6nzt/UsingDevOpsMCPTools-003.png" alt="" width="563"><figcaption></figcaption></figure></div>

Haz referencia a las ramas, solicitudes de extracción y canalizaciones por nombre. El asistente busca sus ID con las herramientas.

{% hint style="warning" %}

#### Aprobación de herramientas

Es posible que tu asistente de IA te pida aprobar una herramienta antes de ejecutarla. Revisa qué va a hacer la herramienta antes de aprobarla, especialmente si es una herramienta que cambia datos. Una implementación, reversión o fusión cambia tus organizaciones o ramas de Salesforce en cuanto se ejecuta.
{% endhint %}

## Herramientas que leen datos

Estas herramientas leen datos de DevOps y no cambian nada.

<details>

<summary>Ramas y commits</summary>

| Herramienta                       | Qué hace                                                                                                     |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `list_branches`                   | Enumera las ramas, filtradas por nombre, entorno, activas o obsoletas, creador, fecha o rama predeterminada. |
| `get_branch`                      | Obtiene los detalles de una rama.                                                                            |
| `list_commits`                    | Enumera el historial de commits de una rama, del más reciente al más antiguo.                                |
| `get_commit`                      | Obtiene el mensaje, hash, hora y autor de un commit.                                                         |
| `list_commit_components`          | Enumera los componentes que cambió un commit.                                                                |
| `list_component_versions`         | Enumera la versión más reciente de cada componente en una rama.                                              |
| `get_component_version`           | Obtiene una versión de componente, con sus archivos y el commit que la introdujo.                            |
| `list_fit_component_dependencies` | Enumera las dependencias de una versión de componente en una rama.                                           |

</details>

<details>

<summary>Componentes de la organización</summary>

| Herramienta                    | Qué hace                                                                              |
| ------------------------------ | ------------------------------------------------------------------------------------- |
| `list_organization_components` | Enumera los componentes que DevOps ha almacenado para una organización de Salesforce. |
| `get_organization_component`   | Obtiene un componente de la organización, con sus archivos de metadatos.              |
| `list_component_dependencies`  | Enumera las dependencias de un componente de la organización.                         |

</details>

<details>

<summary>Solicitudes de extracción</summary>

| Herramienta                             | Qué hace                                                                                                                                            |
| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `list_pull_requests`                    | Enumera las solicitudes de extracción, filtradas por estado, ramas, creador, revisor o fecha.                                                       |
| `get_pull_request`                      | Obtiene una solicitud de extracción, con sus ramas, revisores y estado.                                                                             |
| `list_pull_request_activities`          | Enumera la cronología de una solicitud de extracción: creada, commits, solicitudes de revisión, cambios solicitados, aprobada, fusionada y cerrada. |
| `list_pull_request_conversations`       | Enumera los hilos de revisión de una solicitud de extracción.                                                                                       |
| `list_pull_request_reviewers`           | Enumera los revisores y su estado de revisión.                                                                                                      |
| `list_available_pull_request_reviewers` | Enumera los usuarios que pueden asignarse como revisores.                                                                                           |
| `list_pull_request_merge_rules`         | Enumera las reglas de aprobación de solicitudes de extracción.                                                                                      |
| `get_conflicts`                         | Comprueba si hay conflictos de fusión entre una rama de origen y una rama de destino.                                                               |
| `list_conflict_components`              | Enumera los componentes en conflicto.                                                                                                               |

</details>

<details>

<summary>Implementaciones</summary>

| Herramienta                  | Qué hace                                                                                                         |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| `list_deployments`           | Enumera el historial de Validación, Despliegue, Despliegue rápido y Reversión, con la organización de destino.   |
| `list_deployment_components` | Enumera los componentes que procesó una implementación, con estado, tipo de cambio y cualquier mensaje de error. |
| `list_deployment_changes`    | Enumera los cambios de componentes en los resultados de una implementación.                                      |
| `get_deployment_stats`       | Obtiene el número de componentes que tuvieron éxito y fallaron en una implementación.                            |
| `get_deployment_tests`       | Obtiene los totales de pruebas Apex para una implementación.                                                     |

</details>

<details>

<summary>Canalizaciones</summary>

| Herramienta                     | Qué hace                                                                                                                                   |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `list_pipelines`                | Enumera las canalizaciones en la topología.                                                                                                |
| `get_pipeline`                  | Obtiene los detalles de una canalización.                                                                                                  |
| `list_steps`                    | Enumera los pasos de una canalización y cómo se vinculan en caso de éxito y de fallo.                                                      |
| `list_pipeline_launch_settings` | Enumera cuándo las canalizaciones se inician automáticamente: al hacer commit o al fusionar una solicitud de extracción, y para qué ramas. |
| `list_pipeline_runs`            | Enumera las ejecuciones de la canalización, con canalización, rama, desencadenador, estado y duración.                                     |
| `get_pipeline_run`              | Obtiene el estado de una ejecución.                                                                                                        |
| `list_run_steps`                | Enumera el estado de cada paso en una ejecución.                                                                                           |

</details>

<details>

<summary>Historial de actividad</summary>

| Herramienta       | Qué hace                                                                                                      |
| ----------------- | ------------------------------------------------------------------------------------------------------------- |
| `list_activities` | Enumera el historial de actividad, filtrado por tipo de trabajo, estado, creador, fecha, rama u organización. |
| `get_activity`    | Obtiene los detalles de una actividad.                                                                        |

</details>

<details>

<summary>Análisis de código</summary>

| Herramienta                     | Qué hace                                                                                            |
| ------------------------------- | --------------------------------------------------------------------------------------------------- |
| `get_code_scan_stats`           | Obtiene los hallazgos de un análisis de código por gravedad.                                        |
| `list_code_scan_components`     | Enumera los archivos de componentes en un análisis de código.                                       |
| `get_code_scan_component`       | Obtiene los hallazgos de un archivo, por gravedad: Bloqueador, Crítica, Mayor, Menor e Información. |
| `get_code_scan_component_stats` | Obtiene los conteos de gravedad de un archivo.                                                      |

</details>

<details>

<summary>Protección contra sobrescritura</summary>

| Herramienta                            | Qué hace                                                                                     |
| -------------------------------------- | -------------------------------------------------------------------------------------------- |
| `get_overwrite_protection_stats`       | Obtiene los totales de comparación para una comprobación de protección contra sobrescritura. |
| `list_overwrite_protection_components` | Enumera los componentes, por estado: Igual, Diferente o Nuevo.                               |
| `get_overwrite_protection_component`   | Obtiene un componente.                                                                       |
| `get_overwrite_protection_content`     | Obtiene el contenido de los archivos de un componente.                                       |

</details>

<details>

<summary>Corrección previa al despliegue</summary>

| Herramienta                                       | Qué hace                                                                                              |
| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `list_pre_deploy_fix_search_missing_dependencies` | Enumera las dependencias faltantes que encontró una búsqueda de corrección previa al despliegue.      |
| `list_pre_deploy_fix_search_api_version_issues`   | Enumera los problemas de versión de API que encontró una búsqueda de corrección previa al despliegue. |
| `list_pre_deploy_fix_retrieve_components`         | Enumera los componentes que recuperó una corrección previa al despliegue.                             |
| `list_pre_deploy_fix_remove_components`           | Enumera los componentes que eliminó una corrección previa al despliegue.                              |
| `list_pre_deploy_fix_update_components`           | Enumera los componentes que actualizó una corrección previa al despliegue.                            |

</details>

## Herramientas que cambian datos

Estas herramientas crean o cambian datos en DevOps, y algunas cambian tus organizaciones de Salesforce o tu repositorio Git.

<details>

<summary>Todas las herramientas que cambian datos</summary>

| Herramienta                        | Qué hace                                                                         |
| ---------------------------------- | -------------------------------------------------------------------------------- |
| `create_branch`                    | Crea una rama a partir de una rama existente.                                    |
| `create_commit`                    | Hace commit de componentes a una rama.                                           |
| `create_pull_request`              | Crea una solicitud de extracción, con revisores o sin ellos.                     |
| `update_pull_request`              | Cambia el título o la rama de destino de una solicitud de extracción.            |
| `set_pull_request_reviewers`       | Reemplaza los revisores de una solicitud de extracción.                          |
| `set_pull_request_review`          | Establece una revisión como Aprobada, Cambios solicitados o Revisión solicitada. |
| `create_pull_request_conversation` | Inicia un hilo de revisión en una línea de un archivo.                           |
| `create_pull_request_comment`      | Añade un comentario a un hilo de revisión.                                       |
| `create_pipeline`                  | Crea una canalización vacía.                                                     |
| `save_pipeline_steps`              | Reemplaza todos los pasos de una canalización.                                   |
| `run_pipeline`                     | Ejecuta una canalización en una rama.                                            |
| `run_activity`                     | Inicia un trabajo de DevOps. Consulta la lista a continuación.                   |

</details>

{% hint style="info" %}

#### Repositorios Git

En una topología conectada a un repositorio Git, crear una rama o un commit también lo envía al repositorio.
{% endhint %}

### Trabajos que puede iniciar el asistente

La herramienta `run_activity` inicia estos trabajos:

* Recuperar
* Validar
* Desplegar, con Apex opcional después del despliegue, nivel de pruebas Apex y cambios destructivos
* Despliegue rápido
* Reversión
* Hacer commit a la rama
* Fusión de una rama o una solicitud de extracción
* Buscar y reemplazar texto
* Protección contra sobrescritura
* Búsqueda, eliminación, recuperación y actualización de corrección previa al despliegue

### Pasos de canalización que el asistente puede configurar

La herramienta `save_pipeline_steps` la herramienta puede añadir estos tipos de pasos: Desplegar, Validar, Reversión, Paso manual, Análisis de código, Ejecutar Apex, Hacer commit a la rama, Protección contra sobrescritura y Búsqueda de corrección previa al despliegue. Añade pasos de WebHook, Migrar datos y Ejecución de pruebas en DevOps.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flosum.com/devops/devops-es/servidor-mcp/uso-de-las-herramientas-mcp-de-devops.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
