Upstash MCP-Server

Der Upstash MCP-Server ermöglicht es Ihrem Agenten, Ihre Upstash-Ressourcen direkt zu verwalten und zu debuggen, über Redis, QStash, Workflow und Upstash Box hinweg.

[!TIP] Für die meisten Workflows ist es vorzuziehen, den Upstash Skill zu installieren und Ihren Agenten die @upstash/cli steuern zu lassen, anstatt den MCP-Server auszuführen.

Schnellstart

Sie benötigen Ihre Upstash-Konto-E-Mail-Adresse und einen API-Schlüssel – erstellen Sie einen unter Upstash Console → Account → API Keys.

Der Upstash MCP-Server funktioniert mit jedem MCP-kompatiblen Client. Wenn Ihr Client unten nicht aufgeführt ist, lesen Sie in dessen Dokumentation nach, wie ein stdio-MCP-Server hinzugefügt wird, und verweisen Sie dann auf den Basisbefehl:

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

[!NOTE] Readonly-API-Schlüssel werden unterstützt. Wenn der Server mit einem solchen gestartet wird, deaktiviert er automatisch jedes Tool, das den Status ändern würde (Datenbanken erstellen, Backups löschen, Workflows wiederholen usw.). Ihr Agent kann Ihr Konto weiterhin lesen und abfragen, aber keine Änderungen vornehmen.

Führen Sie diesen Befehl in Ihrem Terminal aus. Weitere Informationen finden Sie in der Claude Code MCP-Dokumentation.

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

Gehen Sie zu Settings → Cursor Settings → MCP → Add new global MCP server.

Das Einfügen der folgenden Konfiguration in Ihre Cursor-Datei ~/.cursor/mcp.json ist der empfohlene Ansatz. Sie können die Installation auch in einem bestimmten Projekt vornehmen, indem Sie eine .cursor/mcp.json in Ihrem Projektordner erstellen. Weitere Informationen finden Sie in der Cursor MCP-Dokumentation.

Seit Cursor 1.0 können Sie für eine sofortige Ein-Klick-Installation auf die Schaltfläche unten klicken. Ersetzen Sie YOUR_EMAIL und YOUR_API_KEY durch Ihre echten Werte, bevor Sie bestätigen.

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

Fügen Sie dies Ihrer Windsurf-MCP-Konfigurationsdatei unter ~/.codeium/windsurf/mcp_config.json hinzu. Weitere Informationen finden Sie in der Windsurf MCP-Dokumentation.

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

Fügen Sie dies Ihrer OpenCode-Konfigurationsdatei hinzu (~/.config/opencode/opencode.json oder eine opencode.json auf Projektebene). Weitere Informationen finden Sie in der OpenCode MCP-Dokumentation.

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

Weitere Informationen finden Sie in der OpenAI Codex MCP-Dokumentation.

Verwendung der CLI

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

Manuelle Konfiguration

Fügen Sie dies Ihrer Codex-Konfigurationsdatei hinzu (~/.codex/config.toml oder .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] Wenn Sie Zeitüberschreitungsfehler beim Start sehen, erhöhen Sie startup_timeout_sec auf 40.

Klicken Sie zum Installieren – VS Code fragt nach Ihrer E-Mail-Adresse und Ihrem API-Schlüssel (diese werden im geheimen Speicher von VS Code gespeichert):

Oder fügen Sie dies zu .vscode/mcp.json (oder Ihrer Benutzer-Einstellung mcp.servers) hinzu. Die Verwendung von inputs mit promptString bedeutet, dass Ihr API-Schlüssel einmal abgefragt und im geheimen Speicher von VS Code aufbewahrt wird, anstatt in der Konfigurationsdatei zu liegen. Weitere Informationen finden Sie in der VS Code MCP-Dokumentation.

{
  "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}"
      ]
    }
  }
}

Fügen Sie dies Ihrer Antigravity-MCP-Konfiguration hinzu. Weitere Informationen finden Sie in der Antigravity MCP-Dokumentation.

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

Öffnen Sie die Entwicklereinstellungen von Claude Desktop und bearbeiten Sie claude_desktop_config.json. Weitere Informationen finden Sie in der Claude Desktop MCP-Dokumentation.

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

Öffnen Sie die Einstellungsdatei der Gemini CLI unter ~/.gemini/settings.json und fügen Sie Upstash zu mcpServers hinzu. Details finden Sie unter 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

Beispiel-Prompts

Redis

• "Erstelle eine neue Redis-Datenbank in us-east-1"

• "Liste meine Datenbanken sortiert nach Speichernutzung auf"

• "Aktualisiere das Benutzerschema durch Abruf aus Redis"

• "Erstelle ein Backup dieser Datenbank und leere sie dann"

• "Zeige mir Durchsatzspitzen während der letzten 7 Tage"

QStash & Workflow

• "Überprüfe die QStash-Logs und finde heraus, warum mein Webhook ständig fehlschlägt"

• "Finde fehlgeschlagene Workflow-Ausführungen für Benutzer @admin von heute"

• "Wiederhole die fehlgeschlagene Workflow-Ausführung, die vor 2 Stunden gestartet wurde"

• "Fasse zusammen, was sich gerade in der DLQ befindet, gruppiert nach Fehlertyp"

• "Pausiere die Zeitpläne, die Fehler verursachen"

Upstash Box

• "Starte eine Box, klone dieses Repository und führe die Tests aus"

• "Erstelle einen Snapshot dieser Box und erstelle 5 Kopien davon, weise jeder ein GitHub-Issue zu"

• "Meine Box startet ständig nicht, überprüfe die Logs und sag mir, was falsch ist"

Upstash Box API-Schlüssel (optional)

Damit der MCP mit Upstash Box interagieren kann, benötigt der Agent Ihren Box-API-Schlüssel. Standardmäßig müssen Sie ihn jedes Mal, wenn der Agent ein Box-Tool ausführt, in den Chat einfügen (oder in einer .env behalten). Um dies zu vermeiden, können Sie den Schlüssel direkt in die MCP-Einrichtung integrieren, sodass der Server ihn beim Start automatisch übernimmt.

Sie können ihn auf zwei Arten übergeben.

CLI-Flag

{
  "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"
      ]
    }
  }
}

Umgebungsvariable

{
  "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"
      }
    }
  }
}

Debugging

Wenn sich der Server fehlerhaft verhält oder ein Tool ständig fehlschlägt, aktivieren Sie die ausführliche Protokollierung mit dem --debug-Flag:

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

Jedes interne Ereignis wird dann in stderr geschrieben, das Ihr MCP-Client in seinem eigenen Log-Viewer anzeigt. Teilen Sie den relevanten Ausschnitt, wenn Sie ein Problem auf GitHub melden.

Telemetrie

Der Server sendet bei jeder Anfrage anonyme Diagnoseinformationen an Upstash: die MCP-Server-SDK-Version, Ihre Laufzeitversion (Node, Bun usw.) und grundlegende Plattforminformationen (Betriebssystem und Architektur). Es werden keine Kontodaten, Tool-Argumente oder Ergebnisse gesammelt. Um dies zu deaktivieren, fügen Sie --disable-telemetry zu den Argumenten hinzu.

Entwicklung

Klonen Sie das Projekt und führen Sie Folgendes aus:

bun i
bun run watch

Dies erstellt das Projekt kontinuierlich und überwacht Änderungen.

Erstellen Sie zum Testen eine .env-Datei im Projektstammverzeichnis:

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

So installieren Sie den lokalen MCP-Server in Claude Code:

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

So verfolgen Sie die Logs des MCP-Servers in Echtzeit:

bun run logs