Installation

Choose the installation method that best fits your workflow.

Recommended: Setup Wizard

The fastest way to get started. The interactive wizard auto-detects your environment and configures everything:

npx @structured-world/gitlab-mcp setup

See Setup Wizard for a detailed walkthrough.

Installation Methods

Method	Best For	Guide
Setup Wizard	First-time setup, auto-configuration	Interactive, detects clients
npm / npx	Quick start, CI/CD	Minimal config, no install
Docker	Teams, server deployments	Isolated, scalable
Claude Desktop	Claude Desktop users	One-click .mcpb extension
VS Code	VS Code + GitHub Copilot users	One-click install
Codex	OpenAI Codex CLI users	Direct integration
Manual	Custom setups, advanced users	Full control

Prerequisites

• Node.js >= 24.0.0 (for npm/npx methods)
• GitLab Personal Access Token with api and read_user scopes
• One or more supported MCP clients

Next Steps

• Client-specific setup guides
• Deployment options
• Configuration reference