Supported MCP 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
Codex	stdio or HTTP	CLI command	Plugin or `codex mcp`

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:

bash

npx @structured-world/gitlab-mcp setup

Or install to specific clients directly:

bash

# 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`
Codex	`~/.codex/config.toml`

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`
Codex	`%USERPROFILE%\.codex\config.toml`

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`
Codex	`~/.codex/config.toml`

CODEX_HOME moves the Codex file on every platform.

Next Steps

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

Supported MCP Clients ​

Client Overview ​

Automatic Setup ​

Config File Locations ​

macOS ​

Windows ​

Linux ​

Next Steps ​