GitLab MCP Server

Подключите свой ИИ-ассистент к GitLab, чтобы он мог проверять merge request'ы, разбирать пайплайны, управлять issue и составлять релизы — на обычном языке. Один статический бинарник (или контейнер) даёт более 1000 инструментов GitLab через полный REST + GraphQL API и работает с Claude, Cursor, VS Code и любым MCP-клиентом.

Вы общаетесь со своим ИИ-ассистентом, а он выполняет работу в GitLab. Не нужно запоминать ID проектов, API-эндпоинты или JSON.

"Проверь merge request !15 — безопасно ли его сливать?" · "Почему упал последний пайплайн?" · "Покажи открытые issue, назначенные на меня" · "Сформируй примечания к релизу с v1.0 по v2.0"

🤖 Пользуетесь ИИ-ассистентом? Дайте ему URL этого репозитория и попросите установить сервер для вашего клиента. Всё, что нужно модели для выполнения этого без участия человека — декларативная конфигурация для каждого клиента, однострочники claude mcp add и значения по умолчанию — есть в llms.txt (интерактивный мастер не требуется).

Установка за 60 секунд

Выберите один вариант. Каждый путь заканчивается тем, что вы вводите запрос своему ассистенту.

Установка в один клик

Каждая кнопка регистрирует сервер на базе Docker (при первом запуске образ подтягивается автоматически; вам нужен установленный Docker). Строка Claude Desktop вместо этого загружает нативное расширение для рабочего стола .mcpb (macOS universal + Windows, без Docker) — откройте его через Claude Desktop и заполните настройки. Нужен токен? Создайте Personal Access Token с областью api. Используете self-managed GitLab? Добавьте переменную окружения GITLAB_URL в MCP-конфиг вашего клиента после установки.

Claude Code (claude mcp add)

Docker (без установки — образ подтягивается при первом запуске):

claude mcp add gitlab --env GITLAB_TOKEN=glpat-xxxx --transport stdio \
  -- docker run -i --rm -e GITLAB_TOKEN ghcr.io/jmrplens/gitlab-mcp-server:latest --http=false

Или сначала установите нативный бинарник, а затем зарегистрируйте его:

# macOS/Linux (Homebrew)
brew install jmrplens/tap/gitlab-mcp-server
# Linux/macOS (script)
curl -fsSL https://raw.githubusercontent.com/jmrplens/gitlab-mcp-server/main/scripts/install.sh | sh
# Windows (winget)
winget install --id jmrplens.gitlab-mcp-server -e
# Windows (PowerShell)
irm https://raw.githubusercontent.com/jmrplens/gitlab-mcp-server/main/scripts/install.ps1 | iex

claude mcp add gitlab --env GITLAB_TOKEN=glpat-xxxx -- gitlab-mcp-server

Self-managed GitLab? Добавьте --env GITLAB_URL=https://gitlab.example.com (и --env GITLAB_SKIP_TLS_VERIFY=true для самоподписанных сертификатов).

Настройка с мастером (любой клиент, не нужно помнить флаги)

Бинарник поставляется с мастером настройки, который собирает ваш GitLab-токен и настраивает MCP-клиент за вас — идеально, если не хочется редактировать JSON:

gitlab-mcp-server --setup

Он автоматически определяет VS Code, Claude Desktop, Claude Code, Cursor и Windsurf и записывает нужную конфигурацию. В Windows дважды щёлкните .exe, чтобы запустить его.

Ручная настройка JSON (Claude Desktop, Cursor, VS Code, …)

Нативный бинарник (Claude Desktop mcpServers, Cursor и т. д.):

{
  "mcpServers": {
    "gitlab": {
      "command": "/path/to/gitlab-mcp-server",
      "env": { "GITLAB_TOKEN": "glpat-xxxxxxxxxxxxxxxxxxxx" }
    }
  }
}

VS Code (.vscode/mcp.json, обратите внимание на servers + type):

{
  "servers": {
    "gitlab": {
      "type": "stdio",
      "command": "/path/to/gitlab-mcp-server",
      "env": { "GITLAB_TOKEN": "glpat-xxxxxxxxxxxxxxxxxxxx" }
    }
  }
}

Вариант с Docker — замените "command"/"args" на:

"command": "docker",
"args": ["run", "-i", "--rm", "-e", "GITLAB_TOKEN", "ghcr.io/jmrplens/gitlab-mcp-server:latest", "--http=false"]

Cline (VS Code) — откройте боковую панель Cline → значок MCP servers → Edit Global MCP, или отредактируйте файл настроек напрямую:

• macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

• Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

• Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

Cline использует структуру mcpServers, показанную выше, для нативного бинарника.

Для общего долгоживущего HTTP-развёртывания вместо пользовательского stdio см. режим HTTP-сервера.

Попробуйте без установки (публичный endpoint)

Публичный инстанс работает по адресу https://mcp.jmrp.io/gitlab — ничего устанавливать не нужно, кроме собственного токена GitLab, и никакой учётной записи. Направьте на него любой MCP-клиент, поддерживающий HTTP:

{
  "mcpServers": {
    "gitlab": {
      "type": "http",
      "url": "https://mcp.jmrp.io/gitlab",
      "headers": { "PRIVATE-TOKEN": "glpat-xxxxxxxxxxxx" }
    }
  }
}

PRIVATE-TOKEN обязателен и передаётся с каждым запросом — на сервере он никогда не хранится. GITLAB-URL необязателен и по умолчанию равен https://gitlab.com; задайте его, чтобы обратиться к другому инстансу (он должен быть доступен из публичного интернета).

Это самый быстрый способ попробовать сервер, но правильный способ продолжать им пользоваться — по-прежнему локально (любой вариант выше) — по одной конкретной причине, а не для проформы: ваш токен и каждый запрос проходят через чужую машину. Запуск локально означает, что ваши учётные данные и трафик GitLab никогда не покидают ваш компьютер, а кроме того, делает этот вариант единственным разумным для частного self-managed инстанса.

Endpoint — это stateless streamable HTTP на поверхности dynamic, используемой по умолчанию: транспорт — POST, GET на нём намеренно отвечает 405, а https://mcp.jmrp.io/gitlab/health отвечает 200 с {"status":"ok",…}.

Самостоятельное HTTP-развёртывание также может работать с --auth-mode=oauth --gitlab-url=https://gitlab.com --public-url=https://mcp.example.com (оба параметра обязательны: для OAuth нужны фиксированный инстанс и внешне доступный origin, по которому RFC 9728 идентифицирует ресурс) — в этом случае клиенты обнаруживают GitLab как сервер авторизации через эти метаданные и авторизуются в браузере, а не копируют токены. См. настройку OAuth-приложения.

Это один из серверов, перечисленных на mcp.jmrp.io — в каталоге MCP-серверов, которые я поддерживаю; каждый доступен по своему endpoint. https://mcp.jmrp.io/servers.json — тот же список для автоматизированных клиентов.

А дальше просто спросите: откройте ИИ-клиент и попробуйте "Список моих проектов GitLab." Подробности для каждого клиента — в руководстве по началу работы, а ещё примеры запросов — по ссылке.

Related MCP server: mcp-gitlab-jira

Почему этот сервер

• GitLab на простом языке. ИИ переводит запрос «безопасно ли мёржить MR !15?» в правильные API-вызовы. Вам не нужно касаться эндпоинтов, ID или JSON.

• Вся платформа — более 1000 инструментов. Широкое покрытие GitLab REST v4 + GraphQL: проекты, ветки, теги, релизы, запросы на слияние, задачи, пайплайны, задания, группы, пользователи, вики, окружения, развёртывания, пакеты, container registry, раннеры, feature flags, переменные CI/CD, безопасность, администрирование, токены и многое другое.

• Низкое потребление токенов по умолчанию. Стандартная динамическая поверхность даёт всего 2 инструмента (find + execute), но обеспечивает доступ ко всему каталогу — поэтому она вписывается в контекстное окно любого клиента. (Объём токенов →)

• Проверено на реальных моделях. Автоматический оценщик прогоняет Anthropic, Google, OpenAI и Qwen на живых инстансах GitLab: совокупный успех 99.5% на тысячах операций. (Результаты →)

• Безопасно по построению. Режим «только чтение», безопасный режим (предпросмотр каждой мутации в режиме dry-run), опции TLS для self-hosted GitLab и непрерывные проверки качества/безопасности SonarCloud.

• Работает где угодно. Один статический бинарник или контейнер; Windows, Linux и macOS; amd64 и arm64; stdio (десктоп) и HTTP (удалённо).

• 45 ресурсов MCP (данные только для чтения: проекты, задачи, пайплайны, MR, ветки, участники, манифест gitlab://tools, учитывающий текущую поверхность, и руководства по лучшим практикам рабочих процессов). 26 типов одиночных объектов также поддерживают подписку.

• 37 промптов MCP (ревью кода, статус пайплайна, оценка рисков, заметки о релизе, стендап, аналитика, аудит и другое).

• 4 мастера элиситации (интерактивное создание issue/MR/релиза/проекта).

• 4 возможности MCP (автодополнения, прогресс, элиситация и подписки на ресурсы — живые уведомления resources/updated, поддерживаемые через polling), а также 51 иконка инструментов (50 доменных иконок плюс логотип проекта) для визуальной идентификации в MCP-клиентах.

• Пагинация на каждой конечной точке списка с полными метаданными.

Tool surfaces

Сервер может представлять GitLab в трёх формах, управляемых через TOOL_SURFACE. Вариант по умолчанию не требует настройки.

Количество инструментов масштабируется в зависимости от редакции GitLab (GITLAB_TIER); более высокие редакции открывают больше действий. Модель ранжирования, защитные механизмы и полные каталоги см. в Dynamic Toolset и Meta-Tools Reference. Для динамических запусков, где ресурсы преобладают в контексте, установите CAPABILITY_SURFACE=minimal.

Token Footprint

Измерено с помощью go run ./cmd/audit_tokens/ -footprint на текущем каталоге. Итоги оценивают стартовый контекст, видимый MCP-клиенту: видимые схемы инструментов плюс общие ресурсы и промпты, с использованием токенизатора cl100k_base (кодировка GPT-4/GPT-3.5). Полную матрицу (поверхности meta и individual, все режимы META_PARAM_SCHEMA) см. в Token Footprint Reference.

Конфигурация по умолчанию: если TOOL_SURFACE не задан или равен TOOL_SURFACE=dynamic, CAPABILITY_SURFACE=full, META_TOOLS не задан, META_PARAM_SCHEMA=opaque, а GITLAB_TIER не задан (определяется автоматически, запасной вариант free), сервер использует динамическую поверхность find/execute. Используйте TOOL_SURFACE=meta только когда вам явно нужны доменные meta-инструменты; TOOL_SURFACE=individual — только когда ваш клиент может обработать полный каталог инструментов.

В строках используется базовый каталог Community Edition, если в колонке «Редакция» не указано иное. GITLAB_TIER определяет, какие действия доступны; более высокие редакции открывают больше инструментов и, следовательно, больше достижимых действий.

Compatibility

Протестировано с: VS Code + GitHub Copilot, Claude Desktop, Claude Code, Cursor, Windsurf, JetBrains IDEs, Zed, Kiro, Cline. См. полную Compatibility Matrix.

AI Model Tool-Use Evaluation

Проект включает автоматический оценщик качества MCP для моделей. Он выполняет проверки только по схемам каталога инструментов либо исполняет валидированные вызовы инструментов моделей через MCP против Docker GitLab CE или лицензированных инстансов Enterprise, наполненных фикстурами. Он определяет, выбирает ли каждая модель правильное действие, отправляет ли валидные параметры, восстанавливается ли после ошибок GitLab, на которые можно среагировать, и соблюдает ли защитные ограничения для деструктивных действий — на Anthropic, Google, OpenAI и Qwen.

Текущий опубликованный результат: Docker CE dynamic 20260627-232303.

Опубликованный набор модельных оценок охватывает 596 попыток выполнения задач и 2220 ожидаемых операций MCP. В выбранных отчётах модели совершили 2265 вызовов инструментов на 2265 модельных запросов, с совокупным финальным успехом 99.5%. Детальную текущую матрицу см. в AI Model Evaluation Results.

Текущий опубликованный результат: Docker Enterprise meta 20260527.

Опубликованный набор модельных оценок охватывает 92 попытки выполнения задач и 336 ожидаемых операций MCP. В выбранных отчётах модели совершили 345 вызовов инструментов на 350 модельных запросов, с совокупным финальным успехом 100.0%. Детальную текущую матрицу см. в AI Model Evaluation Results.

Текущий опубликованный результат: Docker Enterprise dynamic 20260628-015421.

Опубликованный набор модельных оценок охватывает 124 попытки выполнения задач и 808 ожидаемых операций MCP. В выбранных отчётах модели совершили 817 вызовов инструментов на 817 модельных запросов, с совокупным финальным успехом 100.0%. Детальную текущую матрицу см. в AI Model Evaluation Results.

Документация

Полная документация доступна по адресу jmrp.io/docs/gitlab-mcp-server. Используйте эту таблицу как основной справочник по конкретной области:

FAQ

Да. Установите GITLAB_URL в URL вашего экземпляра. Если GITLAB_URL не указан, режим stdio использует https://gitlab.com. Самоподписанные TLS-сертификаты поддерживаются через GITLAB_SKIP_TLS_VERIFY=true.

Когда вы запускаете его самостоятельно — локально через stdio или в собственной инфраструктуре через HTTP — все API-запросы идут напрямую в ваш экземпляр GitLab. Единственный запрос, который уходит куда-либо ещё, — это проверка обновлений на GitHub Releases; она включена по умолчанию и отключается с помощью AUTO_UPDATE=false.

Исключение — размещённая конечная точка: использование https://mcp.jmrp.io/gitlab означает, что ваш токен и каждый запрос проходят через эту машину. Там ничего не хранится, но это чужой сервер, поэтому раздел о размещённом сервере рекомендует продолжать использовать его локально.

О том, что именно отправляет проверка обновлений, см. PRIVACY.md, а о модели безопасности — SECURITY.md.

Да. Установите GITLAB_READ_ONLY=true, чтобы отключить все изменяющие инструменты (create, update, delete). Доступны будут только операции чтения.

Либо установите GITLAB_SAFE_MODE=true для режима пробного запуска (dry-run): изменяющие инструменты остаются видимыми, но вместо выполнения возвращают структурированное JSON-представление. Полезно для аудита, обучения или проверки того, что сделал бы ИИ-ассистент.

Обе редакции: Community Edition (CE) и Enterprise Edition (EE). Установите GITLAB_TIER=premium или GITLAB_TIER=ultimate в режиме stdio, чтобы включить дополнительные инструменты для функций Premium/Ultimate (метрики DORA, уязвимости, соответствие требованиям и т. д.); если параметр не задан, уровень определяется по лицензии экземпляра (запасной вариант — free). В режиме HTTP уровень можно принудительно задать через --tier, иначе он определяется по лицензии для каждой записи пула «токен+URL».

Сервер включает логику повторов с отсрочкой (backoff) при ограничениях частоты запросов GitLab API. Ошибки классифицируются как временные (повторяемые) или постоянные, с практическими подсказками в сообщениях об ошибках.

Любой MCP-совместимый клиент: VS Code + GitHub Copilot, Claude Desktop, Cursor, Claude Code, Windsurf, IDE от JetBrains, Zed, Kiro и другие. Встроенный мастер настройки может автоматически настроить большинство клиентов.

Сборка из исходного кода

git clone https://github.com/jmrplens/gitlab-mcp-server.git
cd gitlab-mcp-server
make build

Опубликованный образ контейнера — ghcr.io/jmrplens/gitlab-mcp-server:latest. О кроссплатформенной компиляции, Docker Compose и правилах внесения вклада см. Development Guide.

Политика конфиденциальности

Сервер полностью работает на вашей машине и не имеет ни собственной телеметрии, ни аналитики, ни серверной части — данные передаются только между вашим MCP-клиентом и настроенным экземпляром GitLab (плюс необязательная проверка обновлений подписанного бинарного файла на GitHub Releases). Ваш токен используется только для аутентификации запросов к GitLab и никогда не записывается в журналы. Подробнее: PRIVACY.md.

Вклад в проект и безопасность

• Вклад в проект: см. CONTRIBUTING.md — правила разработки, именование веток, соглашения о коммитах и процесс pull request.

• Безопасность: см. SECURITY.md — политика безопасности и порядок сообщения об уязвимостях.

• Кодекс поведения: см. CODE_OF_CONDUCT.md (Contributor Covenant v2.1).

Зеркало репозитория: GitHub — канонический репозиторий. Для удобства обнаружения доступно зеркало только для чтения на GitLab.com; пожалуйста, отправляйте вклады на GitHub.

Количество файлов

Функции

Соотношения, которые стоит отметить

Паттерны кода

Проект

Зал славы

А почему бы и нет

Поддерживается José M. Requena Plens · Страница проекта · Размещённый экземпляр: mcp.jmrp.io/gitlab