GitLab MCP Server

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

Это MCP-сервер, встроенный в сам GitLab: отдельно ничего ставить не нужно, клиент подключается по адресу /api/v4/mcp вашего экземпляра GitLab (на GitLab.com это gitlab.com). Он выпускается вендором и в документации помечен как общедоступный. Агент получает данные о проектах, задачах и merge request, а также может действовать от вашего имени.

По списку инструментов из документации агент ищет в GitLab (search, semantic_search), читает проект, коммиты, ветки, теги, дерево репозитория и файлы, смотрит merge request вместе с диффами, конфликтами, коммитами и пайплайнами. Он может создавать и обновлять merge request (save_merge_request), оставлять заметки и ревью, делать коммит с несколькими файловыми действиями за один вызов (add_commit), вести рабочие элементы (save_work_item), запускать и разбирать пайплайны и задания, а ещё читать вики и уязвимости.

Когда использовать

Подключайте сервер, если команда живёт в GitLab и хочет задавать вопросы обычным языком: что сломало пайплайн, какие merge request ждут ревью, что изменилось между ветками, какие уязвимости открыты. Он же подходит для рутины: оформить merge request, закрыть задачу, добавить заметку.

Группы инструментов (toolsets) включаются заголовком запроса. По умолчанию доступны core, merge_requests, work_items, repository и ci, а wikis, code_security и orbit включаются явно.

Ограничения и безопасность

Админ должен разрешить доступ к серверу: для группы верхнего уровня на GitLab.com или для всего экземпляра в GitLab Self-Managed и Dedicated. Сервер принимает токен OAuth с областью mcp (клиенты получают его при подключении через динамическую регистрацию или заранее созданное приложение) и персональный токен с тонкой настройкой прав. Старые персональные токены, токены проектов и групп он отклоняет с ошибкой 403, потому что к ним нельзя добавить область mcp.

Агент видит и меняет только то, что разрешено вашей учётной записи, но документация прямо предупреждает: защита от внедрения инструкций (prompt injection) лежит на вас. Используйте инструменты только на объектах GitLab, которым доверяете. На GitLab.com действует лимит запросов к серверу: 60 в минуту на пользователя на тарифе Free и 600 на Premium и Ultimate, он общий для всех клиентов пользователя.

Часть инструментов зависит от тарифа и лицензии. Например, code_security показываются только при доступных функциях Ultimate, а duo_agent_platform только при доступности GitLab Duo Agent Platform.

Во всех примерах замените <gitlab.example.com> на адрес вашего экземпляра GitLab (для GitLab.com: gitlab.com). Перед подключением администратор должен разрешить доступ к MCP-серверу. При первом подключении откроется страница авторизации OAuth в браузере.

Транспорт HTTP (рекомендуется)

{
  "mcpServers": {
    "GitLab": {
      "type": "http",
      "url": "https://<gitlab.example.com>/api/v4/mcp"
    }
  }
}

Префикс имён инструментов задаёт заголовок X-Gitlab-Mcp-Server-Tool-Name-Prefix, он помогает избежать конфликтов имён с другими серверами:

{
  "mcpServers": {
    "GitLab": {
      "type": "http",
      "url": "https://<gitlab.example.com>/api/v4/mcp",
      "headers": {
        "X-Gitlab-Mcp-Server-Tool-Name-Prefix": "gitlab_"
      }
    }
  }
}

Ограничить набор инструментов можно заголовком X-Gitlab-Enabled-Mcp-Server-Toolsets (список групп через запятую):

{
  "mcpServers": {
    "GitLab": {
      "type": "http",
      "url": "https://<gitlab.example.com>/api/v4/mcp",
      "headers": {
        "X-Gitlab-Enabled-Mcp-Server-Toolsets": "core,work_items"
      }
    }
  }
}

Cursor

В Cursor откройте Settings > Cursor Settings > Tools & MCP, под Installed MCP Servers выберите New MCP Server и добавьте в открывшийся mcp.json тот же блок, что и для HTTP-транспорта выше:

{
  "mcpServers": {
    "GitLab": {
      "type": "http",
      "url": "https://<gitlab.example.com>/api/v4/mcp"
    }
  }
}

Claude Code

Команда выполняется в терминале. Флаг -s user делает сервер доступным во всех проектах:

claude mcp add -s user --transport http GitLab https://<gitlab.example.com>/api/v4/mcp

Затем запустите Claude Code, введите /mcp, выберите сервер GitLab и подтвердите запрос авторизации в браузере. Чтобы ограничить набор инструментов, добавьте заголовок:

claude mcp add -s user --transport http GitLab https://<gitlab.example.com>/api/v4/mcp \
 --header "X-Gitlab-Enabled-Mcp-Server-Toolsets: core,work_items"

Claude Desktop

Нужен Node.js 20 или новее, доступный в PATH. Откройте Settings > Developer > Edit Config и добавьте запись в claude_desktop_config.json, затем перезапустите Claude Desktop:

{
  "mcpServers": {
    "GitLab": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://<gitlab.example.com>/api/v4/mcp"
      ]
    }
  }
}

OpenAI Codex

codex mcp add GitLab --url "https://<gitlab.example.com>/api/v4/mcp"

В ~/.codex/config.toml включите флаг функции и добавьте сервер:

[features]
"rmcp_client" = true

[mcp_servers.GitLab]
url = "https://<gitlab.example.com>/api/v4/mcp"

Затем выполните вход:

codex mcp login GitLab

Для Gemini Code Assist и Gemini CLI, GitHub Copilot в VS Code, Kiro, OpenCode, Zed и Amazon Q Developer в документации GitLab есть отдельные разделы.