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`.

Настройка клиентов

codex
{
    "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 для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники