Advanced GitLab MCP server — MCP-сервер для Claude Code
Связывает ИИ-агента с 234 операциями GitLab через 64 CQRS-инструмента. Подходит для работы с пайплайнами, репозиториями и merge request прямо из терминала или IDE.
claude mcp add --env GITLAB_TOKEN=<GITLAB_TOKEN> --env GITLAB_API_URL=<GITLAB_API_URL> --env GITLAB_READ_ONLY_MODE=<GITLAB_READ_ONLY_MODE> --transport stdio advanced-gitlab-mcp-server -- npx -y @structured-world/gitlab-mcpЧто делает Advanced GitLab MCP server
Сервер делит команды на две группы по паттерну CQRS. Запросы на чтение начинаются с префикса browse_, а действия на изменение ресурсов — с manage_. Схема доступных инструментов формируется динамически: сервер сверяет версию вашего GitLab, уровень подписки и права токена, скрывая неподдерживаемые вызовы.
Внутри предусмотрена защита от сбоев сети. Если инстанс GitLab недоступен, сервер переходит в режим изоляции с базовым инструментом manage_context для проверки связи и не блокирует запуск среды. Поддерживаются подключения к нескольким аккаунтам одновременно, включая связку корпоративного сервера и облачного gitlab.com.
Для запуска нужен Node.js от 24 версии.
Какие задачи решает
- просмотреть логи упавшего шага в пайплайне
- создать или обновить merge request без открытия браузера
- перезапустить упавший пайплайн в GitLab CI
- управлять переменными окружения и ключами деплоя
Примеры запросов агенту
- Покажи последние упавшие задачи в пайплайне ветки
main - Перезапусти пайплайн для последнего коммита в проекте
- Создай merge request из ветки
feature/authвmainс кратким описанием изменений
Как установить Advanced GitLab MCP server
Командой платформы
claude mcp add --env GITLAB_TOKEN=<GITLAB_TOKEN> --env GITLAB_API_URL=<GITLAB_API_URL> --env GITLAB_READ_ONLY_MODE=<GITLAB_READ_ONLY_MODE> --transport stdio advanced-gitlab-mcp-server -- npx -y @structured-world/gitlab-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add advanced-gitlab-mcp-server --env GITLAB_TOKEN=<GITLAB_TOKEN> --env GITLAB_API_URL=<GITLAB_API_URL> --env GITLAB_READ_ONLY_MODE=<GITLAB_READ_ONLY_MODE> -- npx -y @structured-world/gitlab-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"advanced-gitlab-mcp-server": {
"command": "npx",
"args": [
"-y",
"@structured-world/gitlab-mcp"
],
"env": {
"GITLAB_TOKEN": "<GITLAB_TOKEN>",
"GITLAB_API_URL": "<GITLAB_API_URL>",
"GITLAB_READ_ONLY_MODE": "<GITLAB_READ_ONLY_MODE>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"advanced-gitlab-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@structured-world/gitlab-mcp"
],
"env": {
"GITLAB_TOKEN": "<GITLAB_TOKEN>",
"GITLAB_API_URL": "<GITLAB_API_URL>",
"GITLAB_READ_ONLY_MODE": "<GITLAB_READ_ONLY_MODE>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e GITLAB_TOKEN=<GITLAB_TOKEN> -e GITLAB_API_URL=<GITLAB_API_URL> -e GITLAB_READ_ONLY_MODE=<GITLAB_READ_ONLY_MODE> advanced-gitlab-mcp-server npx -y @structured-world/gitlab-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Advanced GitLab MCP server
Как установить Advanced GitLab MCP server в Claude Code?
Выполните в терминале команду claude mcp add gitlab-mcp -e GITLAB_TOKEN=<GITLAB_TOKEN> -- npx -y @structured-world/gitlab-mcp. Вместо <GITLAB_TOKEN> укажите ваш личный токен доступа GitLab.
Что делает этот MCP-сервер?
Он даёт ассистенту доступ к 26 типам сущностей GitLab, объединяя 234 операции в 64 инструмента для чтения и изменения данных.
Какие системные требования нужны для работы?
Потребуется установленный Node.js версии 24 или выше. Также нужен токен GitLab с правами доступа к целевым репозиториям и API.
