ドキュメントの全ページを検索するには、2文字以上入力してください。

↑ ↓ で移動 ↵ で開く esc で閉じる

rdev の使い方

AI アシスタントの接続

Claude Code、Claude Desktop、Cursor、Codex など、ノートPC上の AI アシスタントを rdev パネルに接続できます。接続すると、「どのサーバーかに問題がありますか?」「最後のタスクはなぜ失敗しましたか?」「私の対応を待っているエージェントはどれですか?」といった質問に答えさせたり、依頼に応じてデプロイやエージェントセッションを操作させたりできます。

これはパネル自身の MCP サーバー https://rdev.cloud/mcp です。サーバー上のエージェントが持つ MCP アクセス(AI エージェント を参照)とは別のものです。そちらは環境内のサイト、データベース、サービスを管理し、こちらはすべてのサーバーにまたがるアカウント全体の状況を表示します。

アシスタントにできること

ツール 内容
list_servers オンライン状態、rdev バージョン、プロジェクト、CPU・メモリ・ディスクの使用状況、アラート(オフライン、再起動が必要、セキュリティアップデート、ディスク残量わずか、失敗したサービス)を含むサーバー一覧
server_details 1台のサーバーのサービス、PHP と Node.js のバージョン、プロセス、最後の終了コード付きのスケジュールタスク、バックアップストレージの場所
agent_sessions 最新のエージェントセッションと状態:作業中、あなたの対応待ち、完了、エラーで停止
recent_tasks パネルがサーバーに送信した最新のタスクと結果。失敗したものだけを一覧表示することもできます
deploy_requests お客様がオーナーまたは管理者であるチームで、承認待ちのチームデプロイ
approve_deploy, reject_deploy 承認待ちのデプロイを判断します。チーム ページと同じルールで、オーナーと管理者のみ、リクエストから1時間以内に限ります
stop_agent_session エージェントセッション ページと同様に、実行中のエージェントセッションを停止します

アシスタントが確認できるのは、パネルで変更できるサーバーのみです。ご自身のサーバーと、Team プランでチームのオーナーまたは管理者である場合はメイン環境です。ライセンスキー、env の値、暗号化パスワード、トークンが渡されることはありません。アシスタントは、何かを変更するほかの MCP ツールと同様に、承認、却下、停止の前にお客様に確認を求めます。

トークンを作成する

  1. パネルで 設定 > 連携アプリ を開きます。
  2. AI アシスタントを接続 で、後で見分けられる名前(例:「MacBook の Claude Code」)をトークンに付けて、トークンを作成 を選びます。
  3. その下に表示されるコマンドまたは設定をコピーします。トークンは1回だけ表示されます。紛失した場合は新しく作成してください。

各トークンは 連携アプリ に、最終使用時刻とともに一覧表示されます。連携解除 を選ぶとすぐに無効になります。アシスタントとノートPCごとに1つのトークンを使うと、ほかに影響を与えずに1つだけ無効にできます。

トークンはパスワードと同じように扱ってください。持っている人は誰でもサーバーを確認し、デプロイを承認できます。リポジトリにコミットされるプロジェクトファイルには含めないでください。

Claude Code

パネルに表示されたコマンドを、ノートPCのターミナルで実行します。

claude mcp add --transport http --scope user rdev https://rdev.cloud/mcp --header "Authorization: Bearer <token>"

--scope user により、すべてのプロジェクトでサーバーが利用可能になります。接続は claude mcp list または Claude Code 内の /mcp で確認できます。

Cursor とその他の MCP クライアント

ほとんどのクライアントは同じ JSON を読み取ります。Cursor では、~/.cursor/mcp.json(すべてのプロジェクト)またはプロジェクト内の .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "rdev": {
      "type": "http",
      "url": "https://rdev.cloud/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

このサーバーは MCP の Streamable HTTP トランスポートに対応し、Authorization: Bearer ヘッダーで認証します。カスタムヘッダー付きのリモートサーバーに対応しているクライアントであれば、どれでも利用できます。

Codex

トークンを環境変数に設定し(例:シェルプロファイルに export RDEV_MCP_TOKEN=<token>)、次の内容を ~/.codex/config.toml に追加します。

[mcp_servers.rdev]
url = "https://rdev.cloud/mcp"
bearer_token_env_var = "RDEV_MCP_TOKEN"

Claude Desktop

Claude Desktop のカスタムコネクタは OAuth でサインインしますが、パネルはまだ OAuth に対応していません。代わりに mcp-remote ブリッジ経由で接続してください(ノートPCに Node.js が必要です)。Settings > Developer > Edit Config で、次を追加します。

{
  "mcpServers": {
    "rdev": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://rdev.cloud/mcp", "--header", "Authorization: Bearer ${RDEV_MCP_TOKEN}"],
      "env": { "RDEV_MCP_TOKEN": "<token>" }
    }
  }
}

その後、Claude Desktop を再起動します。

制限

アシスタントは1分あたり最大120件のリクエストを送信できます。1つの質問では通常、数件で済みます。無効化されたトークンや入力ミスのあるトークンには 401 Unauthorized が返されます。新しいトークンを作成して、クライアントの設定を更新してください。