MCP для GitHub + GitLab: инженерный гайд 2026

• repo - если нужны приватные репозитории;
  
• public_repo - если только публичные;
  
• read:org - если надо видеть org/team metadata;
  
• workflow - только если MCP должен работать с GitHub Actions.

• read_api
  
• read_repository

• api
  
• write_repository
  

Пробегись по моей системе и найди все установленные AI coding tools и IDE, которые поддерживают MCP: Claude Code, Claude Desktop, Cursor, Gemini CLI, Antigravity, Antigravity IDE, Codex CLI, Codex App, Cline, Roo Code, Continue, Windsurf, VS Code extensions и похожие инструменты.
Цель: настроить единый MCP-доступ к GitHub и GitLab так, чтобы все эти инструменты использовали один и тот же локально установленный MCP-сервер, а не тянули разные версии через npx.
Сначала найди реальные MCP-конфиги каждого инструмента и прочитай их формат. Не угадывай пути и не ломай существующие настройки. Проверь стандартные места:
- ~/.claude.json
- ~/.cursor/mcp.json
- ~/.gemini/settings.json
- ~/.gemini/config/mcp_config.json
- ~/.codex/config.toml
- Claude Desktop:
  - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  - Windows: %APPDATA%\Claude\claude_desktop_config.json
  - Windows MSIX/package: AppData\Local\Packages\Claude_*\LocalCache\Roaming\Claude\claude_desktop_config.json
- Codex App / package-local configs
- Cline / Roo Code / Continue / Windsurf / VS Code extension configs
Если один конфиг является symlink — не ломай symlink, меняй реальный target-файл.
Для GitLab self-hosted используй @zereight/mcp-gitlab. Если найдёшь @modelcontextprotocol/server-gitlab или npx -y @modelcontextprotocol/server-gitlab — замени: этот вариант часто ломается на schema/inputSchema validation.
Установи или проверь пакет:
npm install -g @zereight/mcp-gitlab
Найди реальный global npm path через:
npm root -g
И пропиши абсолютный путь к:
@zereight/mcp-gitlab/build/index.js
Базовая схема GitLab:
command: node
args: [абсолютный путь к @zereight/mcp-gitlab/build/index.js]
env:
  GITLAB_PERSONAL_ACCESS_TOKEN: <мой PAT>
  GITLAB_API_URL: https://<мой-gitlab-host>/api/v4
Важно: GITLAB_API_URL обязательно должен заканчиваться на /api/v4. Не используй официальный GitLab HTTP MCP /api/v4/mcp, если на self-hosted GitLab он не включён админами.
Для GitHub используй официальный github/github-mcp-server, а не старый @modelcontextprotocol/server-github.
Проверь официальный репозиторий:
https://github.com/github/github-mcp-server
Если GitHub MCP ещё не установлен, предложи лучший вариант установки для моей системы: локальный бинарь, Docker или другой официальный recommended-вариант.
Для GitHub настрой ограниченный набор toolsets, не включай всё подряд. Базовый набор:
context,repos,issues,pull_requests
По умолчанию включи read-only режим, если мне явно не нужны write-операции.
Для каждого найденного клиента запиши MCP в его родном формате:
- JSON для Claude Desktop / Cursor / Gemini
- TOML для Codex
- специальный формат для Antigravity, если он использует $typeName
- формат расширения, если это VS Code / Cline / Roo / Continue / Windsurf
Не коммить токены в проектные репозитории. Если конфиг проектный — предупреди меня. Если возможно — используй user-level config.
После настройки проверь:
- что MCP-сервер стартует
- что tools реально видны
- что нет ошибок schema validation
- что GitLab/GitHub отвечают на простые read-запросы
В конце дай отчёт:
1. какие AI-инструменты найдены
2. какие конфиги изменены
3. какой GitLab MCP используется
4. какой GitHub MCP используется
5. где лежит единый сервер
6. какие токены/scopes нужны
7. какие инструменты надо перезапустить
8. какие проблемы были исправлены
Важное ограничение: не делай опасных write-операций в GitHub/GitLab. Только настройка локальных MCP-конфигов и read-only проверка.

https://<gitlab.example.com>/api/v4/mcp

Invalid input: expected "object"
inputSchema.type

• работает через обычный Personal Access Token
  
• поддерживает self-hosted GitLab через GITLAB_API_URL
  
• работает со stdio, SSE, Streamable HTTP
  
• есть примеры для Claude Code, Codex, Antigravity, Cursor, Cline, Roo Code и других клиентов
  
• умеет issues, merge requests, pipelines, wiki, releases, tags, milestones
  
• schema-баги уже фиксились, проект живой

{
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-gitlab"]
}

• Ставим MCP один раз глобально.
  
• Во все клиенты прописываем один и тот же node path/to/server.js или один и тот же бинарь.
  
• Обновляем централизованно.

npm install -g @zereight/mcp-gitlab

npm root -g

C:\Users\User\.npm-global\node_modules\@zereight\mcp-gitlab\build\index.js

~/.npm-global/node_modules/@zereight/mcp-gitlab/build/index.js

docker pull ghcr.io/github/github-mcp-server

git clone https://github.com/github/github-mcp-server
cd github-mcp-server
go build -o github-mcp-server ./cmd/github-mcp-server

/path/to/github-mcp-server stdio

C:\tools\github-mcp-server.exe stdio

{
  "mcpServers": {
    "gitlab": {
      "command": "node",
      "args": [
        "C:\\Users\\User\\.npm-global\\node_modules\\@zereight\\mcp-gitlab\\build\\index.js"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "glpat_xxxxx",
        "GITLAB_API_URL": "https://gitlab.company.com/api/v4"
      }
    }
  }
}

GITLAB_API_URL должен быть с /api/v4

https://gitlab.company.com/api/v4

https://gitlab.company.com

{
  "mcpServers": {
    "github": {
      "command": "C:\\tools\\github-mcp-server.exe",
      "args": ["stdio"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "github_pat_xxxxx",
        "GITHUB_TOOLSETS": "context,repos,issues,pull_requests",
        "GITHUB_READ_ONLY": "1"
      }
    }
  }
}

GITHUB_HOST должен быть с https://

• больше токенов на каждую сессию
  
• хуже tool choice
  
• больше шанс, что агент выберет не тот инструмент
  
• больше риск случайных write-операций
  
• быстрее упираетесь в лимиты

context,repos,issues,pull_requests

~/.claude.json

claude mcp add gitlab \
  -e GITLAB_PERSONAL_ACCESS_TOKEN=glpat_xxxxx \
  -e GITLAB_API_URL=https://gitlab.company.com/api/v4 \
  -- node /path/to/@zereight/mcp-gitlab/build/index.js

~/Library/Application Support/Claude/claude_desktop_config.json

%APPDATA%\Claude\claude_desktop_config.json

AppData\Local\Packages\Claude_*\LocalCache\Roaming\Claude\claude_desktop_config.json

~/.gemini/settings.json

~/.gemini/config/mcp_config.json

"$typeName": "exa.cascade_plugins_pb.CascadePluginCommandTemplate"

~/.codex/config.toml

[mcp_servers.gitlab]
command = "node"
args = ['C:\Users\User\.npm-global\node_modules\@zereight\mcp-gitlab\build\index.js']
[mcp_servers.gitlab.env]
GITLAB_PERSONAL_ACCESS_TOKEN = "glpat_xxxxx"
GITLAB_API_URL = "https://gitlab.company.com/api/v4"

[mcp_servers.github]
command = "C:\tools\github-mcp-server.exe"
args = ["stdio"]
[mcp_servers.github.env]
GITHUB_PERSONAL_ACCESS_TOKEN = "github_pat_xxxxx"
GITHUB_TOOLSETS = "context,repos,issues,pull_requests"
GITHUB_READ_ONLY = "1"

~/.cursor/mcp.json

{
  "mcpServers": {
    "gitlab": {
      "command": "node",
      "args": [
        "C:\\Users\\User\\.npm-global\\node_modules\\@zereight\\mcp-gitlab\\build\\index.js"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "glpat_xxxxx",
        "GITLAB_API_URL": "https://gitlab.company.com/api/v4"
      }
    }
  }
}

• сломанная schema tools
  
• старый пакет
  
• клиент стал строже валидировать JSON Schema
  
• используется @modelcontextprotocol/server-gitlab

• заменить на @zereight/mcp-gitlab
  
• не использовать старый @modelcontextprotocol/server-gitlab
  
• проверить /mcp или MCP logs

• либо просить админа включить GitLab Duo/MCP/beta features
  
• либо использовать локальный @zereight/mcp-gitlab с PAT

GITLAB_PERSONAL_ACCESS_TOKEN
GITLAB_API_URL

"GITHUB_TOOLSETS": "context,repos,issues,pull_requests"

"GITHUB_READ_ONLY": "1"

npm install -g @zereight/mcp-gitlab

• Claude Desktop перезапустить полностью
  
• Cursor перезапустить
  
• Antigravity перезапустить
  
• Gemini/Codex иногда перечитывают конфиг только при новом запуске
  
• Claude Code можно проверить через claude mcp list

github/github-mcp-server
local stdio
GITHUB_TOOLSETS=context,repos,issues,pull_requests
GITHUB_READ_ONLY=1

@zereight/mcp-gitlab
local stdio
GITLAB_API_URL=https://gitlab.company.com/api/v4
GITLAB_PERSONAL_ACCESS_TOKEN=glpat_xxxxx

https://gitlab.company.com/api/v4/mcp
HTTP transport
OAuth flow