Redis Cloud MCPサーバーでサブスクリプションを管理する

mcp-redis-cloudはRedis社が公開しているMCPサーバーで、Redis Cloudのアカウント管理をClaudeから自然言語で行えるようにします。サブスクリプションの作成、利用可能なリージョンの確認、料金プランの照会、実行中タスクの進捗確認までをカバーします。MITライセンスでGitHubスターは41、データ操作用のmcp-redisと名前が似ているため役割を混同しやすいツールです。「AWSに新しいRedisデータベースを作って」「今のサブスクリプションを教えて」のような発話を、実際のAPI呼び出しへ変換します。

Redis Cloud MCPサーバーで何ができるか

ツールは6つの領域に分かれています。アカウント管理ではget_current_accountでアカウント情報を、get_current_payment_methodsで登録済みの支払い方法を一覧取得できます。「今このアカウントに登録されているクレジットカードは何?」のような確認も、Redis Cloudの管理画面を開かずに済みます。サブスクリプション管理ではProサブスクリプション(マルチクラウド展開・Active-Active構成・カスタムネットワーキングまで対応する上位プラン)とEssentialサブスクリプション(作成・取得・削除)の両方を扱います。

データベース機能の確認に加え、get_pro_plans_regionsでAWS・GCP各リージョンの対応状況、ネットワーキングオプション、可用性ゾーンの構成を取得できます。「東京リージョンでProサブスクリプションを作るとしたら、どの可用性ゾーンが選べる?」といった質問を、コンソールを開かずに確認できるのが利点です。Essentialプランの料金一覧照会、そして長時間かかる操作(サブスクリプション作成など)の進捗を追うget_tasks / get_task_by_idもそろっています。プロビジョニングは非同期処理になるため、作成系のツールを呼んだ後はタスクIDで完了を確認する流れになります。

ProとEssentialは性格が異なります。Proは複数クラウドへの同時展開、Active-Active構成(複数リージョンで同時に書き込み可能な構成)、メモリー容量やパーシステンス(永続化方式)・モジュールの個別設定まで、細かい要件に応える上位プランです。Essentialは料金プランの一覧取得・作成・削除が一通りそろったシンプルな構成で、AWS・GCP・Azureの3クラウドに対応し、Redis Flex(メモリーとディスクを併用してコストを抑えるプラン)も選べます。「まずは検証用にEssentialで小さく始めて、要件が固まったらProへ」という進め方をClaudeに相談しながら決められます。

どちらを選ぶかの判断軸は、リージョン構成とネットワーキングの要件にあります。単一リージョンで動けば十分な検証環境やスモールチームの本番用途ならEssentialで足り、複数リージョンにまたがる可用性やカスタムネットワーキング(VPCピアリングなど)が要件に入った時点でProに切り替える、という段階的な選び方がしやすい構成です。

サブスクリプション作成(create_pro_subscription / create_essential_subscription)のような操作を頼んだあと、プロビジョニングが終わったかどうかはget_task_by_idにタスクIDを渡して確認します。ステータスが完了扱いになるまでは数分かかることがあり、Claudeに「さっきのタスクは終わった?」と聞き直せば、このツールを呼んで進捗を答えます。完了前にデータベースへの接続を試みてもエラーになるため、この確認を挟む手順が前提になっています。

一覧取得系のツールはページネーション(分割取得)に対応しています。Essentialプランの料金一覧やサブスクリプション一覧は件数が多いと1回のレスポンスに収まらず、複数回の呼び出しが必要になる場合があります。

mcp-redisとの役割の違い

同じRedis社が公開していても、扱う対象がまったく異なります。

両方を同時に接続しておけば、「新しいRedis Cloudデータベースを作って、そこにセッションデータを書き込む」のような一連の操作を1つのチャットで続けられます。データ操作そのもののツール一覧はRedis MCPサーバーの使い方にまとめています。

事前に用意するものは、Redis CloudのAPIキーとシークレットキーの2つだけです。どちらもRedis Cloudのアカウント設定画面から発行します。あとはNode.js(バージョン22系)とnpmが入った環境があれば、ビルドまで進められます。

Claude Desktopへの接続手順

公式の手順はnpmでの配布を使わず、リポジトリをクローンしてビルドします。

git clone https://github.com/redis/mcp-redis-cloud.git
cd mcp-redis-cloud
npm install
npm run build

ビルドが終わったらclaude_desktop_config.jsonに絶対パスで指定します。

{
  "mcpServers": {
    "mcp-redis-cloud": {
      "command": "node",
      "args": ["--experimental-fetch", "/absolute/path/to/mcp-redis-cloud/dist/index.js"],
      "env": {
        "API_KEY": "<redis_cloud_api_key>",
        "SECRET_KEY": "<redis_cloud_api_secret_key>"
      }
    }
  }
}

APIキーとシークレットキーはRedis Cloudのアカウント側で発行したものを使います。ビルドせずに動かしたい場合は、公式が配布するDockerイメージmcp/redis-cloudでも同じ設定が組めます。

{
  "mcpServers": {
    "redis-cloud": {
      "command": "docker",
      "args": ["run", "-i", "--rm",
        "-e", "API_KEY=<redis_cloud_api_key>",
        "-e", "SECRET_KEY=<redis_cloud_api_secret_key>",
        "mcp/redis-cloud"]
    }
  }
}

APIキーとシークレットキーの発行場所

接続に必要なAPIキーとシークレットキーは、どちらもRedis Cloudのアカウント設定画面(Access ManagementのAPI Keysタブ)から発行します。発行時に権限スコープを選べる場合は、検証段階では読み取り中心の操作に絞っておくと、設定ミスで課金操作が実行されるリスクを抑えられます。発行したキーはAPI_KEYとSECRET_KEYとしてそれぞれの設定ファイルに渡します。

Claude Codeへの追加コマンド

Docker版であればビルド不要なので、claude mcp addにそのままコマンドを渡せます。Claude Code自体のclaude mcp add構文の全体像はClaude Code MCP設定ガイドで扱っています。

claude mcp add --transport stdio redis-cloud \
  -- docker run -i --rm \
  -e API_KEY=your-api-key -e SECRET_KEY=your-secret-key \
  mcp/redis-cloud

npmパッケージを使う前に確認すること

npmレジストリにはmcp-redis-cloudという名前のパッケージが公開されています。ただしこのパッケージの公開アカウントは、Redis社のGitHub組織とは別の個人アカウントです。GitHub上の公式リポジトリには、npm経由のインストール手順自体が書かれていません。

公開者本人による、公式リポジトリとの関係を説明する記述は見当たらず、コードの改変が加えられていないという保証もありません。

このMCPサーバーはRedis Cloudの課金やインフラ操作を行う権限を持つAPIキーを扱います。出所を確認できないnpmパッケージにそのキーを渡すのは避け、公式リポジトリからのクローン・ビルド、またはDocker Hubのmcp/redis-cloudイメージを使う経路を選ぶのが安全です。

動作確認はMCP Inspectorが早い

Claude DesktopやCursorに設定してからでは、接続が失敗したときの原因がAPIキーなのかビルドなのか切り分けにくくなります。先にMCP Inspectorでツール単体の動作を確認しておくと早道です。

npx @modelcontextprotocol/inspector node dist/index.js --api-key=<api_key> --secret-key=<secret_key>

ブラウザ上でツール一覧が表示され、get_current_accountのような読み取り系ツールから順に呼び出して応答を確認できます。Inspectorの使い方全般はMCP Inspectorの使い方にまとめています。

よくあるつまずき

バージョンが固定できない。GitHubリポジトリにタグ付きリリースが無く、Dockerイメージのタグもlatestしかありません。両方とも最終更新は1年以上前(リポジトリは2025年5月、Dockerイメージは2025年6月)で止まっており、mcp-redisほど活発には更新されていません。本番運用で使う場合は、ビルドしたイメージを自社のレジストリに固定して保存しておく方が安全です。

APIキーの権限範囲を確認していない。サブスクリプション作成・削除ツールはRedis Cloudの課金に直結します。Claudeに渡すAPIキーの権限を、検証用アカウントや読み取り中心の操作に絞れないか、Redis Cloud側の管理画面で確認してから接続します。特にEssentialサブスクリプションの削除ツールは取り消せない操作なので、実行前に対象が正しいかをClaudeとの会話で確認する習慣をつけます。

設定ファイルのパスをコピーしたまま動かそうとする。claude_desktop_config.jsonに書くdist/index.jsへのパスは環境ごとに変わるため、READMEやこの記事のサンプルにある/absolute/path/to/mcp-redis-cloud/dist/index.jsをそのまま貼っても動きません。自分の環境でnpm run buildした実際のビルド成果物の絶対パスに必ず置き換えます。リポジトリのコードを変更したりRedis Cloud側の設定を変えたりした後は、npm run buildでのリビルドとClaude Desktopの再起動を忘れずに行います。再起動なしだと古いプロセスが動き続け、変更が反映されません。

まとめ

mcp-redis-cloudはRedis Cloudのアカウント・サブスクリプション管理を自然言語で行うためのMCPサーバーで、Redisデータベースの中身を操作するmcp-redisとは対象がはっきり分かれています。公式のインストール経路はソースビルドとDockerの2つで、npmパッケージは公式が案内していない第三者公開のため、課金権限を持つAPIキーを渡す前に出所を確認する価値があります。バージョン固定の手段が乏しい点も踏まえ、本番ではビルド済みイメージを自社側で保管しておく構成が安定します。

まず試すなら、読み取り専用のget_current_accountやget_pro_subscriptionsのような一覧系ツールから動作を確認し、create_essential_subscriptionのような課金が発生するツールは検証用アカウントで動きを把握してから本番のAPIキーに切り替える順番が安全です。データ操作用のmcp-redisと合わせて導入すれば、Redis Cloud上でのアカウント管理からデータベースへの実際の読み書きまでを、Claudeとの対話だけで一通りカバーできます。