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

- 类型: MCP 工具
- 说明: 连接 GitLab 项目与协作流程，统一管理代码、合并请求、议题与流水线。
- 仓库: https://github.com/zereight/gitlab-mcp
- ⚠ 安全: 该 MCP 工具面向 GitLab 项目与协作资源，属于需要凭证并会访问远程 GitLab API 的常规集成型工具。来源较可信且开源可审计，当前未见明确恶意红旗，但因具备代码执行、可选写操作及可配置 TLS 行为，整体建议按 caution 使用。

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

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

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

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

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

### Claude Code
```bash
claude mcp add --env GITLAB_PERSONAL_ACCESS_TOKEN=YOUR_VALUE --env GITLAB_JOB_TOKEN=YOUR_VALUE --env GITLAB_AUTH_COOKIE_PATH=YOUR_VALUE --env GITLAB_API_URL=YOUR_VALUE --env GITLAB_ALLOWED_PROJECT_IDS=YOUR_VALUE --env GITLAB_READ_ONLY_MODE=YOUR_VALUE --env USE_GITLAB_WIKI=YOUR_VALUE --env GITLAB_TOOLSETS=YOUR_VALUE --env GITLAB_TOOLS=YOUR_VALUE --env GITLAB_DENIED_TOOLS_REGEX=YOUR_VALUE --env GITLAB_TOOL_POLICY_APPROVE=YOUR_VALUE --env GITLAB_TOOL_POLICY_HIDDEN=YOUR_VALUE --env NODE_TLS_REJECT_UNAUTHORIZED=YOUR_VALUE --env GITLAB_CA_CERT_PATH=YOUR_VALUE --transport stdio io-github-zereight-gitlab-mcp -- npx -y @zereight/mcp-gitlab
```
需要环境变量：GITLAB_PERSONAL_ACCESS_TOKEN, GITLAB_JOB_TOKEN, GITLAB_AUTH_COOKIE_PATH, GITLAB_API_URL, GITLAB_ALLOWED_PROJECT_IDS, GITLAB_READ_ONLY_MODE, USE_GITLAB_WIKI, GITLAB_TOOLSETS, GITLAB_TOOLS, GITLAB_DENIED_TOOLS_REGEX, GITLAB_TOOL_POLICY_APPROVE, GITLAB_TOOL_POLICY_HIDDEN, NODE_TLS_REJECT_UNAUTHORIZED, GITLAB_CA_CERT_PATH

### Codex
```bash
codex mcp add --env GITLAB_PERSONAL_ACCESS_TOKEN=YOUR_VALUE --env GITLAB_JOB_TOKEN=YOUR_VALUE --env GITLAB_AUTH_COOKIE_PATH=YOUR_VALUE --env GITLAB_API_URL=YOUR_VALUE --env GITLAB_ALLOWED_PROJECT_IDS=YOUR_VALUE --env GITLAB_READ_ONLY_MODE=YOUR_VALUE --env USE_GITLAB_WIKI=YOUR_VALUE --env GITLAB_TOOLSETS=YOUR_VALUE --env GITLAB_TOOLS=YOUR_VALUE --env GITLAB_DENIED_TOOLS_REGEX=YOUR_VALUE --env GITLAB_TOOL_POLICY_APPROVE=YOUR_VALUE --env GITLAB_TOOL_POLICY_HIDDEN=YOUR_VALUE --env NODE_TLS_REJECT_UNAUTHORIZED=YOUR_VALUE --env GITLAB_CA_CERT_PATH=YOUR_VALUE io-github-zereight-gitlab-mcp -- npx -y @zereight/mcp-gitlab
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-zereight-gitlab-mcp]
command = "npx"
args = ["-y","@zereight/mcp-gitlab"]

[mcp_servers.io-github-zereight-gitlab-mcp.env]
GITLAB_PERSONAL_ACCESS_TOKEN = "YOUR_VALUE"
GITLAB_JOB_TOKEN = "YOUR_VALUE"
GITLAB_AUTH_COOKIE_PATH = "YOUR_VALUE"
GITLAB_API_URL = "YOUR_VALUE"
GITLAB_ALLOWED_PROJECT_IDS = "YOUR_VALUE"
GITLAB_READ_ONLY_MODE = "YOUR_VALUE"
USE_GITLAB_WIKI = "YOUR_VALUE"
GITLAB_TOOLSETS = "YOUR_VALUE"
GITLAB_TOOLS = "YOUR_VALUE"
GITLAB_DENIED_TOOLS_REGEX = "YOUR_VALUE"
GITLAB_TOOL_POLICY_APPROVE = "YOUR_VALUE"
GITLAB_TOOL_POLICY_HIDDEN = "YOUR_VALUE"
NODE_TLS_REJECT_UNAUTHORIZED = "YOUR_VALUE"
GITLAB_CA_CERT_PATH = "YOUR_VALUE"
```
需要环境变量：GITLAB_PERSONAL_ACCESS_TOKEN, GITLAB_JOB_TOKEN, GITLAB_AUTH_COOKIE_PATH, GITLAB_API_URL, GITLAB_ALLOWED_PROJECT_IDS, GITLAB_READ_ONLY_MODE, USE_GITLAB_WIKI, GITLAB_TOOLSETS, GITLAB_TOOLS, GITLAB_DENIED_TOOLS_REGEX, GITLAB_TOOL_POLICY_APPROVE, GITLAB_TOOL_POLICY_HIDDEN, NODE_TLS_REJECT_UNAUTHORIZED, GITLAB_CA_CERT_PATH

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-zereight-gitlab-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@zereight/mcp-gitlab"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "YOUR_VALUE",
        "GITLAB_JOB_TOKEN": "YOUR_VALUE",
        "GITLAB_AUTH_COOKIE_PATH": "YOUR_VALUE",
        "GITLAB_API_URL": "YOUR_VALUE",
        "GITLAB_ALLOWED_PROJECT_IDS": "YOUR_VALUE",
        "GITLAB_READ_ONLY_MODE": "YOUR_VALUE",
        "USE_GITLAB_WIKI": "YOUR_VALUE",
        "GITLAB_TOOLSETS": "YOUR_VALUE",
        "GITLAB_TOOLS": "YOUR_VALUE",
        "GITLAB_DENIED_TOOLS_REGEX": "YOUR_VALUE",
        "GITLAB_TOOL_POLICY_APPROVE": "YOUR_VALUE",
        "GITLAB_TOOL_POLICY_HIDDEN": "YOUR_VALUE",
        "NODE_TLS_REJECT_UNAUTHORIZED": "YOUR_VALUE",
        "GITLAB_CA_CERT_PATH": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-zereight-gitlab-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB6ZXJlaWdodC9tY3AtZ2l0bGFiIl0sImVudiI6eyJHSVRMQUJfUEVSU09OQUxfQUNDRVNTX1RPS0VOIjoiWU9VUl9WQUxVRSIsIkdJVExBQl9KT0JfVE9LRU4iOiJZT1VSX1ZBTFVFIiwiR0lUTEFCX0FVVEhfQ09PS0lFX1BBVEgiOiJZT1VSX1ZBTFVFIiwiR0lUTEFCX0FQSV9VUkwiOiJZT1VSX1ZBTFVFIiwiR0lUTEFCX0FMTE9XRURfUFJPSkVDVF9JRFMiOiJZT1VSX1ZBTFVFIiwiR0lUTEFCX1JFQURfT05MWV9NT0RFIjoiWU9VUl9WQUxVRSIsIlVTRV9HSVRMQUJfV0lLSSI6IllPVVJfVkFMVUUiLCJHSVRMQUJfVE9PTFNFVFMiOiJZT1VSX1ZBTFVFIiwiR0lUTEFCX1RPT0xTIjoiWU9VUl9WQUxVRSIsIkdJVExBQl9ERU5JRURfVE9PTFNfUkVHRVgiOiJZT1VSX1ZBTFVFIiwiR0lUTEFCX1RPT0xfUE9MSUNZX0FQUFJPVkUiOiJZT1VSX1ZBTFVFIiwiR0lUTEFCX1RPT0xfUE9MSUNZX0hJRERFTiI6IllPVVJfVkFMVUUiLCJOT0RFX1RMU19SRUpFQ1RfVU5BVVRIT1JJWkVEIjoiWU9VUl9WQUxVRSIsIkdJVExBQl9DQV9DRVJUX1BBVEgiOiJZT1VSX1ZBTFVFIn19
需要环境变量：GITLAB_PERSONAL_ACCESS_TOKEN, GITLAB_JOB_TOKEN, GITLAB_AUTH_COOKIE_PATH, GITLAB_API_URL, GITLAB_ALLOWED_PROJECT_IDS, GITLAB_READ_ONLY_MODE, USE_GITLAB_WIKI, GITLAB_TOOLSETS, GITLAB_TOOLS, GITLAB_DENIED_TOOLS_REGEX, GITLAB_TOOL_POLICY_APPROVE, GITLAB_TOOL_POLICY_HIDDEN, NODE_TLS_REJECT_UNAUTHORIZED, GITLAB_CA_CERT_PATH