GitLab

GitLab — MCP-сервер сообщества (автор — vish288). Сервер GitLab: проекты, merge request, пайплайны, CI/CD и задачи, с режимом только чтения. Ставится через uvx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
vish288
Лицензия
MIT
Транспорт
stdio, streamable_http, sse
Авторизация
token_env
ОС
Не указана
Языки
python

Уровень риска: high

Без ограничения даёт 57 пишущих инструментов с правами токена GitLab. Включайте `MCP_READ_ONLY=true` и сужайте набор через `MCP_TOOLSETS`.

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

codex
{
    "code": "codex mcp add gitlab --env MCP_READ_ONLY=true --env GITLAB_URL=https://gitlab.example.com --env GITLAB_TOKEN=glpat-xxxxxxxxxxxxxxxxxxxx -- uvx mcp-gitlab",
    "lang": "bash",
    "notes": "Дословно из README, вариант только для чтения",
    "verified": "docs"
}

Что умеет

mcp-gitlab (vish288/mcp-gitlab) — MCP-сервер для GitLab.com и собственных инсталляций GitLab (CE/EE). GitLab Duo или Premium не нужны. Сервер поддерживает спецификацию MCP 2026-07-28 и остаётся совместимым с клиентами версии 2025-11-25. Построен на FastMCP 4.x, httpx и Pydantic.

Инструменты разбиты на группы, которые можно включать по отдельности через MCP_TOOLSETS или --toolsets:

  • code — файлы, ветки, коммиты (12 инструментов);
  • review — merge request'ы, заметки, обсуждения, ревью (29);
  • ci — пайплайны, задачи, переменные CI/CD (18);
  • issues — задачи (5);
  • release — теги и релизы (9);
  • admin — проекты, группы, согласования (23).

Всего 91 инструмент, 57 из них пишущие. Кроме инструментов сервер отдаёт ресурсы и промпты. Транспорты — stdio (по умолчанию) и streamable-http (рекомендуется для удалённого запуска), есть режим OAuth 2.1 для командных развёртываний.

Кому подойдёт

  • Разработчикам на GitLab: ревью merge request'ов, работа с ветками и коммитами из чата с ассистентом.
  • DevOps-инженерам: пайплайны, задачи CI и переменные CI/CD.
  • Командам с собственным GitLab: общий сервер по streamable HTTP с OAuth.

Похожие серверы — в категории разработка.

Установка

Нужен менеджер uv. Сервер запускается одной командой, с записью или в режиме только для чтения:

uvx mcp-gitlab
MCP_READ_ONLY=true uvx mcp-gitlab

Обязательная переменная — GITLAB_URL (адрес инсталляции), токен передаётся в GITLAB_TOKEN либо через вход mcp-gitlab auth login. Для Claude Code есть плагин, который запрашивает адрес и токен и хранит токен в хранилище учётных данных, а не в конфиге. Набор инструментов можно сузить, например MCP_TOOLSETS=review uvx mcp-gitlab для ревью MR.

Подключение к клиентам

Команды и конфиг приведены дословно из README (вариант только для чтения). Замените адрес и токен на свои, а чтобы разрешить запись, уберите MCP_READ_ONLY. Общий порядок — в инструкции как подключить MCP.

claude mcp add gitlab -e MCP_READ_ONLY=true -e GITLAB_URL=https://gitlab.example.com -e GITLAB_TOKEN=glpat-xxxxxxxxxxxxxxxxxxxx -- uvx mcp-gitlab

Проверка

Попросите ассистента показать сведения о проекте — он вызовет gitlab_get_project. Ошибка 401 означает неверный токен или адрес GITLAB_URL.

Примеры задач

Покажи открытые merge request'ы в проекте group/app, где я ревьюер.
Почему упал последний пайплайн в ветке main? Покажи упавшую задачу.

Риски

Без ограничения сервер даёт агенту 57 пишущих инструментов с правами вашего токена: изменение файлов и веток, слияние MR, управление переменными CI/CD, проектами и группами. Ошибочное действие затронет общий репозиторий и пайплайны.

Как снизить риски: включите MCP_READ_ONLY=true — тогда пишущие инструменты и промпты не показываются клиенту. Для общего сервера задавайте этот флаг в окружении развёртывания, а не в конфиге клиента. Сужайте набор инструментов через MCP_TOOLSETS, выдавайте токен с минимальными правами. HTTP-транспорт на внешнем адресе требует GITLAB_HTTP_BEARER_TOKEN. Лицензия — MIT.

Частые вопросы

Работает ли с собственным GitLab?

Да, поддерживаются GitLab.com и собственные инсталляции CE/EE. Укажите адрес в GITLAB_URL.

Как запретить агенту изменения?

Задайте MCP_READ_ONLY=true (или GITLAB_READ_ONLY). Пишущие инструменты исчезнут из списка.

Нужна ли подписка GitLab Premium?

Нет, Duo и Premium не требуются.

Основы протокола — на странице что такое MCP-сервер.

Похожие 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

Источники