Skip to content

Prerequisites

🛠️ Required Tools

Essential Components

IDE

GitLab Engine

MCP Server

Container Runtime

🔧 System Requirements

Hardware Requirements

  • RAM: Minimum 8GB (16GB recommended)
  • Storage: At least 10GB free space
  • CPU: Multi-core processor recommended

Operating System Support

  • Linux: Ubuntu 20.04+, CentOS 8+, or equivalent
  • macOS: macOS 11.0+ (Big Sur)
  • Windows: Windows 10/11 with WSL2

🌐 Network Requirements

Ports

  • Port 8080: GitLab web interface
  • Port 2222: GitLab SSH
  • Port 3000: MCP Server (configurable)

External Dependencies

  • Internet access for downloading Docker images
  • Access to GitLab repositories (if using GitLab.com)
  • AI model API access (OpenAI, Anthropic, etc.)

🔑 Authentication

GitLab Access Token

  1. Navigate to GitLab → User Settings → Access Tokens
  2. Create a new token with appropriate scopes:
  3. api: Full API access
  4. read_repository: Repository read access
  5. write_repository: Repository write access

MCP Configuration

  • AI service API keys (OpenAI, Anthropic, etc.)
  • GitLab instance URL and access token

✅ Verification Checklist

Before proceeding, ensure you have:

  • VSCode or VSCodium installed
  • Docker and Docker Compose installed
  • GitLab access (self-hosted or GitLab.com)
  • GitLab MCP server repository cloned
  • Required ports available
  • GitLab access token generated
  • AI service API keys obtained

🚀 Next Steps

Once all prerequisites are met, proceed to the Setup Guide to begin the installation process.