mcp-gitlab — MCP-сервер для Claude Code: функции и установка
Связывает ИИ-агента с GitLab: он может работать с проектами, merge request, пайплайнами и задачами. Режим только для чтения закрывает инструменты записи.
claude mcp add mcp-gitlab -e GITLAB_TOKEN=<GITLAB_TOKEN> -e GITLAB_URL=<GITLAB_URL> -e GITLAB_OAUTH_CLIENT_SECRET=<GITLAB_OAUTH_CLIENT_SECRET> -e GITLAB_OAUTH_JWT_KEY=<GITLAB_OAUTH_JWT_KEY> -e GITLAB_HTTP_BEARER_TOKEN=<GITLAB_HTTP_BEARER_TOKEN> -- uvx mcp-gitlabЧто делает mcp-gitlab
mcp-gitlab подключает агента к GitLab REST API. Через MCP-сервер можно управлять проектами, merge request, пайплайнами, CI/CD-переменными, согласованиями и issues, а также разбирать код на ревью. Он работает с GitLab.com и собственными инсталляциями GitLab CE/EE.
Сервер запускается через uvx mcp-gitlab; для подключения нужны uv, адрес GitLab в GITLAB_URL и токен в GITLAB_TOKEN. Поддерживаются также другие переменные токена и вход через mcp-gitlab auth login. Режим записи можно отключить переменной MCP_READ_ONLY=true: сервер не предложит агенту инструменты записи и промпты для рабочих процессов с записью. Если нужны изменения в GitLab, этот режим их заблокирует.
Какие задачи решает
- найти и просмотреть проекты GitLab
- проверить состояние merge request и согласований
- разобрать сбой пайплайна CI/CD
- работать с issues и переменными CI/CD
- проводить ревью кода через агента
Примеры запросов агенту
- Покажи проекты GitLab и найди нужный репозиторий.
- Проверь merge request и перечисли незакрытые замечания.
- Разбери последний сбой пайплайна и связанные issues.
Как установить mcp-gitlab
Командой платформы
claude mcp add mcp-gitlab -e GITLAB_TOKEN=<GITLAB_TOKEN> -e GITLAB_URL=<GITLAB_URL> -e GITLAB_OAUTH_CLIENT_SECRET=<GITLAB_OAUTH_CLIENT_SECRET> -e GITLAB_OAUTH_JWT_KEY=<GITLAB_OAUTH_JWT_KEY> -e GITLAB_HTTP_BEARER_TOKEN=<GITLAB_HTTP_BEARER_TOKEN> -- uvx mcp-gitlabВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-gitlab <команда>
Командой платформы
codex mcp add mcp-gitlab --env GITLAB_TOKEN=<GITLAB_TOKEN> --env GITLAB_URL=<GITLAB_URL> --env GITLAB_READ_ONLY=<GITLAB_READ_ONLY> --env MCP_READ_ONLY=<MCP_READ_ONLY> --env GITLAB_AUTH=<GITLAB_AUTH> -- uvx mcp-gitlabВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-gitlab <команда>
Файл настроек
{
"mcpServers": {
"mcp-gitlab": {
"command": "uvx",
"args": [
"mcp-gitlab"
],
"env": {
"GITLAB_TOKEN": "<GITLAB_TOKEN>",
"GITLAB_URL": "<GITLAB_URL>",
"GITLAB_READ_ONLY": "<GITLAB_READ_ONLY>",
"MCP_READ_ONLY": "<MCP_READ_ONLY>",
"GITLAB_AUTH": "<GITLAB_AUTH>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-gitlab <команда>
Файл настроек
{
"servers": {
"mcp-gitlab": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-gitlab"
],
"env": {
"GITLAB_TOKEN": "<GITLAB_TOKEN>",
"GITLAB_URL": "<GITLAB_URL>",
"GITLAB_READ_ONLY": "<GITLAB_READ_ONLY>",
"MCP_READ_ONLY": "<MCP_READ_ONLY>",
"GITLAB_AUTH": "<GITLAB_AUTH>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-gitlab <команда>
Командой платформы
gemini mcp add -e GITLAB_TOKEN=<GITLAB_TOKEN> -e GITLAB_URL=<GITLAB_URL> -e GITLAB_READ_ONLY=<GITLAB_READ_ONLY> -e MCP_READ_ONLY=<MCP_READ_ONLY> -e GITLAB_AUTH=<GITLAB_AUTH> mcp-gitlab uvx mcp-gitlabВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-gitlab <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-gitlab
Как установить mcp-gitlab в Claude Code?
Сначала установите uv, затем выполните `claude mcp add mcp-gitlab -e GITLAB_TOKEN=<GITLAB_TOKEN> -e GITLAB_URL=<GITLAB_URL> -e GITLAB_OAUTH_CLIENT_SECRET=<GITLAB_OAUTH_CLIENT_SECRET> -e GITLAB_OAUTH_JWT_KEY=<GITLAB_OAUTH_JWT_KEY> -e GITLAB_HTTP_BEARER_TOKEN=<GITLAB_HTTP_BEARER_TOKEN> -- uvx mcp-gitlab`. Заполните значения переменных данными своего GitLab.
Что делает mcp-gitlab?
Он подключает ИИ-агента к GitLab REST API для работы с проектами, merge request, пайплайнами, CI/CD и issues. Также сервер поддерживает задачи согласования и ревью кода.
Можно ли запретить агенту менять данные в GitLab?
Да. Переменная MCP_READ_ONLY=true включает режим только для чтения: инструменты записи и промпты для процессов с записью не предлагаются агенту.
