GitLab MCP Server — MCP-сервер для Claude Code: что делает
Подключает GitLab к агенту: проекты, merge requests, issues, пайплайны, wiki и релизы доступны прямо в чате.
claude mcp add --env GITLAB_PERSONAL_ACCESS_TOKEN=<GITLAB_PERSONAL_ACCESS_TOKEN> --env GITLAB_PERSONAL_ACCESS_TOKEN_FILE=<GITLAB_PERSONAL_ACCESS_TOKEN_FILE> --env GITLAB_JOB_TOKEN=<GITLAB_JOB_TOKEN> --env GITLAB_AUTH_COOKIE_PATH=<GITLAB_AUTH_COOKIE_PATH> --env GITLAB_USE_OAUTH=<GITLAB_USE_OAUTH> --transport stdio gitlab-mcp-server -- npx -y @zereight/mcp-gitlabЧто делает GitLab MCP Server
Сервер даёт агенту инструменты для работы с GitLab через API. По умолчанию включены 40 инструментов: 38 базовых плюс discover_tools и help. Всего в наборах 278, и лишние можно подтянуть вызовом discover_tools — набор api лучше не включать, пока не готовы принять риск обхода ограничений.
Ставится бинарник zereight-mcp-gitlab: npm install -g @zereight/mcp-gitlab, Homebrew или разовый запуск через npx -y @zereight/mcp-gitlab@latest. Дальше регистрируете сервер в клиенте — для Claude это claude mcp add, для Codex codex mcp add, для Cursor и Copilot правится JSON конфига. Нужен токен: локально проще всего GITLAB_PERSONAL_ACCESS_TOKEN, можно читать его из файла через GITLAB_PERSONAL_ACCESS_TOKEN_FILE или включить OAuth.
Пути к проектам задаются как project_id=group%2Fproject, вложенные группы разделяются %2F на каждом сегменте, merge request — merge_request_iid=123. Есть и путь без MCP: скилл плюс CLI, где ответы приходят целиком, без сжатия. Разрушительные инструменты требуют флага --yes.
Какие задачи решает
- посмотреть изменённые файлы merge request и их диффы
- вытащить лог упавшего job из пайплайна
- создать issue или обновить wiki из чата
- проверить релизы проекта, не открывая браузер
- найти проект по вложенному пути группы
Примеры запросов агенту
- Покажи изменённые файлы в merge request !123 проекта group%2Fproject
- Достань лог последнего упавшего job в пайплайне
- Создай issue в проекте group%2Fsubgroup%2Fproject с описанием бага
Как установить GitLab MCP Server
Командой платформы
claude mcp add --env GITLAB_PERSONAL_ACCESS_TOKEN=<GITLAB_PERSONAL_ACCESS_TOKEN> --env GITLAB_PERSONAL_ACCESS_TOKEN_FILE=<GITLAB_PERSONAL_ACCESS_TOKEN_FILE> --env GITLAB_JOB_TOKEN=<GITLAB_JOB_TOKEN> --env GITLAB_AUTH_COOKIE_PATH=<GITLAB_AUTH_COOKIE_PATH> --env GITLAB_USE_OAUTH=<GITLAB_USE_OAUTH> --transport stdio gitlab-mcp-server -- npx -y @zereight/mcp-gitlabВместо <…> подставьте свои значения. Ещё 16 переменных окружения — в README сервера
Командой платформы
codex mcp add gitlab-mcp-server --env GITLAB_PERSONAL_ACCESS_TOKEN=<GITLAB_PERSONAL_ACCESS_TOKEN> --env GITLAB_PERSONAL_ACCESS_TOKEN_FILE=<GITLAB_PERSONAL_ACCESS_TOKEN_FILE> --env GITLAB_JOB_TOKEN=<GITLAB_JOB_TOKEN> --env GITLAB_AUTH_COOKIE_PATH=<GITLAB_AUTH_COOKIE_PATH> --env GITLAB_USE_OAUTH=<GITLAB_USE_OAUTH> -- npx -y @zereight/mcp-gitlabВместо <…> подставьте свои значения. Ещё 16 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"gitlab-mcp-server": {
"command": "npx",
"args": [
"-y",
"@zereight/mcp-gitlab"
],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "<GITLAB_PERSONAL_ACCESS_TOKEN>",
"GITLAB_PERSONAL_ACCESS_TOKEN_FILE": "<GITLAB_PERSONAL_ACCESS_TOKEN_FILE>",
"GITLAB_JOB_TOKEN": "<GITLAB_JOB_TOKEN>",
"GITLAB_AUTH_COOKIE_PATH": "<GITLAB_AUTH_COOKIE_PATH>",
"GITLAB_USE_OAUTH": "<GITLAB_USE_OAUTH>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 16 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"gitlab-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@zereight/mcp-gitlab"
],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "<GITLAB_PERSONAL_ACCESS_TOKEN>",
"GITLAB_PERSONAL_ACCESS_TOKEN_FILE": "<GITLAB_PERSONAL_ACCESS_TOKEN_FILE>",
"GITLAB_JOB_TOKEN": "<GITLAB_JOB_TOKEN>",
"GITLAB_AUTH_COOKIE_PATH": "<GITLAB_AUTH_COOKIE_PATH>",
"GITLAB_USE_OAUTH": "<GITLAB_USE_OAUTH>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 16 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e GITLAB_PERSONAL_ACCESS_TOKEN=<GITLAB_PERSONAL_ACCESS_TOKEN> -e GITLAB_PERSONAL_ACCESS_TOKEN_FILE=<GITLAB_PERSONAL_ACCESS_TOKEN_FILE> -e GITLAB_JOB_TOKEN=<GITLAB_JOB_TOKEN> -e GITLAB_AUTH_COOKIE_PATH=<GITLAB_AUTH_COOKIE_PATH> -e GITLAB_USE_OAUTH=<GITLAB_USE_OAUTH> gitlab-mcp-server npx -y @zereight/mcp-gitlabВместо <…> подставьте свои значения. Ещё 16 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о GitLab MCP Server
Как установить GitLab MCP Server в Claude?
Сначала поставьте бинарник: npm install -g @zereight/mcp-gitlab. Затем зарегистрируйте сервер командой `claude mcp add gitlab-mcp -e GITLAB_PERSONAL_ACCESS_TOKEN=<GITLAB_PERSONAL_ACCESS_TOKEN> -e GITLAB_JOB_TOKEN=<GITLAB_JOB_TOKEN> -- npx -y @zereight/mcp-gitlab`.
Что делает GitLab MCP Server?
Даёт агенту инструменты GitLab: проекты, merge requests, issues, пайплайны, wiki и релизы. Агент вызывает их в чате вместо того, чтобы вы копировали ссылки и диффы вручную.
Можно ли работать с GitLab без MCP?
Да, есть отдельный путь: скилл gitlab-mcp-skill и CLI zereight-mcp-gitlab. Терминал отдаёт полные ответы, сжатие к нему не применяется.
