Supported Clients

GitLab MCP works with all major AI coding assistants that support the Model Context Protocol.

Client Overview

Client	Transport	Auto-Detect	Setup Guide
Claude Desktop	stdio	App bundle	JSON config
Claude Code	stdio	CLI command	CLI or JSON
Cursor	stdio	Config dir	JSON config
VS Code	stdio	Config dir	JSON config
Windsurf	stdio	Config dir	JSON config
Cline	stdio	Extension dir	JSON config
Roo Code	stdio	Config dir	JSON config

All clients can also connect via HTTP (StreamableHTTP or SSE) to a remote server deployment.

Automatic Setup

The setup wizard automatically detects installed clients and configures them:

npx @structured-world/gitlab-mcp setup

Or install to specific clients directly:

# Install to all detected clients
npx @structured-world/gitlab-mcp install --all

# Install to specific clients
npx @structured-world/gitlab-mcp install --claude-desktop --cursor

Config File Locations

macOS

Client	Path
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json
Claude Code	~/.claude.json
Cursor	~/.cursor/mcp.json
VS Code	.vscode/mcp.json (per-project)
Windsurf	~/.codeium/windsurf/mcp_config.json
Cline	~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Roo Code	~/.roo/mcp.json

Windows

Client	Path
Claude Desktop	%APPDATA%\Claude\claude_desktop_config.json
Claude Code	%USERPROFILE%\.claude.json
Cursor	%USERPROFILE%\.cursor\mcp.json
VS Code	.vscode\mcp.json (per-project)
Windsurf	%USERPROFILE%\.codeium\windsurf\mcp_config.json
Cline	%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
Roo Code	%USERPROFILE%\.roo\mcp.json

Linux

Client	Path
Claude Desktop	~/.config/claude/claude_desktop_config.json
Claude Code	~/.claude.json
Cursor	~/.cursor/mcp.json
VS Code	.vscode/mcp.json (per-project)
Windsurf	~/.codeium/windsurf/mcp_config.json
Cline	~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Roo Code	~/.roo/mcp.json

Next Steps

• Setup Wizard — automatic configuration
• Manual Configuration — edit config files directly
• Deployment Options — local vs remote server