> 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-ja/mcpsb/devops-mcptsruno.md).

# DevOps MCPツールの使用

{% hint style="warning" %}

#### ベータ

DevOps MCP サーバーはベータ版です。一部のツールはまだ期待どおりに動作しない場合があり、このドキュメントにはサーバーへの最新の変更が反映されていない可能性があります。
{% endhint %}

## ![](https://225042527-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) 概要

この記事では、AI アシスタントを DevOps MCP サーバーに接続した後に DevOps MCP ツールを使う方法を説明します。Topology ID の確認方法、アシスタントに DevOps データを扱わせる依頼の仕方、そして DevOps MCP サーバーが提供するツールを取り上げます。

この記事では各ツールを短く説明しますが、使うためにツール名を知る必要はありません。やりたいことを自然な言葉でアシスタントに伝えると、どのツールを使うかを選んでくれます。アシスタントは、接続時にサインインした Flosum ユーザーとして DevOps 内で動作します。

{% hint style="info" %}

#### 始める前に

まず AI アシスタントを DevOps MCP サーバーに接続してください。次の記事を参照してください。

* [ChatGPTをDevOps MCPサーバーに接続する](https://docs.flosum.com/devops/devops-ja/mcpsb/chatgptwodevops-mcpsbnisuru.md)
* [ClaudeをDevOps MCPサーバーに接続する](https://docs.flosum.com/devops/devops-ja/mcpsb/claudewodevops-mcpsbnisuru.md)
  {% endhint %}

## Topology ID の確認方法

ほとんどすべての DevOps MCP ツールは 1 つの Topology 内で動作するため、アシスタントには Topology の ID が必要です。Global Settings で Topology を開くと、アドレスバーに ID が表示されます。

{% stepper %}
{% step %}

### Global Settings にログインする

Global Settings にログインします。ログイン手順は次の記事を参照してください。

* [グローバル設定にログインする](https://docs.flosum.com/global-settings/global-settings-docs-ja/hajimeni/gurbaruniroguinsuru.md)
  {% endstep %}

{% step %}

### Topology を開く

1. クリック **トポロジー** を左側のサイドバー メニューから。
2. 作業している Topology をクリックします。

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

### Topology ID をコピーする

1. ブラウザーのアドレスバーにある URL の末尾の数字をコピーします。これが Topology ID です。

   <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" %}
たとえば、 `https://global-us.flosum.app/topologies/123`では、Topology ID は `123`.
{% endhint %}
{% endstep %}
{% endstepper %}

## ツールの使い方

AI アシスタントとの新しいチャットを開始し、リクエストに Topology ID を含めてください。アシスタントは、その後のチャットでそれを使用します。たとえば、

* トポロジー内のブランチを一覧表示して `<Topology ID>` Flosum DevOps MCP を使用して。
* トポロジー内の未承認のプルリクエストを表示して `<Topology ID>`.
* トポロジー内の最新5件のデプロイを一覧表示して `<Topology ID>`.
* という名前のパイプラインのステップを表示して `<pipeline name>` トポロジー内で `<Topology ID>`.

次の例では、Claude がトポロジー内の最新5件のデプロイを一覧表示しています。

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

ブランチ、プルリクエスト、パイプラインは名前で参照してください。アシスタントはツールを使ってそれらの ID を検索します。

{% hint style="warning" %}

#### ツールの承認

実行前に、AI アシスタントがツールの承認を求める場合があります。特にデータを変更するツールは、承認する前に何を行うのかを確認してください。デプロイ、ロールバック、またはマージは、実行されるとすぐに Salesforce 組織またはブランチを変更します。
{% endhint %}

## データを読み取るツール

これらのツールは DevOps データを読み取り、変更は行いません。

<details>

<summary>ブランチとコミット</summary>

| ツール                               | 機能                                                             |
| --------------------------------- | -------------------------------------------------------------- |
| `list_branches`                   | 名前、環境、Active または Stale、作成者、日付、またはデフォルト ブランチで絞り込んだブランチを一覧表示します。 |
| `get_branch`                      | 1 つのブランチの詳細を取得します。                                             |
| `list_commits`                    | ブランチのコミット履歴を新しい順に一覧表示します。                                      |
| `get_commit`                      | 1 件のコミットのメッセージ、ハッシュ、時間、作成者を取得します。                              |
| `list_commit_components`          | 1 つのコミットで変更されたコンポーネントを一覧表示します。                                 |
| `list_component_versions`         | ブランチ内の各コンポーネントの最新バージョンを一覧表示します。                                |
| `get_component_version`           | コンポーネント 1 件のバージョンを、そのファイルと、それを導入したコミットとともに取得します。               |
| `list_fit_component_dependencies` | ブランチ内の 1 つのコンポーネント バージョンの依存関係を一覧表示します。                         |

</details>

<details>

<summary>組織コンポーネント</summary>

| ツール                            | 機能                                              |
| ------------------------------ | ----------------------------------------------- |
| `list_organization_components` | DevOps が Salesforce 組織向けに保存しているコンポーネントを一覧表示します。 |
| `get_organization_component`   | メタデータ ファイルとともに 1 つの組織コンポーネントを取得します。             |
| `list_component_dependencies`  | 1 つの組織コンポーネントの依存関係を一覧表示します。                     |

</details>

<details>

<summary>プルリクエスト</summary>

| ツール                                     | 機能                                                       |
| --------------------------------------- | -------------------------------------------------------- |
| `list_pull_requests`                    | ステータス、ブランチ、作成者、レビュー担当者、または日付で絞り込んだプルリクエストを一覧表示します。       |
| `get_pull_request`                      | 1 つのプルリクエストを、そのブランチ、レビュー担当者、ステータスとともに取得します。              |
| `list_pull_request_activities`          | プルリクエストのタイムラインを一覧表示します: 作成、コミット、レビュー依頼、変更依頼、承認、マージ、クローズ。 |
| `list_pull_request_conversations`       | プルリクエストのレビュー スレッドを一覧表示します。                               |
| `list_pull_request_reviewers`           | レビュー担当者とそのレビュー状況を一覧表示します。                                |
| `list_available_pull_request_reviewers` | レビュー担当者として割り当て可能なユーザーを一覧表示します。                           |
| `list_pull_request_merge_rules`         | プルリクエスト承認ルールを一覧表示します。                                    |
| `get_conflicts`                         | ソース ブランチとターゲット ブランチ間のマージ競合を確認します。                        |
| `list_conflict_components`              | 競合しているコンポーネントを一覧表示します。                                   |

</details>

<details>

<summary>デプロイ</summary>

| ツール                          | 機能                                                     |
| ---------------------------- | ------------------------------------------------------ |
| `list_deployments`           | 検証、デプロイ、クイック デプロイ、ロールバックの履歴を、対象組織とともに一覧表示します。          |
| `list_deployment_components` | 1 回のデプロイで処理されたコンポーネントを、ステータス、変更タイプ、エラーメッセージ付きで一覧表示します。 |
| `list_deployment_changes`    | 1 回のデプロイ結果におけるコンポーネント変更を一覧表示します。                       |
| `get_deployment_stats`       | 1 回のデプロイで成功したコンポーネント数と失敗したコンポーネント数を取得します。              |
| `get_deployment_tests`       | 1 回のデプロイの Apex テスト合計を取得します。                            |

</details>

<details>

<summary>パイプライン</summary>

| ツール                             | 機能                                                                 |
| ------------------------------- | ------------------------------------------------------------------ |
| `list_pipelines`                | Topology 内のパイプラインを一覧表示します。                                         |
| `get_pipeline`                  | 1 つのパイプラインの詳細を取得します。                                               |
| `list_steps`                    | パイプラインのステップと、成功時および失敗時のリンク方法を一覧表示します。                              |
| `list_pipeline_launch_settings` | パイプラインが自動的に開始されるタイミング: コミット時、またはプルリクエストのマージ時、そして対象となるブランチを一覧表示します。 |
| `list_pipeline_runs`            | パイプライン、ブランチ、トリガー、ステータス、実行時間付きでパイプラインの実行を一覧表示します。                   |
| `get_pipeline_run`              | 1 回の実行のステータスを取得します。                                                |
| `list_run_steps`                | 1 回の実行における各ステップのステータスを一覧表示します。                                     |

</details>

<details>

<summary>アクティビティ履歴</summary>

| ツール               | 機能                                                     |
| ----------------- | ------------------------------------------------------ |
| `list_activities` | ジョブタイプ、ステータス、作成者、日付、ブランチ、または組織で絞り込んだアクティビティ履歴を一覧表示します。 |
| `get_activity`    | 1 件のアクティビティの詳細を取得します。                                  |

</details>

<details>

<summary>コードスキャン</summary>

| ツール                             | 機能                                                            |
| ------------------------------- | ------------------------------------------------------------- |
| `get_code_scan_stats`           | コードスキャンの検出結果を重大度別に取得します。                                      |
| `list_code_scan_components`     | コードスキャン内のコンポーネント ファイルを一覧表示します。                                |
| `get_code_scan_component`       | 1 つのファイルの検出結果を、重大度別に取得します: Blocker、Critical、Major、Minor、Info。 |
| `get_code_scan_component_stats` | 1 つのファイルの重大度別件数を取得します。                                        |

</details>

<details>

<summary>上書き保護</summary>

| ツール                                    | 機能                                 |
| -------------------------------------- | ---------------------------------- |
| `get_overwrite_protection_stats`       | 上書き保護チェックの比較合計を取得します。              |
| `list_overwrite_protection_components` | コンポーネントをステータス別に一覧表示します: 同一、異なる、新規。 |
| `get_overwrite_protection_component`   | 1 つのコンポーネントを取得します。                 |
| `get_overwrite_protection_content`     | 1 つのコンポーネントのファイル内容を取得します。          |

</details>

<details>

<summary>デプロイ前の修正</summary>

| ツール                                               | 機能                                     |
| ------------------------------------------------- | -------------------------------------- |
| `list_pre_deploy_fix_search_missing_dependencies` | デプロイ前の修正検索で見つかった不足している依存関係を一覧表示します。    |
| `list_pre_deploy_fix_search_api_version_issues`   | デプロイ前の修正検索で見つかった API バージョンの問題を一覧表示します。 |
| `list_pre_deploy_fix_retrieve_components`         | デプロイ前の修正が取得したコンポーネントを一覧表示します。          |
| `list_pre_deploy_fix_remove_components`           | デプロイ前の修正が削除したコンポーネントを一覧表示します。          |
| `list_pre_deploy_fix_update_components`           | デプロイ前の修正が更新したコンポーネントを一覧表示します。          |

</details>

## データを変更するツール

これらのツールは DevOps 内にデータを作成または変更し、Salesforce 組織や Git リポジトリを変更するものもあります。

<details>

<summary>データを変更するすべてのツール</summary>

| ツール                                | 機能                               |
| ---------------------------------- | -------------------------------- |
| `create_branch`                    | 既存のブランチからブランチを作成します。             |
| `create_commit`                    | コンポーネントをブランチにコミットします。            |
| `create_pull_request`              | レビュー担当者あり/なしでプルリクエストを作成します。      |
| `update_pull_request`              | プルリクエストのタイトルまたはターゲット ブランチを変更します。 |
| `set_pull_request_reviewers`       | プルリクエストのレビュー担当者を置き換えます。          |
| `set_pull_request_review`          | レビューを承認、変更要求、またはレビュー要求に設定します。    |
| `create_pull_request_conversation` | ファイルの行にレビュー スレッドを開始します。          |
| `create_pull_request_comment`      | レビュー スレッドにコメントを追加します。            |
| `create_pipeline`                  | 空のパイプラインを作成します。                  |
| `save_pipeline_steps`              | パイプラインのすべてのステップを置き換えます。          |
| `run_pipeline`                     | ブランチ上でパイプラインを実行します。              |
| `run_activity`                     | DevOps ジョブを開始します。以下の一覧を参照してください。 |

</details>

{% hint style="info" %}

#### Git リポジトリ

Git リポジトリに接続された Topology では、ブランチまたはコミットを作成すると、その内容もリポジトリにプッシュされます。
{% endhint %}

### アシスタントが開始できるジョブ

この `run_activity` ツールは次のジョブを開始します:

* Retrieve
* Validate
* Deploy、必要に応じてデプロイ後の Apex、Apex テスト レベル、破壊的変更を含む
* Quick Deploy
* Rollback
* Commit To Branch
* ブランチまたはプルリクエストのマージ
* Search and Replace Text
* 上書き保護
* Pre-Deploy Fix の検索、削除、取得、および更新

### アシスタントが設定できるパイプライン ステップ

この `save_pipeline_steps` ツールは次のステップタイプを追加できます: Deploy、Validate、Rollback、Manual Step、Code Scan、Execute Apex、Commit To Branch、Overwrite Protection、および Pre-Deploy Fix Search。WebHook、Migrate Data、Test Execution のステップは 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-ja/mcpsb/devops-mcptsruno.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.
