GitLab MCP Server
MCP-сервер для GitLab и self-hosted инстансов: проекты, merge requests, issues, пайплайны, вики и релизы
Установка
npm install -g @zereight/mcp-gitlabИли brew install zereight/gitlab-mcp/zereight-mcp-gitlab после brew tap.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает агента к GitLab через API и дает сотни мелких инструментов для проектов, merge requests, issues, пайплайнов, вики, тегов, релизов и вех. Для ревью MR есть двухшаговый сценарий: сначала список измененных файлов, затем диффы пачками. Набор инструментов можно сузить группами, списком или регулярным выражением, а режимы readonly и modify закрывают запись или удаление. В репозитории лежит скилл с подсказками по рабочим сценариям.
Для кого. Для команд на GitLab.com или собственном GitLab, которые хотят вести MR, задачи и CI через агента.
Подходит, если
- Нужно провести ревью merge request с разбором диффа
- Нужно разобраться, почему упал пайплайн
- Нужно создавать и обновлять issues на корпоративном GitLab
Не подходит, если
- Код хранится на GitHub или другой платформе
- Политика компании запрещает выдавать токены сторонним инструментам
Пример запроса к агенту
Сделай ревью MR !42 в проекте backend/api и оставь замечания по измененным файламОграничения
Нужен Personal Access Token или OAuth-приложение GitLab. По умолчанию режим full, включая удаление, поэтому стоит выставить GITLAB_PERMISSION_MODE=readonly или modify. GITLAB_API_URL должен указывать на /api/v4, а не на корень сайта. Доступ к GitLab.com из России может быть нестабильным, с собственным инстансом ограничений нет. Проект не официальный от GitLab.
Как отключить. Выполните claude mcp remove gitlab или удалите блок gitlab из конфигурации MCP. Отзовите токен в настройках GitLab.
MCP
- Транспорт
- stdio, sse, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| GITLAB_PERSONAL_ACCESS_TOKEN обязательная, секрет | Personal Access Token GitLab, если не используется OAuth. |
| GITLAB_API_URL | Адрес API, например https://gitlab.com/api/v4. |
| GITLAB_PERMISSION_MODE | readonly, modify или full (по умолчанию). |
| GITLAB_USE_OAUTH | Включает локальный OAuth через браузер вместо токена. |
Проверка безопасности
- Пишет в репозитории, MR и issues и в режиме full может удалять данные
- Работает с токеном доступа GitLab
Коротко о README
README описывает четыре способа авторизации: PAT, локальный OAuth через браузер, OAuth-прокси для удаленных клиентов и авторизацию на каждый запрос. Сервер ставится через Homebrew, npm или Nix и запускается в режимах stdio, SSE и Streamable HTTP, в том числе из Docker-образа. Есть отдельные гайды для Claude Code, VS Code, Copilot, Codex и Cursor, фильтры инструментов и переменные окружения описаны на сайте документации. Лицензия MIT.
Частые вопросы
Работает ли с собственным GitLab?
Да, укажите адрес своего инстанса в GITLAB_API_URL с суффиксом /api/v4.
Как запретить удаление?
GITLAB_PERMISSION_MODE=modify оставляет создание и изменение, но убирает все инструменты удаления. readonly закрывает запись полностью.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything
Актуальная документация и примеры кода нужной версии библиотеки прямо в контексте агента, через MCP или CLI со скиллом