gitlab-automation

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

GitLab Automation via Rube MCP

通过Rube MCP实现GitLab自动化

Automate GitLab operations including project management, issue tracking, merge request workflows, CI/CD pipeline monitoring, branch management, and user administration through Composio's GitLab toolkit.

借助Composio的GitLab工具包，自动化GitLab操作，包括项目管理、议题追踪、合并请求工作流、CI/CD流水线监控、分支管理和用户权限管理。

Prerequisites

前提条件

Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
Active GitLab connection via
```
RUBE_MANAGE_CONNECTIONS
```
with toolkit
```
gitlab
```
Always call
```
RUBE_SEARCH_TOOLS
```
first to get current tool schemas

必须已连接Rube MCP（需确保
```
RUBE_SEARCH_TOOLS
```
可用）
通过
```
RUBE_MANAGE_CONNECTIONS
```
激活GitLab连接，工具包选择
```
gitlab
```
请始终先调用
```
RUBE_SEARCH_TOOLS
```
以获取最新的工具模式

Setup

设置步骤

Get Rube MCP: Add

https://rube.app/mcp

as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

Verify Rube MCP is available by confirming
```
RUBE_SEARCH_TOOLS
```
responds
Call
```
RUBE_MANAGE_CONNECTIONS
```
with toolkit
```
gitlab
```
If connection is not ACTIVE, follow the returned auth link to complete GitLab OAuth
Confirm connection status shows ACTIVE before running any workflows

获取Rube MCP：在客户端配置中添加

https://rube.app/mcp

作为MCP服务器。无需API密钥，只需添加端点即可使用。

确认
```
RUBE_SEARCH_TOOLS
```
可正常响应，以此验证Rube MCP是否可用
调用
```
RUBE_MANAGE_CONNECTIONS
```
并指定工具包为
```
gitlab
```
如果连接状态未激活，请按照返回的授权链接完成GitLab OAuth认证
在运行任何工作流之前，确认连接状态显示为ACTIVE

Core Workflows

核心工作流

1. Manage Issues

1. 议题管理

When to use: User wants to create, update, list, or search issues in a GitLab project

Tool sequence:

```
GITLAB_GET_PROJECTS
```
- Find the target project and get its ID [Prerequisite]
```
GITLAB_LIST_PROJECT_ISSUES
```
- List and filter issues for a project [Required]
```
GITLAB_CREATE_PROJECT_ISSUE
```
- Create a new issue [Required for create]
```
GITLAB_UPDATE_PROJECT_ISSUE
```
- Update an existing issue (title, labels, state, assignees) [Required for update]
```
GITLAB_LIST_PROJECT_USERS
```
- Find user IDs for assignment [Optional]

Key parameters:

```
id
```
: Project ID (integer) or URL-encoded path (e.g.,
```
"my-group/my-project"
```
)
```
title
```
: Issue title (required for creation)
```
description
```
: Issue body text (max 1,048,576 characters)
```
labels
```
: Comma-separated label names (e.g.,
```
"bug,critical"
```
)
```
add_labels
```
/
```
remove_labels
```
: Add or remove labels without replacing all
```
state
```
: Filter by
```
"all"
```
,
```
"opened"
```
, or
```
"closed"
```
```
state_event
```
:
```
"close"
```
or
```
"reopen"
```
to change issue state
```
assignee_ids
```
: Array of user IDs; use
```
[0]
```
to unassign all
```
issue_iid
```
: Internal issue ID within the project (required for updates)
```
milestone
```
: Filter by milestone title
```
search
```
: Search in title and description

scope

"created_by_me"

"assigned_to_me"

, or

"all"

```
page
```
/
```
per_page
```
: Pagination (default per_page: 20)

Pitfalls:

```
id
```
accepts either integer project ID or URL-encoded path; wrong IDs yield 4xx errors
```
issue_iid
```
is the project-internal ID (shown as #42), different from the global issue ID
Labels in
```
labels
```
field replace ALL existing labels; use
```
add_labels
```
/
```
remove_labels
```
for incremental changes
Setting
```
assignee_ids
```
to empty array does NOT unassign; use
```
[0]
```
instead
```
updated_at
```
field requires administrator or project/group owner rights

适用场景：用户需要在GitLab项目中创建、更新、列出或搜索议题

工具执行顺序:

```
GITLAB_GET_PROJECTS
```
- 找到目标项目并获取其ID [前提步骤]
```
GITLAB_LIST_PROJECT_ISSUES
```
- 列出并筛选项目中的议题 [必需步骤]
```
GITLAB_CREATE_PROJECT_ISSUE
```
- 创建新议题 [创建操作必需]
```
GITLAB_UPDATE_PROJECT_ISSUE
```
- 更新现有议题（标题、标签、状态、经办人） [更新操作必需]
```
GITLAB_LIST_PROJECT_USERS
```
- 查找用于分配的用户ID [可选步骤]

关键参数:

```
id
```
: 项目ID（整数）或URL编码路径（例如：
```
"my-group/my-project"
```
）
```
title
```
: 议题标题（创建操作必填）
```
description
```
: 议题正文（最大1,048,576字符）
```
labels
```
: 逗号分隔的标签名称（例如：
```
"bug,critical"
```
）
```
add_labels
```
/
```
remove_labels
```
: 添加或移除标签，无需替换所有现有标签
```
state
```
: 筛选条件，可选
```
"all"
```
、
```
"opened"
```
或
```
"closed"
```
```
state_event
```
: 用于修改议题状态，可选
```
"close"
```
或
```
"reopen"
```
```
assignee_ids
```
: 用户ID数组；使用
```
[0]
```
可移除所有经办人
```
issue_iid
```
: 项目内的议题ID（显示为#42），与全局议题ID不同
```
milestone
```
: 按里程碑标题筛选
```
search
```
: 在标题和正文中搜索

scope

: 可选

"created_by_me"

、

"assigned_to_me"

或

"all"

```
page
```
/
```
per_page
```
: 分页参数（默认每页20条）

注意事项:

```
id
```
字段支持整数项目ID或URL编码路径；错误的ID会导致4xx错误
```
issue_iid
```
是项目内部ID（显示为#42），与全局议题ID不同
```
labels
```
字段中的标签会替换所有现有标签；如需增量修改，请使用
```
add_labels
```
/
```
remove_labels
```
将
```
assignee_ids
```
设为空数组无法移除经办人；需使用
```
[0]
```
替代
修改
```
updated_at
```
字段需要管理员或项目/群组所有者权限

2. Manage Merge Requests

2. 合并请求管理

When to use: User wants to list, filter, or review merge requests in a project

Tool sequence:

```
GITLAB_GET_PROJECT
```
- Get project details and verify access [Prerequisite]
```
GITLAB_GET_PROJECT_MERGE_REQUESTS
```
- List and filter merge requests [Required]
```
GITLAB_GET_REPOSITORY_BRANCHES
```
- Verify source/target branches [Optional]
```
GITLAB_LIST_ALL_PROJECT_MEMBERS
```
- Find reviewers/assignees [Optional]

Key parameters:

```
id
```
: Project ID or URL-encoded path

state

"opened"

"closed"

"locked"

"merged"

, or

"all"

scope

"created_by_me"

(default),

"assigned_to_me"

, or

"all"

```
source_branch
```
/
```
target_branch
```
: Filter by branch names
```
author_id
```
/
```
author_username
```
: Filter by MR author
```
assignee_id
```
: Filter by assignee (use
```
None
```
for unassigned,
```
Any
```
for assigned)
```
reviewer_id
```
/
```
reviewer_username
```
: Filter by reviewer
```
labels
```
: Comma-separated label filter
```
search
```
: Search in title and description
```
wip
```
:
```
"yes"
```
for draft MRs,
```
"no"
```
for non-draft

order_by

"created_at"

(default),

"title"

"merged_at"

"updated_at"

```
view
```
:
```
"simple"
```
for minimal fields
```
iids[]
```
: Filter by specific MR internal IDs

Pitfalls:

Default
```
scope
```
is
```
"created_by_me"
```
which limits results; use
```
"all"
```
for complete listings
```
author_id
```
and
```
author_username
```
are mutually exclusive
```
reviewer_id
```
and
```
reviewer_username
```
are mutually exclusive
```
approved
```
filter requires the
```
mr_approved_filter
```
feature flag (disabled by default)
Large MR histories can be noisy; use filters and moderate
```
per_page
```
values

适用场景：用户需要列出、筛选或审核项目中的合并请求

工具执行顺序:

```
GITLAB_GET_PROJECT
```
- 获取项目详情并验证访问权限 [前提步骤]
```
GITLAB_GET_PROJECT_MERGE_REQUESTS
```
- 列出并筛选合并请求 [必需步骤]
```
GITLAB_GET_REPOSITORY_BRANCHES
```
- 验证源分支/目标分支 [可选步骤]
```
GITLAB_LIST_ALL_PROJECT_MEMBERS
```
- 查找审核人/经办人 [可选步骤]

关键参数:

```
id
```
: 项目ID或URL编码路径

state

: 可选

"opened"

、

"closed"

、

"locked"

、

"merged"

或

"all"

scope

: 可选

"created_by_me"

（默认）、

"assigned_to_me"

或

"all"

```
source_branch
```
/
```
target_branch
```
: 按分支名称筛选
```
author_id
```
/
```
author_username
```
: 按合并请求作者筛选
```
assignee_id
```
: 按经办人筛选（
```
None
```
表示未分配，
```
Any
```
表示已分配）
```
reviewer_id
```
/
```
reviewer_username
```
: 按审核人筛选
```
labels
```
: 逗号分隔的标签筛选条件
```
search
```
: 在标题和正文中搜索
```
wip
```
:
```
"yes"
```
表示草稿合并请求，
```
"no"
```
表示非草稿

order_by

: 可选

"created_at"

（默认）、

"title"

、

"merged_at"

、

"updated_at"

```
view
```
:
```
"simple"
```
表示仅返回基础字段
```
iids[]
```
: 按特定合并请求内部ID筛选

注意事项:

默认
```
scope
```
为
```
"created_by_me"
```
，会限制结果范围；如需完整列表请使用
```
"all"
```
```
author_id
```
和
```
author_username
```
不可同时使用
```
reviewer_id
```
和
```
reviewer_username
```
不可同时使用
```
approved
```
筛选条件需要启用
```
mr_approved_filter
```
功能标志（默认禁用）
大型合并请求历史记录可能包含冗余信息；请使用筛选条件并合理设置
```
per_page
```
值

3. Manage Projects and Repositories

3. 项目与仓库管理

When to use: User wants to list projects, create new projects, or manage branches

Tool sequence:

```
GITLAB_GET_PROJECTS
```
- List all accessible projects with filters [Required]
```
GITLAB_GET_PROJECT
```
- Get detailed info for a specific project [Optional]
```
GITLAB_LIST_USER_PROJECTS
```
- List projects owned by a specific user [Optional]
```
GITLAB_CREATE_PROJECT
```
- Create a new project [Required for create]
```
GITLAB_GET_REPOSITORY_BRANCHES
```
- List branches in a project [Required for branch ops]
```
GITLAB_CREATE_REPOSITORY_BRANCH
```
- Create a new branch [Optional]
```
GITLAB_GET_REPOSITORY_BRANCH
```
- Get details of a specific branch [Optional]
```
GITLAB_LIST_REPOSITORY_COMMITS
```
- View commit history [Optional]
```
GITLAB_GET_PROJECT_LANGUAGES
```
- Get language breakdown [Optional]

Key parameters:

```
name
```
/
```
path
```
: Project name and URL-friendly path (both required for creation)
```
visibility
```
:
```
"private"
```
,
```
"internal"
```
, or
```
"public"
```
```
namespace_id
```
: Group or user ID for project placement
```
search
```
: Case-insensitive substring search for projects
```
membership
```
:
```
true
```
to limit to projects user is a member of
```
owned
```
:
```
true
```
to limit to user-owned projects
```
project_id
```
: Project ID for branch operations
```
branch_name
```
: Name for new branch
```
ref
```
: Source branch or commit SHA for new branch creation

order_by

"id"

"name"

"path"

"created_at"

"updated_at"

"star_count"

"last_activity_at"

Pitfalls:

```
GITLAB_GET_PROJECTS
```
pagination is required for complete coverage; stopping at first page misses projects
Some responses place items under
```
data.details
```
; parse the actual returned list structure
Most follow-up calls depend on correct
```
project_id
```
; verify with
```
GITLAB_GET_PROJECT
```
first
Invalid
```
branch_name
```
/
```
ref
```
/
```
sha
```
causes client errors; verify branch existence via
```
GITLAB_GET_REPOSITORY_BRANCHES
```
first
Both
```
name
```
and
```
path
```
are required for
```
GITLAB_CREATE_PROJECT
```

适用场景：用户需要列出项目、创建新项目或管理分支

工具执行顺序:

```
GITLAB_GET_PROJECTS
```
- 列出所有可访问的项目并应用筛选条件 [必需步骤]
```
GITLAB_GET_PROJECT
```
- 获取特定项目的详细信息 [可选步骤]
```
GITLAB_LIST_USER_PROJECTS
```
- 列出特定用户拥有的项目 [可选步骤]
```
GITLAB_CREATE_PROJECT
```
- 创建新项目 [创建操作必需]
```
GITLAB_GET_REPOSITORY_BRANCHES
```
- 列出项目中的分支 [分支操作必需]
```
GITLAB_CREATE_REPOSITORY_BRANCH
```
- 创建新分支 [可选步骤]
```
GITLAB_GET_REPOSITORY_BRANCH
```
- 获取特定分支的详细信息 [可选步骤]
```
GITLAB_LIST_REPOSITORY_COMMITS
```
- 查看提交历史 [可选步骤]
```
GITLAB_GET_PROJECT_LANGUAGES
```
- 获取项目语言占比 [可选步骤]

关键参数:

```
name
```
/
```
path
```
: 项目名称和URL友好路径（创建操作必填）
```
visibility
```
: 可选
```
"private"
```
、
```
"internal"
```
或
```
"public"
```
```
namespace_id
```
: 项目所属的群组或用户ID
```
search
```
: 对项目名称进行不区分大小写的子串搜索
```
membership
```
:
```
true
```
表示仅显示用户为成员的项目
```
owned
```
:
```
true
```
表示仅显示用户拥有的项目
```
project_id
```
: 分支操作对应的项目ID
```
branch_name
```
: 新分支的名称
```
ref
```
: 创建新分支的源分支或提交SHA

order_by

: 可选

"id"

、

"name"

、

"path"

、

"created_at"

、

"updated_at"

、

"star_count"

、

"last_activity_at"

注意事项:

```
GITLAB_GET_PROJECTS
```
需要分页才能获取完整项目列表；仅获取第一页会遗漏项目
部分响应结果的项目列表位于
```
data.details
```
下；请解析实际返回的列表结构
大多数后续操作依赖正确的
```
project_id
```
；请先通过
```
GITLAB_GET_PROJECT
```
验证
无效的
```
branch_name
```
/
```
ref
```
/
```
sha
```
会导致客户端错误；请先通过
```
GITLAB_GET_REPOSITORY_BRANCHES
```
验证分支是否存在
```
GITLAB_CREATE_PROJECT
```
操作同时需要
```
name
```
和
```
path
```
参数

4. Monitor CI/CD Pipelines

4. CI/CD流水线监控

When to use: User wants to check pipeline status, list jobs, or monitor CI/CD runs

Tool sequence:

```
GITLAB_GET_PROJECT
```
- Verify project access [Prerequisite]
```
GITLAB_LIST_PROJECT_PIPELINES
```
- List pipelines with filters [Required]
```
GITLAB_GET_SINGLE_PIPELINE
```
- Get detailed info for a specific pipeline [Optional]
```
GITLAB_LIST_PIPELINE_JOBS
```
- List jobs within a pipeline [Optional]

Key parameters:

```
id
```
: Project ID or URL-encoded path

status

: Filter by

"created"

"waiting_for_resource"

"preparing"

"pending"

"running"

"success"

"failed"

"canceled"

"skipped"

"manual"

"scheduled"

scope

"running"

"pending"

"finished"

"branches"

"tags"

```
ref
```
: Branch or tag name
```
sha
```
: Specific commit SHA
```
source
```
: Pipeline source (use
```
"parent_pipeline"
```
for child pipelines)

order_by

"id"

(default),

"status"

"ref"

"updated_at"

"user_id"

```
created_after
```
/
```
created_before
```
: ISO 8601 date filters
```
pipeline_id
```
: Specific pipeline ID for job listing
```
include_retried
```
:
```
true
```
to include retried jobs (default
```
false
```
)

Pitfalls:

Large pipeline histories can be noisy; use
```
status
```
,
```
ref
```
, and date filters to narrow results
Use moderate
```
per_page
```
values to keep output manageable
Pipeline job
```
scope
```
accepts single status string or array of statuses
```
yaml_errors: true
```
returns only pipelines with invalid configurations

适用场景：用户需要检查流水线状态、列出作业或监控CI/CD运行情况

工具执行顺序:

```
GITLAB_GET_PROJECT
```
- 验证项目访问权限 [前提步骤]
```
GITLAB_LIST_PROJECT_PIPELINES
```
- 列出流水线并应用筛选条件 [必需步骤]
```
GITLAB_GET_SINGLE_PIPELINE
```
- 获取特定流水线的详细信息 [可选步骤]
```
GITLAB_LIST_PIPELINE_JOBS
```
- 列出流水线中的作业 [可选步骤]

关键参数:

```
id
```
: 项目ID或URL编码路径

status

: 按状态筛选，可选

"created"

、

"waiting_for_resource"

、

"preparing"

、

"pending"

、

"running"

、

"success"

、

"failed"

、

"canceled"

、

"skipped"

、

"manual"

、

"scheduled"

scope

: 可选

"running"

、

"pending"

、

"finished"

、

"branches"

、

"tags"

```
ref
```
: 分支或标签名称
```
sha
```
: 特定提交SHA
```
source
```
: 流水线来源（
```
"parent_pipeline"
```
表示子流水线）

order_by

: 可选

"id"

（默认）、

"status"

、

"ref"

、

"updated_at"

、

"user_id"

```
created_after
```
/
```
created_before
```
: ISO 8601格式的日期筛选条件
```
pipeline_id
```
: 用于列出作业的特定流水线ID
```
include_retried
```
:
```
true
```
表示包含重试的作业（默认
```
false
```
）

注意事项:

大型流水线历史记录可能包含冗余信息；请使用
```
status
```
、
```
ref
```
和日期筛选条件缩小结果范围
合理设置
```
per_page
```
值以保持输出内容简洁
流水线作业的
```
scope
```
参数支持单个状态字符串或状态数组
```
yaml_errors: true
```
仅返回配置无效的流水线

5. Manage Users and Members

5. 用户与成员管理

When to use: User wants to find users, list project members, or check user status

Tool sequence:

```
GITLAB_GET_USERS
```
- Search and list GitLab users [Required]
```
GITLAB_GET_USER
```
- Get details for a specific user by ID [Optional]
```
GITLAB_GET_USERS_ID_STATUS
```
- Get user status message and availability [Optional]
```
GITLAB_LIST_ALL_PROJECT_MEMBERS
```
- List all project members (direct + inherited) [Required for member listing]
```
GITLAB_LIST_PROJECT_USERS
```
- List project users with search filter [Optional]

Key parameters:

```
search
```
: Search by name, username, or public email
```
username
```
: Get specific user by username
```
active
```
/
```
blocked
```
: Filter by user state
```
id
```
: Project ID for member listing
```
query
```
: Filter members by name, email, or username
```
state
```
: Filter members by
```
"awaiting"
```
or
```
"active"
```
(Premium/Ultimate)
```
user_ids
```
: Filter by specific user IDs

Pitfalls:

Many user filters (admins, auditors, extern_uid, two_factor) are admin-only
```
GITLAB_LIST_ALL_PROJECT_MEMBERS
```
includes direct, inherited, and invited members
User search is case-insensitive but may not match partial email domains
Premium/Ultimate features (state filter, seat info) are not available on free plans

适用场景：用户需要查找用户、列出项目成员或检查用户状态

工具执行顺序:

```
GITLAB_GET_USERS
```
- 搜索并列出GitLab用户 [必需步骤]
```
GITLAB_GET_USER
```
- 通过ID获取特定用户的详细信息 [可选步骤]
```
GITLAB_GET_USERS_ID_STATUS
```
- 获取用户状态消息和可用性 [可选步骤]
```
GITLAB_LIST_ALL_PROJECT_MEMBERS
```
- 列出所有项目成员（直接成员+继承成员） [成员列表操作必需]
```
GITLAB_LIST_PROJECT_USERS
```
- 列出项目用户并应用搜索筛选 [可选步骤]

关键参数:

```
search
```
: 按名称、用户名或公开邮箱搜索
```
username
```
: 按用户名获取特定用户
```
active
```
/
```
blocked
```
: 按用户状态筛选
```
id
```
: 成员列表对应的项目ID
```
query
```
: 按名称、邮箱或用户名筛选成员
```
state
```
: 按成员状态筛选（仅Premium/Ultimate版本支持，可选
```
"awaiting"
```
或
```
"active"
```
）
```
user_ids
```
: 按特定用户ID筛选

注意事项:

许多用户筛选条件（管理员、审计员、extern_uid、双因素认证）仅管理员可用
```
GITLAB_LIST_ALL_PROJECT_MEMBERS
```
包含直接成员、继承成员和受邀成员
用户搜索不区分大小写，但可能无法匹配部分邮箱域名
Premium/Ultimate版本专属功能（状态筛选、席位信息）在免费版本中不可用

Common Patterns

通用模式

ID Resolution

ID解析

GitLab uses two identifier formats for projects:

Numeric ID: Integer project ID (e.g.,
```
123
```
)
URL-encoded path: Namespace/project format (e.g.,
```
"my-group%2Fmy-project"
```
or
```
"my-group/my-project"
```
)
Issue IID vs ID:
```
issue_iid
```
is the project-internal number (#42); the global
```
id
```
is different
User ID: Numeric; resolve via
```
GITLAB_GET_USERS
```
with
```
search
```
or
```
username
```

GitLab为项目提供两种标识符格式：

数字ID: 整数类型的项目ID（例如：
```
123
```
）
URL编码路径: 命名空间/项目格式（例如：
```
"my-group%2Fmy-project"
```
或
```
"my-group/my-project"
```
）
议题IID与ID:
```
issue_iid
```
是项目内部编号（#42）；全局
```
id
```
与之不同
用户ID: 数字类型；可通过
```
GITLAB_GET_USERS
```
的
```
search
```
或
```
username
```
参数解析

Pagination

分页

GitLab uses offset-based pagination:

Set
```
page
```
(starting at 1) and
```
per_page
```
(1-100, default 20)
Continue incrementing
```
page
```
until response returns fewer items than
```
per_page
```
or is empty
Total count may be available in response headers (
```
X-Total
```
,
```
X-Total-Pages
```
)
Always paginate to completion for accurate results

GitLab使用基于偏移量的分页方式：

设置
```
page
```
（从1开始）和
```
per_page
```
（1-100，默认20）
持续递增
```
page
```
直到返回结果数量少于
```
per_page
```
或返回空结果
总数量可能在响应头中提供（
```
X-Total
```
、
```
X-Total-Pages
```
）
为获取准确结果，请始终完成全部分页请求

URL-Encoded Paths

URL编码路径

When using project paths as identifiers:

Forward slashes must be URL-encoded:
```
my-group/my-project
```
becomes
```
my-group%2Fmy-project
```
Some tools accept unencoded paths; check schema for each tool
Prefer numeric IDs when available for reliability

当使用项目路径作为标识符时：

斜杠必须进行URL编码：
```
my-group/my-project
```
需转换为
```
my-group%2Fmy-project
```
部分工具支持未编码路径；请查阅每个工具的模式确认
如有可用，优先使用数字ID以提高可靠性

Known Pitfalls

已知注意事项

ID Formats

ID格式

Project
```
id
```
field accepts both integer and string (URL-encoded path)
Issue
```
issue_iid
```
is project-scoped; do not confuse with global issue ID
Pipeline IDs are project-scoped integers
User IDs are global integers across the GitLab instance

项目
```
id
```
字段支持整数和字符串（URL编码路径）两种类型
议题
```
issue_iid
```
是项目范围内的ID；请勿与全局议题ID混淆
流水线ID是项目范围内的整数
用户ID是GitLab实例全局唯一的整数

Rate Limits

速率限制

GitLab has per-user rate limits (typically 300-2000 requests/minute depending on plan)
Large pipeline/issue histories should use date and status filters to reduce result sets
Paginate responsibly with moderate
```
per_page
```
values

GitLab对每个用户设置了速率限制（根据版本不同，通常为300-2000请求/分钟）
对于大型流水线/议题历史记录，请使用日期和状态筛选条件缩小结果范围
合理设置
```
per_page
```
值，负责任地进行分页请求

Parameter Quirks

参数特殊性

```
labels
```
field replaces ALL labels; use
```
add_labels
```
/
```
remove_labels
```
for incremental changes
```
assignee_ids: [0]
```
unassigns all; empty array does nothing
```
scope
```
defaults vary:
```
"created_by_me"
```
for MRs,
```
"all"
```
for issues
```
author_id
```
and
```
author_username
```
are mutually exclusive in MR filters
Date parameters use ISO 8601 format:
```
"2024-01-15T10:30:00Z"
```

```
labels
```
字段会替换所有现有标签；如需增量修改，请使用
```
add_labels
```
/
```
remove_labels
```
```
assignee_ids: [0]
```
可移除所有经办人；空数组无效果
默认
```
scope
```
参数值因操作而异：合并请求默认
```
"created_by_me"
```
，议题默认
```
"all"
```
合并请求筛选条件中，
```
author_id
```
和
```
author_username
```
不可同时使用
日期参数需使用ISO 8601格式：
```
"2024-01-15T10:30:00Z"
```

Plan Restrictions

版本限制

Some features require Premium/Ultimate:
```
epic_id
```
,
```
weight
```
,
```
iteration_id
```
,
```
approved_by_ids
```
, member
```
state
```
filter
Admin-only features: user management filters,
```
updated_at
```
override, custom attributes
The
```
mr_approved_filter
```
feature flag is disabled by default

部分功能需要Premium/Ultimate版本：
```
epic_id
```
、
```
weight
```
、
```
iteration_id
```
、
```
approved_by_ids
```
、成员
```
state
```
筛选
仅管理员可用功能：用户管理筛选条件、
```
updated_at
```
覆盖、自定义属性
```
mr_approved_filter
```
功能标志默认禁用

Quick Reference

快速参考

Task	Tool Slug	Key Params
List projects	`GITLAB_GET_PROJECTS`	`search` , `membership` , `visibility`
Get project details	`GITLAB_GET_PROJECT`	`id`
User's projects	`GITLAB_LIST_USER_PROJECTS`	`id` , `search` , `owned`
Create project	`GITLAB_CREATE_PROJECT`	`name` , `path` , `visibility`
List issues	`GITLAB_LIST_PROJECT_ISSUES`	`id` , `state` , `labels` , `search`
Create issue	`GITLAB_CREATE_PROJECT_ISSUE`	`id` , `title` , `description` , `labels`
Update issue	`GITLAB_UPDATE_PROJECT_ISSUE`	`id` , `issue_iid` , `state_event`
List merge requests	`GITLAB_GET_PROJECT_MERGE_REQUESTS`	`id` , `state` , `scope` , `labels`
List branches	`GITLAB_GET_REPOSITORY_BRANCHES`	`project_id` , `search`
Get branch	`GITLAB_GET_REPOSITORY_BRANCH`	`project_id` , `branch_name`
Create branch	`GITLAB_CREATE_REPOSITORY_BRANCH`	`project_id` , `branch_name` , `ref`
List commits	`GITLAB_LIST_REPOSITORY_COMMITS`	project ID, branch ref
Project languages	`GITLAB_GET_PROJECT_LANGUAGES`	project ID
List pipelines	`GITLAB_LIST_PROJECT_PIPELINES`	`id` , `status` , `ref`
Get pipeline	`GITLAB_GET_SINGLE_PIPELINE`	`project_id` , `pipeline_id`
List pipeline jobs	`GITLAB_LIST_PIPELINE_JOBS`	`id` , `pipeline_id` , `scope`
Search users	`GITLAB_GET_USERS`	`search` , `username` , `active`
Get user	`GITLAB_GET_USER`	user ID
User status	`GITLAB_GET_USERS_ID_STATUS`	user ID
List project members	`GITLAB_LIST_ALL_PROJECT_MEMBERS`	`id` , `query` , `state`
List project users	`GITLAB_LIST_PROJECT_USERS`	`id` , `search`

任务	工具标识	关键参数
列出项目	`GITLAB_GET_PROJECTS`	`search` , `membership` , `visibility`
获取项目详情	`GITLAB_GET_PROJECT`	`id`
用户的项目	`GITLAB_LIST_USER_PROJECTS`	`id` , `search` , `owned`
创建项目	`GITLAB_CREATE_PROJECT`	`name` , `path` , `visibility`
列出议题	`GITLAB_LIST_PROJECT_ISSUES`	`id` , `state` , `labels` , `search`
创建议题	`GITLAB_CREATE_PROJECT_ISSUE`	`id` , `title` , `description` , `labels`
更新议题	`GITLAB_UPDATE_PROJECT_ISSUE`	`id` , `issue_iid` , `state_event`
列出合并请求	`GITLAB_GET_PROJECT_MERGE_REQUESTS`	`id` , `state` , `scope` , `labels`
列出分支	`GITLAB_GET_REPOSITORY_BRANCHES`	`project_id` , `search`
获取分支详情	`GITLAB_GET_REPOSITORY_BRANCH`	`project_id` , `branch_name`
创建分支	`GITLAB_CREATE_REPOSITORY_BRANCH`	`project_id` , `branch_name` , `ref`
列出提交	`GITLAB_LIST_REPOSITORY_COMMITS`	project ID, branch ref
项目语言占比	`GITLAB_GET_PROJECT_LANGUAGES`	project ID
列出流水线	`GITLAB_LIST_PROJECT_PIPELINES`	`id` , `status` , `ref`
获取流水线详情	`GITLAB_GET_SINGLE_PIPELINE`	`project_id` , `pipeline_id`
列出流水线作业	`GITLAB_LIST_PIPELINE_JOBS`	`id` , `pipeline_id` , `scope`
搜索用户	`GITLAB_GET_USERS`	`search` , `username` , `active`
获取用户详情	`GITLAB_GET_USER`	user ID
用户状态	`GITLAB_GET_USERS_ID_STATUS`	user ID
列出项目成员	`GITLAB_LIST_ALL_PROJECT_MEMBERS`	`id` , `query` , `state`
列出项目用户	`GITLAB_LIST_PROJECT_USERS`	`id` , `search`