Storm Tools
Storm MCPStorm RouterChallenge
Resources
Leaderboard

Installation Guide

Storm MCP Gateway is a cloud-based platform that requires minimal setup on your end. This guide will walk you through getting your environment ready to use Storm MCP Gateway.

Prerequisites

Before you begin, ensure you have the following installed on your system:

MCP Client Software

Storm MCP Gateway works with any MCP-compatible client. We provide one-click integration buttons for these popular clients:

  • Claude Desktop (version 1.1.0 or later) - Download - One-click setup available
  • Cursor IDE (latest version) - Download - One-click setup available
  • VS Code (with MCP extension) - Download - Manual configuration

ℹ️ Info

Note: You can use any MCP-compatible client with Storm MCP Gateway by configuring it with your gateway's endpoint URL. The clients listed above simply offer the convenience of one-click configuration.

Browser Requirements

Storm MCP Gateway works best with modern browsers:

  • Chrome 90+
  • Firefox 88+
  • Safari 14+
  • Edge 90+

Client Installation

Claude Desktop Setup

  1. Download Claude Desktop

    # macOS brew install --cask claude # Windows winget install Anthropic.Claude # Or download directly from https://claude.ai/desktop

  2. Verify Installation

    • Open Claude Desktop
    • Go to Settings → MCP
    • You should see an option to add MCP servers

Cursor IDE Setup

  1. Download Cursor

    # macOS brew install --cask cursor # Windows winget install Cursor.Cursor # Or download directly from https://cursor.sh

  2. Enable MCP Support

    • Open Cursor
    • Go to Settings → Extensions
    • Ensure MCP support is enabled

Storm MCP Gateway Setup

1. Create Your Account

  1. Navigate to stormmcp.ai
  2. Click Get Started
  3. Sign up using:
    • Google authentication
    • GitHub authentication
    • Email and password

2. Verify Your Email

If you signed up with email:

  1. Check your inbox for a verification email
  2. Click the verification link
  3. You'll be redirected to the app

3. Initial Configuration

Once logged in:

  1. Complete Profile Setup

    • Add your organization name
    • Select your use case (optional)
    • Configure notification preferences

  2. Generate API Keys (Optional)

    • Navigate to Gateways → API Keys
    • Click "Generate New Key"
    • Store the key securely

⚠️ Warning

API keys are shown only once. Store them in a secure password manager immediately after generation.

Docker Installation (Enterprise)

⚠️ Warning

Enterprise License Required: Docker packages for self-hosted deployment are only available to enterprise customers with an active license. Contact sales@stormmcp.ai for licensing information.

For enterprise customers who prefer self-hosted deployment:

Prerequisites

  • Docker 20.10+
  • Docker Compose 2.0+
  • 4GB RAM minimum
  • 10GB disk space

Installation Steps

  1. Clone the Enterprise Repository

    # Requires enterprise credentials git clone https://github.com/storm-mcp-enterprise/gateway.git cd gateway

  2. Configure Environment

    cp .env.example .env # Edit .env with your configuration

  3. Start the Services

    docker-compose up -d

  4. Verify Installation

    docker-compose ps # All services should be "Up"

  5. Access the Gateway

Kubernetes Installation (Enterprise)

⚠️ Warning

Enterprise License Required: Kubernetes Helm charts and container images are only available to enterprise customers with an active license. You will need authentication credentials provided with your enterprise subscription.

For Kubernetes deployments, we provide Helm charts:

# Add the Storm MCP Helm repository (requires authentication) helm repo add storm-mcp https://charts.stormmcp.ai \ --username $ENTERPRISE_USERNAME \ --password $ENTERPRISE_TOKEN helm repo update # Install the chart helm install storm-gateway storm-mcp/gateway \ --namespace storm-mcp \ --create-namespace \ --values values.yaml

ℹ️ Info

Contact our enterprise support team for assistance with Kubernetes deployments and custom configurations.

Environment Variables

Key environment variables for configuration:

# Authentication AUTH_PROVIDER=storm-auth AUTH_URL=https://auth.stormmcp.ai AUTH_CLIENT_ID=your-client-id # API Configuration API_BASE_URL=https://api.stormmcp.ai WEBSOCKET_URL=wss://ws.stormmcp.ai # Optional Features ENABLE_ANALYTICS=true ENABLE_DEBUG_MODE=false LOG_LEVEL=info

Firewall Configuration

Ensure your firewall allows connections to:

  • HTTPS (443): API and web access
  • WSS (443): WebSocket connections for real-time features
  • SSE (443): Server-sent events for MCP communication

Troubleshooting Installation

Common Issues

Cannot connect to Storm MCP Gateway

  • Check your internet connection
  • Verify firewall settings
  • Try clearing browser cache

Authentication fails

  • Ensure cookies are enabled
  • Check if third-party cookies are blocked
  • Try a different browser

Docker installation fails

# Reset Docker environment docker-compose down -v docker system prune -a # Retry installation

Port conflicts

# Check for port usage lsof -i :4000 # Change port in docker-compose.yml if needed

Next Steps

Once installation is complete:

  1. Configure Authentication
  2. Create Your First Gateway
  3. Connect Your First App

Support

Need help with installation?

Previous
Quick Start
Next
Authentication