Servidor MCP de Upstash

El servidor MCP de Upstash permite a tu agente gestionar y depurar tus recursos de Upstash directamente, a través de Redis, QStash, Workflow y Upstash Box.

[!TIP] Para la mayoría de los flujos de trabajo, es preferible instalar la Skill de Upstash y dejar que tu agente controle @upstash/cli en lugar de ejecutar el servidor MCP.

Inicio rápido

Necesitarás tu correo electrónico de la cuenta de Upstash y una clave API; crea una en Consola de Upstash → Cuenta → Claves API.

El servidor MCP de Upstash funciona con cualquier cliente compatible con MCP. Si tu cliente no aparece en la lista a continuación, consulta su documentación sobre cómo añadir un servidor MCP stdio y luego apúntalo al comando base:

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

[!NOTE] Se admiten claves API de solo lectura. Cuando el servidor se inicia con una, deshabilita automáticamente todas las herramientas que modificarían el estado (crear bases de datos, eliminar copias de seguridad, reintentar flujos de trabajo, etc.). Tu agente aún puede leer y consultar tu cuenta, pero no puede realizar cambios.

Ejecuta este comando en tu terminal. Consulta la documentación de MCP de Claude Code para obtener más información.

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

Ve a Settings → Cursor Settings → MCP → Add new global MCP server.

Se recomienda pegar la siguiente configuración en tu archivo ~/.cursor/mcp.json de Cursor. También puedes instalarlo en un proyecto específico creando un archivo .cursor/mcp.json en la carpeta de tu proyecto. Consulta la documentación de MCP de Cursor para obtener más información.

Desde Cursor 1.0, puedes hacer clic en el botón de instalación a continuación para una instalación instantánea con un solo clic. Reemplaza YOUR_EMAIL y YOUR_API_KEY con tus valores reales antes de confirmar.

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

Añade esto a tu archivo de configuración MCP de Windsurf en ~/.codeium/windsurf/mcp_config.json. Consulta la documentación de MCP de Windsurf para obtener más información.

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

Añade esto a tu archivo de configuración de OpenCode (~/.config/opencode/opencode.json o un opencode.json a nivel de proyecto). Consulta la documentación de MCP de OpenCode para obtener más información.

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

Consulta la documentación de MCP de OpenAI Codex para obtener más información.

Usando la CLI

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

Configuración manual

Añade esto a tu archivo de configuración de Codex (~/.codex/config.toml o .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] Si ves errores de tiempo de espera de inicio, aumenta startup_timeout_sec a 40.

Haz clic para instalar: VS Code te pedirá tu correo electrónico y clave API (almacenados en su almacenamiento secreto):

O añade esto a .vscode/mcp.json (o a tu configuración de usuario mcp.servers). Usar inputs con promptString significa que tu clave API se solicita una vez y se mantiene en el almacenamiento secreto de VS Code en lugar de estar en el archivo de configuración. Consulta la documentación de MCP de VS Code para obtener más información.

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

Añade esto a tu configuración de MCP de Antigravity. Consulta la documentación de MCP de Antigravity para obtener más información.

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

Abre la configuración de desarrollador de Claude Desktop y edita claude_desktop_config.json. Consulta la documentación de MCP de Claude Desktop para obtener más información.

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

Abre el archivo de configuración de Gemini CLI en ~/.gemini/settings.json y añade Upstash a mcpServers. Consulta la Configuración de Gemini CLI para obtener más detalles.

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

Related MCP server: MCP Server Sample

Ejemplos de prompts

Redis

• "Crea una nueva base de datos Redis en us-east-1"

• "Lista mis bases de datos ordenadas por uso de memoria"

• "Actualiza el esquema de usuario extrayéndolo de Redis"

• "Crea una copia de seguridad de esta base de datos y luego límpiala"

• "Muéstrame los picos de rendimiento durante los últimos 7 días"

QStash y Workflow

• "Revisa los registros de QStash y averigua por qué mi webhook sigue fallando"

• "Busca ejecuciones de flujo de trabajo fallidas para el usuario @admin hoy"

• "Reintenta la ejecución del flujo de trabajo fallido que comenzó hace 2 horas"

• "Resume lo que hay en la DLQ ahora mismo, agrupado por tipo de error"

• "Pausa las programaciones que están lanzando errores"

Upstash Box

• "Inicia una Box, clona este repositorio y ejecuta las pruebas"

• "Toma una instantánea de esta Box y crea 5 copias a partir de ella, asigna a cada una un issue de GitHub"

• "Mi Box sigue fallando al iniciarse, revisa los registros y dime qué está mal"

Clave API de Upstash Box (opcional)

Para que el MCP interactúe con Upstash Box, el agente necesita tu clave API de Box. Por defecto, tienes que pegarla en el chat (o mantenerla en un .env) cada vez que el agente ejecuta una herramienta de Box. Para evitar esto, puedes integrar la clave en la propia configuración de MCP para que el servidor la recoja automáticamente al iniciarse.

Puedes pasarla de dos maneras.

Flag de 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"
      ]
    }
  }
}

Variable de entorno

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

Depuración

Si el servidor no funciona correctamente o una herramienta sigue fallando, habilita el registro detallado con la flag --debug:

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

Cada evento interno se escribe entonces en stderr, que tu cliente MCP muestra en su propio visor de registros. Comparte el fragmento relevante al informar de un problema en GitHub.

Telemetría

El servidor envía información de diagnóstico anónima a Upstash con cada solicitud: la versión del SDK del servidor MCP, la versión de tu entorno de ejecución (Node, Bun, etc.) e información básica de la plataforma (SO y arquitectura). No se recopilan datos de la cuenta, argumentos de herramientas ni resultados. Para optar por no participar, añade --disable-telemetry a los argumentos.

Desarrollo

Clona el proyecto y ejecuta:

bun i
bun run watch

Esto construye continuamente el proyecto y observa los cambios.

Para realizar pruebas, crea un archivo .env en la raíz del proyecto:

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

Para instalar el servidor MCP local en Claude Code:

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

Para seguir los registros del servidor MCP en tiempo real:

bun run logs