快速配置
选择适合您环境的设置。
最后验证: 2026-06-13
验证环境: Node.js 18+，@zereight/mcp-gitlab 使用 stdio（官方参考服务已弃用）
安装命令:
npx -y @zereight/mcp-gitlab本地配置
JSON 本地配置 json
{
"gitlab": {
"command": "npx",
"args": ["-y", "@zereight/mcp-gitlab"],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "${GITLAB_PERSONAL_ACCESS_TOKEN}",
"GITLAB_API_URL": "https://gitlab.com/api/v4",
"GITLAB_READ_ONLY_MODE": "true"
}
}
}验证提示词
列出我的 GitLab 项目，并总结分配给我的待办 issues。
成功时应看到
应以只读方式返回你的项目与分配给你的 issues。
常见陷阱与修复
- ⚠️ 注意: PAT 权限范围、自建 GitLab 的 base URL，以及 group/project ID 识别。
- 🔑 始终将 API 密钥存储在环境变量中，切勿硬编码在 JSON 中。
- 🛡️ 如果可用，从只读权限开始，以安全地验证连接。
安全检查
- 使用最小权限 PAT（read_api），并默认保持 GITLAB_READ_ONLY_MODE=true。
- 官方 @modelcontextprotocol/server-gitlab 已弃用；本指南改用仍在维护的 @zereight/mcp-gitlab。
常见错误
| 错误 | 原因 | 修复方法 |
|---|---|---|
401 Unauthorized | token 缺失或无效。 | 创建带 read_api 范围的 PAT，并设为 GITLAB_PERSONAL_ACCESS_TOKEN。 |
404 / project not found | 自建实例的 GITLAB_API_URL 不正确。 | 把 GITLAB_API_URL 指向你实例的 /api/v4 端点。 |
Write blocked | GITLAB_READ_ONLY_MODE=true 默认禁止写操作。 | 仅在确实要写入时才设为 false。 |
示例提示词
连接后，尝试这些提示词以测试功能：
- 列出项目中打开的合并请求，并概括每个 MR 的改动。
- 找出最近 7 天更新、带有 bug 标签的 Issue，并按状态分组。
- 查看最新流水线状态，标出失败的 jobs 并给出可能原因。