GitLab MCP Server (Yoda Digital)
GitLab MCP на 86 инструментов: задачи, запросы на слияние, пайплайны, вики и файлы, режим только для чтения, локальный и удаленный запуск
- 65 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Токен GitLab дает агенту доступ к репозиториям, веткам и пайплайнам в пределах прав токена, включая слияние и удаление
- Общее сетевое развертывание без OAuth-шлюза выставляет доступ к GitLab всем, кто достучится до сервера
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/gitlab-mcp-server-yoda-digitalОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Токен GitLab дает агенту доступ к репозиториям, веткам и пайплайнам в пределах прав токена, включая слияние и удаление
- Общее сетевое развертывание без OAuth-шлюза выставляет доступ к GitLab всем, кто достучится до сервера
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту работать с GitLab через REST API: типизированные инструменты с пагинацией и проверкой схемы. Работает с gitlab.com и с собственными инстансами GitLab. Это не обертка над «glab» и не парсинг страниц. Всего 86 инструментов. Они покрывают репозитории и файлы, ветки и теги, релизы, «issues» с обсуждениями, «merge request» с одобрениями, перебазированием и автослиянием, CI/CD с пайплайнами, задачами и окружениями, вики, группы с участниками, метки и этапы, защищенные ветки, историю коммитов и события проекта. Локально запуск идет по stdio командой npx, для общих развертываний есть SSE и Streamable HTTP, Docker-образ на ghcr.io и Helm-чарт. Флаг GITLAB_READ_ONLY_MODE=true убирает все изменяющие инструменты еще при регистрации, поэтому агент их не видит и вызвать не может.
Для кого. Для разработчиков и DevOps-инженеров, которые работают в Claude Code, Cursor или Zed и хотят вести GitLab-проекты, «merge request» и пайплайны через агента.
Подходит, если
- Нужен gitlab mcp для собственного инстанса GitLab: адрес API задается переменной GITLAB_API_URL
- Агент должен создать «issue», открыть «merge request», ответить в обсуждении или влить изменения
- Требуется запустить, повторить или отменить пайплайн и прочитать лог задачи прямо из чата
- Нужно поднять один общий сервер для команды за шлюзом с OAuth, а не раздавать токены
- Хочется безопасной демонстрации: режим только для чтения скрывает инструменты записи
Не подходит, если
- Ваш код живет на GitHub: для него есть отдельные серверы
- Нужен небольшой набор из нескольких команд: 86 инструментов раздувают список, которым пользуется агент
- Сетевое развертывание без шлюза с OAuth: режим PAT разрешен только на loopback, и сервер откажется стартовать
- Токен GitLab с широкими правами нельзя отдавать агенту, а режим только для чтения вам не подходит
Пример запроса к агенту
Покажи открытые «merge request» в проекте «backend», а для того, что с красным пайплайном, прочитай лог упавшей задачи и предложи исправление.MCP
- Транспорт
- stdio, sse, http
- Авторизация
- API-ключ
Переменные окружения
GITLAB_PERSONAL_ACCESS_TOKENобязательная, секрет- Токен доступа GitLab, обязателен в режиме PAT.
GITLAB_API_URL- Адрес API, по умолчанию https://gitlab.com/api/v4.
GITLAB_READ_ONLY_MODE- true скрывает все изменяющие инструменты.
AUTH_MODE- pat (только loopback) или oauth.
Ограничения
Для работы нужен токен доступа GitLab (переменная GITLAB_PERSONAL_ACCESS_TOKEN) или OAuth-токен, который передает шлюз. Режим PAT поддерживает только привязку к 127.0.0.1, а сетевое развертывание требует AUTH_MODE=oauth. В Helm-чарте режим PAT не поддерживается. Список CORS по умолчанию пустой: в OAuth-режиме это означает запрет. Docker-образ запускается без прав «root» и с отброшенными привилегиями. Лицензия MIT. Работа из России не проверялась: gitlab.com и собственные инстансы зависят от вашей сети.
Как отключить. Удалите запись gitlab из конфигурации клиента. Если сервер развернут в Docker или Helm, остановите контейнер или удалите релиз. Выданный GitLab токен отзовите в настройках профиля.
Частые вопросы
Как подключить GitLab MCP от Yoda Digital к Claude Code или Cursor?
Добавьте в конфигурацию сервер с командой npx -y @yoda.digital/gitlab-mcp-server и переменными GITLAB_PERSONAL_ACCESS_TOKEN и GITLAB_API_URL. Для собственного инстанса укажите его адрес вида https://gitlab.example.com/api/v4.
Сколько инструментов у этого gitlab mcp?
Восемьдесят шесть. Полный список лежит в файле CLAUDE.md репозитория, для части инструментов есть отдельные страницы в docs/api.
Как запретить агенту менять данные в GitLab?
Задайте GITLAB_READ_ONLY_MODE=true. Все изменяющие инструменты тогда не регистрируются, и агент их не видит.
Как развернуть один сервер для всей команды?
Запустите Docker-образ ghcr.io/yoda-digital/mcp-gitlab-server с AUTH_MODE=oauth и USE_STREAMABLE_HTTP=true. Перед ним нужен шлюз, который подставляет заголовок Authorization: Bearer для каждого подключения.
Чем он отличается от другого GitLab MCP в каталоге?
Это отдельный проект. У него режим только для чтения на уровне регистрации, три транспорта, режимы PAT и OAuth по подключению, Docker-образ и Helm-чарт для общего развертывания.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОфициальный MCP-сервер GitHub: код, issues, пул-реквесты, Actions и алерты безопасности прямо из агента
Buildkite MCP Server
buildkite-mcp-server
Официальный MCP-сервер Buildkite: пайплайны, сборки, джобы, логи и результаты тестов для агента
Защищенный MCP-рантайм, через который агент управляет локальными машинами, серверами и контейнерами
MCP для Jira, Confluence, Bitbucket и Jenkins
Sberworks MCP
Локальный stdio MCP-сервер для корпоративных Jira, Confluence, Bitbucket Server и Jenkins с mTLS и раздельным включением операций записи
Официальный MCP-сервер Netlify: агент создает проекты, собирает и деплоит сайты, управляет переменными окружения и формами
Официальный MCP-сервер Microsoft для Azure DevOps: задачи, репозитории, сборки, тест-планы и вики из агента
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| GitLab MCP Server (Yoda Digital) (эта запись) | нет | API-ключ | 65 | |
| GitLab MCP Server | нет | API-ключ | 2 061 | другой MCP-сервер для GitLab со своим набором инструментов и способами аутентификации |
| GitHub MCP Server | нет | ключ необязателен | 33 858 | официальный сервер для GitHub, а здесь работа с GitLab |
Коротко о README
Описание рассказывает, почему проект появился: команда Yoda Digital работает на собственном GitLab, а среди первых серверов MCP для него не нашлось. Код открыли в марте 2025 года, позже в него вошли Docker-образ и Helm-чарт от стороннего автора. Далее идут быстрый старт для локальных клиентов и для удаленного режима, перечень групп инструментов, таблица транспортов, два режима аутентификации и таблица переменных конфигурации.