1. ホーム
  2. マニュアル
  3. 管理ツール
  4. XServer MCP Server

XServer MCP Server

XServer MCP Serverとは

Model Context Protocol（MCP）に対応した公式MCPサーバーです。「XServer API」の機能を、CursorやClaudeなどのMCPに対応したAIエージェントから直接実行できます。

ご利用方法

ご利用にはXServer APIキーが必要です。

1.APIキーの準備

XServerアカウントにログインし、「APIキー管理」からAPIキーを発行してください。
APIキーの発行方法は、マニュアル「XServer API」をご参照ください。

2.UUIDの確認

操作対象はUUIDで指定します。このUUIDは、コントロールパネルや契約管理には表示されません。

MCPの設定後、AIエージェントに「VPSの一覧を見せて」と依頼してください。
一覧のサーバー名と、コントロールパネルや契約管理に表示されているサーバー名が同じ行のUUIDを使用します。同じサーバー名が複数ある場合は、契約管理のサービスコードが同じ行のUUIDを使用します。
DBサーバー、L4ロードバランサー、NFS、追加IPも、それぞれの一覧で同じ手順です。

※コントロールパネルの詳細画面に表示される「UUID」は、操作に使うUUIDとは別の値です。操作には使用できません。

3.MCPサーバーの設定

お使いのAIエージェントのMCP設定ファイルに、以下の内容を追加してください。
「XSERVER_API_KEY」はご自身の情報に置き換えてください。

Cursor の設定

プロジェクトの .cursor/mcp.json、またはグローバルの ~/.cursor/mcp.json に以下を追加します。

{
  "mcpServers": {
    "xserver-vps-cloud": {
      "command": "npx",
      "args": ["-y", "xserver-mcp", "--services=vps-cloud"],
      "env": {
        "XSERVER_API_KEY": "xs_xxxxxxxxxxxx"
      }
    }
  }
}
Claude Desktop の設定

Claude Desktopの設定ファイル（claude_desktop_config.json）に以下を追加します。

設定ファイルの場所
Windows %APPDATA%\Claude\claude_desktop_config.json
Mac ~/Library/Application Support/Claude/claude_desktop_config.json 
{
  "mcpServers": {
    "xserver-vps-cloud": {
      "command": "npx",
      "args": ["-y", "xserver-mcp", "--services=vps-cloud"],
      "env": {
        "XSERVER_API_KEY": "xs_xxxxxxxxxxxx"
      }
    }
  }
}
VS Code（GitHub Copilot）の設定

プロジェクトの .vscode/mcp.json に以下を追加します。

{
  "servers": {
    "xserver-vps-cloud": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "xserver-mcp", "--services=vps-cloud"],
      "env": {
        "XSERVER_API_KEY": "xs_xxxxxxxxxxxx"
      }
    }
  }
}
Claude Code の設定

ターミナルで以下のコマンドを実行します。

claude mcp add --transport stdio xserver-vps-cloud \
  --env XSERVER_API_KEY=xs_xxxxxxxxxxxx \
  -- npx -y xserver-mcp --services=vps-cloud
Codex の設定

ターミナルで以下のコマンドを実行します。

codex mcp add xserver-vps-cloud \
  --env XSERVER_API_KEY=xs_xxxxxxxxxxxx \
  -- npx -y xserver-mcp --services=vps-cloud
4.動作確認

設定完了後、AIエージェントに以下のように話しかけて動作を確認してください。
なお、対象リソースはUUID（例: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx）で指定します。

  • 「VPSの一覧を見せて」
  • 「xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxの電源状態を見せて」

環境変数

XServer MCP Serverでは、以下の環境変数を使用します。

変数名 必須 説明
XSERVER_API_KEY ○ XServer APIキー（xs_ で始まる文字列）
XSERVER_MCP_ENABLE_HIGH_RISK_EXECUTE 任意 新規お申し込みやOS再インストールを行う場合に1を設定 
"XSERVER_MCP_ENABLE_HIGH_RISK_EXECUTE": "1"

利用可能な機能

XServer MCP Serverでは、XServer APIで提供されている機能をAIエージェントを通じてご利用いただけます。

カテゴリ 主な操作
VPS 一覧 / 詳細 / サーバー情報の変更 / ネットワーク / IPv6 / リソース / OS再インストール / 電源操作
DBサーバー 一覧 / 詳細 / メモの変更 / データベース / ユーザー / リソース / 電源操作
L4ロードバランサー 一覧 / 詳細 / 基本情報の変更 / バランシング設定 / 電源操作
NFS 一覧 / 詳細 / サーバー情報の変更 / リソース / 電源操作
プライベートネットワーク 一覧 / 詳細 / 作成 / 削除 / 名前・接続先の変更
追加IPアドレス 一覧 / 詳細 / メモの変更 / NICへの割り当て・解除
パケットフィルター 一覧 / 詳細 / 作成 / 削除 / ルールの設定
SSH Key 公開鍵の一覧 / 詳細 / 登録 / 削除
新規お申し込み プラン・料金の確認 / 申込 / 状況確認

各APIの詳細な仕様については、APIリファレンスをご参照ください。

使用例

AIエージェントへの指示例
  • 「VPSの一覧を見せて」
  • 「xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx（VPSの一覧で確認したUUID）を再起動して」
  • 「xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx（VPSの一覧で確認したUUID）のパケットフィルターの設定を見せて」
  • 「DBサーバーの一覧を見せて」
  • 「xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx（DBサーバーの一覧で確認したUUID）のデータベース一覧を見せて」
  • 「L4ロードバランサーの一覧を見せて」
  • 「xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx（L4ロードバランサーの一覧で確認したUUID）の振り分け先を見せて」
  • 「NFSの一覧を見せて」
  • 「xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx（NFSの一覧で確認したUUID）の電源状態を見せて」

注意事項

マニュアル一覧へ戻る