GitLab MCP Server
GitLab MCP Server — MCP-сервер сообщества (автор — zereight). Сервер для GitLab: проекты, merge request, задачи, пайплайны, вики и релизы. Ставится через npx. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- zereight
- Лицензия
- MIT
- Транспорт
- stdio, streamable_http
- Авторизация
- token_env
- ОС
- Не указана
- Языки
- typescript
Уровень риска: high
Действует с правами токена GitLab; по умолчанию режим `full` с изменением и удалением. Используйте `--permission-mode readonly` и токен с минимальными правами, не включайте набор `api`.
Настройка клиентов
{
"code": "codex mcp add gitlab --env GITLAB_PERSONAL_ACCESS_TOKEN=\"$GITLAB_PERSONAL_ACCESS_TOKEN\" --env GITLAB_API_URL=https://gitlab.com/api/v4 -- zereight-mcp-gitlab",
"lang": "bash",
"notes": "Дословно из README",
"verified": "docs"
}
Что умеет
GitLab MCP Server (zereight/gitlab-mcp) подключает ИИ-ассистента к GitLab: проекты, merge request'ы, задачи, пайплайны, вики и другие разделы. Работает с gitlab.com и с собственными инсталляциями GitLab через адрес API.
- Merge request'ы: список изменённых файлов (
list_merge_request_changed_files) и пакетное получение диффов (get_merge_request_file_diff) вместо ручной вставки ссылок и диффов в чат. - Пайплайны: вывод логов задач с постраничной выборкой (
get_pipeline_job_output) без поиска в веб-интерфейсе. - Наборы инструментов: по умолчанию включено 40 инструментов (38 из набора
coreплюсdiscover_toolsиhelp), всего их 288.discover_toolsвключает нужную категорию на время сессии, отдельные инструменты добавляются через--tools. - Режимы доступа:
--permission-modeсо значениямиreadonly,modify(без удаления) иfull(по умолчанию). - Дополнительно: маскирование текста в ответах, сжатие длинных ответов, журнал аудита вызовов в формате NDJSON, загрузка вложений и артефактов в отдельную папку.
Есть и путь без MCP: навык для агента и консольная утилита zereight-mcp-gitlab с теми же сценариями.
Кому подойдёт
- Разработчикам на GitLab: ревью merge request'ов, разбор упавших пайплайнов и работа с задачами из IDE.
- Тимлидам: обзор открытых MR и задач по проекту.
- Командам с собственным GitLab: общий сервер по Streamable HTTP с авторизацией пользователей.
Похожие серверы — в категории разработка.
Установка
Сначала установите бинарник zereight-mcp-gitlab:
npm install -g @zereight/mcp-gitlabТакже доступна установка через Homebrew и запуск одной командой npx -y @zereight/mcp-gitlab@latest. Для доступа нужен персональный токен GitLab. README рекомендует вводить его без отображения на экране:
read -rs GITLAB_PERSONAL_ACCESS_TOKEN && export GITLAB_PERSONAL_ACCESS_TOKENВместо токена можно включить OAuth (GITLAB_USE_OAUTH=true). Для своей инсталляции замените GITLAB_API_URL на адрес её API. Не задавайте GITLAB_TOOLSETS=all: это загрузит почти все схемы инструментов и сильно увеличит контекст.
Подключение к клиентам
Команды приведены дословно из README. Для Cursor и VS Code в репозитории есть отдельные инструкции. Общий порядок — в инструкции как подключить MCP.
claude mcp add gitlab --transport stdio --scope local --env GITLAB_PERSONAL_ACCESS_TOKEN="$GITLAB_PERSONAL_ACCESS_TOKEN" --env GITLAB_API_URL=https://gitlab.com/api/v4 -- zereight-mcp-gitlabПроверка
Попросите ассистента показать открытые merge request'ы в нужном проекте. Проект можно указывать как group%2Fproject. Если приходит ошибка 401, проверьте токен и адрес API.
Примеры задач
Покажи изменённые файлы в MR 123 проекта group/project и кратко опиши правки.Почему упал последний пайплайн? Покажи лог упавшей задачи.Риски
Сервер действует с правами вашего токена GitLab. В режиме full по умолчанию доступны инструменты изменения и удаления: агент может закрывать задачи, сливать merge request'ы, удалять ресурсы. Набор api даёт произвольные запросы к API GitLab в обход ограничений отдельных инструментов, README прямо предупреждает об этом риске.
Как снизить риски: используйте --permission-mode readonly или modify, выдавайте токен с минимальными правами, не включайте набор api без необходимости. Включите маскирование и журнал аудита для командной установки. Лицензия — MIT.
Частые вопросы
Работает ли с собственным GitLab?
Да. Укажите адрес API своей инсталляции в GITLAB_API_URL.
Почему видно только 40 инструментов?
Так задумано, чтобы не перегружать контекст модели. Остальные включаются через discover_tools или --toolsets.
Как запретить агенту изменения?
Запустите с --permission-mode readonly. Режим modify разрешает изменения, но без удаления.
Основы протокола — на странице что такое MCP-сервер.
Инструменты
- list_merge_request_changed_files
- get_merge_request_file_diff
- get_pipeline_job_output
- list_issues
- discover_tools
Похожие MCP-серверы
GitHub MCP Server
Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.
Git
Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.
GitDiagram
Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.
git-mcp
Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.