> 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-pt-br/servidor-mcp/usando-as-ferramentas-mcp-de-devops.md).

# Usando as Ferramentas MCP de DevOps

{% hint style="warning" %}

#### Beta

O servidor MCP de DevOps está em beta. Algumas ferramentas podem ainda não funcionar como esperado, e esta documentação pode não refletir as alterações mais recentes no servidor.
{% endhint %}

## ![](https://2465342021-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) Visão geral

Este artigo explica como usar as ferramentas MCP do DevOps depois que você conecta seu assistente de IA ao servidor MCP do DevOps. Ele aborda onde encontrar seu ID de Topologia, como pedir ao assistente para trabalhar com seus dados do DevOps e as ferramentas que o servidor MCP do DevOps fornece.

O artigo lista cada ferramenta com uma breve descrição, mas você não precisa saber os nomes das ferramentas para usá-las. Diga ao assistente, em linguagem simples, o que você quer, e ele escolhe quais ferramentas usar. O assistente trabalha no DevOps como o usuário Flosum com o qual você fez login quando o conectou.

{% hint style="info" %}

#### Antes de começar

Conecte primeiro seu assistente de IA ao servidor MCP do DevOps. Consulte os artigos a seguir.

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

## Onde encontrar seu ID de Topologia

Quase todas as ferramentas MCP do DevOps funcionam dentro de uma única Topologia, então o assistente precisa do ID da sua Topologia. O ID aparece na barra de endereços quando você abre a Topologia em Configurações Globais.

{% stepper %}
{% step %}

### Faça login em Configurações Globais

Faça login em Configurações Globais. Para instruções de login, consulte o artigo a seguir.

* [Fazer login em Configurações globais](https://docs.flosum.com/global-settings/global-settings-docs-pt-br/primeiros-passos/fazer-login-em-configuracoes-globais.md)
  {% endstep %}

{% step %}

### Abra a Topologia

1. Clique em **Topologias** no menu da barra lateral esquerda.
2. Clique na Topologia em que você trabalha.

   <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 %}

### Copie o ID da Topologia

1. Copie o número no final da URL na barra de endereços do seu navegador. Este é o ID da Topologia.

   <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 exemplo, em `https://global-us.flosum.app/topologies/123`, o ID da Topologia é `123`.
{% endhint %}
{% endstep %}
{% endstepper %}

## Usando as Ferramentas

Inicie um novo chat com seu assistente de IA e inclua seu ID de Topologia na solicitação. O assistente o usa pelo restante do chat. Por exemplo:

* Liste os branches na Topologia `<ID da Topologia>` usando o Flosum DevOps MCP.
* Mostre-me os pull requests abertos na Topologia `<ID da Topologia>`.
* Liste os últimos cinco deployments na Topologia `<ID da Topologia>`.
* Mostre as etapas no pipeline chamado `<nome do pipeline>` na Topologia `<ID da Topologia>`.

O exemplo a seguir mostra o Claude listando os últimos cinco deployments em uma Topologia.

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

Consulte branches, pull requests e pipelines pelo nome. O assistente localiza os IDs deles com as ferramentas.

{% hint style="warning" %}

#### Aprovação de Ferramentas

Seu assistente de IA pode pedir que você aprove uma ferramenta antes de executá-la. Verifique o que a ferramenta está prestes a fazer antes de aprová-la, especialmente uma ferramenta que altera dados. Um deployment, rollback ou merge altera suas organizações do Salesforce ou branches assim que é executado.
{% endhint %}

## Ferramentas Que Leem Dados

Essas ferramentas leem dados do DevOps e não alteram nada.

<details>

<summary>Branches e Commits</summary>

| Ferramenta                        | O que ela faz                                                                                    |
| --------------------------------- | ------------------------------------------------------------------------------------------------ |
| `list_branches`                   | Lista branches, filtrados por nome, ambiente, Ativo ou Obsoleto, criador, data ou branch padrão. |
| `get_branch`                      | Obtém os detalhes de um branch.                                                                  |
| `list_commits`                    | Lista o histórico de commits de um branch, do mais recente para o mais antigo.                   |
| `get_commit`                      | Obtém a mensagem, o hash, a hora e o autor de um commit.                                         |
| `list_commit_components`          | Lista os componentes que um commit alterou.                                                      |
| `list_component_versions`         | Lista a versão mais recente de cada componente em um branch.                                     |
| `get_component_version`           | Obtém uma versão de componente, com seus arquivos e o commit que a introduziu.                   |
| `list_fit_component_dependencies` | Lista as dependências de uma versão de componente em um branch.                                  |

</details>

<details>

<summary>Componentes da Organização</summary>

| Ferramenta                     | O que ela faz                                                                |
| ------------------------------ | ---------------------------------------------------------------------------- |
| `list_organization_components` | Lista os componentes que o DevOps armazenou para uma organização Salesforce. |
| `get_organization_component`   | Obtém um componente da organização, com seus arquivos de metadados.          |
| `list_component_dependencies`  | Lista as dependências de um componente da organização.                       |

</details>

<details>

<summary>Pull Requests</summary>

| Ferramenta                              | O que ela faz                                                                                                                           |
| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `list_pull_requests`                    | Lista pull requests, filtrados por status, branches, criador, revisor ou data.                                                          |
| `get_pull_request`                      | Obtém um pull request, com seus branches, revisores e status.                                                                           |
| `list_pull_request_activities`          | Lista a linha do tempo de um pull request: criado, commits, revisões solicitadas, alterações solicitadas, aprovado, mesclado e fechado. |
| `list_pull_request_conversations`       | Lista os threads de revisão de um pull request.                                                                                         |
| `list_pull_request_reviewers`           | Lista os revisores e o status da revisão deles.                                                                                         |
| `list_available_pull_request_reviewers` | Lista os usuários que podem ser atribuídos como revisores.                                                                              |
| `list_pull_request_merge_rules`         | Lista as Regras de Aprovação de Pull Request.                                                                                           |
| `get_conflicts`                         | Verifica conflitos de merge entre um branch de origem e um branch de destino.                                                           |
| `list_conflict_components`              | Lista os componentes em conflito.                                                                                                       |

</details>

<details>

<summary>Deployments</summary>

| Ferramenta                   | O que ela faz                                                                                                |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `list_deployments`           | Lista o histórico de Validate, Deploy, Quick Deploy e Rollback, com a organização de destino.                |
| `list_deployment_components` | Lista os componentes que um deployment processou, com status, tipo de alteração e qualquer mensagem de erro. |
| `list_deployment_changes`    | Lista as alterações de componente nos resultados de um deployment.                                           |
| `get_deployment_stats`       | Obtém a quantidade de componentes que tiveram sucesso e falharam em um deployment.                           |
| `get_deployment_tests`       | Obtém os totais dos testes Apex para um deployment.                                                          |

</details>

<details>

<summary>Pipelines</summary>

| Ferramenta                      | O que ela faz                                                                                                    |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| `list_pipelines`                | Lista os pipelines na Topologia.                                                                                 |
| `get_pipeline`                  | Obtém os detalhes de um pipeline.                                                                                |
| `list_steps`                    | Lista as etapas de um pipeline e como elas se conectam em caso de sucesso e falha.                               |
| `list_pipeline_launch_settings` | Lista quando os pipelines iniciam automaticamente: em commit ou em merge de pull request, e para quais branches. |
| `list_pipeline_runs`            | Lista as execuções de pipeline, com pipeline, branch, gatilho, status e duração.                                 |
| `get_pipeline_run`              | Obtém o status de uma execução.                                                                                  |
| `list_run_steps`                | Lista o status de cada etapa em uma execução.                                                                    |

</details>

<details>

<summary>Histórico de Atividades</summary>

| Ferramenta        | O que ela faz                                                                                            |
| ----------------- | -------------------------------------------------------------------------------------------------------- |
| `list_activities` | Lista o histórico de atividades, filtrado por tipo de job, status, criador, data, branch ou organização. |
| `get_activity`    | Obtém os detalhes de uma atividade.                                                                      |

</details>

<details>

<summary>Verificação de Código</summary>

| Ferramenta                      | O que ela faz                                                                                       |
| ------------------------------- | --------------------------------------------------------------------------------------------------- |
| `get_code_scan_stats`           | Obtém as descobertas de uma verificação de código por gravidade.                                    |
| `list_code_scan_components`     | Lista os arquivos de componente em uma verificação de código.                                       |
| `get_code_scan_component`       | Obtém as descobertas de um arquivo, por gravidade: Bloqueador, Crítico, Maior, Menor e Informativo. |
| `get_code_scan_component_stats` | Obtém as contagens de gravidade de um arquivo.                                                      |

</details>

<details>

<summary>Proteção contra Sobrescrita</summary>

| Ferramenta                             | O que ela faz                                                                    |
| -------------------------------------- | -------------------------------------------------------------------------------- |
| `get_overwrite_protection_stats`       | Obtém os totais de comparação de uma verificação de Proteção contra Sobrescrita. |
| `list_overwrite_protection_components` | Lista os componentes, por status: Igual, Diferente ou Novo.                      |
| `get_overwrite_protection_component`   | Obtém um componente.                                                             |
| `get_overwrite_protection_content`     | Obtém o conteúdo do arquivo de um componente.                                    |

</details>

<details>

<summary>Correção Pré-Deploy</summary>

| Ferramenta                                        | O que ela faz                                                                         |
| ------------------------------------------------- | ------------------------------------------------------------------------------------- |
| `list_pre_deploy_fix_search_missing_dependencies` | Lista as dependências ausentes encontradas por uma busca de Correção Pré-Deploy.      |
| `list_pre_deploy_fix_search_api_version_issues`   | Lista os problemas de versão de API encontrados por uma busca de Correção Pré-Deploy. |
| `list_pre_deploy_fix_retrieve_components`         | Lista os componentes recuperados por uma Correção Pré-Deploy.                         |
| `list_pre_deploy_fix_remove_components`           | Lista os componentes removidos por uma Correção Pré-Deploy.                           |
| `list_pre_deploy_fix_update_components`           | Lista os componentes atualizados por uma Correção Pré-Deploy.                         |

</details>

## Ferramentas Que Alteram Dados

Essas ferramentas criam ou alteram dados no DevOps, e algumas alteram suas organizações do Salesforce ou o repositório Git.

<details>

<summary>Todas as Ferramentas Que Alteram Dados</summary>

| Ferramenta                         | O que ela faz                                                                   |
| ---------------------------------- | ------------------------------------------------------------------------------- |
| `create_branch`                    | Cria um branch a partir de um branch existente.                                 |
| `create_commit`                    | Faz commit de componentes para um branch.                                       |
| `create_pull_request`              | Cria um pull request, com ou sem revisores.                                     |
| `update_pull_request`              | Altera o título ou o branch de destino de um pull request.                      |
| `set_pull_request_reviewers`       | Substitui os revisores de um pull request.                                      |
| `set_pull_request_review`          | Define uma revisão como Aprovada, Alterações Solicitadas ou Revisão Solicitada. |
| `create_pull_request_conversation` | Inicia um thread de revisão em uma linha de um arquivo.                         |
| `create_pull_request_comment`      | Adiciona um comentário a um thread de revisão.                                  |
| `create_pipeline`                  | Cria um pipeline vazio.                                                         |
| `save_pipeline_steps`              | Substitui todas as etapas de um pipeline.                                       |
| `run_pipeline`                     | Executa um pipeline em um branch.                                               |
| `run_activity`                     | Inicia um job do DevOps. Veja a lista abaixo.                                   |

</details>

{% hint style="info" %}

#### Repositórios Git

Em uma Topologia conectada a um repositório Git, criar um branch ou um commit também o envia ao repositório.
{% endhint %}

### Jobs que o Assistente Pode Iniciar

A `run_activity` ferramenta inicia estes jobs:

* Retrieve
* Validate
* Deploy, com Apex opcional após o deployment, nível de teste Apex e alterações destrutivas
* Quick Deploy
* Rollback
* Commit para Branch
* Merge de um branch ou de um pull request
* Pesquisar e Substituir Texto
* Proteção contra Sobrescrita
* Pre-Deploy Fix Search, Remove, Retrieve e Update

### Etapas de Pipeline que o Assistente Pode Configurar

A `save_pipeline_steps` a ferramenta pode adicionar estes tipos de etapa: Deploy, Validate, Rollback, Etapa Manual, Verificação de Código, Executar Apex, Commit para Branch, Proteção contra Sobrescrita e Pre-Deploy Fix Search. Adicione etapas de WebHook, Migrate Data e Test Execution no 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-pt-br/servidor-mcp/usando-as-ferramentas-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.
