---
name: conoha-vps-mcp
description: ConoHa VPS の基本操作ガイド。サーバー作成・削除・起動・停止・リサイズ、ボリューム管理、セキュリティグループ設定など、ConoHa VPS APIをMCPツールで操作する際に参照する。「ConoHa」「VPS」「サーバー作成」「サーバー削除」「ボリューム」「セキュリティグループ」「conoha_get」「conoha_post」「conoha_delete_by_param」「フレーバー」「イメージ」「SSHキーペア」「スタートアップスクリプト」などのキーワードで発動する。
---

# ConoHa VPS 操作ガイド

## 前提条件

- MCP クライアントが ConoHa VPS MCP に接続済みで、OAuth 認可が完了していること
- Keystone token / tenant ID は MCP サーバーが OAuth アクセストークンのイントロスペクション結果から自動取得する。ツール利用者が OpenStack の認証情報（ユーザーID・パスワード）や tenant ID を直接指定する必要はない
- API リージョン・接続先はサーバー側の OpenStack base URL 設定で決まる

## ツール概要

| ツール名                      | HTTPメソッド | 概要                                        |
| ----------------------------- | ------------ | ------------------------------------------- |
| `fetch_url`                   | —            | 指定URLからコンテンツを取得                 |
| `encode_base64`               | —            | 文字列をBase64エンコード（1-10000文字）     |
| `conoha_get`                  | GET          | リソース一覧取得（10パス）                  |
| `conoha_get_by_param`         | GET          | パラメータ指定で個別リソース取得（6パス）   |
| `conoha_post`                 | POST         | リソース作成（5パス）                       |
| `conoha_post_put_by_param`    | POST/PUT     | リソース更新・操作（6パス）                 |
| `conoha_delete_by_param`      | DELETE       | リソース削除（5パス、`confirm: true` 必須） |
| `create_server`（プロンプト） | —            | サーバー作成ウィザード                      |

パス・パラメータの詳細は [tool-path-reference.md](references/tool-path-reference.md) を参照。

## 絶対遵守制約

1. **パスワード自動生成禁止** — `adminPass` は必ずユーザーが指定した値のみを使用する。条件不適合でも再入力を依頼する。自動生成・提案をしない
2. **ポート範囲自動設定禁止** — `port_range_min` / `port_range_max` は必ずユーザーに確認して指定する
3. **user_data は encode_base64 必須** — スタートアップスクリプトを `user_data` に設定する場合、必ず `encode_base64` ツールでエンコードした結果を使用する。自前でのBase64エンコードをしない
4. **削除は明示確認必須** — `conoha_delete_by_param` は必ず `confirm: true` を指定する
5. **名前タグ制約** — `instance_name_tag` とボリューム名は英数字・アンダースコア・ハイフンのみ（1-255文字）。SSHキーペア名は英数字・アンダースコア・ハイフンのみ（1文字以上、上限なし）

## ワークフロー判定ツリー

### サーバー作成フロー

```text
1. conoha_get path="/flavors/detail" → フレーバー一覧取得、ユーザー要件に合うフレーバーを選択
2. conoha_get path="/v2/images?limit=200" → イメージ一覧取得、OS/バージョンを選択
3. conoha_get path="/types" → ボリュームタイプ一覧取得
4. conoha_post path="/volumes" → ブートボリューム作成（imageRef 必須）
5. （任意）セキュリティグループ・SSHキーペアの準備
6. ユーザーに adminPass を確認
7. conoha_post path="/servers" → サーバー作成
```

### スタートアップスクリプト準備フロー

```text
1. conoha_get path="/startup-scripts" → スタートアップスクリプト一覧取得
2. 一覧に該当スクリプトがある場合:
   a. fetch_url → スクリプト内容を取得
   b. encode_base64 → Base64エンコード
3. 一覧にない場合:
   a. 既存スクリプトを参考に新規スクリプトを作成
   b. encode_base64 → Base64エンコード
4. エンコード結果を user_data に設定してサーバー作成
```

**サイズ制約**: `encode_base64` は入力最大10000文字。`user_data` はエンコード後 ≤65535バイト・デコード後 ≤49149バイトの padded Base64 である必要がある。長大なスクリプトはこの上限に収める。

### サーバー操作フロー

| 操作         | ツール                     | path               | requestBody                                                      |
| ------------ | -------------------------- | ------------------ | ---------------------------------------------------------------- |
| 起動         | `conoha_post_put_by_param` | `/action`          | `{"os-start": null}`                                             |
| 停止         | `conoha_post_put_by_param` | `/action`          | `{"os-stop": null}`                                              |
| 強制停止     | `conoha_post_put_by_param` | `/action`          | `{"os-stop": {"force_shutdown": true}}`                          |
| 再起動       | `conoha_post_put_by_param` | `/action`          | `{"reboot": {"type": "SOFT"}}` or `"HARD"`                       |
| リサイズ     | `conoha_post_put_by_param` | `/action`          | `{"resize": {"flavorRef": "<ID>"}}`                              |
| リサイズ確定 | `conoha_post_put_by_param` | `/action`          | `{"confirmResize": null}`                                        |
| リサイズ取消 | `conoha_post_put_by_param` | `/action`          | `{"revertResize": null}`                                         |
| コンソール   | `conoha_post_put_by_param` | `/remote-consoles` | `{"remote_console": {"protocol": "vnc", "type": "novnc"}}`       |
| 削除         | `conoha_delete_by_param`   | `/servers`         | requestBody なし（flat 入力: param=サーバーID, `confirm: true`） |

**リサイズ手順**: **リサイズはサーバーが SHUTOFF（停止）状態でのみ可能**。
os-stop で停止し status=SHUTOFF を確認 → resize → status=VERIFY_RESIZE まで待機 → confirmResize で確定（または revertResize で取消）→ 必要に応じて os-start で起動。

**制約**: メモリ 512MB プランはスケールアップ／ダウンの対象外。割引プラン（きっぷ／長期パス）とまとめトク間などプラン種別をまたぐ変更に制限がある。リサイズ先 flavor が選べない場合はプラン種別の制約を確認する。

### セキュリティグループフロー

```text
1. conoha_post path="/v2.0/security-groups" → セキュリティグループ作成
2. conoha_post path="/v2.0/security-group-rules" → ルール追加（ポート範囲はユーザーに確認）
3. conoha_get path="/v2.0/ports" → ポート一覧取得、対象サーバーのポートIDを特定
4. conoha_post_put_by_param path="/v2.0/ports" → ポートにセキュリティグループを適用
```

### ボリューム管理フロー

```text
■ ボリューム作成
  1. conoha_get path="/types" → ボリュームタイプ確認
  2. conoha_post path="/volumes" → ボリューム作成（size は正の整数 GB。利用可能サイズは /types と ConoHa プラン制約に従う。例: 30, 100, 200, 500, 1000, 5000, 10000 GB）

■ ボリュームアタッチ
  conoha_post_put_by_param path="/os-volume_attachments" param=サーバーID requestBody={"volumeAttachment": {"volumeId": "<ID>"}}

■ ボリューム更新
  conoha_post_put_by_param path="/volumes" param=ボリュームID requestBody={"volume": {"name": "...", "description": "..."}}

■ ボリューム削除
  conoha_delete_by_param path="/volumes" param=ボリュームID confirm=true
```

### 情報取得フロー

| 取得対象                                         | ツール                | path                    | param      |
| ------------------------------------------------ | --------------------- | ----------------------- | ---------- |
| サーバー一覧                                     | `conoha_get`          | `/servers/detail`       | —          |
| フレーバー一覧                                   | `conoha_get`          | `/flavors/detail`       | —          |
| イメージ一覧                                     | `conoha_get`          | `/v2/images?limit=200`  | —          |
| ボリューム一覧                                   | `conoha_get`          | `/volumes/detail`       | —          |
| SSHキーペア一覧                                  | `conoha_get`          | `/os-keypairs`          | —          |
| セキュリティグループ一覧                         | `conoha_get`          | `/v2.0/security-groups` | —          |
| ポート一覧                                       | `conoha_get`          | `/v2.0/ports`           | —          |
| サーバーのIP                                     | `conoha_get_by_param` | `/ips`                  | サーバーID |
| CPU使用状況（時系列統計・値はCPU使用時間nsec/s） | `conoha_get_by_param` | `/rrd/cpu`              | サーバーID |
| ディスクIO（時系列統計・read/write B/s）         | `conoha_get_by_param` | `/rrd/disk`             | サーバーID |

## ユーザー発話パターンとツール対応

| 発話パターン                       | 使用ツール                 | パス                                                        |
| ---------------------------------- | -------------------------- | ----------------------------------------------------------- |
| 「サーバーを作成して」             | `conoha_post`              | `/servers`（事前に flavors, images, volumes, types を取得） |
| 「サーバーを停止/起動/再起動して」 | `conoha_post_put_by_param` | `/action`                                                   |
| 「サーバーをリサイズして」         | `conoha_post_put_by_param` | `/action`（resize → confirmResize）                         |
| 「サーバーを削除して」             | `conoha_delete_by_param`   | `/servers`（`confirm: true` 必須）                          |
| 「セキュリティグループを作成して」 | `conoha_post`              | `/v2.0/security-groups` + `/v2.0/security-group-rules`      |
| 「サーバーの状態を確認して」       | `conoha_get`               | `/servers/detail`                                           |
| 「コンソールに接続して」           | `conoha_post_put_by_param` | `/remote-consoles`                                          |

## エラー対応ガイド

| エラー                       | 原因                                          | 対処                                                                |
| ---------------------------- | --------------------------------------------- | ------------------------------------------------------------------- |
| 401 Unauthorized             | OAuth 認可切れ、scope 不足、Bearer token 不正 | MCP クライアント側で再認可し、`vps:read` / `vps:write` scope を確認 |
| 409 Conflict                 | リソース競合（削除中のボリューム等）          | 状態を確認して再試行                                                |
| 400 Bad Request (adminPass)  | パスワード要件不足                            | 9-70文字、大小英字+数字+記号を含むか確認                            |
| 400 Bad Request (port_range) | ポート範囲不正                                | 0-65535の整数か確認                                                 |
| 404 Not Found                | リソースが存在しない                          | ID/名前を再確認                                                     |

## リファレンス

- [ツール別パス・パラメータ一覧](references/tool-path-reference.md)
- [リクエストボディスキーマ全集](references/request-body-schemas.md)
- [主要操作のワークフローレシピ](references/workflow-recipes.md)