# 安装 io.github.vish288/mcp-gitlab

- 类型: MCP 工具
- 说明: 连接 GitLab API，统一管理项目、合并请求、流水线与代码评审流程。
- 仓库: https://github.com/vish288/mcp-gitlab
- ⚠ 安全: 该 MCP 工具主要作为 GitLab API 的桥接层，已知需要 GitLab 访问令牌并会与配置的 GitLab 实例交互。基于官方 Registry、开源且近期有更新，整体更接近常规可控风险，但仍需关注令牌权限、只读配置及实际代码行为。

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "io.github.vish288/mcp-gitlab" MCP 服务：
执行：claude mcp add 'io-github-vish288-mcp-gitlab' -- npx -y mcp-gitlab
```

### Codex
```
请帮我安装 askskill 上的 "io.github.vish288/mcp-gitlab" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-vish288-mcp-gitlab]
command = "npx"
args = ["-y","mcp-gitlab"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "io.github.vish288/mcp-gitlab" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-vish288-mcp-gitlab": { "command": "npx", "args": ["-y","mcp-gitlab"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env GITLAB_TOKEN=YOUR_VALUE --env GITLAB_URL=YOUR_VALUE --env GITLAB_READ_ONLY=YOUR_VALUE --env MCP_READ_ONLY=YOUR_VALUE --env GITLAB_AUTH=YOUR_VALUE --env GITLAB_OAUTH_CLIENT_ID=YOUR_VALUE --env GITLAB_OAUTH_CLIENT_SECRET=YOUR_VALUE --env GITLAB_OAUTH_BASE_URL=YOUR_VALUE --env GITLAB_OAUTH_SCOPES=YOUR_VALUE --env GITLAB_OAUTH_JWT_KEY=YOUR_VALUE --env GITLAB_HTTP_BEARER_TOKEN=YOUR_VALUE --transport stdio io-github-vish288-mcp-gitlab -- npx -y mcp-gitlab
```
需要环境变量：GITLAB_TOKEN, GITLAB_URL, GITLAB_READ_ONLY, MCP_READ_ONLY, GITLAB_AUTH, GITLAB_OAUTH_CLIENT_ID, GITLAB_OAUTH_CLIENT_SECRET, GITLAB_OAUTH_BASE_URL, GITLAB_OAUTH_SCOPES, GITLAB_OAUTH_JWT_KEY, GITLAB_HTTP_BEARER_TOKEN

### Codex
```bash
codex mcp add --env GITLAB_TOKEN=YOUR_VALUE --env GITLAB_URL=YOUR_VALUE --env GITLAB_READ_ONLY=YOUR_VALUE --env MCP_READ_ONLY=YOUR_VALUE --env GITLAB_AUTH=YOUR_VALUE --env GITLAB_OAUTH_CLIENT_ID=YOUR_VALUE --env GITLAB_OAUTH_CLIENT_SECRET=YOUR_VALUE --env GITLAB_OAUTH_BASE_URL=YOUR_VALUE --env GITLAB_OAUTH_SCOPES=YOUR_VALUE --env GITLAB_OAUTH_JWT_KEY=YOUR_VALUE --env GITLAB_HTTP_BEARER_TOKEN=YOUR_VALUE io-github-vish288-mcp-gitlab -- npx -y mcp-gitlab
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-vish288-mcp-gitlab]
command = "npx"
args = ["-y","mcp-gitlab"]

[mcp_servers.io-github-vish288-mcp-gitlab.env]
GITLAB_TOKEN = "YOUR_VALUE"
GITLAB_URL = "YOUR_VALUE"
GITLAB_READ_ONLY = "YOUR_VALUE"
MCP_READ_ONLY = "YOUR_VALUE"
GITLAB_AUTH = "YOUR_VALUE"
GITLAB_OAUTH_CLIENT_ID = "YOUR_VALUE"
GITLAB_OAUTH_CLIENT_SECRET = "YOUR_VALUE"
GITLAB_OAUTH_BASE_URL = "YOUR_VALUE"
GITLAB_OAUTH_SCOPES = "YOUR_VALUE"
GITLAB_OAUTH_JWT_KEY = "YOUR_VALUE"
GITLAB_HTTP_BEARER_TOKEN = "YOUR_VALUE"
```
需要环境变量：GITLAB_TOKEN, GITLAB_URL, GITLAB_READ_ONLY, MCP_READ_ONLY, GITLAB_AUTH, GITLAB_OAUTH_CLIENT_ID, GITLAB_OAUTH_CLIENT_SECRET, GITLAB_OAUTH_BASE_URL, GITLAB_OAUTH_SCOPES, GITLAB_OAUTH_JWT_KEY, GITLAB_HTTP_BEARER_TOKEN

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-vish288-mcp-gitlab": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-gitlab"
      ],
      "env": {
        "GITLAB_TOKEN": "YOUR_VALUE",
        "GITLAB_URL": "YOUR_VALUE",
        "GITLAB_READ_ONLY": "YOUR_VALUE",
        "MCP_READ_ONLY": "YOUR_VALUE",
        "GITLAB_AUTH": "YOUR_VALUE",
        "GITLAB_OAUTH_CLIENT_ID": "YOUR_VALUE",
        "GITLAB_OAUTH_CLIENT_SECRET": "YOUR_VALUE",
        "GITLAB_OAUTH_BASE_URL": "YOUR_VALUE",
        "GITLAB_OAUTH_SCOPES": "YOUR_VALUE",
        "GITLAB_OAUTH_JWT_KEY": "YOUR_VALUE",
        "GITLAB_HTTP_BEARER_TOKEN": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-vish288-mcp-gitlab&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1jcC1naXRsYWIiXSwiZW52Ijp7IkdJVExBQl9UT0tFTiI6IllPVVJfVkFMVUUiLCJHSVRMQUJfVVJMIjoiWU9VUl9WQUxVRSIsIkdJVExBQl9SRUFEX09OTFkiOiJZT1VSX1ZBTFVFIiwiTUNQX1JFQURfT05MWSI6IllPVVJfVkFMVUUiLCJHSVRMQUJfQVVUSCI6IllPVVJfVkFMVUUiLCJHSVRMQUJfT0FVVEhfQ0xJRU5UX0lEIjoiWU9VUl9WQUxVRSIsIkdJVExBQl9PQVVUSF9DTElFTlRfU0VDUkVUIjoiWU9VUl9WQUxVRSIsIkdJVExBQl9PQVVUSF9CQVNFX1VSTCI6IllPVVJfVkFMVUUiLCJHSVRMQUJfT0FVVEhfU0NPUEVTIjoiWU9VUl9WQUxVRSIsIkdJVExBQl9PQVVUSF9KV1RfS0VZIjoiWU9VUl9WQUxVRSIsIkdJVExBQl9IVFRQX0JFQVJFUl9UT0tFTiI6IllPVVJfVkFMVUUifX0
需要环境变量：GITLAB_TOKEN, GITLAB_URL, GITLAB_READ_ONLY, MCP_READ_ONLY, GITLAB_AUTH, GITLAB_OAUTH_CLIENT_ID, GITLAB_OAUTH_CLIENT_SECRET, GITLAB_OAUTH_BASE_URL, GITLAB_OAUTH_SCOPES, GITLAB_OAUTH_JWT_KEY, GITLAB_HTTP_BEARER_TOKEN