Pular para o conteúdo
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Usando as Ferramentas MCP de DevOps

Beta

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.

Antes de começar

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

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.

1

Faça login em Configurações Globais

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

2

Abra a Topologia

  1. Clique em Topologias no menu da barra lateral esquerda.

  2. Clique na Topologia em que você trabalha.

3

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.

Por exemplo, em https://global-us.flosum.app/topologies/123, o ID da Topologia é 123.

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.

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

Aprovação de Ferramentas

Ferramentas Que Leem Dados

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

Branches e Commits
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.

Componentes da Organização
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.

Pull Requests
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.

Deployments
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.

Pipelines
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.

Histórico de Atividades
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.

Verificação de Código
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.

Proteção contra Sobrescrita
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.

Correção Pré-Deploy
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.

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.

Todas as Ferramentas Que Alteram Dados
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.

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.

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.

Atualizado

Isto foi útil?