Skip to main content
Glama
upstash

Upstash MCP Server

Official
by upstash

Upstash MCP Server

Install MCP Server

Upstash MCP サーバーを使用すると、エージェントが Redis、QStash、Workflow、および Upstash Box にわたって、Upstash リソースを直接管理およびデバッグできるようになります。

[!TIP] ほとんどのワークフローでは、MCP サーバーを実行するよりも、Upstash Skill をインストールし、エージェントに @upstash/cli を操作させることを推奨します。

クイックスタート

Upstash アカウントのメールアドレスと API キーが必要です。まだお持ちでない場合は Upstash Console → Account → API Keys で作成してください。

Upstash MCP サーバーは、MCP 互換のあらゆるクライアントで動作します。お使いのクライアントが以下にリストされていない場合は、そのドキュメントを参照して stdio MCP サーバーの追加方法を確認し、ベースコマンドを指定してください。

npx -y @upstash/mcp-server@latest --email YOUR_EMAIL --api-key YOUR_API_KEY

[!NOTE] 読み取り専用の API キーもサポートされています。サーバーが読み取り専用キーで起動すると、状態を変更するツール(データベースの作成、バックアップの削除、ワークフローの再試行など)はすべて自動的に無効になります。エージェントは引き続きアカウントの読み取りやクエリを実行できますが、変更を加えることはできません。

ターミナルでこのコマンドを実行してください。詳細については Claude Code MCP ドキュメント を参照してください。

claude mcp add --scope user upstash -- npx -y @upstash/mcp-server@latest --email YOUR_EMAIL --api-key YOUR_API_KEY

Settings → Cursor Settings → MCP → Add new global MCP server に移動します。

以下の設定を Cursor の ~/.cursor/mcp.json ファイルに貼り付けることを推奨します。プロジェクトフォルダーに .cursor/mcp.json を作成して、特定のプロジェクトにインストールすることも可能です。詳細については Cursor MCP ドキュメント を参照してください。

Cursor 1.0 以降では、以下のインストールボタンをクリックしてワンクリックでインストールできます。確認前に YOUR_EMAIL と YOUR_API_KEY を実際の値に置き換えてください。

Install MCP Server

{
  "mcpServers": {
    "upstash": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/mcp-server@latest",
        "--email",
        "YOUR_EMAIL",
        "--api-key",
        "YOUR_API_KEY"
      ]
    }
  }
}

これを Windsurf の MCP 設定ファイル ~/.codeium/windsurf/mcp_config.json に追加してください。詳細については Windsurf MCP ドキュメント を参照してください。

{
  "mcpServers": {
    "upstash": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/mcp-server@latest",
        "--email",
        "YOUR_EMAIL",
        "--api-key",
        "YOUR_API_KEY"
      ]
    }
  }
}

これを OpenCode 設定ファイル (~/.config/opencode/opencode.json またはプロジェクトレベルの opencode.json) に追加してください。詳細については OpenCode MCP ドキュメント を参照してください。

{
  "mcp": {
    "upstash": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@upstash/mcp-server@latest",
        "--email",
        "YOUR_EMAIL",
        "--api-key",
        "YOUR_API_KEY"
      ],
      "enabled": true
    }
  }
}

詳細については OpenAI Codex MCP ドキュメント を参照してください。

CLI の使用

codex mcp add upstash -- npx -y @upstash/mcp-server@latest --email YOUR_EMAIL --api-key YOUR_API_KEY

手動設定

これを Codex 設定ファイル (~/.codex/config.toml または .codex/config.toml) に追加してください:

[mcp_servers.upstash]
command = "npx"
args = ["-y", "@upstash/mcp-server@latest", "--email", "YOUR_EMAIL", "--api-key", "YOUR_API_KEY"]
startup_timeout_sec = 20

[!NOTE] 起動タイムアウトエラーが発生する場合は、startup_timeout_sec を 40 に増やしてください。

クリックしてインストールしてください。VS Code がメールアドレスと API キー(シークレットストレージに保存されます)の入力を求めます:

または、.vscode/mcp.json(またはユーザーの mcp.servers 設定)に追加してください。inputs で promptString を使用すると、API キーが一度だけ要求され、設定ファイルではなく VS Code のシークレットストレージに保持されます。詳細については VS Code MCP ドキュメント を参照してください。

{
  "inputs": [
    { "type": "promptString", "id": "email", "description": "Upstash email" },
    { "type": "promptString", "id": "apiKey", "description": "Upstash API key", "password": true }
  ],
  "servers": {
    "upstash": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@upstash/mcp-server@latest",
        "--email",
        "${input:email}",
        "--api-key",
        "${input:apiKey}"
      ]
    }
  }
}

これを Antigravity MCP 設定に追加してください。詳細については Antigravity MCP ドキュメント を参照してください。

{
  "mcpServers": {
    "upstash": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/mcp-server@latest",
        "--email",
        "YOUR_EMAIL",
        "--api-key",
        "YOUR_API_KEY"
      ]
    }
  }
}

Claude Desktop の開発者設定を開き、claude_desktop_config.json を編集してください。詳細については Claude Desktop MCP ドキュメント を参照してください。

{
  "mcpServers": {
    "upstash": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/mcp-server@latest",
        "--email",
        "YOUR_EMAIL",
        "--api-key",
        "YOUR_API_KEY"
      ]
    }
  }
}

~/.gemini/settings.json にある Gemini CLI 設定ファイルを開き、mcpServers に Upstash を追加してください。詳細については Gemini CLI Configuration を参照してください。

{
  "mcpServers": {
    "upstash": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/mcp-server@latest",
        "--email",
        "YOUR_EMAIL",
        "--api-key",
        "YOUR_API_KEY"
      ]
    }
  }
}

Related MCP server: MCP Server Boilerplate

プロンプト例

Redis

  • "us-east-1 に新しい Redis データベースを作成して"

  • "メモリ使用量順にデータベースをリストアップして"

  • "Redis から取得してユーザーのスキーマを更新して"

  • "このデータベースのバックアップを作成してから、中身をクリアして"

  • "過去7日間のスループットの急上昇を表示して"

QStash & Workflow

  • "QStash のログを確認して、なぜ webhook が失敗し続けているのか調べて"

  • "今日、ユーザー @admin の失敗したワークフロー実行を見つけて"

  • "2時間前に開始された失敗したワークフロー実行を再試行して"

  • "現在 DLQ にあるものをエラータイプ別にグループ化して要約して"

  • "エラーをスローしているスケジュールを一時停止して"

Upstash Box

  • "Box を立ち上げて、このリポジトリをクローンし、テストを実行して"

  • "この Box のスナップショットを作成して5つコピーし、それぞれに GitHub の issue を割り当てて"

  • "Box が起動に失敗し続けているので、ログを確認して何が問題か教えて"

Upstash Box API キー (オプション)

MCP が Upstash Box と対話するには、エージェントに Box API キーが必要です。デフォルトでは、エージェントが Box ツールを実行するたびにチャットに貼り付ける(または .env に保持する)必要があります。これを避けるために、キーを MCP 設定自体に組み込み、サーバー起動時に自動的に読み込ませることができます。

以下の2つの方法で渡すことができます。

CLI フラグ

{
  "mcpServers": {
    "upstash": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/mcp-server@latest",
        "--email",
        "YOUR_EMAIL",
        "--api-key",
        "YOUR_API_KEY",
        "--box-api-key",
        "YOUR_BOX_API_KEY"
      ]
    }
  }
}

環境変数

{
  "mcpServers": {
    "upstash": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/mcp-server@latest",
        "--email",
        "YOUR_EMAIL",
        "--api-key",
        "YOUR_API_KEY"
      ],
      "env": {
        "UPSTASH_BOX_API_KEY": "YOUR_BOX_API_KEY"
      }
    }
  }
}

デバッグ

サーバーの動作がおかしい場合やツールが失敗し続ける場合は、--debug フラグを使用して詳細ログを有効にしてください:

{
  "mcpServers": {
    "upstash": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/mcp-server@latest",
        "--email",
        "YOUR_EMAIL",
        "--api-key",
        "YOUR_API_KEY",
        "--debug"
      ]
    }
  }
}

すべての内部イベントが stderr に書き込まれ、MCP クライアントのログビューアーに表示されます。GitHub で問題を報告する際は、関連するスニペットを共有してください。

テレメトリ

サーバーはリクエストごとに匿名化された診断情報を Upstash に送信します。これには MCP サーバー SDK のバージョン、ランタイムバージョン (Node, Bun など)、基本的なプラットフォーム情報 (OS およびアーキテクチャ) が含まれます。アカウントデータ、ツール引数、結果は収集されません。 オプトアウトするには、引数に --disable-telemetry を追加してください。

開発

プロジェクトをクローンして以下を実行します:

bun i
bun run watch

これによりプロジェクトが継続的にビルドされ、変更が監視されます。

テスト用に、プロジェクトルートに .env ファイルを作成してください:

UPSTASH_EMAIL=<UPSTASH_EMAIL>
UPSTASH_API_KEY=<UPSTASH_API_KEY>
# Optional, for Box tools:
UPSTASH_BOX_API_KEY=<UPSTASH_BOX_API_KEY>

ローカルの MCP サーバーを Claude Code にインストールするには:

claude mcp add --transport stdio upstash -- bun --watch dist/index.js --debug

MCP サーバーのログをリアルタイムで追跡するには:

bun run logs

Related MCP Connectors

Related MCP Servers