GitLab·GitLab

GitLab MCP — подключение и инструкция

Официальный GitLab MCP подключает агента к проектам, merge requests, issues и разрешённым операциям GitLab instance.

РазработкаУдалённоАвторизация

Что умеет этот сервер

01

Официальный GitLab MCP подключает агента к проектам, merge requests, issues и разрешённым операциям GitLab instance.

02

Native сервер отличается от community zereight и jmrplens.

03

Прочитай один тестовый MR, diff и CI.

Задача для знакомства

Через официальный GitLab MCP прочитай diff тестового MR и CI. Merge, approve и комментарии не отправляй.

Уточнить результат

Сверь host, project и scopes. Некоторые Duo/security tools появляются только при доступных лицензиях и правах, даже если запросить all.

Как подключить

Выберите подходящий способ

Подключить GitLab MCP

Разреши MCP на уровне instance или top-level group по документации. Добавь HTTP https://<gitlab-host>/api/v4/mcp и пройди OAuth. Для ограничения каталога задай X-Gitlab-Enabled-Mcp-Server-Toolsets.

Что понадобится

  • GitLab instance с включённым MCP и пользователь с нужными разрешениями. Для OAuth-клиента нужна поддержка Dynamic Client Registration.
  1. 01

    Подготовь окружение

    GitLab instance с включённым MCP и пользователь с нужными разрешениями. Для OAuth-клиента нужна поддержка Dynamic Client Registration.

  2. 02

    Установи и настрой

    Разреши MCP на уровне instance или top-level group по документации. Добавь HTTP https://<gitlab-host>/api/v4/mcp и пройди OAuth. Для ограничения каталога задай X-Gitlab-Enabled-Mcp-Server-Toolsets.

  3. 03

    Открой новую сессию

    Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.

Первый запрос — пример для чата агента

Через официальный GitLab MCP прочитай diff тестового MR и CI. Merge, approve и комментарии не отправляй.

Как проверить

Сверь host, project и scopes. Некоторые Duo/security tools появляются только при доступных лицензиях и правах, даже если запросить all.

Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.

Документация подключения

Что умеет GitLab

Официальный GitLab MCP подключает агента к проектам, merge requests, issues и разрешённым операциям GitLab instance.

Native сервер отличается от community zereight и jmrplens. Доступность определяется версией GitLab, instance/group settings и разрешёнными toolsets.

Что подготовить перед подключением

GitLab instance с включённым MCP и пользователь с нужными разрешениями. Для OAuth-клиента нужна поддержка Dynamic Client Registration.

Как установить и подключить

Разреши MCP на уровне instance или top-level group по документации. Добавь HTTP https://<gitlab-host>/api/v4/mcp и пройди OAuth. Для ограничения каталога задай X-Gitlab-Enabled-Mcp-Server-Toolsets.

Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.

Как пользоваться: первый сценарий

Прочитай один тестовый MR, diff и CI. Уточни project и commit SHA, затем подготовь review без автоматического approve/merge.

Как проверить результат и решить проблемы

Сверь host, project и scopes. Некоторые Duo/security tools появляются только при доступных лицензиях и правах, даже если запросить all.

Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.

Ограничения

MCP не обходит protected branches и роли GitLab. Старые версии сервера могут не поддерживать новые toolsets и способы auth.

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

Источник: GitLab — документация MCP. Здесь опубликованы актуальные способы подключения и требования сервиса.

Другие подключения — в каталоге MCP-серверов Нейролюба.

Вопросы о GitLab

Официальный GitLab MCP подключает агента к проектам, merge requests, issues и разрешённым операциям GitLab instance.
Вернуться в библиотеку