Upstash MCP 서버

👁 Install MCP Server

Upstash MCP 서버를 사용하면 에이전트가 Redis, QStash, Workflow, 그리고 Upstash Box 전반에 걸쳐 Upstash 리소스를 직접 관리하고 디버깅할 수 있습니다.

[!TIP] 대부분의 워크플로우에서는 MCP 서버를 실행하는 것보다 Upstash Skill을 설치하고 에이전트가 @upstash/cli를 직접 제어하도록 하는 것을 권장합니다.

빠른 시작

Upstash 계정 이메일과 API 키가 필요합니다. Upstash 콘솔 → 계정 → API 키에서 생성하세요.

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

~/.codeium/windsurf/mcp_config.json에 있는 Windsurf MCP 구성 파일에 추가하세요. 자세한 내용은 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 설정)에 추가하세요. promptString과 함께 inputs를 사용하면 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 구성을 참조하세요.

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

Related MCP server: @lex-tools/codebase-context-dumper

예시 프롬프트

Redis

• *"us-east-1에 새 Redis 데이터베이스 생성"

• *"메모리 사용량순으로 내 데이터베이스 나열"

• *"Redis에서 가져와 사용자 스키마 업데이트"

• *"이 DB의 백업을 생성한 다음 비우기"

• *"지난 7일 동안의 처리량 급증 확인"

QStash & Workflow

• *"QStash 로그를 확인하고 웹훅이 계속 실패하는 이유 파악"

• *"오늘 사용자 @admin에 대한 실패한 워크플로우 실행 찾기"

• *"2시간 전에 시작된 실패한 워크플로우 실행 재시도"

• *"현재 DLQ에 있는 내용을 오류 유형별로 그룹화하여 요약"

• *"오류를 발생시키는 일정 일시 중지"

Upstash Box

• *"Box를 실행하고 이 저장소를 복제한 다음 테스트 실행"

• *"이 Box의 스냅샷을 찍고 5개의 복사본을 생성한 다음, 각각에 GitHub 이슈 할당"

• *"내 Box가 계속 시작되지 않음, 로그를 확인하고 무엇이 문제인지 알려줘"

Upstash Box API 키 (선택 사항)

MCP가 Upstash Box와 상호 작용하려면 에이전트에 Box API 키가 필요합니다. 기본적으로 에이전트가 Box 도구를 실행할 때마다 채팅에 붙여넣거나 .env 파일에 보관해야 합니다. 이를 방지하려면 MCP 설정 자체에 키를 연결하여 서버가 시작될 때 자동으로 가져오도록 할 수 있습니다.

두 가지 방법으로 전달할 수 있습니다.

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

모든 내부 이벤트는 MCP 클라이언트가 자체 로그 뷰어에 표시하는 stderr에 기록됩니다. GitHub에 문제를 보고할 때 관련 스니펫을 공유하세요.

텔레메트리

서버는 각 요청과 함께 익명의 진단 정보(MCP 서버 SDK 버전, 런타임 버전(Node, Bun 등), 기본 플랫폼 정보(OS 및 아키텍처))를 Upstash로 보냅니다. 계정 데이터, 도구 인수 또는 결과는 수집되지 않습니다. 수집을 거부하려면 인수에 --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

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers