Upstash MCP Server

Der Upstash MCP Server ist die offizielle Model-Context-Protocol-Anbindung an das eigene Upstash-Konto und lässt KI-Agenten Redis-Datenbanken, QStash-Nachrichtenwarteschlangen, Workflow-Läufe und Upstash-Box-Container direkt verwalten und debuggen. Statt zwischen Upstash-Konsole, Terminal und KI-Assistent zu wechseln, kann ein Coding-Agent Datenbanken anlegen, Logs durchsuchen, fehlgeschlagene Workflows erneut anstoßen oder Sandbox-Container starten – alles per natürlicher Sprache im Chat mit Claude Code, Cursor, Codex oder anderen MCP-fähigen Clients.

Was der Server kann

Für Redis lassen sich laut Anbieter unter anderem neue Datenbanken in einer bestimmten Region anlegen, bestehende Datenbanken nach Speicherverbrauch sortiert auflisten, das Schema gespeicherter Daten erklären lassen, Schlüssel mit bestimmten Mustern samt Inhalt finden, Backups erstellen und Datenbanken leeren sowie Durchsatzspitzen der letzten Tage analysieren. Für QStash und Workflow kann ein Agent Logs auf Fehlerursachen durchsuchen, fehlgeschlagene Workflow-Läufe der letzten 24 Stunden finden und erneut anstoßen, die Dead-Letter-Queue nach Fehlertyp zusammenfassen oder geplante Aufgaben pausieren. Für Upstash Box lassen sich Sandbox-Container starten, Repositories klonen und Tests direkt darin ausführen, Snapshots erstellen und vervielfältigen oder Fehlerursachen in den Container-Logs identifizieren.

Kostenlose Test-Datenbank ohne Anmeldung

Ein besonderes Werkzeug richtet sich direkt an KI-Agenten: Über redis_database_start_free oder einen direkten POST-Request an https://upstash.com/start-redis lässt sich eine kostenlose, temporäre Redis-Datenbank ohne Registrierung und ohne API-Schlüssel starten. Die Antwort enthält Zugangsdaten und eine Kurzanleitung als Markdown; die Datenbank läuft nach 72 Stunden ab, kann aber über ein Upstash-Konto dauerhaft übernommen werden. Laut Anbieter eignet sich das besonders für Agenten, die spontan Zwischenspeicher benötigen.

Zugangsdaten und Berechtigungen

Vor der Einrichtung werden die eigene Kontoemail sowie ein API-Schlüssel aus der Upstash-Konsole benötigt. Der Server unterstützt schreibgeschützte API-Schlüssel: Wird der Server damit gestartet, deaktiviert er automatisch alle zustandsverändernden Werkzeuge wie das Anlegen von Datenbanken, Löschen von Backups oder erneute Anstoßen von Workflows – der Agent kann das Konto dann nur noch lesen und abfragen, aber nicht verändern. Für den Zugriff auf Upstash Box wird zusätzlich ein separater Box-API-Schlüssel benötigt, der sich fest in die Server-Konfiguration einbinden lässt, um wiederholte manuelle Eingaben zu vermeiden.

Unterstützte Clients

Der Server läuft laut Anbieter mit jedem MCP-kompatiblen Client über stdio, mit offiziell dokumentierten Anleitungen für Claude Code, Cursor, Devin Desktop, OpenCode, OpenAI Codex, Visual Studio Code, Google Antigravity, Claude Desktop, Zed, DeepSeek Harness und Gemini CLI. Für Clients ohne eigene Anleitung genügt eine generische stdio-Konfiguration mit dem Befehl npx -y @upstash/mcp-server@latest.

Hinweis des Anbieters: Skill statt MCP-Server erwägen

Upstash empfiehlt im Repository selbst, für die meisten Workflows eher den Upstash-Skill zu installieren und den Agenten darüber die upstash-Kommandozeile bedienen zu lassen, statt den MCP-Server dauerhaft laufen zu lassen. Der MCP-Server eignet sich vor allem, wenn der Agent direkten, interaktiven Werkzeugzugriff auf laufende Ressourcen braucht – etwa um Logs live zu durchsuchen oder Workflows im Gespräch erneut anzustoßen.

Telemetrie und Datenschutz

Der Server sendet laut Anbieter anonyme Diagnosedaten an Upstash: SDK-Version, Laufzeitversion und grundlegende Plattforminformationen wie Betriebssystem und Architektur. Kontodaten, Werkzeugparameter oder -ergebnisse werden dabei nicht übertragen. Wer auch das nicht möchte, deaktiviert die Telemetrie über das Flag --disable-telemetry.

Lizenz und Kosten

Das Repository steht unter der MIT-Lizenz. Der MCP-Server selbst verursacht keine gesonderten Kosten; abgerechnet wird ausschließlich über den bestehenden Upstash-Tarif für die verwalteten Ressourcen.

Für wen sich der Einsatz lohnt

Besonders nützlich ist der Server für Entwicklerteams, die bereits auf Upstash-Diensten wie Redis oder QStash aufbauen: Fehleranalyse ohne Konsolen-Wechsel, automatisiertes Anlegen von Testdatenbanken für neue Projekte, oder das schnelle Debuggen fehlgeschlagener Workflows direkt aus dem Editor heraus. Wer nur mit einer einzelnen Redis-Datenbank arbeitet, kommt laut Anbieter mit dem schlankeren, dedizierten Redis-MCP-Server oft besser zurecht.

Ein Upstash-Konto (Kontoemail + API-Schlüssel aus Console → Account → API Keys) sowie ein MCP-fähiger Client mit stdio-Unterstützung (Node.js/npx verfügbar). Für Upstash-Box-Werkzeuge zusätzlich ein separater Box-API-Schlüssel.

Für Claude Code:

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

Für Codex:

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

Für jeden anderen stdio-fähigen MCP-Client genügt der Basisbefehl:

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

Für einen rein lesenden Zugriff einen schreibgeschützten API-Schlüssel aus der Upstash-Konsole verwenden – der Server deaktiviert dann automatisch alle verändernden Werkzeuge.

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

Kontoemail plus API-Schlüssel aus der Upstash-Konsole, beim Start als CLI-Flags übergeben. Schreibgeschützte API-Schlüssel werden unterstützt und deaktivieren automatisch alle zustandsverändernden Werkzeuge. Für Upstash Box ist ein zusätzlicher Box-API-Schlüssel nötig.

Der Server arbeitet mit den Rechten des verwendeten API-Schlüssels. Mit einem schreibgeschützten Schlüssel kann der Agent nur lesen und abfragen, nicht verändern; mit vollem Zugriff kann er auch Datenbanken anlegen, Backups löschen und Workflows erneut anstoßen.

Anfragen laufen lokal über den npx-Prozess und kommunizieren direkt mit der Upstash-API. Der Server sendet laut Anbieter anonyme Telemetrie (SDK-Version, Laufzeitversion, OS/Architektur) an Upstash, jedoch keine Kontodaten, Werkzeugparameter oder -ergebnisse. Telemetrie lässt sich per --disable-telemetry abschalten.

Mit einem vollen API-Schlüssel kann ein Agent Datenbanken löschen, Backups entfernen oder Produktionsdaten verändern. Upstash empfiehlt, wo möglich schreibgeschützte API-Schlüssel zu verwenden und den vollen Zugriff nur bei nachgewiesenem Bedarf zu gewähren.