Install mcpgate

One command. Self-hosted. No .env file needed.

curl -fsSL https://mcpgate.de/install.sh | bash

Reviewable shell script. Runs entirely on your infrastructure. No data sent externally.

View install script · View Docker Compose file

1
Run the command above
Checks Docker, downloads Compose setup to ~/.mcpgate, starts the stack
2
Open localhost:8642
The setup wizard walks you through login, branding, and service connections
3
Connect your AI client
Claude, Codex, Gemini, or ChatGPT — from the dashboard

Requirements

  • Docker and Docker Compose v2
  • A Google or Microsoft account (for initial login)

Manual Docker install

If you prefer to review and run the setup yourself, create a new directory first:

mkdir mcpgate && cd mcpgate

Save the following as docker-compose.yml:

services:
  mcpgate:
    image: mcpgate/mcpgate:latest
    ports:
      - "8642:3001"
    env_file:
      - path: .env
        required: false
    environment:
      - BASE_URL=http://localhost:8642
      - REDIS_URL=redis://:mcpgate-default-pw@redis:6379/0
    depends_on:
      redis:
        condition: service_healthy
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-sf", "http://localhost:3001/health"]
      interval: 10s
      timeout: 5s
      retries: 3
      start_period: 15s
    volumes:
      - gateway-data:/app/data

  redis:
    image: redis:7-alpine
    command: redis-server --requirepass mcpgate-default-pw --appendonly yes --maxmemory 128mb --maxmemory-policy allkeys-lru
    volumes:
      - redis-data:/data
    healthcheck:
      test: ["CMD", "redis-cli", "-a", "mcpgate-default-pw", "ping"]
      interval: 5s
      retries: 3
    restart: unless-stopped

volumes:
  gateway-data:
  redis-data:

Start the stack

docker compose up -d

That's it. Secrets are auto-generated on first start. Configuration is persisted automatically.

Open the setup wizard

Open localhost:8642 in your browser. The wizard walks you through:

  • Login — Sign in with Google or Microsoft (no OIDC setup needed)
  • Branding — Company name, logo, and primary color
  • Team — Admin emails and company domain
  • Services — Connect Jira, Slack, GitLab, Grafana, and more

Connect your AI client

After setup, connect your preferred AI client from the dashboard.

claude mcp add mcpgate https://your-gateway-url/mcp -s user -t http

For company-wide setup: Admin Settings → Connectors → add https://your-gateway-url/mcp

Verify

curl http://localhost:8642/health
# returns JSON with status and version

Updates

docker compose pull
docker compose up -d

Alternative: git clone

If you prefer to start from the repository (includes .env.example and documentation):

git clone https://gitlab.com/mcpgate/mcpgate.git
cd mcpgate
docker compose up -d

Advanced: .env configuration

For users who prefer file-based configuration:

cp .env.example .env
# Edit .env with your values
docker compose up -d

Environment variables take priority over wizard configuration. See Configuration Reference for all options.