InfoGrab DocsInfoGrab Docs

GitLab MCP 서버 도구

요약

이 기능에 대한 피드백을 제공하려면 이슈 630189에 댓글을 남깁니다. GitLab MCP 서버는 기존 GitLab 워크플로와 통합하는 도구 세트를 제공합니다. 각 도구는 툴셋에 속하며, 툴셋은 GitLab MCP 서버가 특정 연결에 해당 도구를 반환할지 결정합니다.

Warning

이 기능에 대한 피드백을 제공하려면 이슈 630189에 댓글을 남깁니다.

GitLab MCP 서버는 기존 GitLab 워크플로와 통합하는 도구 세트를 제공합니다. 이 도구를 사용하여 GitLab과 직접 상호 작용하고 일반적인 GitLab 작업을 수행할 수 있습니다.

각 도구는 툴셋에 속하며, 툴셋은 GitLab MCP 서버가 특정 연결에 해당 도구를 반환할지 결정합니다. 에이전트가 예상한 도구를 찾지 못하면 해당 툴셋이 활성화되어 있는지 확인합니다.

툴셋별 도구#

툴셋 도구
meta get_mcp_server_version
core get_project, save_project, get_user, get_group, list_groups, list_projects, list_project_members, list_todos, list_user_events, list_milestones, save_note, search, search_labels, semantic_search, get_pages_content
merge_requests save_merge_request, get_merge_request, list_merge_requests, get_merge_request_commits (목록 제외, 대체됨), get_merge_request_diffs (목록 제외, 대체됨), get_merge_request_pipelines (목록 제외, 대체됨), get_merge_request_conflicts (목록 제외, 대체됨), get_merge_request_notes (목록 제외, 대체됨), save_merge_request_review, accept_merge_request
work_items get_work_item, get_workitem_notes (목록 제외, 대체됨), get_work_item_types, link_work_items, get_saved_view_work_items, list_work_item_saved_views, save_work_item, list_work_items, create_issue (목록 제외, 대체됨), get_issue (목록 제외, 대체됨)
repository add_branch, fork_repository, list_branches, get_repository_file, list_repository_tree, get_commit, list_commits, list_releases, list_tags, add_commit
ci get_pipeline, get_pipeline_jobs (목록 제외, 대체됨), get_job, get_artifact_file, list_pipelines, list_pipeline_schedules, save_pipeline, save_pipeline_job, manage_pipeline (목록 제외, 대체됨)
duo_agent_platform list_duo_agents_and_flows, start_duo_session, list_duo_sessions, get_duo_session, send_duo_session_input
wikis list_wiki_pages
code_security list_vulnerabilities, get_vulnerability, save_vulnerability, attach_scan_profile
orbit Orbit tools

get_mcp_server_version#

히스토리

이 도구는 meta 툴셋에 속합니다.

GitLab MCP 서버의 현재 버전을 반환합니다.

예시:

What version of the GitLab MCP server am I connected to?

get_project#

히스토리
  • GitLab 19.4에서 도입.
  • GitLab 19.6에서 include 파라미터가 도입.

이 도구는 core 툴셋에 속합니다.

단일 GitLab 프로젝트의 메타데이터(숫자 ID, 전체 경로, 기본 브랜치, 공개 범위, 웹 URL)를 반환합니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트의 URL. url 또는 project_id 중 정확히 하나를 제공합니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url 또는 project_id 중 정확히 하나를 제공합니다.
include array 아니요 프로젝트와 함께 포함할 패싯. 호출당 하나: work_item_types.

프로젝트에 아직 리포지터리가 없으면 default_branch는 null입니다. 아직 이름을 알 수 없는 프로젝트를 찾으려면 projects 범위로 search를 사용합니다.

work_item_types 패싯은 프로젝트에서 사용할 수 있는 작업 항목 유형을 나열합니다. 각 유형에는 글로벌 ID, 이름, 아이콘, 해당 유형에서 활성화된 위젯 유형이 포함되므로, save_work_item을 호출할 때 해당 유형이 지원하지 않는 필드를 설정하지 않도록 할 수 있습니다.

예시:

What is the default branch of gitlab-org/gitlab?

save_project#

히스토리

이 도구는 core 툴셋에 속합니다.

지정한 네임스페이스(그룹 또는 사용자)에 새 GitLab 프로젝트를 만듭니다. 네임스페이스를 지정하지 않으면 인증된 사용자의 개인 네임스페이스에 프로젝트를 만듭니다.

파라미터 유형 필수 설명
name string 예 프로젝트 이름.
path string 아니요 프로젝트의 URL 슬러그. 기본값은 이름을 슬러그로 변환한 값입니다.
namespace_id integer 아니요 프로젝트를 만들 네임스페이스(그룹 또는 사용자)의 ID.
namespace_path string 아니요 네임스페이스의 전체 경로. namespace_id의 대안이며 둘 중 하나만 제공합니다.
description string 아니요 프로젝트 설명.
visibility string 아니요 공개 범위: private, internal, public 중 하나. 기본값은 인스턴스의 기본 프로젝트 공개 범위입니다.
initialize_with_readme boolean 아니요 초기 README.md 파일을 만듭니다.
default_branch string 아니요 기본 브랜치 이름. 기본값은 인스턴스의 기본값입니다.
topics array of strings 아니요 프로젝트의 토픽(태그) 목록.
template_name string 아니요 프로젝트 템플릿 이름. 기본 제공 템플릿(예: rails, spring, express)에는 단독으로 사용합니다. 사용자 지정 템플릿에는 use_custom_template과 함께 사용합니다.
template_project_id integer 아니요 사용자 지정 템플릿의 프로젝트 ID. template_name의 대안입니다. use_custom_template과 함께 사용합니다. Premium 및 Ultimate 전용.
use_custom_template boolean 아니요 사용자 지정 프로젝트 템플릿을 사용합니다. template_name 또는 template_project_id가 필요합니다. Premium 및 Ultimate 전용.
group_with_project_templates_id integer 아니요 그룹 수준 템플릿의 템플릿 소스 역할을 하는 그룹의 ID. 인스턴스 수준 템플릿에는 선택 사항입니다. Premium 및 Ultimate 전용.

예시:

Create a new private project called "my-app" in the gitlab-org group

add_commit#

히스토리
  • GitLab 19.3에서 도입.
  • GitLab 19.4에서 start_sha 및 start_project 파라미터가 도입.

이 도구는 repository 툴셋에 속합니다.

한 번의 호출로 하나 이상의 파일 작업을 포함한 커밋을 브랜치에 추가합니다.

파라미터 유형 필수 설명
commit_message string 예 커밋 메시지.
actions array of objects 예 하나의 배치로 커밋할 파일 작업.
branch string 예 커밋할 브랜치 이름.
project_id string 아니요 프로젝트의 ID 또는 경로. url을 제공하지 않으면 필수입니다.
url string 아니요 프로젝트의 GitLab URL. project_id를 제공하지 않으면 필수입니다.
start_branch string 아니요 새 브랜치를 시작할 브랜치 이름. branch가 존재하지 않으면 필수입니다.
start_sha string 아니요 새 브랜치를 시작할 커밋의 SHA. start_branch와 함께 사용할 수 없습니다.
start_project string 아니요 커밋을 시작할 프로젝트의 전체 경로. 해당 프로젝트 자신이거나 그 프로젝트가 포크된 원본 프로젝트여야 합니다.

actions의 각 객체는 다음 필드를 허용합니다.

필드 유형 필수 설명
action string 예 수행할 작업: create, update, delete, move, chmod 중 하나.
file_path string 예 파일의 전체 경로.
content string 아니요 파일 콘텐츠. create, update, move에서 사용합니다. old_str 및 new_str과 함께 사용할 수 없습니다.
old_str string 아니요 update 작업에서 교체할 기존 텍스트. new_str이 필요합니다.
new_str string 아니요 update 작업에서 old_str을 대체할 텍스트.
previous_path string 아니요 원래 파일 경로. move에서 필수입니다.
encoding string 아니요 content의 인코딩: text 또는 base64. 기본값은 text입니다.
last_commit_id string 아니요 낙관적 동시성 제어에 사용하는, 파일의 마지막으로 알려진 커밋 ID.
execute_filemode boolean 아니요 파일이 실행 가능한지 여부. chmod에서 필수입니다.

부분 편집은 old_str이 정확히 한 번 나타나는 위치만 교체합니다. 두 번 이상 나타나면 주변 컨텍스트를 더 많이 제공해야 합니다. 부분 편집은 서버에서 전체 파일을 읽으므로 10 MiB보다 큰 파일에서는 지원되지 않습니다. 더 큰 파일은 전체 파일 콘텐츠를 커밋합니다.

부분 편집은 바이너리 파일이나 LFS에 저장된 파일에서는 지원되지 않습니다.

예시:

In project gitlab-org/gitlab, create README.md on branch "docs-update"
with the content "# New title" and commit message "Add README"

create_issue#

히스토리

이 도구는 work_items 툴셋에 속합니다.

save_work_item으로 대체되었습니다. save_work_item은 마일스톤 제목과 레이블 이름을 같은 위치(프로젝트와 그 상위 그룹)에서 확인하지만, 찾을 수 없는 이름에는 더 엄격합니다. create_issue는 아직 없는 레이블 이름을 새로 만들고 알 수 없는 마일스톤 제목은 조용히 버리지만, save_work_item은 찾을 수 없는 항목을 명시한 오류를 반환합니다. 이 도구는 더 이상 tools/list에 나타나지 않지만, 호출자가 마이그레이션하는 동안에는 계속 호출할 수 있습니다.

GitLab 프로젝트에 새 이슈를 만듭니다.

파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
title string 예 이슈 제목.
description string 아니요 이슈 설명.
assignee_ids array of integers 아니요 배정된 사용자 ID 배열.
milestone_id integer 아니요 마일스톤 ID.
labels array of strings 아니요 레이블 이름 배열.
confidential boolean 아니요 이슈를 기밀로 설정합니다. 기본값은 false.
epic_id integer 아니요 연결된 에픽의 ID.

예시:

Create a new issue titled "Fix login bug" in project 123 with description
"Users cannot log in with special characters in password"

get_issue#

히스토리

이 도구는 work_items 툴셋에 속합니다.

이슈와 다른 작업 항목 유형을 모두 다루는 get_work_item으로 대체되었습니다. 이 도구는 더 이상 tools/list에 나타나지 않지만, 호출자가 마이그레이션하는 동안에는 계속 호출할 수 있습니다.

특정 GitLab 이슈에 대한 자세한 정보를 가져옵니다.

파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
issue_iid integer 예 이슈의 내부 ID.

예시:

Get details for issue 42 in project 123

save_merge_request#

히스토리
  • GitLab 18.5에서 create_merge_request로 도입.
  • GitLab 18.8에서 assignee_ids, reviewer_ids, description, labels, milestone_id가 추가.
  • GitLab 19.3에서 save_merge_request로 이름이 변경되고 머지 리퀘스트를 업데이트하도록 확장되었습니다. create_merge_request와 update_merge_request 이름은 별칭으로 유지됩니다.

이 도구는 merge_requests 툴셋에 속합니다.

GitLab 프로젝트에서 머지 리퀘스트를 만들거나 업데이트합니다. merge_request_iid의 유무로 작업이 결정됩니다. 생략하면 머지 리퀘스트를 만들고, 제공하면 기존 머지 리퀘스트를 업데이트합니다.

파라미터 유형 필수 설명
project_id string 예 프로젝트의 ID 또는 전체 경로.
merge_request_iid integer 아니요 머지 리퀘스트의 내부 ID. 기존 머지 리퀘스트를 업데이트하려면 제공하고, 만들려면 생략합니다.
title string 아니요 머지 리퀘스트 제목. 만들 때 필수입니다.
source_branch string 아니요 소스 브랜치 이름. 만들 때 필수입니다.
target_branch string 아니요 대상 브랜치 이름. 만들 때 필수입니다.
target_project_id integer 아니요 대상 프로젝트의 ID. 만들 때 적용됩니다.
description string 아니요 머지 리퀘스트 설명.
labels array of strings 아니요 레이블 이름. 기존 레이블을 모두 교체합니다. 모든 레이블을 제거하려면 빈 배열을 전달합니다.
add_labels array of strings 아니요 추가할 레이블 이름. 업데이트할 때 적용됩니다.
remove_labels array of strings 아니요 제거할 레이블 이름. 업데이트할 때 적용됩니다.
assignees array of strings 아니요 배정할 사용자 이름. assignee_ids의 대안이며 둘 중 하나만 제공합니다. 모든 담당자를 제거하려면 빈 배열을 전달합니다.
assignee_ids array of integers 아니요 배정할 사용자 ID. assignees의 대안이며 둘 중 하나만 제공합니다. 모든 담당자를 제거하려면 빈 배열을 전달합니다.
reviewers array of strings 아니요 리뷰를 요청할 사용자 이름. reviewer_ids의 대안이며 둘 중 하나만 제공합니다. 모든 리뷰어를 제거하려면 빈 배열을 전달합니다.
reviewer_ids array of integers 아니요 리뷰를 요청할 사용자 ID. reviewers의 대안이며 둘 중 하나만 제공합니다. 모든 리뷰어를 제거하려면 빈 배열을 전달합니다.
milestone_id integer 아니요 마일스톤 ID.
milestone string 아니요 배정할 프로젝트 또는 상위 그룹 마일스톤의 제목. milestone_id와 함께 사용할 수 없습니다.
remove_source_branch boolean 아니요 머지 리퀘스트가 머지될 때 소스 브랜치를 제거합니다.
squash boolean 아니요 머지할 때 커밋을 하나의 커밋으로 스쿼시합니다.
state_event string 아니요 수행할 상태 전환. close 또는 reopen 중 하나. 업데이트할 때 적용됩니다.
discussion_locked boolean 아니요 머지 리퀘스트 토론을 잠급니다. 업데이트할 때 적용됩니다.
allow_collaboration boolean 아니요 대상 브랜치에 머지할 수 있는 멤버의 커밋을 허용합니다. 업데이트할 때 적용됩니다.

예시:

Create a merge request in project gitlab-org/gitlab titled "Bug fix broken specs"
from branch "fix/specs-broken" into "master" and enable squash
Update merge request 42 in project gitlab-org/gitlab to add the "bug" label and close it

get_merge_request#

히스토리
  • GitLab 18.4에서 도입.
  • GitLab 19.3에서 url을 받고 연관 데이터 패싯을 반환하도록 변경.
  • GitLab 19.6에서 호출당 둘 이상의 include 패싯을 받도록 변경.

이 도구는 merge_requests 툴셋에 속합니다.

머지 리퀘스트를 가져오며, 선택적으로 diff, 커밋, 노트, 파이프라인, 토론, 승인, 충돌도 가져옵니다. include 파라미터로 연관 데이터를 요청하지 않으면 기본 머지 리퀘스트만 반환됩니다.

파라미터 유형 필수 설명
url string 아니요 머지 리퀘스트의 GitLab URL. 이것을 제공하거나 project_id와 merge_request_iid를 제공합니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url이 없으면 필수입니다.
merge_request_iid integer 아니요 머지 리퀘스트의 내부 ID. url이 없으면 필수입니다.
include array 아니요 머지 리퀘스트와 함께 반환할 연관 패싯. diffs, commits, notes, pipelines, discussions, approvals, conflicts 중 하나 이상. 한 번의 호출에서 여러 패싯을 요청할 수 있습니다.
detail string 아니요 diff 상세 수준. 요약 개수만 반환하는 none, 파일별 추가 및 삭제 수를 반환하는 stats, 파일별 패치 텍스트와 파일별 통계를 반환하는 full_patch 중 하나. 기본값은 stats입니다. include에 diffs가 포함된 경우에만 적용됩니다. include에 다른 패싯이 있으면 full_patch로 설정할 수 없습니다.
diffs_after string 아니요 파일의 정방향 페이지네이션용 커서. include에 diffs가 포함되고 detail이 full_patch 일 때만 적용됩니다.
diffs_first integer 아니요 커서 이후로 반환할 파일 수(최대 100). include에 diffs가 포함되고 detail이 full_patch 일 때만 적용됩니다.
notes_after string 아니요 노트의 정방향 페이지네이션용 커서. include에 notes가 포함된 경우에만 적용됩니다.
notes_first integer 아니요 커서 이후로 반환할 노트 수(최대 100). include에 notes가 포함된 경우에만 적용됩니다.
notes_before string 아니요 노트의 역방향 페이지네이션용 커서. include에 notes가 포함된 경우에만 적용됩니다.
notes_last integer 아니요 커서 이전으로 반환할 노트 수(최대 100). include에 notes가 포함된 경우에만 적용됩니다.
commits_after string 아니요 커밋의 정방향 페이지네이션용 커서. include에 commits가 포함된 경우에만 적용됩니다.
commits_first integer 아니요 커서 이후로 반환할 커밋 수(최대 100). include에 commits가 포함된 경우에만 적용됩니다.
pipelines_after string 아니요 파이프라인의 정방향 페이지네이션용 커서. include에 pipelines가 포함된 경우에만 적용됩니다.
pipelines_first integer 아니요 커서 이후로 반환할 파이프라인 수(최대 100). include에 pipelines가 포함된 경우에만 적용됩니다.

diffs 패싯은 기본적으로 변경 통계를 반환합니다. 전체 합계와 파일별 추가 및 삭제 수입니다. 패치 텍스트를 가져오려면 detail을 full_patch로 설정합니다.

commits와 pipelines 패싯은 호출당 최대 100개 항목을 반환합니다. 각 응답에는 pageInfo.hasNextPage와 pageInfo.endCursor가 포함됩니다. 다음 페이지를 읽으려면 그 커서를 commits_after 또는 pipelines_after로 다시 전달합니다.

notes 패싯은 notes_last와 notes_before로 역방향 페이지네이션도 지원합니다. 최신 노트를 읽으려면 notes_first나 notes_after 없이 notes_last를 전달합니다. 한 번의 호출에서 두 방향을 함께 사용하면 오류가 반환됩니다. 각 노트는 position(diff 댓글의 파일과 줄)과 discussion(노트가 속한 스레드와 스레드의 해결 여부)을 반환합니다. 응답에는 resolvedDiscussionsCount와 resolvableDiscussionsCount도 포함됩니다.

conflicts 패싯은 Git 충돌 마커를 포함한 원시 충돌 파일 콘텐츠를 반환합니다. 머지 리퀘스트를 머지할 수 없고 소스 브랜치에 푸시할 수 있는 경우에만 사용할 수 있으며, 머지 가능 여부를 확인하기 전에는 null입니다. 상태를 확인하려면 기본 conflicts 필드를 읽습니다.

예시:

Get merge request 15 in project gitlab-org/gitlab with its commits

list_duo_agents_and_flows#

히스토리

이 도구는 duo_agent_platform 툴셋에 속합니다.

프로젝트에서 사용하도록 설정된 GitLab Duo 에이전트와 플로를 나열합니다. 플로 이름을 추측하지 않고 사용 가능한 항목을 확인할 수 있습니다. 프로젝트가 제공하는 에이전트와 플로는 프로젝트별로 구성되며 ID는 프로젝트마다 다릅니다.

각 항목에는 can_start_session이 포함됩니다. 실행 권한이 있는 플로는 true이고, 프로젝트에서 CI 세션을 실행할 수 있는 경우 기본 제공 채팅 에이전트도 true입니다. 기본 GitLab Duo 에이전트, 다른 에이전트, 외부 에이전트는 확인용으로만 나열되며 can_start_session은 항상 false입니다. 실행할 수 없는 플로나 버전이 릴리스되지 않았거나 아직 초안인 플로도 false입니다.

GitLab Ultimate 구독이 없으면 Ultimate가 필요한 기본 제공 채팅 에이전트는 목록에 나타나지 않거나 can_start_session이 false로 설정된 채 나타납니다.

can_start_session이 true인 플로에만 start_duo_session이 받는 ai_catalog_item_consumer_id가 포함됩니다. 기본 제공 채팅 에이전트를 시작하려면 해당 workflow_definition을 agent로 전달합니다. 설명은 잘릴 수 있습니다.

목록에는 프로젝트에 구성된 에이전트, 플로, 외부 에이전트와 기본 제공 채팅 에이전트가 포함됩니다. 채팅 에이전트는 페이지네이션되는 프로젝트 결과에 속하지 않는 고정 목록이므로 첫 페이지에서만 반환되며, 에이전트를 포함하지 않으면 생략됩니다. 이들은 first와 별도로 추가되므로 첫 페이지에 요청한 것보다 많은 항목이 포함될 수 있습니다. 이들에는 ai_catalog_item_consumer_id 대신 workflow_definition이 있으며, 표시 이름이 GitLab Duo로 같은 두 에이전트도 이것으로 구별합니다. 프로젝트에 구성된 항목은 workflow_definition이 null입니다.

기본 제공 채팅 에이전트는 프로젝트가 아니라 GitLab.com에서는 프로젝트의 최상위 그룹이, GitLab Self-Managed에서는 조직이 관리합니다.

파라미터 유형 필수 설명
project_id string 예 에이전트와 플로를 나열할 프로젝트의 숫자 ID 또는 전체 경로.
item_type string 아니요 agent, flow, third_party_flow 항목만 반환합니다. 생략하면 모든 종류를 반환합니다.
after string 아니요 정방향 페이지네이션용 커서.
first integer 아니요 정방향 페이지네이션으로 반환할 에이전트와 플로 수. 기본값은 20, 최댓값은 100입니다.

각 호출은 결과의 한 페이지를 반환합니다. 페이지가 더 있으면 응답에 pageInfo.endCursor가 포함되며, 이를 after로 전달할 수 있습니다.

구성되어 있지만 사용 중지된 항목은 페이지를 가져온 뒤에 제외되므로, pageInfo.hasNextPage가 여전히 true인데도 페이지에 first보다 적은 항목이 있거나 항목이 하나도 없을 수 있습니다. 빈 페이지에서 멈추지 말고 hasNextPage가 false가 될 때까지 계속 페이지를 넘깁니다.

예시:

Which Duo flows can I run in gitlab-org/gitlab?

start_duo_session#

히스토리

이 도구는 duo_agent_platform 툴셋에 속합니다.

프로젝트에서 목표를 달성하기 위해 비동기 GitLab Duo Agent Platform 세션을 시작합니다. workflow_id를 즉시 반환합니다. 해당 ID로 get_duo_session을 사용하여 진행 상황을 추적하고 최종 결과를 가져옵니다.

이 도구는 GitLab Duo Agent Platform을 사용할 수 있는 경우에만 나열됩니다. 자세한 내용은 도구 그룹 선택을 참고합니다.

세션은 커밋을 푸시하고 머지 리퀘스트를 열 수 있는 CI job에서 실행됩니다.

url 또는 project_id 중 정확히 하나를 제공합니다. flow, flow_item_id, ai_catalog_item_consumer_id, agent 중에서는 최대 하나만 제공합니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트의 전체 GitLab URL(예: https://gitlab.com/group/project). project_id와 함께 사용하지 않습니다.
project_id string 아니요 프로젝트의 숫자 ID 또는 전체 경로(예: gitlab-org/gitlab). url과 함께 사용하지 않습니다.
goal string 예 세션의 자연어 목표(예: Fix the flaky spec in issue #1234 and open a merge request). 일부 플로는 URL을 받습니다. 예를 들어 fix_pipeline/v1은 실패한 파이프라인의 URL을 받습니다.
flow string 아니요 기본 제공 플로 참조(예: developer/v1, fix_pipeline/v1). 플로나 에이전트를 지정하지 않으면 기본값은 developer/v1입니다. flow_item_id, ai_catalog_item_consumer_id, agent와 함께 사용하지 않습니다.
flow_item_id integer 아니요 프로젝트에서 사용하도록 설정된 사용자 지정 플로의 AI Catalog 항목 ID. 릴리스된 최신 버전이 실행됩니다. flow, ai_catalog_item_consumer_id, agent와 함께 사용하지 않습니다.
ai_catalog_item_consumer_id integer 아니요 실행할 플로를 구성하는 AI Catalog 항목 소비자의 ID. list_duo_agents_and_flows로 찾습니다. flow, flow_item_id, agent와 함께 사용하지 않습니다.
agent string 아니요 실행할 기본 제공 에이전트의 참조(예: analytics_agent/v1). 기본 GitLab Duo 에이전트는 시작할 수 없습니다. flow, flow_item_id, ai_catalog_item_consumer_id와 함께 사용하지 않습니다.

플로는 프로젝트 또는 프로젝트의 상위 그룹에서 사용하도록 설정되어 있어야 합니다. 플로가 사용하도록 설정되어 있지 않으면 도구가 오류를 반환합니다.

기능 플래그 뒤에 있는 플로는 해당 플래그가 활성화된 경우에만 실행됩니다. 플로가 이 조건을 충족하지 않으면 도구가 오류를 반환합니다.

일부 플로는 특정 형식의 목표를 기대하며, 도구는 세션을 시작하기 전에 형식을 확인합니다:

  • fix_pipeline/v1은 같은 프로젝트에서 실패한 파이프라인의 URL을 기대합니다. 세션은 파이프라인의 브랜치에서 실행됩니다. 파이프라인이 열려 있는 머지 리퀘스트에 속하면 플로는 해당 머지 리퀘스트에 수정 제안을 게시합니다. 그렇지 않으면 수정 내용으로 새 머지 리퀘스트를 엽니다. 목표가 프로젝트의 파이프라인이 아니면 도구가 오류를 반환하고 세션을 시작하지 않습니다.
  • code_review/v1은 머지 리퀘스트의 URL 또는 IID를 기대합니다. 세션은 머지 리퀘스트의 소스 브랜치에서 실행됩니다.

이 브랜치와 머지 리퀘스트는 GitLab UI의 파이프라인이나 머지 리퀘스트에서 플로를 시작할 때 플로가 사용하는 것과 같습니다.

기본 제공 플로를 시작하려면 flow를 사용합니다. 기본 제공 플로의 AI Catalog 항목 ID를 flow_item_id에 전달하면, 도구가 대신 사용할 flow 값을 알려 주는 오류를 반환합니다. 기본 제공 에이전트의 참조를 flow에 전달하면, 도구가 대신 사용할 agent 값을 알려 주는 오류를 반환합니다.

응답에는 get_duo_session을 호출하기 전에 얼마나 기다릴지에 대한 힌트로 poll_after_seconds가 포함됩니다.

예시:

Fix the flaky spec in issue #1234 and open an MR in gitlab-org/gitlab

list_duo_sessions#

히스토리
  • GitLab 19.3에서 도입.
  • GitLab 19.5에서 statuses 파라미터를 받도록 변경.

이 도구는 duo_agent_platform 툴셋에 속합니다.

Duo Chat 세션을 제외한 GitLab Duo Agent Platform 세션을 나열합니다. 각 세션에는 개별 상태, 목표 미리보기, 플로 정의, 생성 타임스탬프가 포함됩니다. 프로젝트 및 그룹 세션에는 세션 URL도 포함됩니다. 목표 미리보기는 잘릴 수 있습니다.

파라미터 유형 필수 설명
url string 아니요 세션을 필터링할 프로젝트의 GitLab URL. project_id와 함께 사용하지 않습니다.
project_id string 아니요 세션을 필터링할 프로젝트의 숫자 ID 또는 전체 경로. url과 함께 사용하지 않습니다.
status_group string 아니요 세션 상태 그룹. active, paused, awaiting_input, completed, failed, canceled 중 하나.
statuses array 아니요 세션 상태. created, running, paused, finished, failed, stopped, input_required, plan_approval_required, tool_call_approval_required, idle 중 하나 이상. status_group과 함께 사용하지 않습니다.
after string 아니요 정방향 페이지네이션용 커서.
first integer 아니요 정방향 페이지네이션으로 반환할 세션 수. 기본값은 20, 최댓값은 100입니다.

status_group 필터는 여러 개별 상태의 세션을 반환할 수 있습니다. 정확히 일치하는 하나 이상의 상태로 필터링하려면 대신 statuses를 사용합니다. 각 호출은 결과의 한 페이지를 반환합니다. 페이지가 더 있으면 응답에 pageInfo.endCursor가 포함되며, 이를 after로 전달할 수 있습니다.

예시:

List my active Duo Agent Platform sessions in gitlab-org/gitlab

get_duo_session#

히스토리
  • GitLab 19.4에서 도입. get_duo_workflow_status도 별칭으로 사용할 수 있습니다.
  • GitLab 19.5에서 세션이 만든 머지 리퀘스트, 작업 항목, 댓글을 반환하고, 상태에 따라 폴링 지연 시간을 달리하며, list_duo_sessions와 일치하도록 status를 밑줄로 보고(input required가 아니라 input_required)하도록 변경.
  • GitLab 19.5에서 실패한 세션이 실패한 이유와 해당 CI job 링크를 반환하도록 변경.

이 도구는 duo_agent_platform 툴셋에 속합니다.

GitLab Duo Agent Platform 세션의 상태를 확인합니다. 실행 중인 세션에는 권장 폴링 지연 시간이 포함되며, 세션이 CI job 시작을 기다리는 동안에는 이 지연 시간이 더 깁니다. 완료된 세션과 완료된 채팅 턴에는 에이전트의 최신 답변이 포함됩니다. 세션이 만든 머지 리퀘스트, 작업 항목, 댓글은 생성되는 즉시 created_merge_requests, created_work_items, created_notes로 포함됩니다. 각각은 배열이며, 해당 종류를 만들지 않았으면 비어 있고 최신 항목 최대 20개만 담습니다. 목록이 잘리면 artifacts_truncated가 잘린 목록을 알려 주고 artifact_limit가 상한을 알려 줍니다. 머지 리퀘스트의 모든 댓글을 페이지별로 확인하려면 include: ["notes"]와 함께 get_merge_request를 사용합니다. 승인을 기다리는 세션에는 send_duo_session_input으로 세션을 계속하는 방법에 대한 안내가 포함됩니다.

실패한 세션에는 다음도 포함됩니다:

  • failure_reason: 실패에 대해 기록된 이유. 기록된 이유가 없으면 null.
  • job_url: 세션을 실행한 CI job. CI job이 실행되지 않았거나 해당 로그를 읽을 수 없으면 null.

세션이 에이전트를 시작하기 전에 실패한 경우 응답은 변경 사항이 없으며 다시 시작할 수 있다고 알려 줍니다. 30일이 지난 세션에는 이 메시지가 포함되지 않습니다. 30일이 지난 체크포인트는 보관되지 않으므로, 도구는 에이전트가 세션을 실행했는지 식별할 수 없습니다.

파라미터 유형 필수 설명
workflow_id integer 예 Duo 세션의 ID. start_duo_session 또는 list_duo_sessions가 반환한 값.

예시:

Check the status of Duo session 42

send_duo_session_input#

히스토리

이 도구는 duo_agent_platform 툴셋에 속합니다.

입력을 기다리는 GitLab Duo Agent Platform 세션에 응답합니다. 대기 중인 계획이나 도구 호출을 승인하거나 거부하고, 에이전트가 한 질문에 답합니다. ai_catalog_item_consumer_id로 시작한 세션과 agent로 시작한 세션에서 작동합니다. 세션은 마지막 CI job이 끝난 뒤에 입력을 받으며, 상태가 input_required, plan_approval_required, tool_call_approval_required 중 무엇이든 대기 중이면 받을 수 있습니다.

세션은 CI job에서 계속됩니다. 응답에는 권장 폴링 지연 시간이 포함됩니다. 진행 상황을 확인하려면 같은 workflow_id로 get_duo_session을 사용합니다.

파라미터 유형 필수 설명
workflow_id integer 예 Duo 세션의 ID. list_duo_sessions 또는 get_duo_session이 반환한 값.
human_approval boolean 예 true는 대기 중인 계획이나 도구 호출을 승인합니다. true와 함께 human_message를 포함하지 않습니다. 포함하면 세션을 재개하는 대신 도구가 호출을 거부합니다. false는 거부합니다. 에이전트가 사용자의 피드백으로 계속하도록 human_message를 포함합니다. 포함하지 않으면 에이전트는 진행하지 말라는 안내를 받고 세션은 계속됩니다.
human_message string 아니요 에이전트에 대한 피드백 또는 세션이 질문을 했을 때의 답변(최대 2000자). human_approval=false와 함께 제공합니다. human_approval=true와 함께 제공하면 세션을 재개하는 대신 도구가 호출을 거부합니다.

예시:

Approve the plan for Duo session 42
Reject the plan for Duo session 42 and ask it to also add tests

list_merge_requests#

히스토리
  • GitLab 19.3에서 도입.
  • GitLab 19.4에서 group_id 파라미터와 그룹 범위가 추가.

이 도구는 merge_requests 툴셋에 속합니다.

GitLab 프로젝트 또는 그룹의 머지 리퀘스트를 나열하거나 검색하며, 간략한 머지 리퀘스트 메타데이터를 반환합니다. 그룹 범위는 항상 그룹과 그 하위 그룹에 속한 모든 프로젝트의 머지 리퀘스트를 포함하지만, 보관된 프로젝트의 머지 리퀘스트는 제외합니다. 그룹 결과에는 get_merge_request에서 사용할 수 있도록 각 머지 리퀘스트를 소유한 프로젝트 경로도 포함됩니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트 또는 그룹의 GitLab URL. url, project_id, group_id 중 정확히 하나를 제공합니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url, project_id, group_id 중 정확히 하나를 제공합니다.
group_id string 아니요 그룹의 ID 또는 전체 경로. url, project_id, group_id 중 정확히 하나를 제공합니다.
author_username string 아니요 머지 리퀘스트 작성자의 사용자 이름으로 필터링합니다.
assignee_username string 아니요 담당자의 사용자 이름으로 필터링합니다.
reviewer_username string 아니요 리뷰어의 사용자 이름으로 필터링합니다.
state string 아니요 상태로 필터링합니다. opened, closed, merged, locked, all 중 하나. 생략하면 모든 상태를 포함합니다.
scope string 아니요 인증된 사용자를 기준으로 필터링합니다. created_by_me, assigned_to_me, review_requested 중 하나. 명시적으로 지정한 사용자 이름이 해당 필드에서 우선합니다.
milestone string 아니요 마일스톤 제목으로 필터링합니다.
labels string 아니요 쉼표로 구분한 레이블 이름 목록. 이 레이블을 모두 가진 머지 리퀘스트만 반환됩니다.
search string 아니요 머지 리퀘스트 제목과 설명에서 일치를 찾는 검색어.
after string 아니요 정방향 페이지네이션용 커서.
first integer 아니요 정방향 페이지네이션으로 반환할 머지 리퀘스트 수. 기본값은 20, 최댓값은 100입니다.

단일 머지 리퀘스트의 전체 상세 정보를 가져오려면 get_merge_request를 사용합니다. 커밋을 가져오려면 include: ["commits"]와 함께 get_merge_request를 사용합니다. diff나 노트는 include: ["diffs"] 또는 include: ["notes"]를 사용합니다. 패치 텍스트를 가져오려면 detail도 full_patch로 설정합니다. 리소스 유형 전반에 걸친 전체 텍스트 검색에는 search를 사용합니다.

예시:

List my open merge requests in gitlab-org/gitlab

get_merge_request_commits#

히스토리

이 도구는 merge_requests 툴셋에 속합니다.

include: ["commits"]와 함께 사용하는 get_merge_request로 대체되었습니다. 이 도구는 더 이상 tools/list에 나타나지 않지만, 호출자가 마이그레이션하는 동안에는 계속 호출할 수 있습니다.

특정 GitLab 머지 리퀘스트의 커밋 목록을 가져옵니다.

파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
merge_request_iid integer 예 머지 리퀘스트의 내부 ID.
per_page integer 아니요 페이지당 커밋 수.
page integer 아니요 현재 페이지 번호.

예시:

Show me all commits in merge request 42 from project 123

get_merge_request_diffs#

히스토리

이 도구는 merge_requests 툴셋에 속합니다.

include: ["diffs"]와 함께 사용하는 get_merge_request로 대체되었습니다. 원시 패치 텍스트가 필요하면 detail: full_patch도 전달합니다. 이 도구는 더 이상 tools/list에 나타나지 않지만, 호출자가 마이그레이션하는 동안에는 계속 호출할 수 있습니다.

특정 GitLab 머지 리퀘스트의 diff를 가져옵니다.

파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
merge_request_iid integer 예 머지 리퀘스트의 내부 ID.
per_page integer 아니요 페이지당 diff 수.
page integer 아니요 현재 페이지 번호.

예시:

What files were changed in merge request 25 in the gitlab project?

get_merge_request_pipelines#

히스토리

이 도구는 merge_requests 툴셋에 속합니다.

include: ["pipelines"]와 함께 사용하는 get_merge_request로 대체되었습니다. 이 도구는 더 이상 tools/list에 나타나지 않지만, 호출자가 마이그레이션하는 동안에는 계속 호출할 수 있습니다.

특정 GitLab 머지 리퀘스트의 파이프라인을 가져옵니다.

파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
merge_request_iid integer 예 머지 리퀘스트의 내부 ID.

예시:

Show me all pipelines for merge request 42 in project gitlab-org/gitlab

get_merge_request_conflicts#

히스토리

이 도구는 merge_requests 툴셋에 속합니다.

include: ["conflicts"]와 함께 사용하는 get_merge_request로 대체되었습니다. 이 방식은 아래의 일반 텍스트 대신 같은 충돌을 ourPath와 theirPath 필드가 분리된 구조화된 conflictFiles 항목으로 반환합니다. 이 도구는 더 이상 tools/list에 나타나지 않지만, 호출자가 마이그레이션하는 동안에는 계속 호출할 수 있습니다.

머지할 수 없는 머지 리퀘스트의 머지 충돌 콘텐츠를 가져옵니다. 충돌이 발생한 파일에 나타나는 그대로 원시 Git 충돌 마커(<<<<<<<, =======, >>>>>>>)를 반환합니다. 각 파일의 콘텐츠는 # File: 제목 아래에 그룹화됩니다. 이름이 변경된 파일은 제목에 각 브랜치의 경로가 표시됩니다.

파라미터 유형 필수 설명
project_id string 예 프로젝트의 ID 또는 전체 경로(예: gitlab-org/gitlab).
merge_request_iid integer 예 머지 리퀘스트의 내부 ID.

머지 리퀘스트의 소스 브랜치에 푸시할 수 있는 권한이 있어야 합니다. 머지 리퀘스트에 충돌이 없거나, 머지 가능 여부를 아직 확인하지 않았거나, 브랜치 또는 diff ref가 없으면 도구가 오류를 반환합니다.

예시:

Show the conflicts for merge request 42 in project gitlab-org/gitlab

save_note#

히스토리
  • GitLab 19.2에서 도입.
  • GitLab 19.4에서 create_merge_request_note 및 create_workitem_note 도구를 대체. 두 원래 도구 이름은 별칭으로 계속 작동합니다.
  • GitLab 19.5에서 method 및 resolved 파라미터가 추가. body는 더 이상 모든 호출에 필수가 아닙니다.

이 도구는 core 툴셋에 속합니다.

인증된 사용자로서 GitLab 머지 리퀘스트나 작업 항목에 댓글을 추가하거나, 기존 토론 스레드에 답글을 달거나, 토론 스레드를 해결하거나 해결을 취소합니다.

파라미터 유형 필수 설명
url string 아니요 머지 리퀘스트 또는 작업 항목의 URL. URL이 대상 유형을 결정합니다.
project_id string 아니요 프로젝트의 ID 또는 경로. merge_request_iid와 함께, 그리고 프로젝트 수준 작업 항목에는 work_item_iid와 함께 필수입니다.
group_id string 아니요 그룹의 ID 또는 경로. 그룹 수준 작업 항목에는 work_item_iid와 함께 필수입니다.
merge_request_iid integer 아니요 머지 리퀘스트의 내부 ID. project_id와 함께 제공합니다. work_item_iid와 함께 사용할 수 없습니다.
work_item_iid integer 아니요 작업 항목의 내부 ID. project_id 또는 group_id와 함께 제공합니다. merge_request_iid와 함께 사용할 수 없습니다.
method string 아니요 수행할 쓰기 작업: create_note, reply_discussion, resolve_discussion1 중 하나. 기본값은 create_note이며, discussion_id를 지정하면 reply_discussion입니다. 선택한 메서드에 나열된 파라미터만 채우며, 다른 파라미터는 거부됩니다.
body string 아니요 노트의 콘텐츠. create_note와 reply_discussion에서 필수입니다. 퀵 액션(예: /merge)이 실행되지 않도록 줄은 /로 시작할 수 없습니다.
internal boolean 아니요 노트를 내부용으로 표시합니다(Reporter 권한 이상의 멤버에게만 표시됨). 기본값은 false입니다.
discussion_id string 아니요 답글을 달 토론(reply_discussion) 또는 해결하거나 해결을 취소할 토론(resolve_discussion). 글로벌 ID(gid://gitlab/Discussion/<id> 형식) 또는 토론 ID만 사용할 수 있습니다. 없으면 새 최상위 노트를 만듭니다.
resolved boolean 아니요 true는 토론을 해결하고, false는 해결을 취소합니다. resolve_discussion에서 필수입니다.

예시:

  • 머지 리퀘스트에 댓글 달기:

    Reply "Thanks, fixed in the latest push" to merge request 42 in project gitlab-org/gitlab
    
  • 작업 항목에 댓글 달기:

    Add a comment "This looks good to me" to work item 42 in project gitlab-org/gitlab
    
  • 작업 항목의 토론 해결하기:

    Resolve the open discussion about the acceptance criteria on work item 42 in project gitlab-org/gitlab
    

get_merge_request_notes#

히스토리

이 도구는 merge_requests 툴셋에 속합니다.

include: ["notes"]와 함께 사용하는 get_merge_request로 대체되었습니다. 이 도구는 더 이상 tools/list에 나타나지 않지만, 호출자가 마이그레이션하는 동안에는 계속 호출할 수 있습니다.

특정 GitLab 머지 리퀘스트의 노트(댓글과 시스템 노트)를 가져옵니다.

파라미터 유형 필수 설명
url string 아니요 GitLab 머지 리퀘스트의 URL. project_id와 merge_request_iid가 없으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url이 없으면 필수입니다.
merge_request_iid integer 아니요 머지 리퀘스트의 내부 ID. url이 없으면 필수입니다.
after string 아니요 정방향 페이지네이션용 커서.
before string 아니요 역방향 페이지네이션용 커서.
first integer 아니요 정방향 페이지네이션으로 반환할 노트 수.
last integer 아니요 역방향 페이지네이션으로 반환할 노트 수.

반환되는 각 노트에는 토론 ID가 포함되므로, 관련 노트를 스레드로 그룹화할 수 있습니다.

예시:

Show me all comments on merge request 5 in project gitlab-org/gitlab

save_merge_request_review#

히스토리
  • GitLab 19.4에서 도입.
  • GitLab 19.6에서 update_note 메서드가 도입.

이 도구는 merge_requests 툴셋에 속합니다.

인증된 사용자로서 머지 리퀘스트 리뷰 산출물을 작성합니다. 각 호출은 method 파라미터로 선택한 정확히 하나의 작업을 수행합니다.

메서드 동작
create_note 최상위 댓글을 추가합니다.
reply_discussion 기존 토론에 답글을 답니다.
create_diff_note 특정 diff 줄에 댓글을 답니다.
resolve_discussion 토론을 해결하거나 해결을 취소합니다.
update_note 머지 리퀘스트에 있는 노트의 텍스트를 교체합니다. 노트 작성자이거나 최소 Maintainer 권한이 있어야 합니다.
submit_review 여러 diff 댓글과 선택적 요약을 한 번의 호출로 게시합니다.
post_duo_review GitLab Duo에 머지 리퀘스트 리뷰를 요청합니다. GitLab Duo Code Review가 필요합니다.
approve 머지 리퀘스트를 승인합니다. 이미 승인한 상태에서 호출해도 already_approved 상태로 성공합니다.
unapprove 본인의 승인을 제거합니다. 이전에 승인하지 않은 상태에서 호출해도 not_approved 상태로 성공합니다.

post_duo_review, approve, unapprove의 응답에는 머지 리퀘스트의 현재 diff_head_sha가 포함되므로, 기존 승인이나 리뷰가 최신 커밋을 여전히 포함하는지 확인할 수 있습니다.

파라미터 유형 필수 설명
url string 아니요 GitLab 머지 리퀘스트의 URL 또는 #note_<id>로 끝나는 댓글 링크. project_id와 merge_request_iid가 없으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 경로. url이 없으면 필수입니다.
merge_request_iid integer 아니요 머지 리퀘스트의 내부 ID. url이 없으면 필수입니다.
method string 예 수행할 작업. 다른 메서드에 속한 파라미터는 거부됩니다.
body string 아니요 노트 텍스트. create_note, reply_discussion, create_diff_note, update_note에서 필수입니다. 퀵 액션(예: /merge)이 실행되지 않도록 줄은 /로 시작할 수 없습니다.
discussion_id string 아니요 작업할 토론. reply_discussion과 resolve_discussion에서 필수입니다. 글로벌 ID 또는 토론 ID만 사용할 수 있습니다.
note_id integer 아니요 작업할 노트. url에 댓글 앵커(#note_<id>)가 없으면 update_note에서 필수입니다. create_note가 반환한 정수 노트 ID를 사용할 수 있습니다. get_merge_request와 include: ["notes"]로 찾은 노트를 편집하려면 해당 노트의 webUrl을 url로 전달합니다. 노트는 지정한 머지 리퀘스트에 속해야 합니다. 머지 리퀘스트의 커밋에 달린 댓글은 지원되지 않습니다.
internal boolean 아니요 create_note에서 노트를 내부용으로 표시합니다.
resolved boolean 아니요 resolve_discussion에서 true는 해결, false는 해결 취소입니다. 해당 메서드에서 필수입니다.
old_path string 아니요 create_diff_note에서 변경 전 파일 경로. old_path 또는 new_path 중 하나 또는 둘 다 제공합니다.
new_path string 아니요 create_diff_note에서 변경 후 파일 경로.
old_line integer 아니요 create_diff_note에서 이전 버전의 줄 번호. old_line 또는 new_line 중 하나 또는 둘 다 제공합니다.
new_line integer 아니요 create_diff_note에서 새 버전의 줄 번호.
comments array 아니요 submit_review에서 1~20개의 diff 댓글. 각 항목은 file과 body(필수), old_line, new_line, suggestion(선택)을 받습니다. 해당 메서드에서 필수입니다. file은 변경 후 경로이며, 이름이 변경된 파일에는 대신 create_diff_note를 사용합니다.
verdict string 아니요 submit_review에서 요약 노트 앞에 붙는 전체 판정.
summary string 아니요 submit_review에서 diff 댓글 뒤에 게시되는 요약 노트.
summary_internal boolean 아니요 submit_review에서 요약 노트를 내부용으로 표시합니다.
sha string 아니요 approve에서 head SHA 가드. 값을 지정했는데 머지 리퀘스트 head와 더 이상 일치하지 않으면 승인이 거부됩니다. get_merge_request가 반환한 40자 전체 diff_head_sha를 전달합니다.

예시:

Review merge request 42 in project gitlab-org/gitlab and leave your findings as diff comments with a summary

list_milestones#

히스토리

이 도구는 core 툴셋에 속합니다.

GitLab 프로젝트 또는 그룹의 마일스톤을 나열합니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트 또는 그룹의 GitLab URL. url, project_id, group_id 중 정확히 하나를 제공합니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url, project_id, group_id 중 정확히 하나를 제공합니다.
group_id string 아니요 그룹의 ID 또는 전체 경로. url, project_id, group_id 중 정확히 하나를 제공합니다.
state string 아니요 상태로 마일스톤을 필터링합니다(active 또는 closed). 생략하면 모든 상태의 마일스톤을 반환합니다.
search string 아니요 제목으로 마일스톤을 필터링하는 검색 문자열.
include_ancestors boolean 아니요 상위 그룹의 마일스톤을 포함합니다. 프로젝트의 경우 프로젝트의 상위 그룹과 그 상위 그룹들의 마일스톤을 포함합니다.
include_descendants boolean 아니요 하위 그룹과 그 프로젝트의 마일스톤을 포함합니다. 그룹에만 적용됩니다.
first integer 아니요 커서 이후로 반환할 마일스톤 수(정방향 페이지네이션). 최댓값 100.
after string 아니요 마일스톤의 정방향 페이지네이션용 커서. 이전 응답의 pageInfo.endCursor를 사용합니다.

예시:

List the open milestones in project gitlab-org/gitlab

list_project_members#

히스토리

이 도구는 core 툴셋에 속합니다.

GitLab 프로젝트 멤버를 권한 및 액세스 수준과 함께 나열합니다.

파라미터 유형 필수 설명
project_id string 예 프로젝트의 전체 경로 또는 숫자 ID(예: gitlab-org/gitlab 또는 278964).
include_inherited boolean 아니요 상위 그룹이나 프로젝트의 하위 그룹에서 권한을 상속받는 멤버도 함께 반환합니다. 기본값은 false입니다.
query string 아니요 이름 또는 사용자 이름에 이 텍스트가 포함된 멤버만 반환합니다.
first integer 아니요 정방향 페이지네이션으로 반환할 멤버 수(기본값 20, 최댓값 100).
after string 아니요 정방향 페이지네이션용 커서.

응답은 각 멤버에 대해 사용자 ID, 사용자 이름, 이름, 숫자 access_level, 해당하는 access_level_name(예: Maintainer), 멤버십 expires_at 날짜를 반환합니다. 이메일로 초대받았지만 아직 초대를 수락하지 않은 멤버는 반환되지 않습니다.

각 호출은 결과의 한 페이지를 반환합니다. 페이지가 더 있으면 응답 metadata에 end_cursor가 포함되며, 이를 after로 전달하여 다음 페이지를 가져올 수 있습니다.

예시:

Who are the maintainers of gitlab-org/gitlab?

get_user#

히스토리

이 도구는 core 툴셋에 속합니다.

단일 GitLab 사용자를 가져옵니다. 이 도구를 사용하여 사용자 이름이나 본인 계정을 숫자 사용자 ID로 확인합니다. 예를 들어 다른 도구로 담당자나 리뷰어를 설정하기 전에 사용합니다.

username, id, me 중 정확히 하나를 제공합니다.

파라미터 유형 필수 설명
username string 아니요 조회할 사용자의 사용자 이름.
id integer 아니요 조회할 사용자의 숫자 ID.
me boolean 아니요 인증된 사용자를 조회하려면 true로 설정합니다. 설정할 때는 username과 id를 생략합니다. 이 파라미터를 사용하지 않으려면 false로 설정합니다.

응답은 사용자의 숫자 id, username, name, state, web_url을 반환합니다.

예시:

What is my GitLab user ID?

list_todos#

히스토리

이 도구는 core 툴셋에 속합니다.

리뷰 요청, 배정, 멘션 같은 할 일 항목을 나열합니다. state를 done으로 설정하지 않으면 대기 중인 할 일 항목을 반환합니다.

파라미터 유형 필수 설명
state string 아니요 상태로 필터링합니다: pending 또는 done. 기본값은 pending입니다.
action string 아니요 할 일 항목을 만든 동작으로 필터링합니다(예: review_requested, assigned, mentioned).
type string 아니요 할 일 항목 대상의 유형으로 필터링합니다(예: MERGEREQUEST, ISSUE, WORKITEM).
author_id integer 아니요 할 일 항목을 만든 사용자의 숫자 ID로 필터링합니다. 사용자 ID를 조회하려면 get_user를 사용합니다.
project_id string 아니요 프로젝트로 필터링합니다. 프로젝트의 ID 또는 전체 경로.
group_id string 아니요 그룹으로 필터링합니다. 그룹의 ID 또는 전체 경로.
first integer 아니요 정방향 페이지네이션으로 반환할 할 일 항목 수. 기본값은 20, 최댓값은 100입니다.
after string 아니요 정방향 페이지네이션용 커서. 이전 응답의 pageInfo.endCursor를 사용합니다.

각 할 일 항목에는 다음 정보가 포함됩니다.

  • 숫자 id, action, state, body, targetType, targetUrl, createdAt
  • targetEntity에 있는 대상의 name과 iid
  • 작성자
  • 할 일 항목이 속한 프로젝트 또는 그룹

할 일 항목, 작성자, 프로젝트, 그룹의 ID는 다른 도구에 다시 전달할 수 있도록 GraphQL 글로벌 ID에서 풀어낸 숫자로 반환됩니다.

예시:

Which merge requests am I asked to review?

list_user_events#

히스토리

이 도구는 core 툴셋에 속합니다.

지정한 사용자의 기여 이벤트를 가져옵니다. 에픽이나 머지 리퀘스트와 관련된 이벤트는 반환하지 않습니다. 대량 푸시 이벤트는 커밋 세부 정보를 제한해 반환합니다.

파라미터 유형 필수 설명
id string 예 사용자의 ID 또는 사용자 이름.
action string 아니요 동작 유형으로 이벤트를 필터링합니다.
target_type string 아니요 대상 유형으로 이벤트를 필터링합니다.
before string 아니요 지정한 날짜(YYYY-MM-DD) 이전에 생성된 이벤트를 반환합니다.
after string 아니요 지정한 날짜(YYYY-MM-DD) 이후에 생성된 이벤트를 반환합니다.
sort string 아니요 생성 날짜 기준 오름차순(asc) 또는 내림차순(desc)으로 결과를 정렬합니다.
page integer 아니요 페이지네이션용 페이지 번호.
per_page integer 아니요 페이지당 반환할 이벤트 수.

예시:

List recent events for user john_doe

accept_merge_request#

히스토리

이 도구는 merge_requests 툴셋에 속합니다.

머지 리퀘스트를 머지하거나, 자동으로 머지되도록 예약합니다. strategy가 없으면 머지가 즉시 시작되어 비동기로 완료됩니다. strategy가 있으면 자동 머지가 설정되고 검사를 통과하면 머지 리퀘스트가 머지됩니다. 대신 머지 리퀘스트를 승인하려면 save_merge_request_review 도구를 사용합니다.

이미 머지된 머지 리퀘스트에 대한 호출은 already_merged 상태로 성공하며, 이미 예약된 머지 리퀘스트에 strategy를 지정한 호출은 already_scheduled 상태로 성공합니다.

파라미터 유형 필수 설명
url string 아니요 머지 리퀘스트의 GitLab URL. 이것을 제공하거나 project_id와 merge_request_iid를 제공합니다.
project_id string 아니요 프로젝트의 ID 또는 경로. url이 없으면 필수입니다.
merge_request_iid integer 아니요 머지 리퀘스트의 내부 ID. url이 없으면 필수입니다.
sha string 예 head SHA 가드. 머지 리퀘스트 head와 더 이상 일치하지 않으면 머지가 거부됩니다. get_merge_request가 반환한 diff_head_sha를 전달합니다.
strategy string 아니요 자동 머지 전략(예: merge_when_checks_pass). 지정하면 즉시 머지하는 대신 자동 머지를 설정합니다.
squash boolean 아니요 머지할 때 커밋을 하나의 커밋으로 스쿼시합니다.
commit_message string 아니요 사용자 지정 머지 커밋 메시지.
squash_commit_message string 아니요 사용자 지정 스쿼시 커밋 메시지. squash가 true 일 때 적용됩니다.
should_remove_source_branch boolean 아니요 머지 후 소스 브랜치를 제거합니다.

예시:

Merge merge request 42 in project gitlab-org/gitlab once its checks pass, and remove the source branch

add_branch#

히스토리
  • GitLab 19.3에서 도입. create_branch도 별칭으로 사용할 수 있습니다.

이 도구는 repository 툴셋에 속합니다.

소스 ref에서 GitLab 프로젝트에 브랜치를 추가합니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트의 GitLab URL. 이것을 제공하거나 project_id를 제공합니다.
project_id string 아니요 프로젝트의 ID 또는 경로. url을 제공하지 않으면 필수입니다.
branch string 예 새 브랜치의 이름.
ref string 예 새 브랜치를 만들 기준이 되는 브랜치 이름 또는 커밋 SHA.

예시:

Create a branch named feature/x from main in project gitlab-org/gitlab

fork_repository#

히스토리

이 도구는 repository 툴셋에 속합니다.

GitLab 프로젝트를 네임스페이스로 포크합니다.

포크는 비동기로 생성됩니다. 응답에는 새 프로젝트 속성이 포함되며, 포크 진행 상황을 보여 주는 import_status 필드(예: scheduled)가 들어 있습니다.

호출은 다음 상태에 따라 각각의 이유로 실패합니다.

  • 409 상태: 네임스페이스에 이미 해당 프로젝트의 포크가 있는 경우.
  • 404 상태: 프로젝트나 네임스페이스가 존재하지 않거나, 프로젝트를 포크할 권한이 없는 경우.
파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
namespace_id integer 아니요 프로젝트를 포크할 네임스페이스의 ID.
namespace_path string 아니요 프로젝트를 포크할 네임스페이스의 경로.
name string 아니요 포크에 지정할 이름.
path string 아니요 포크에 지정할 경로.
description string 아니요 포크에 지정할 설명.
visibility string 아니요 포크의 공개 범위.

예시:

Fork gitlab-org/gitlab-test into my personal namespace

list_branches#

히스토리

이 도구는 repository 툴셋에 속합니다.

GitLab 프로젝트의 브랜치를 나열하며, 선택적으로 이름으로 필터링합니다.

파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
search string 아니요 이름으로 브랜치를 필터링합니다.
page integer 아니요 현재 페이지 번호. 기본값은 1입니다.
per_page integer 아니요 페이지당 항목 수. 기본값은 20입니다.

예시:

List branches in gitlab-org/gitlab whose names contain "release"

get_repository_file#

히스토리
  • GitLab 19.3에서 도입.
  • GitLab 19.6에서 최대 응답 콘텐츠가 1 MiB에서 32 KiB로 변경.
  • GitLab 19.6에서 line_byte_offset 파라미터가 도입.

이 도구는 repository 툴셋에 속합니다.

특정 ref에서 리포지터리의 단일 파일 콘텐츠를 가져옵니다.

콘텐츠는 로컬 파일 시스템이 아니라 리포지터리에서 가져옵니다. 파일은 ref에 커밋된 상태로 반환되므로, 로컬 체크아웃의 커밋되지 않은 변경 사항은 포함되지 않습니다.

파라미터 유형 필수 설명
url string 아니요 파일의 URL(예: https://gitlab.example.com/my-group/my-project/-/blob/main/app/models/user.rb). 이것을 제공하거나 project_id, file_path, ref를 제공합니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url을 제공하지 않으면 필수입니다. url도 함께 제공하는 경우 둘은 같은 프로젝트를 가리켜야 합니다.
file_path string 아니요 리포지터리 루트를 기준으로 한 파일 경로. url을 제공하지 않으면 필수입니다.
ref string 아니요 브랜치 이름, 태그 이름 또는 커밋 SHA. 기본 브랜치에는 HEAD를 사용합니다. url을 제공하지 않으면 필수입니다.
offset integer 아니요 읽기를 시작할 0부터 시작하는 줄 번호. 기본값은 0입니다.
limit integer 아니요 반환할 최대 줄 수. 기본값은 500, 최댓값은 2000입니다.
line_byte_offset integer 아니요 offset에 해당하는 줄에서 응답이 시작되는 바이트 위치. 긴 줄이 잘린 뒤에는 system_instruction의 값을 사용합니다.

응답에는 total_lines, returned_lines, truncated, size_bytes를 담은 metadata 객체가 포함됩니다. 응답이 파일의 일부만 포함하면 system_instruction에 다음 호출에서 사용할 offset 이 명시됩니다.

각 응답은 최대 32 KiB의 파일 콘텐츠를 반환합니다. 줄이 그보다 길면 응답이 줄 중간에서 끝나며, system_instruction에 줄의 나머지를 읽을 때 사용할 offset과 line_byte_offset이 명시됩니다.

이 도구는 텍스트만 반환합니다. 바이너리 파일과 Git LFS에 저장된 파일은 오류를 반환합니다. 프로젝트가 GitLab Duo 컨텍스트에서 제외한 파일도 오류를 반환합니다.

예시:

Show me app/models/user.rb from the main branch of my-group/my-project

list_repository_tree#

히스토리

이 도구는 repository 툴셋에 속합니다.

지정한 경로와 ref에서 GitLab 리포지터리의 파일과 디렉터리를 나열합니다. 항목 메타데이터만 반환하며 파일 콘텐츠는 반환하지 않습니다. 파일의 콘텐츠를 읽으려면 get_repository_file을 사용합니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트의 GitLab URL. url 또는 project_id 중 정확히 하나를 제공합니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url 또는 project_id 중 정확히 하나를 제공합니다.
path string 아니요 리포지터리 루트를 기준으로 나열할 디렉터리의 경로. 기본값은 루트입니다.
ref string 아니요 브랜치 이름, 태그 이름 또는 커밋 SHA. 기본값은 기본 브랜치입니다.
recursive boolean 아니요 모든 하위 디렉터리의 항목을 재귀적으로 나열합니다. 기본값은 false입니다.
after string 아니요 정방향 페이지네이션용 커서. 이전 응답의 endCursor를 사용합니다.

각 호출은 최대 100개의 항목을 반환합니다. pageInfo.hasNextPage가 true 이면 pageInfo.endCursor를 after로 전달하여 다음 페이지를 가져옵니다.

예시:

List the files under app/services in gitlab-org/gitlab on the default branch

get_commit#

히스토리
  • GitLab 19.3에서 도입.
  • GitLab 19.6에서 호출당 둘 이상의 include 패싯을 받도록 변경.

이 도구는 repository 툴셋에 속합니다.

단일 커밋의 메타데이터를 가져오며, 선택적으로 diff나 노트도 가져옵니다.

파라미터 유형 필수 설명
url string 아니요 GitLab 커밋의 URL. project_id와 commit_sha를 제공하지 않으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url을 제공하지 않으면 필수입니다.
commit_sha string 아니요 조회할 커밋. 전체 또는 짧은 SHA, 브랜치 이름, 태그 이름을 사용할 수 있습니다. url을 제공하지 않으면 필수입니다.
include array 아니요 인라인으로 가져올 연관 패싯. diff, notes 또는 둘 다 한 번의 호출에서 요청할 수 있습니다. 기본 메타데이터는 항상 반환됩니다.
diff_detail string 아니요 커밋 diff의 상세 수준. include에 diff가 포함된 경우에만 적용됩니다. stats 또는 full_patch 중 하나입니다. 기본값은 stats입니다.
notes_after string 아니요 다음 노트 페이지를 가져오는 토큰. include에 notes가 포함된 경우에만 적용됩니다.
notes_first integer 아니요 페이지당 반환할 노트 수(최대 100). include에 notes가 포함된 경우에만 적용됩니다.

diff_detail을 stats로 설정하면 diff 패싯은 파일별 및 요약 줄 수를 반환합니다. full_patch로 설정하면 패치 텍스트를 반환합니다.

예시:

Show me commit abc123 in gitlab-org/gitlab with its diff stats

list_commits#

히스토리

이 도구는 repository 툴셋에 속합니다.

GitLab 프로젝트의 커밋을 나열하며, 선택적으로 ref, 작성자, 경로, 날짜로 필터링합니다. 간략한 커밋 메타데이터를 반환합니다. 단일 커밋의 diff나 노트를 가져오려면 get_commit을 사용합니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트의 GitLab URL. url 또는 project_id 중 정확히 하나를 제공합니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url 또는 project_id 중 정확히 하나를 제공합니다.
ref_name string 아니요 커밋을 나열할 브랜치 또는 태그. 기본값은 기본 브랜치입니다.
author string 아니요 커밋 작성자의 이름 또는 이메일로 필터링합니다.
path string 아니요 이 파일 경로를 변경한 커밋만 반환합니다.
since string 아니요 커밋 날짜가 이 ISO 8601 날짜 또는 시간 이후인 커밋만 반환합니다.
until string 아니요 커밋 날짜가 이 ISO 8601 날짜 또는 시간 이전인 커밋만 반환합니다.
order string 아니요 정렬 방식. topo 또는 date를 사용할 수 있습니다. 기본값은 시간 역순입니다.
first_parent boolean 아니요 머지 커밋의 첫 번째 부모만 따라갑니다.
with_stats boolean 아니요 커밋별 줄 수 통계(추가, 삭제, 변경된 파일)를 포함합니다.
after string 아니요 정방향 페이지네이션용 커서. 이전 응답의 endCursor를 사용합니다.
first integer 아니요 반환할 커밋 수. 기본값은 20, 최댓값은 100입니다.

with_stats가 true이면 각 커밋마다 Gitaly 호출이 발생하므로, first의 기본값은 10 이고 with_stats를 설정한 경우 10을 넘을 수 없습니다.

예시:

List commits to app/models in gitlab-org/gitlab since 2026-08-01 by Alex

list_releases#

히스토리

이 도구는 repository 툴셋에 속합니다.

GitLab 프로젝트의 릴리스를 가장 최근에 릴리스된 순서로 나열합니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트의 GitLab URL. project_id를 제공하지 않으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url을 제공하지 않으면 필수입니다.
page integer 아니요 가져올 페이지 번호. 기본값은 1입니다.
per_page integer 아니요 페이지당 반환할 릴리스 수. 기본값은 20, 최댓값은 100입니다.
state string 아니요 릴리스 상태로 필터링합니다: released, upcoming, all. 기본값은 released입니다.

url 또는 project_id 중 정확히 하나를 제공합니다.

각 항목은 릴리스 메타데이터만 반환합니다: tag_name, name, released_at, upcoming, assets. assets 에는 릴리스 에셋 링크의 count와 그중 최대 5개의 links가 들어 있습니다. 릴리스에 에셋 링크가 5개보다 많으면 count는 실제 전체 개수를 나타냅니다. 소스 아카이브는 태그에서 파생할 수 있으므로 제외됩니다.

응답에는 page, per_page, has_more를 담은 metadata 객체도 포함됩니다. has_more로 다음 페이지를 요청할지 결정합니다.

릴리스 노트는 의도적으로 이 응답에 반환되지 않습니다.

released_at 이 미래인 릴리스는 게시된 것이 아니라 예약된 것이며, 게시된 릴리스보다 앞에 정렬됩니다. state로 어느 쪽을 가져올지 제어합니다. 예약된 릴리스는 upcoming 이 true로 설정됩니다.

릴리스의 기반이 되는 커밋을 읽으려면 해당 tag_name을 get_commit 도구에 전달합니다. 에셋을 다운로드하려면 assets.links의 url을 사용합니다.

예시:

List the most recent releases for project gitlab-org/gitlab

list_tags#

히스토리

이 도구는 repository 툴셋에 속합니다.

GitLab 프로젝트의 태그를 가장 최근에 업데이트된 순서로 나열합니다. search가 태그 이름과 정확히 일치하면 GitLab은 해당 태그를 가장 먼저 나열합니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트의 GitLab URL. project_id를 제공하지 않으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url을 제공하지 않으면 필수입니다.
search string 아니요 이름으로 태그를 필터링합니다. 시작 고정에는 ^, 끝 고정에는 $, 와일드카드에는 *를 지원합니다.
first integer 아니요 반환할 태그 수. 기본값은 20, 최댓값은 100입니다.
after string 아니요 정방향 페이지네이션용 커서. 이전 응답의 metadata.end_cursor를 사용합니다.

url 또는 project_id 중 정확히 하나를 제공합니다.

각 항목은 name과 commit을 반환하며, commit 에는 태그 끝 커밋의 sha 와 title 이 들어 있습니다. 태그가 커밋이 아닌 다른 대상을 가리키면 commit은 null입니다.

태그 메시지는 의도적으로 이 응답에 반환되지 않습니다.

응답에는 has_next_page와 end_cursor를 담은 metadata 객체도 포함됩니다. has_next_page가 true이면 end_cursor를 after로 전달하여 다음 페이지를 가져옵니다.

태그가 가리키는 전체 커밋을 읽으려면 get_commit 도구를 사용합니다.

예시:

List the most recent tags for the gitlab-org/gitlab project

get_pipeline#

히스토리
  • GitLab 19.3에서 도입.
  • artifacts 패싯이 GitLab 19.5에서 도입.
  • GitLab 19.6에서 하위 파이프라인 ID 지원이 도입.

이 도구는 ci 툴셋에 속합니다.

파이프라인을 가져오며, 선택적으로 job, 다운스트림 파이프라인, 브리지(트리거) job 또는 해당 job이 생성한 아티팩트도 가져옵니다.

파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
pipeline_id integer 예 파이프라인의 ID.
include array 아니요 파이프라인과 함께 포함할 패싯. 호출당 하나: jobs, downstream_pipelines, bridge_jobs, artifacts.
job_status string 아니요 상태로 jobs 패싯을 필터링합니다(예: failed). include가 jobs 일 때만 적용됩니다.
first integer 아니요 선택한 include 패싯에 대해 반환할 항목 수. artifacts 패싯에서는 아티팩트를 반환할 job의 수입니다. 기본값은 20, 최댓값은 100입니다.
after string 아니요 선택한 include 패싯의 정방향 페이지네이션용 커서. 이전 응답의 page_info.end_cursor를 사용합니다.

브리지 job의 downstream_pipeline은 트리거 job이 아직 다운스트림 파이프라인을 트리거하지 않은 경우와 해당 파이프라인에 액세스할 수 없는 경우 모두 생략됩니다(null).

다운스트림 파이프라인은 다른 프로젝트에 속할 수 있으므로, 각 다운스트림 파이프라인에는 project_full_path가 포함됩니다. 이 값을 후속 호출의 id로 사용합니다.

하위 파이프라인을 조사하려면 downstream_pipelines 패싯에 있는 파이프라인의 id 또는 bridge_jobs 패싯에 있는 job의 downstream_pipeline.id를 후속 호출의 pipeline_id로 사용합니다. 예를 들어 include: ["jobs"] 및 job_status: "failed"와 함께 전달하면 하위 파이프라인의 실패한 job을 찾을 수 있습니다.

artifacts 패싯은 아티팩트의 평면 목록을 반환합니다. 각 아티팩트에는 name, size, file_type, 만료 정보, 그리고 아티팩트를 생성한 job의 job_id와 job_name이 포함됩니다. 페이지네이션은 아티팩트가 아니라 파이프라인의 job 단위로 적용됩니다.

예시:

  • 파이프라인 가져오기:

    Get the status of pipeline 12345 in project gitlab-org/gitlab
    
  • 파이프라인의 실패한 job 가져오기:

    Show me the failed jobs in pipeline 12345 for project gitlab-org/gitlab
    
  • 파이프라인의 다운스트림 파이프라인 가져오기:

    Show me the downstream pipelines triggered by pipeline 12345 in project gitlab-org/gitlab
    
  • 파이프라인이 생성한 아티팩트 가져오기:

    List the artifacts of pipeline 12345 in project gitlab-org/gitlab
    

get_pipeline_jobs#

히스토리

이 도구는 ci 툴셋에 속합니다.

include: ["jobs"]와 함께 사용하는 get_pipeline으로 대체되었습니다. 이 방식은 파이프라인의 나머지 데이터와 함께 job을 한 번의 호출로 반환합니다. jobs 패싯은 job당 반환하는 필드가 더 적어서 failure_reason, duration, queued_duration, 타임스탬프를 포함하지 않습니다. 이 도구는 더 이상 tools/list에 나타나지 않지만, 호출자가 마이그레이션하는 동안에는 계속 호출할 수 있습니다.

특정 GitLab CI/CD 파이프라인의 job을 가져옵니다.

파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
pipeline_id integer 예 파이프라인의 ID.
per_page integer 아니요 페이지당 job 수.
page integer 아니요 현재 페이지 번호.

예시:

Show me all jobs in pipeline 12345 for project gitlab-org/gitlab

get_job#

히스토리
  • GitLab 19.3에서 도입.
  • GitLab 19.3에서 get_job_log에서 이름 변경. get_job_log는 별칭으로 계속 작동하며 항상 byte_limit으로 제한된 log 패싯을 반환합니다.
  • artifacts 패싯이 GitLab 19.5에서 도입.
  • GitLab 19.6에서 로그 끝부분 읽기(옵트인)가 도입.
  • GitLab 19.6에서 호출당 둘 이상의 include 패싯을 받도록 변경.

이 도구는 ci 툴셋에 속합니다.

CI/CD job의 메타데이터를 가져오며, 선택적으로 트레이스/로그 또는 job이 생성한 아티팩트도 가져옵니다.

파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
job_id integer 예 job의 ID.
include array 아니요 job과 함께 포함할 패싯: log, artifacts 또는 둘 다.
from string 아니요 로그의 start 또는 end부터 읽습니다. 기본값은 start입니다. log 패싯에만 적용됩니다. end와 byte_offset은 함께 사용할 수 없습니다.
byte_offset integer 아니요 job 로그를 읽기 시작할 바이트 오프셋. include에 log가 포함되고 from이 start일 때만 적용됩니다. 기본값은 0입니다.
byte_limit integer 아니요 반환할 job 로그의 최대 바이트 수. include에 log가 포함된 경우에만 적용됩니다. 기본값과 최댓값은 512000입니다.

로그가 byte_limit 보다 길면 응답이 전체 크기를 알려 주고 다음 구간에 사용할 byte_offset을 안내합니다.

마지막 32 KiB를 읽으려면 from: "end"와 byte_limit: 32768을 설정합니다. 응답에는 반환된 바이트 범위를 나타내는 log.metadata.returned.start와 log.metadata.returned.end가 포함됩니다. end 오프셋은 범위에 포함되지 않습니다. 앞쪽 바이트가 남아 있으면 log.system_instruction이 앞 구간을 읽기 위한 인수를 제공합니다. 꼬리 구간 요청의 파라미터를 대체하려면 from: "start"를 포함해 그 인수를 모두 사용합니다. 더 앞쪽 구간을 읽으려면 반환된 start에서 원하는 구간 크기를 빼고, 결과가 음수이면 0으로 맞춘 다음 byte_limit을 두 오프셋 사이의 거리로 설정합니다.

log.metadata.truncated는 반환된 구간 뒤에 바이트가 남아 있음을 나타냅니다. 끝까지 도달한 꼬리 구간에서는 앞쪽 바이트가 있어도 false입니다. 바이트 오프셋은 불완전한 UTF-8 문자를 대체하기 전의 원본 로그를 기준으로 합니다.

artifacts 패싯은 job이 생성한 모든 아티팩트를 name, size, file_type, 만료 정보와 함께 나열합니다.

예시:

  • job 메타데이터 가져오기:

    Get the status of job 88 in project gitlab-org/gitlab
    
  • job 로그 가져오기:

    Show me the log output for job 88 in project gitlab-org/gitlab
    
  • job 로그의 끝부분 가져오기:

    Show me the last 32 KiB of log output for job 88 in project gitlab-org/gitlab
    
  • job의 아티팩트 가져오기:

    What artifacts did job 88 in project gitlab-org/gitlab produce?
    

get_artifact_file#

히스토리
  • GitLab 19.5에서 도입.
  • GitLab 19.6에서 file_type 파라미터가 도입.

이 도구는 ci 툴셋에 속합니다.

CI/CD job의 아티팩트에 있는 파일을 텍스트로 읽습니다. 아티팩트 아카이브 안의 파일이거나, junit 또는 sast 보고서처럼 별도 파일로 저장된 보고서 아티팩트입니다. job이나 파이프라인이 생성한 항목을 확인하려면 include: artifacts와 함께 get_job 또는 get_pipeline 도구를 사용합니다.

파라미터 유형 필수 설명
url string 아니요 job의 URL. 이것을 제공하거나 project_id와 job_id를 제공합니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url을 제공하지 않으면 필수입니다.
job_id integer 아니요 job의 ID. url을 제공하지 않으면 필수입니다.
artifact_path string 아니요 아티팩트 아카이브 안의 파일 경로(예: coverage/index.html). file_type이 archive이면 필수입니다.
file_type string 아니요 읽을 아티팩트 유형. 기본값은 archive입니다. 별도 파일로 저장된 보고서의 경우 artifacts:reports 유형(예: junit 또는 sast)을 설정합니다. 이 경우 artifact_path는 필요하지 않습니다.
byte_offset integer 아니요 파일을 읽기 시작할 바이트 오프셋. 기본값은 0입니다.
byte_limit integer 아니요 반환할 최대 바이트 수. 기본값과 최댓값은 1048576(1 MB)입니다.

artifacts:reports의 보고서 아티팩트는 아카이브 안이 아니라 별도 파일로 저장됩니다. 읽으려면 file_type을 보고서 유형으로 설정합니다. 압축된 보고서는 반환되기 전에 압축이 해제됩니다.

파일이 byte_limit보다 길면 응답이 전체 크기를 알려 주고 다음 구간에 사용할 byte_offset을 안내합니다. 바이너리 파일은 반환되지 않으며, 오류에 파일 이름, 크기와 유형, 브라우저에서 볼 수 있는 위치가 표시됩니다.

예시:

  • job의 아티팩트에서 테스트 보고서 읽기:

    Read coverage/index.html from the artifacts of job 88 in project gitlab-org/gitlab
    
  • 실패한 엔드투엔드 테스트 조사:

    Find the JUnit report in the artifacts of job 88 in gitlab-org/gitlab and summarize the failures
    
  • 아카이브에 없는 보고서 아티팩트 읽기:

    Read the sast report of job 88 in gitlab-org/gitlab
    

get_pages_content#

히스토리

이 도구는 core 툴셋에 속합니다.

GitLab Pages URL에 게시된 콘텐츠를 텍스트로 읽습니다. 이 도구는 URL을 GitLab 인스턴스의 Pages 사이트에서 확인하고 현재 배포에서 파일을 읽으므로, 리포지터리 소스가 아니라 방문자가 보는 내용을 가져옵니다. 보기 권한이 있는 비공개 Pages 사이트도 읽을 수 있습니다.

파라미터 유형 필수 설명
url string 예 읽을 GitLab Pages URL(예: https://mygroup.gitlab.io/myproject/docs/).
byte_offset integer 아니요 파일을 읽기 시작할 바이트 오프셋. 기본값은 0입니다. 최댓값은 20971520(20 MB)입니다.
byte_limit integer 아니요 반환할 최대 바이트 수. 기본값과 최댓값은 1048576(1 MB)입니다.

URL은 인스턴스의 GitLab Pages가 제공하는 사이트(네임스페이스 도메인, 고유 도메인 또는 확인된 사용자 지정 도메인)를 가리켜야 합니다. 다른 호스트는 가져오지 않습니다.

/로 끝나는 URL은 해당 디렉터리의 index.html 파일을 읽습니다. 그 이름의 디렉터리가 없으면 같은 이름의 .html 파일을 읽습니다.

파일 확장자가 없는 URL은 그 이름의 디렉터리가 있으면 해당 디렉터리의 index.html 파일을 읽고, 없으면 GitLab Pages가 사이트를 제공하는 방식과 같게 같은 이름의 .html 파일로 대체합니다.

응답에는 배포 안에서 파일의 path, content_type, 그리고 사이트를 게시하는 프로젝트의 project_id가 포함됩니다. project_id는 해당 프로젝트를 볼 수 있는 경우에만 포함됩니다. 파일이 byte_limit보다 길면 응답이 전체 크기를 알려 주고 다음 구간에 사용할 byte_offset을 안내합니다. 이미지 같은 바이너리 파일은 반환되지 않습니다.

예시:

Read https://mygroup.gitlab.io/myproject/docs/api/ and summarize the authentication section

list_pipelines#

히스토리

이 도구는 ci 툴셋에 속합니다.

GitLab 프로젝트의 파이프라인을 나열하며, 선택적 필터를 사용할 수 있습니다.

파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
ref string 아니요 브랜치 또는 태그 이름. ref로 파이프라인을 필터링합니다.
status string 아니요 상태로 파이프라인을 필터링합니다(예: running, success, failed).
source string 아니요 소스로 파이프라인을 필터링합니다(예: push, web, schedule).
created_after string 아니요 지정한 날짜와 시간(ISO 8601 형식) 이후에 생성된 파이프라인을 반환합니다.
created_before string 아니요 지정한 날짜와 시간(ISO 8601 형식) 이전에 생성된 파이프라인을 반환합니다.
order_by string 아니요 id, status, ref, updated_at, user_id로 파이프라인을 정렬합니다. 기본값은 id입니다.
sort string 아니요 정렬 방향, asc 또는 desc. 기본값은 desc입니다.
page integer 아니요 현재 페이지 번호. 기본값은 1입니다.
per_page integer 아니요 페이지당 항목 수. 기본값은 20입니다.

자식 파이프라인은 기본적으로 결과에서 제외됩니다. 자식 파이프라인만 반환하려면 source를 parent_pipeline으로 설정합니다.

기본 정렬(id, desc)은 ID가 가장 높은 파이프라인을 먼저 반환합니다. ID 순서는 보통 생성 순서와 일치하지만, 둘이 항상 일치한다고 보장되지는 않습니다. 명시적인 시간 경계로 필터링하려면 created_after 또는 created_before를 사용합니다. 호출자는 결과를 페이지별로 넘기다가 대상 범위를 벗어난 첫 번째 파이프라인에서 멈출 수 있습니다.

예시:

List all failed pipelines on the main branch for project gitlab-org/gitlab

list_pipeline_schedules#

히스토리

이 도구는 ci 툴셋에 속합니다.

GitLab 프로젝트의 파이프라인 스케줄을 나열합니다.

파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
scope string 아니요 상태별로 스케줄을 필터링합니다: active 또는 inactive.
page integer 아니요 가져올 페이지 번호. 기본값은 1입니다.
per_page integer 아니요 페이지당 항목 수. 기본값은 20, 최댓값은 100입니다.

응답에는 스케줄 소유자와 Maintainer 또는 Owner 권한이 있는 사용자에게만 inputs가 포함됩니다.

예시:

List active pipeline schedules for project gitlab-org/gitlab

save_pipeline#

히스토리
  • GitLab 19.3에서 도입.
  • GitLab 19.4에서 update 작업이 도입.
  • GitLab 19.6에서 merge_request_iid 파라미터가 추가.

이 도구는 ci 툴셋에 속합니다.

GitLab 프로젝트에서 CI/CD 파이프라인을 실행, 재시도, 취소하거나 이름을 변경합니다. 파이프라인을 나열하려면 대신 list_pipelines 도구를 사용합니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트의 GitLab URL. 파이프라인을 만들 때만 사용합니다. 이것을 제공하거나 project_id를 제공합니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. 파이프라인을 만들 때만 사용합니다. 이것을 제공하거나 url을 제공합니다.
merge_request_iid integer 아니요 파이프라인을 만들 머지 리퀘스트의 내부 ID.
pipeline_id integer 아니요 대상으로 삼을 기존 파이프라인의 ID. 설정하면 action이 필요합니다. 새 파이프라인을 만들려면 생략합니다.
action string 아니요 pipeline_id에 수행할 수명 주기 작업: retry, cancel, update 중 하나. pipeline_id를 설정하면 필수입니다.
ref string 아니요 브랜치 또는 태그 이름. 브랜치나 태그에 파이프라인을 만들 때(pipeline_id와 merge_request_iid가 없을 때) 필수입니다.
name string 아니요 새 파이프라인 이름. action: "update"에서 필수입니다.
variables array 아니요 배열 형식의 파이프라인 변수([{key, value, variable_type}]).
inputs hash 아니요 키-값 쌍으로 된 파이프라인 입력 파라미터.

예시:

  • 파이프라인 만들기:

    Create a pipeline on the main branch for project gitlab-org/gitlab
    
  • 머지 리퀘스트용 파이프라인 만들기:

    Create a pipeline for merge request 42 in project gitlab-org/gitlab
    
  • 파이프라인 재시도:

    Retry failed jobs in pipeline 12345 for project gitlab-org/gitlab
    
  • 파이프라인 취소:

    Cancel pipeline 12345 in project gitlab-org/gitlab
    
  • 파이프라인 이름 변경:

    Rename pipeline 12345 to "Nightly security scan" in project gitlab-org/gitlab
    

save_pipeline_job#

히스토리

이 도구는 ci 툴셋에 속합니다.

사전 요구 사항:

  • job은 지정한 프로젝트에 속하고, 수동 상태이며, 실행할 수 있어야 합니다.
  • job을 실행할 권한이 있어야 하며, job이 배포하는 보호된 환경에 대한 액세스도 포함됩니다.
  • 변수를 전달하려면 인증된 사용자에게 프로젝트에서 파이프라인 변수를 재정의할 권한이 있어야 합니다.

save_pipeline_job은 GitLab 프로젝트의 기존 수동 CI/CD job을 실행하며, 선택적으로 CI/CD 변수를 함께 전달합니다. job을 실행하면 배포가 트리거될 수 있습니다. job을 실행하기 전에 get_job으로 확인합니다.

job의 url을 제공하거나 project_id와 job_id를 모두 제공합니다. url을 project_id, job_id 또는 둘 다와 함께 제공할 수도 있습니다. 제공한 모든 식별자는 같은 프로젝트와 job을 가리켜야 합니다.

파라미터 유형 필수 설명
url string 아니요 job의 전체 URL(예: https://gitlab.example.com/group/project/-/jobs/12345). project_id와 job_id를 제공하지 않으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url을 제공하지 않으면 필수입니다.
job_id integer 아니요 실행할 수동 job의 ID. url을 제공하지 않으면 필수입니다.
variables array 아니요 배열 형식의 CI/CD 변수([{key, value, variable_type}]). 각 변수에는 key와 value가 필요합니다. 선택 사항인 variable_type은 env_var(기본값) 또는 file입니다.

다음 job 세부 정보를 반환합니다.

필드 유형 설명
id integer job ID.
name string job 이름.
status string 실행 후 job 상태(소문자, 예: pending).
stage string Stage 이름.
pipeline_id integer 파이프라인 ID.
web_url string job의 URL.
pipeline_web_url string 파이프라인의 URL.

예시:

Check job 12345 in project example/my-project, then play it with DEPLOY_ENV set to staging

manage_pipeline#

히스토리
  • GitLab 18.10에서 도입.
  • GitLab 19.3에서 list_pipelines 도구로 대체하기 위해 list 작업이 제거.
  • GitLab 19.3에서 save_pipeline 도구로 대체하기 위해 create, retry, cancel 작업이 제거.
  • GitLab 19.5에서 목록 제외. 파이프라인 이름을 변경하려면 action: "update"와 함께 save_pipeline을 사용합니다.

이 도구는 ci 툴셋에 속합니다.

Warning

이 도구는 더 이상 나열되지 않지만, 오래된 도구 목록을 가지고 있거나 도구 이름을 저장해 둔 에이전트는 계속 호출할 수 있습니다. 파이프라인 이름을 변경하려면 대신 action: "update"와 함께 save_pipeline을 사용합니다. 파이프라인 삭제를 대체하는 도구는 아직 없습니다.

GitLab 프로젝트에서 파이프라인 메타데이터를 업데이트하거나 파이프라인을 삭제합니다. 파이프라인을 만들거나 재시도하거나 취소하려면 대신 save_pipeline 도구를 사용합니다. 파이프라인을 나열하려면 대신 list_pipelines 도구를 사용합니다.

파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
pipeline_id integer 예 파이프라인의 ID. 이 파라미터만 설정하면 파이프라인과 관련 데이터를 모두 삭제합니다.
name string 아니요 파이프라인의 이름. 이 파라미터와 pipeline_id를 함께 설정하면 파이프라인 메타데이터를 업데이트합니다.

예시:

  • 파이프라인 업데이트:

    Rename pipeline 12345 to "My deploy pipeline" in project gitlab-org/gitlab
    
  • 파이프라인 삭제:

    Delete pipeline 12345 in project gitlab-org/gitlab
    

get_work_item#

히스토리
  • GitLab 19.4에서 도입.
  • discussions 패싯이 GitLab 19.5에서 도입.
  • GitLab 19.6에서 호출당 둘 이상의 include 패싯을 받도록 변경.

이 도구는 work_items 툴셋에 속합니다.

단일 작업 항목(이슈, 에픽, 태스크, 인시던트, 목표 또는 핵심 결과)을 유형, 날짜, 담당자, 레이블, 마일스톤, 부모와 함께 가져옵니다. 선택적으로 해당 노트, 토론 또는 관련된 머지 리퀘스트도 포함합니다. 작업 항목 유형이 지원하지 않는 위젯은 생략됩니다.

파라미터 유형 필수 설명
url string 아니요 작업 항목의 GitLab URL(/-/work_items/, /-/issues/, /-/epics/ URL). 이것을 제공하거나 group_id 또는 project_id와 함께 work_item_iid를 제공합니다.
group_id string 아니요 그룹의 ID 또는 경로. url과 project_id가 없으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 경로. url과 group_id가 없으면 필수입니다.
work_item_iid integer 아니요 작업 항목의 내부 ID. url이 없으면 필수입니다.
include array 아니요 반환할 연관 데이터. notes, discussions, related_merge_requests 중 하나 이상입니다. 한 번의 호출에서 여러 패싯을 요청할 수 있습니다. 최신 노트를 가져오려면 notes_first 나 notes_after 없이 notes_last를 사용합니다.
notes_first integer 아니요 커서 이후로 반환할 노트 수(정방향 페이지네이션). 기본값 100, 최댓값 100.
notes_after string 아니요 노트의 정방향 페이지네이션용 커서. 이전 응답의 pageInfo.endCursor를 사용합니다.
notes_last integer 아니요 커서 이전으로 반환할 노트 수(역방향 페이지네이션). 기본값 100, 최댓값 100.
notes_before string 아니요 노트의 역방향 페이지네이션용 커서. 이전 응답의 pageInfo.startCursor를 사용합니다.
discussions_first integer 아니요 커서 이후로 반환할 토론 수. 기본값 20, 최댓값 100.
discussions_after string 아니요 토론의 정방향 페이지네이션용 커서. 이전 응답의 pageInfo.endCursor를 사용합니다.
discussions_filter string 아니요 반환할 토론: all_notes(기본값), 시스템 노트를 제외하는 only_comments, 시스템 노트만 반환하는 only_activity.
related_merge_requests_first integer 아니요 반환할 관련 머지 리퀘스트 수. 기본값 20, 최댓값 100.
related_merge_requests_after string 아니요 관련 머지 리퀘스트의 정방향 페이지네이션용 커서.
mr_page_size integer 아니요 더 이상 사용되지 않음: 대신 related_merge_requests_first를 사용합니다.
mr_pagination_cursor string 아니요 더 이상 사용되지 않음: 대신 related_merge_requests_after를 사용합니다.

notes 패싯은 호출당 최대 100개의 노트를 반환하며 notes_* 파라미터로 양방향 페이지네이션을 지원합니다. 각 노트에는 노트가 속한 스레드의 ID인 discussion.id가 포함되므로 스레드별로 노트를 묶을 수 있습니다.

스레드 구조와 해결 상태에는 discussions를, 시간순으로 나열한 평면 기록에는 notes를 사용합니다.

discussions 패싯은 작업 항목의 스레드를 반환합니다. 각 토론에는 resolvable 및 resolved 상태와 노트가 포함되므로 아직 해결되지 않은 스레드를 찾을 수 있습니다. 해결되지 않은 스레드는 resolvable이 true이고 resolved가 false입니다. discussions_* 파라미터로 정방향 페이지네이션만 지원하며, 하나의 토론이 여러 페이지로 나뉘지 않습니다.

related_merge_requests 패싯은 에픽과 같은 그룹 작업 항목에서는 비어 있습니다.

예시:

Get issue 42 in project gitlab-org/gitlab with its related merge requests

get_workitem_notes#

히스토리

이 도구는 work_items 툴셋에 속합니다.

양방향으로 노트를 페이지네이션하는 include: ["notes"]와 함께 사용하는 get_work_item으로 대체되었습니다. 이 도구는 더 이상 tools/list에 나타나지 않지만, 호출자가 마이그레이션하는 동안에는 계속 호출할 수 있습니다.

특정 GitLab 작업 항목의 모든 노트(댓글)를 가져옵니다.

파라미터 유형 필수 설명
url string 아니요 작업 항목의 URL. group_id 또는 project_id와 work_item_iid가 없으면 필수입니다.
group_id string 아니요 그룹의 ID 또는 경로. url과 project_id가 없으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 경로. url과 group_id가 없으면 필수입니다.
work_item_iid integer 아니요 작업 항목의 내부 ID. url이 없으면 필수입니다.
after string 아니요 정방향 페이지네이션용 커서.
before string 아니요 역방향 페이지네이션용 커서.
first integer 아니요 정방향 페이지네이션으로 반환할 노트 수.
last integer 아니요 역방향 페이지네이션으로 반환할 노트 수.

예시:

Show me all comments on work item 42 in project gitlab-org/gitlab
히스토리
  • GitLab 19.0에서 도입.
  • GitLab 19.4에서 work_items_ids에 일반 iid를 사용할 수 있게 도입.

이 도구는 work_items 툴셋에 속합니다.

작업 항목을 관계 유형과 함께 하나 이상의 다른 작업 항목에 연결합니다.

파라미터 유형 필수 설명
work_items_ids array 예 연결할 작업 항목: 원본과 같은 프로젝트 또는 그룹에서 확인되는 일반 iid, 또는 다른 프로젝트나 그룹의 작업 항목에 대한 글로벌 ID(gid://gitlab/WorkItem/<id>). 최대 10개 항목.
url string 아니요 원본 작업 항목의 URL. group_id 또는 project_id와 work_item_iid가 없으면 필수입니다.
group_id string 아니요 그룹의 ID 또는 경로. url과 project_id가 없으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 경로. url과 group_id가 없으면 필수입니다.
work_item_iid integer 아니요 원본 작업 항목의 내부 ID. url이 없으면 필수입니다.
link_type string 아니요 관계 유형. relates_to, blocks, blocked_by 중 하나. 기본값은 relates_to입니다. blocks와 blocked_by 유형에는 GitLab Premium 또는 Ultimate가 필요합니다.

예시:

Mark work item 42 in project gitlab-org/gitlab as blocked by work item 40

get_saved_view_work_items#

히스토리
  • GitLab 18.11에서 도입.
  • GitLab 19.6에서 숫자 saved_view_id를 받고 표시 설정을 반환하도록 변경.

이 도구는 work_items 툴셋에 속합니다.

네임스페이스에서 저장된 뷰와 해당 작업 항목 목록을 가져옵니다. 이 도구는 저장된 뷰의 필터와 정렬 순서를 반환되는 작업 항목에 적용합니다. 출력에는 저장된 뷰의 표시 설정도 포함됩니다.

파라미터 유형 필수 설명
saved_view_id string 예 저장된 뷰의 숫자 ID(예: 42) 또는 글로벌 ID(gid://gitlab/WorkItems::SavedViews::SavedView/42).
url string 아니요 네임스페이스(프로젝트 또는 그룹)의 URL. group_id 또는 project_id가 없으면 필수입니다.
group_id string 아니요 그룹의 ID 또는 경로. url과 project_id가 없으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 경로. url과 group_id가 없으면 필수입니다.
after string 아니요 정방향 페이지네이션용 커서.
first integer 아니요 반환할 작업 항목 수. 최댓값 100.

예시:

Show me the work items in this saved view: 

list_vulnerabilities#

히스토리

이 도구는 code_security 툴셋에 속합니다.

GitLab 프로젝트의 보안 취약점을 선택적 필터와 커서 페이지네이션으로 나열합니다. 페이지네이션된 취약점 메타데이터를 반환합니다. 단일 취약점의 전체 상세 정보를 가져오려면 get_vulnerability를 사용합니다.

보안 대시보드 기능이 활성화되어 있어야 합니다.

이 도구는 라이선스가 적용되는 기능을 사용할 수 있는 경우에만 나열됩니다. 자세한 내용은 도구 그룹 선택을 참고합니다.

파라미터 유형 필수 설명
project_full_path string 예 프로젝트의 전체 경로(예: namespace/project 또는 group/subgroup/project).
severity array of strings 아니요 심각도 수준으로 필터링합니다. 생략하면 모든 심각도의 취약점을 포함합니다. CRITICAL, HIGH, MEDIUM, LOW, INFO, UNKNOWN 중 하나 이상.
report_type array of strings 아니요 보안 보고서 유형으로 필터링합니다. 생략하면 모든 보고서 유형을 포함합니다. 예: SAST, DAST, DEPENDENCY_SCANNING.
state array of strings 아니요 취약점 상태로 필터링합니다. 생략하면 모든 상태의 취약점을 포함합니다. CONFIRMED, DETECTED, DISMISSED, RESOLVED 중 하나 이상.
first integer 아니요 정방향 페이지네이션으로 반환할 취약점 수. 기본값은 20, 최댓값은 100입니다.
after string 아니요 정방향 페이지네이션용 커서. 이전 응답의 pageInfo.endCursor를 사용합니다.

예시:

List critical and high severity vulnerabilities in project gitlab-org/gitlab

get_vulnerability#

히스토리

이 도구는 code_security 툴셋에 속합니다.

제목, 상태, 설명, 심각도, 식별자를 포함하여 단일 취약점의 상세 정보를 반환합니다.

이 도구는 라이선스가 적용되는 기능을 사용할 수 있는 경우에만 나열됩니다. 자세한 내용은 도구 그룹 선택을 참고합니다.

파라미터 유형 필수 설명
vulnerability_id string 예 취약점의 숫자 ID(예: 567).

예시:

Get full details for vulnerability 567

save_vulnerability#

히스토리

이 도구는 code_security 툴셋에 속합니다.

GitLab 프로젝트의 취약점에 대해 쓰기 작업을 수행합니다.

이 도구는 라이선스가 적용되는 기능을 사용할 수 있는 경우에만 나열됩니다. 자세한 내용은 도구 그룹 선택을 참고합니다.

파라미터 유형 필수 설명
action string 예 수행할 작업. dismiss, confirm, revert_to_detected, update_severity, create_issue 중 하나.
vulnerability_id string 예 취약점의 숫자 ID(예: 567).
comment string 아니요 작업에 대한 설명. action 이 update_severity 일 때 필수입니다.
dismissal_reason string 아니요 무시 사유. ACCEPTABLE_RISK, FALSE_POSITIVE, MITIGATING_CONTROL, USED_IN_TESTS, NOT_APPLICABLE 중 하나. action 이 dismiss 일 때만 사용합니다.
severity string 아니요 새 심각도 수준. INFO, UNKNOWN, LOW, MEDIUM, HIGH, CRITICAL 중 하나. action 이 update_severity 일 때 필수입니다.
project_full_path string 아니요 프로젝트의 전체 경로(예: namespace/project). action 이 create_issue 일 때 필수입니다.

예시:

  • 취약점 무시:

    Dismiss vulnerability 123 with reason FALSE_POSITIVE
    
  • 취약점 확인:

    Mark vulnerability 456 as confirmed
    
  • 탐지됨 상태로 되돌리기:

    Revert vulnerability 789 back to detected state
    
  • 심각도 업데이트:

    Change severity of vulnerability 321 to CRITICAL with comment "Reassessed based on new intel"
    
  • 이슈 만들기:

    Create an issue for vulnerability 654 in project gitlab-org/gitlab
    

save_work_item#

히스토리
  • GitLab 19.4에서 도입.
  • GitLab 19.4에서 labels, add_labels, remove_labels, milestone_id, milestone 파라미터가 도입.
  • GitLab 19.6에서 description_edits 파라미터가 도입.

이 도구는 work_items 툴셋에 속합니다.

이슈, 태스크, 에픽과 같은 GitLab 작업 항목을 만들거나 업데이트합니다. 새 작업 항목을 만들려면 work_item_iid를 생략합니다. 기존 작업 항목을 업데이트하려면 work_item_iid 또는 작업 항목 URL을 제공합니다. 설정하려는 필드만 보내고 나머지는 생략합니다. 도구 이름 create_work_item과 update_work_item은 이 도구의 별칭입니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트, 그룹 또는 작업 항목의 GitLab URL. url, project_id, group_id 중 정확히 하나를 제공합니다.
group_id string 아니요 그룹의 ID 또는 경로. url과 project_id가 없으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 경로. url과 group_id가 없으면 필수입니다.
work_item_iid integer 아니요 업데이트할 작업 항목의 양수 내부 ID. 새 작업 항목을 만들려면 생략합니다.
title string 아니요 작업 항목의 제목. 작업 항목을 만들 때 필수입니다.
type_name string 아니요 작업 항목 유형 이름(예: Issue, Task, Epic). 작업 항목을 만들 때 필수입니다. 유효한 유형은 네임스페이스와 라이선스에 따라 달라집니다.
description string 아니요 GitLab Flavored Markdown으로 작성한 설명. 최대 1,048,576자.
description_edits array of objects 아니요 업데이트 전용. 현재 설명에 순서대로 적용할 교체 항목이며, 각 항목은 old_str과 new_str을 가집니다. 각 old_str은 정확히 한 번 일치해야 합니다. description과 함께 사용할 수 없습니다. 최대 100개 항목.
assignee_ids array of integers 아니요 작업 항목에 배정할 사용자 ID. 최대 100개 항목.
label_ids array of strings 아니요 레이블 ID 또는 글로벌 ID. 만들 때만 사용하며, 업데이트할 때는 add_label_ids 또는 remove_label_ids를 사용합니다. 최대 100개 항목.
labels array of strings 아니요 설정할 레이블 이름. 프로젝트 또는 그룹과 그 상위 그룹에서 확인됩니다. 만들 때만 사용하며, 업데이트할 때는 add_labels 또는 remove_labels를 사용합니다. 최대 100개 항목.
add_label_ids array of strings 아니요 업데이트 전용. 추가할 레이블 ID 또는 글로벌 ID. 최대 100개 항목.
add_labels array of strings 아니요 업데이트 전용. 추가할 레이블 이름. 최대 100개 항목.
remove_label_ids array of strings 아니요 업데이트 전용. 제거할 레이블 ID 또는 글로벌 ID. 최대 100개 항목.
remove_labels array of strings 아니요 업데이트 전용. 제거할 레이블 이름. 최대 100개 항목.
milestone_id string 아니요 배정할 마일스톤의 ID 또는 글로벌 ID. 프로젝트 또는 그룹과 그 상위 그룹을 기준으로 검증됩니다. 둘 다 지정하면 milestone 보다 우선합니다.
milestone string 아니요 배정할 마일스톤의 제목. 프로젝트 또는 그룹과 그 상위 그룹의 마일스톤 중에서 확인됩니다.
confidential boolean 아니요 작업 항목의 기밀 여부를 설정합니다.
start_date string 아니요 시작일. YYYY-MM-DD 형식.
due_date string 아니요 기한. YYYY-MM-DD 형식.
state string 아니요 업데이트 전용. closed는 작업 항목을 닫고, opened는 다시 엽니다.
parent_id string 아니요 부모 작업 항목의 글로벌 ID 또는 숫자 ID.
todo_action string 아니요 업데이트 전용. add는 현재 사용자의 할 일을 추가하고, mark_as_done은 할 일을 완료로 표시합니다.
todo_id string 아니요 업데이트 전용. 할 일의 글로벌 ID 또는 숫자 ID. 작업 항목의 모든 할 일을 업데이트하려면 생략합니다.
health_status string 아니요 상태(health status). onTrack, needsAttention, atRisk 중 하나. Ultimate 전용.
weight integer 아니요 작업 항목의 가중치. 0 이상이어야 합니다. Premium 및 Ultimate 전용.
clear_weight boolean 아니요 업데이트 전용. 가중치를 제거합니다. weight 보다 우선합니다. Premium 및 Ultimate 전용.
status_id string 아니요 설정할 상태의 글로벌 ID. Premium 및 Ultimate 전용.
is_fixed boolean 아니요 시작일과 기한이 고정인지 여부. false이면 날짜가 하위 항목에서 집계되며 start_date와 due_date는 무시됩니다. Premium 및 Ultimate 전용.
agent_plan string 아니요 에이전트 계획의 Markdown 콘텐츠. Premium 및 Ultimate 전용. workplan 기능이 필요합니다.
readiness_score integer 아니요 에이전트 계획의 준비도 점수, 0~100. Premium 및 Ultimate 전용. workplan 기능이 필요합니다.

예시:

Create a task "Update the onboarding guide" in project gitlab-org/gitlab and assign it to me

list_work_item_saved_views#

히스토리

이 도구는 work_items 툴셋에 속합니다.

프로젝트 또는 그룹의 작업 항목 저장된 뷰를 나열합니다. url, group_id, project_id 중 정확히 하나를 제공합니다. 결과의 각 저장된 뷰에는 숫자 id가 있습니다. 저장된 뷰 하나의 필터와 작업 항목을 가져오려면 해당 id를 get_saved_view_work_items에 전달합니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트 또는 그룹의 URL.
group_id string 아니요 그룹의 ID 또는 경로.
project_id string 아니요 프로젝트의 ID 또는 경로.
search string 아니요 이름 또는 설명으로 저장된 뷰를 검색합니다.
subscribed_only boolean 아니요 true이면 구독 중인 저장된 뷰만 반환합니다.
sort string 아니요 정렬 순서. ID는 최신순으로 정렬합니다. NAME_ASC는 이름순으로 정렬합니다. RELATIVE_POSITION은 구독 중인 뷰의 사용자 지정 순서로 정렬하며 subscribed_only: true가 필요합니다. 기본값은 ID입니다.
after string 아니요 정방향 페이지네이션용 커서.
first integer 아니요 반환할 저장된 뷰 수. 최댓값 100.

예시:

List the saved views in group gitlab-org

list_work_items#

히스토리
  • GitLab 19.4에서 도입.
  • GitLab 19.6에서 parent_iid 파라미터가 추가.

이 도구는 work_items 툴셋에 속합니다.

그룹 또는 프로젝트의 작업 항목(이슈, 인시던트, 테스트 케이스, 요구 사항, 태스크, 티켓, 목표, 핵심 결과, 에픽)을 나열하거나 검색합니다. 그룹 범위에는 하위 프로젝트와 하위 그룹의 작업 항목이 포함됩니다. 각 결과에는 ID, IID, 제목, 상태, 웹 URL, 전체 참조, 생성 및 업데이트 타임스탬프, 작업 항목 유형만 포함되며 커서 페이지네이션을 사용합니다. 작업 항목 하나를 자세히 읽으려면 get_work_item을 사용합니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트 또는 그룹의 GitLab URL. url, group_id, project_id 중 정확히 하나를 제공합니다.
group_id string 아니요 그룹의 ID 또는 경로. url과 project_id가 없으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 경로. url과 group_id가 없으면 필수입니다.
state string 아니요 상태로 필터링합니다: opened, closed, all(기본값).
search string 아니요 제목과 설명에서 자유 텍스트로 검색합니다.
author_username string 아니요 작성자의 사용자 이름.
assignee_usernames array 아니요 담당자의 사용자 이름. 작업 항목이 모두와 일치해야 합니다. 최대 100개 값.
label_name array 아니요 레이블 이름. 작업 항목이 모두 가지고 있어야 합니다. 최대 100개 값.
milestone_title array 아니요 마일스톤 제목. milestone_wildcard_id와 함께 사용할 수 없습니다. 최대 100개 값.
milestone_wildcard_id string 아니요 NONE, ANY, STARTED, UPCOMING. milestone_title과 함께 사용할 수 없습니다.
types array 아니요 포함할 작업 항목 유형(예: ["ISSUE", "TASK"]).
parent_iid integer 아니요 지정한 프로젝트 또는 그룹에 있는 부모 작업 항목의 IID. 해당 항목의 직접 하위 항목을 반환합니다.
created_after string 아니요 이 시간 이후에 생성됨(ISO 8601. 날짜만 지정하면 해당 날짜의 시작, 오프셋 적용).
created_before string 아니요 이 시간 이전에 생성됨(ISO 8601. 날짜만 지정하면 해당 날짜의 시작, 오프셋 적용).
updated_after string 아니요 이 시간 이후에 업데이트됨(ISO 8601. 날짜만 지정하면 해당 날짜의 시작, 오프셋 적용).
updated_before string 아니요 이 시간 이전에 업데이트됨(ISO 8601. 날짜만 지정하면 해당 날짜의 시작, 오프셋 적용).
due_after string 아니요 기한이 이 시간 이후임(ISO 8601. 날짜만 지정하면 해당 날짜의 시작, 오프셋 적용).
due_before string 아니요 기한이 이 시간 이전임(ISO 8601. 날짜만 지정하면 해당 날짜의 시작, 오프셋 적용).
sort string 아니요 정렬 순서(예: UPDATED_DESC). 기본값 CREATED_DESC.
first integer 아니요 반환할 작업 항목 수. 기본값 20, 최댓값 100.
after string 아니요 정방향 페이지네이션용 커서.
health_status_filter string 아니요 Ultimate 전용. onTrack, needsAttention, atRisk.
status object 아니요 Ultimate 전용. 사용자 지정 상태 이름으로 필터링합니다(예: {"name": "In progress"}).

예시:

List my open tasks in the gitlab-org group updated this month.

get_work_item_types#

히스토리

이 도구는 work_items 툴셋에 속합니다.

네임스페이스(그룹 또는 프로젝트)에서 사용할 수 있는 작업 항목 유형을 나열합니다. 여기에는 시스템 정의 유형(예: Issue, Epic, Task)과 사용자 지정 유형이 포함됩니다. 반환되는 각 유형에는 글로벌 ID, 이름, 아이콘, 해당 유형에서 활성화된 위젯 유형이 포함되므로, 해당 유형이 지원하지 않는 필드를 설정하지 않도록 할 수 있습니다.

프로젝트 수준 유형의 경우 include: ["work_item_types"]와 함께 get_project를 사용하면 프로젝트와 함께 같은 데이터를 반환합니다.

파라미터 유형 필수 설명
url string 아니요 네임스페이스(프로젝트 또는 그룹)의 GitLab URL. group_id와 project_id가 없으면 필수입니다.
group_id string 아니요 그룹의 ID 또는 경로. url과 project_id가 없으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 경로. url과 group_id가 없으면 필수입니다.

예시:

List the work item types available in the gitlab-org group

list_projects#

히스토리

이 도구는 core 툴셋에 속합니다.

group_id가 없으면 기본적으로 Guest 권한 이상을 가진 프로젝트를 나열하며, 기준을 높이려면 min_access_level을 전달합니다. group_id가 있으면 액세스 수준과 관계없이 해당 그룹과 그 하위 그룹의 모든 프로젝트를 나열합니다. min_access_level 이나 visibility를 추가하면 GitLab이 그룹의 프로젝트를 나열할 때 하위 그룹 탐색과 이러한 필터를 함께 사용하는 것을 지원하지 않으므로, 목록이 하위 그룹을 제외한 해당 그룹으로만 좁혀집니다.

파라미터 유형 필수 설명
group_id string 아니요 그룹의 ID 또는 전체 경로. 생략하면 인스턴스 전체에서 나열하며, 기본적으로 Guest 권한 이상을 가진 프로젝트를 대상으로 합니다.
min_access_level string 아니요 프로젝트가 포함되려면 본인에게 부여해야 하는 최소 액세스 수준. guest, planner, reporter, developer, maintainer, owner 중 하나.
search string 아니요 이름, 경로 또는 설명으로 프로젝트를 검색합니다.
visibility string 아니요 공개 범위 수준으로 필터링합니다: public, internal, private.
archived string 아니요 보관 상태로 필터링합니다: only, include, exclude(기본값).
after string 아니요 정방향 페이지네이션용 커서.
first integer 아니요 정방향 페이지네이션으로 반환할 프로젝트 수. 기본값은 20, 최댓값은 100입니다.

group_id를 제공하면 응답에 subgroupsIncluded가 포함됩니다. 목록이 그룹의 하위 그룹을 포함하면 true, min_access_level 또는 visibility로 목록이 해당 그룹으로만 좁혀졌으면 false입니다.

예시:

List my projects

get_group#

히스토리

이 도구는 core 툴셋에 속합니다.

단일 GitLab 그룹에 대해 다음 메타데이터를 반환합니다.

  • 숫자 ID
  • 전체 경로
  • 이름
  • 공개 범위
  • 부모
  • 웹 URL

url 또는 group_id 중 하나를 제공합니다.

파라미터 유형 필수 설명
url string 아니요 그룹의 URL.
group_id string 아니요 그룹의 ID 또는 전체 경로(예: gitlab-org/quality).

응답에는 id, fullPath, name, visibility, webUrl, parent가 포함됩니다. parent 필드에는 부모 그룹의 숫자 ID가 들어 있습니다. 최상위 그룹이거나 부모 그룹에 액세스할 수 없으면 null입니다. 그룹을 찾으려면 list_groups를 사용합니다.

예시:

What is the ID and visibility of gitlab-org/quality?

list_groups#

히스토리

이 도구는 core 툴셋에 속합니다.

그룹 계층을 탐색하고 다른 도구에서 사용할 그룹 ID와 전체 경로를 찾기 위해 그룹을 나열합니다. group_id가 없으면 이 도구는 본인이 멤버인 최상위 그룹을 나열합니다. group_id가 있으면 멤버십과 관계없이 해당 그룹의 직접 하위 그룹을 나열합니다. include_subgroups를 true로 설정하면 모든 하위 그룹으로 재귀합니다. group_id가 없을 때는 본인의 그룹을 모든 깊이에서 나열합니다. 보관된 그룹과 삭제 예정인 그룹은 제외됩니다.

파라미터 유형 필수 설명
group_id string 아니요 하위 그룹을 나열할 상위 그룹의 ID 또는 전체 경로. 생략하면 본인이 멤버인 최상위 그룹을 나열합니다.
search string 아니요 이름 또는 전체 경로로 그룹을 검색합니다.
visibility string 아니요 공개 범위 수준으로 필터링합니다: public, internal, private.
include_subgroups boolean 아니요 직접 하위 그룹만이 아니라 모든 하위 그룹을 재귀적으로 포함합니다.
after string 아니요 정방향 페이지네이션용 커서.
first integer 아니요 정방향 페이지네이션으로 반환할 그룹 수. 기본값은 20, 최댓값은 100입니다.

예시:

List the subgroups of gitlab-org
히스토리
  • GitLab 18.4에서 도입.
  • GitLab 18.6에서 그룹과 프로젝트 검색, 결과 정렬 및 순서 지정이 추가.
  • GitLab 18.8에서 gitlab_search에서 search로 이름 변경.

이 도구는 core 툴셋에 속합니다.

검색 API로 전체 GitLab 인스턴스에서 검색어를 검색합니다. 이 도구는 전역, 그룹, 프로젝트 검색에서 사용할 수 있습니다. 사용 가능한 범위는 검색 유형에 따라 다릅니다.

파라미터 유형 필수 설명
scope string 예 검색 범위(예: work_items, merge_requests, projects).
search string 예 검색어.
group_id string 아니요 검색할 그룹의 ID 또는 전체 경로.
project_id string 아니요 검색할 프로젝트의 ID 또는 전체 경로.
state string 아니요 검색 결과의 상태(work_items 및 merge_requests 용).
confidential boolean 아니요 기밀 여부로 결과를 필터링합니다(work_items 용). 기본값은 false입니다.
fields array of strings 아니요 검색할 필드 배열(work_items 및 merge_requests 용).
order_by string 아니요 결과를 정렬할 속성. 기본값은 기본 검색에서는 created_at, 고급 검색에서는 관련도입니다.
sort string 아니요 결과의 정렬 방향. 기본값은 desc입니다.
per_page integer 아니요 페이지당 결과 수. 기본값은 20입니다.
page integer 아니요 현재 페이지 번호. 기본값은 1입니다.

예시:

Search issues for "flaky test" across GitLab

search_labels#

히스토리
  • GitLab 18.9에서 도입.
  • GitLab 19.5에서 여러 검색어를 받도록 변경.
  • GitLab 19.6에서 project_id와 group_id를 받도록 변경.

이 도구는 core 툴셋에 속합니다.

GitLab 프로젝트 또는 그룹에서 레이블을 검색합니다.

파라미터 유형 필수 설명
project_id string 아니요 프로젝트의 ID 또는 경로. group_id 또는 full_path의 대안입니다.
group_id string 아니요 그룹의 ID 또는 경로. project_id 또는 full_path의 대안입니다.
full_path string 아니요 프로젝트 또는 그룹의 전체 경로(예: group/project). project_id 또는 group_id의 대안입니다. is_project가 필요합니다.
is_project boolean 아니요 full_path가 프로젝트(true)인지 그룹(false)인지 여부. full_path와 함께 사용할 때 필수입니다.
search string or array of strings 아니요 제목으로 레이블을 필터링하는 검색어 하나 또는 최대 10개의 검색어 배열. 생략하면 대신 레이블을 나열합니다. 빈 배열은 유효하지 않습니다.

project_id, group_id, full_path 중 정확히 하나를 제공합니다.

그룹 레이블을 검색하면 결과에 상위 그룹과 하위 그룹의 레이블이 포함됩니다. 여러 검색어의 결과는 중복되는 레이블 없이 하나의 목록으로 합쳐집니다.

예시:

Show me all labels in project gitlab-org/gitlab

list_wiki_pages#

히스토리

이 도구는 wikis 툴셋에 속합니다.

GitLab 프로젝트 또는 그룹의 위키 페이지를 나열합니다.

파라미터 유형 필수 설명
project_id string 아니요 프로젝트의 전체 경로 또는 숫자 ID(예: gitlab-org/gitlab 또는 278964).
group_id string 아니요 그룹의 전체 경로 또는 숫자 ID(예: gitlab-org 또는 9970).
first integer 아니요 정방향 페이지네이션으로 반환할 위키 페이지 수(최댓값 100).
after string 아니요 정방향 페이지네이션용 커서.

project_id 또는 group_id 중 하나만 제공합니다. 각 호출은 결과의 한 페이지를 반환합니다. 페이지가 더 있으면 응답에 end_cursor가 포함되며, 이를 after로 전달하여 다음 페이지를 가져올 수 있습니다.

예시:

List the wiki pages in gitlab-org/gitlab
히스토리
  • GitLab 18.5에서 code_snippet_search_graphqlapi 라는 기능 플래그와 함께 실험 기능으로 도입. 기본적으로 비활성화되어 있습니다.
  • GitLab 18.6에서 프로젝트 경로로 검색이 추가.
  • GitLab 18.7에서 실험 기능에서 베타로 변경. 기능 플래그 code_snippet_search_graphqlapi 제거.
  • GitLab 18.7에서 mcp_client 라는 기능 플래그와 함께 GitLab UI에 추가. 기본적으로 비활성화되어 있습니다.
  • GitLab 18.11에서 mcp_semantic_code_search_use_rest_api 라는 기능 플래그와 함께 REST API를 사용하도록 업데이트. 기본적으로 비활성화되어 있습니다.
  • GitLab 19.1에서 REST API 사용이 정식 출시. 기능 플래그 mcp_semantic_code_search_use_rest_api 제거.
  • GitLab 19.4에서 semantic_code_search에서 이름 변경. semantic_code_search는 별칭으로 계속 작동합니다.
  • GitLab 19.4에서 scope 파라미터가 추가.
  • GitLab 19.4에서 semantic_query 파라미터가 q로 이름 변경.
  • GitLab 19.6에서 scope 파라미터가 선택 사항으로 변경.

이 도구는 core 툴셋에 속합니다.

Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.

키워드가 아니라 의미를 기준으로 GitLab 프로젝트에서 관련 콘텐츠를 검색합니다. 정확한 심볼이나 파일 이름을 모르거나, 코드베이스 전반에서 특정 동작이 어떻게 구현되어 있는지 파악할 때 이 도구를 사용합니다. 설정 및 활성화를 포함한 자세한 내용은 시맨틱 코드 검색을 참고합니다.

파라미터 유형 필수 설명
scope string 아니요 검색할 콘텐츠 유형. code만 지원됩니다. 생략하면 code가 사용됩니다.
q string 예 자연어 검색 쿼리.
project_id string 예 프로젝트의 ID 또는 전체 경로.
directory_path string 아니요 이 디렉터리 경로 아래의 파일로 검색을 제한합니다(예: app/services/). 앞에 슬래시나 .. 세그먼트가 없는 상대 경로여야 합니다. scope가 code 일 때만 적용됩니다.
knn integer 아니요 내부적으로 조회하는 최근접 이웃 수. 기본값은 64, 최댓값은 100입니다. 값이 높을수록 지연 시간을 대가로 재현율이 향상됩니다. scope가 code 일 때만 적용됩니다.
limit integer 아니요 반환할 최대 결과 수. 기본값은 20, 최댓값은 100입니다. scope가 code 일 때만 적용됩니다.

결과는 파일별로 그룹화됩니다. 각 파일에는 콘텐츠와 관련도 점수가 있는 병합된 줄 범위가 포함됩니다. 최상의 결과를 얻으려면 일반적인 키워드나 특정 함수 또는 변수 이름을 사용하지 말고, 알고 싶은 기능이나 동작을 설명합니다.

예시:

How are authorizations managed in this project?

attach_scan_profile#

히스토리

이 도구는 code_security 툴셋에 속합니다.

지정한 보안 스캔 프로파일을 지정한 프로젝트 또는 지정한 그룹 아래의 모든 프로젝트에 연결합니다.

이 도구는 라이선스가 적용되는 기능을 사용할 수 있는 경우에만 나열됩니다. 자세한 내용은 도구 그룹 선택을 참고합니다.

파라미터 유형 필수 설명
security_scan_profile_id string 예 보안 스캔 프로파일의 글로벌 ID(예: gid://gitlab/Security::ScanProfile/1).
project_ids array of strings 아니요 프로젝트의 글로벌 ID 배열(예: [gid://gitlab/Project/1]). group_ids를 제공하지 않으면 필수입니다.
group_ids array of strings 아니요 그룹의 글로벌 ID 배열(예: [gid://gitlab/Group/1]). project_ids를 제공하지 않으면 필수입니다.

예시:

Attach `gid://gitlab/Security::ScanProfile/1` to all projects under `gid://gitlab/Group/1`.

Orbit 도구#

히스토리

orbit 툴셋에는 GitLab Orbit 명령마다 도구가 하나씩 있습니다(예: query_graph). 도구 이름, 설명, 입력 스키마는 Orbit 서버가 설정합니다. MCP 클라이언트는 GitLab MCP 서버에서 현재 도구 목록을 가져옵니다. 명령과 각 명령의 기능은 GitLab Orbit 엔드포인트 도구를 참고합니다.

이 도구는 orbit 툴셋을 요청하고 Orbit 요구 사항을 충족하는 경우에만 나열됩니다. 자세한 내용은 도구 그룹 선택을 참고합니다.

예시:

Use GitLab Orbit to list the 5 most recently updated projects in my group.

Footnotes

  1. resolve_discussion의 경우 도구는 method, 글로벌 ID 형식의 discussion_id, 새 resolved 상태, 스레드 첫 번째 노트의 web_url을 반환합니다. ↩

GitLab MCP 서버 도구

GitLab v19.6
Tier: Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
원문 보기

요약

이 기능에 대한 피드백을 제공하려면 이슈 630189에 댓글을 남깁니다. GitLab MCP 서버는 기존 GitLab 워크플로와 통합하는 도구 세트를 제공합니다. 각 도구는 툴셋에 속하며, 툴셋은 GitLab MCP 서버가 특정 연결에 해당 도구를 반환할지 결정합니다.

Warning

이 기능에 대한 피드백을 제공하려면 이슈 630189에 댓글을 남깁니다.

GitLab MCP 서버는 기존 GitLab 워크플로와 통합하는 도구 세트를 제공합니다. 이 도구를 사용하여 GitLab과 직접 상호 작용하고 일반적인 GitLab 작업을 수행할 수 있습니다.

각 도구는 툴셋에 속하며, 툴셋은 GitLab MCP 서버가 특정 연결에 해당 도구를 반환할지 결정합니다. 에이전트가 예상한 도구를 찾지 못하면 해당 툴셋이 활성화되어 있는지 확인합니다.

툴셋별 도구#

툴셋 도구
meta get_mcp_server_version
core get_project, save_project, get_user, get_group, list_groups, list_projects, list_project_members, list_todos, list_user_events, list_milestones, save_note, search, search_labels, semantic_search, get_pages_content
merge_requests save_merge_request, get_merge_request, list_merge_requests, get_merge_request_commits (목록 제외, 대체됨), get_merge_request_diffs (목록 제외, 대체됨), get_merge_request_pipelines (목록 제외, 대체됨), get_merge_request_conflicts (목록 제외, 대체됨), get_merge_request_notes (목록 제외, 대체됨), save_merge_request_review, accept_merge_request
work_items get_work_item, get_workitem_notes (목록 제외, 대체됨), get_work_item_types, link_work_items, get_saved_view_work_items, list_work_item_saved_views, save_work_item, list_work_items, create_issue (목록 제외, 대체됨), get_issue (목록 제외, 대체됨)
repository add_branch, fork_repository, list_branches, get_repository_file, list_repository_tree, get_commit, list_commits, list_releases, list_tags, add_commit
ci get_pipeline, get_pipeline_jobs (목록 제외, 대체됨), get_job, get_artifact_file, list_pipelines, list_pipeline_schedules, save_pipeline, save_pipeline_job, manage_pipeline (목록 제외, 대체됨)
duo_agent_platform list_duo_agents_and_flows, start_duo_session, list_duo_sessions, get_duo_session, send_duo_session_input
wikis list_wiki_pages
code_security list_vulnerabilities, get_vulnerability, save_vulnerability, attach_scan_profile
orbit Orbit tools

get_mcp_server_version#

히스토리

이 도구는 meta 툴셋에 속합니다.

GitLab MCP 서버의 현재 버전을 반환합니다.

예시:

What version of the GitLab MCP server am I connected to?

get_project#

히스토리
  • GitLab 19.4에서 도입.
  • GitLab 19.6에서 include 파라미터가 도입.

이 도구는 core 툴셋에 속합니다.

단일 GitLab 프로젝트의 메타데이터(숫자 ID, 전체 경로, 기본 브랜치, 공개 범위, 웹 URL)를 반환합니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트의 URL. url 또는 project_id 중 정확히 하나를 제공합니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url 또는 project_id 중 정확히 하나를 제공합니다.
include array 아니요 프로젝트와 함께 포함할 패싯. 호출당 하나: work_item_types.

프로젝트에 아직 리포지터리가 없으면 default_branch는 null입니다. 아직 이름을 알 수 없는 프로젝트를 찾으려면 projects 범위로 search를 사용합니다.

work_item_types 패싯은 프로젝트에서 사용할 수 있는 작업 항목 유형을 나열합니다. 각 유형에는 글로벌 ID, 이름, 아이콘, 해당 유형에서 활성화된 위젯 유형이 포함되므로, save_work_item을 호출할 때 해당 유형이 지원하지 않는 필드를 설정하지 않도록 할 수 있습니다.

예시:

What is the default branch of gitlab-org/gitlab?

save_project#

히스토리

이 도구는 core 툴셋에 속합니다.

지정한 네임스페이스(그룹 또는 사용자)에 새 GitLab 프로젝트를 만듭니다. 네임스페이스를 지정하지 않으면 인증된 사용자의 개인 네임스페이스에 프로젝트를 만듭니다.

파라미터 유형 필수 설명
name string 예 프로젝트 이름.
path string 아니요 프로젝트의 URL 슬러그. 기본값은 이름을 슬러그로 변환한 값입니다.
namespace_id integer 아니요 프로젝트를 만들 네임스페이스(그룹 또는 사용자)의 ID.
namespace_path string 아니요 네임스페이스의 전체 경로. namespace_id의 대안이며 둘 중 하나만 제공합니다.
description string 아니요 프로젝트 설명.
visibility string 아니요 공개 범위: private, internal, public 중 하나. 기본값은 인스턴스의 기본 프로젝트 공개 범위입니다.
initialize_with_readme boolean 아니요 초기 README.md 파일을 만듭니다.
default_branch string 아니요 기본 브랜치 이름. 기본값은 인스턴스의 기본값입니다.
topics array of strings 아니요 프로젝트의 토픽(태그) 목록.
template_name string 아니요 프로젝트 템플릿 이름. 기본 제공 템플릿(예: rails, spring, express)에는 단독으로 사용합니다. 사용자 지정 템플릿에는 use_custom_template과 함께 사용합니다.
template_project_id integer 아니요 사용자 지정 템플릿의 프로젝트 ID. template_name의 대안입니다. use_custom_template과 함께 사용합니다. Premium 및 Ultimate 전용.
use_custom_template boolean 아니요 사용자 지정 프로젝트 템플릿을 사용합니다. template_name 또는 template_project_id가 필요합니다. Premium 및 Ultimate 전용.
group_with_project_templates_id integer 아니요 그룹 수준 템플릿의 템플릿 소스 역할을 하는 그룹의 ID. 인스턴스 수준 템플릿에는 선택 사항입니다. Premium 및 Ultimate 전용.

예시:

Create a new private project called "my-app" in the gitlab-org group

add_commit#

히스토리
  • GitLab 19.3에서 도입.
  • GitLab 19.4에서 start_sha 및 start_project 파라미터가 도입.

이 도구는 repository 툴셋에 속합니다.

한 번의 호출로 하나 이상의 파일 작업을 포함한 커밋을 브랜치에 추가합니다.

파라미터 유형 필수 설명
commit_message string 예 커밋 메시지.
actions array of objects 예 하나의 배치로 커밋할 파일 작업.
branch string 예 커밋할 브랜치 이름.
project_id string 아니요 프로젝트의 ID 또는 경로. url을 제공하지 않으면 필수입니다.
url string 아니요 프로젝트의 GitLab URL. project_id를 제공하지 않으면 필수입니다.
start_branch string 아니요 새 브랜치를 시작할 브랜치 이름. branch가 존재하지 않으면 필수입니다.
start_sha string 아니요 새 브랜치를 시작할 커밋의 SHA. start_branch와 함께 사용할 수 없습니다.
start_project string 아니요 커밋을 시작할 프로젝트의 전체 경로. 해당 프로젝트 자신이거나 그 프로젝트가 포크된 원본 프로젝트여야 합니다.

actions의 각 객체는 다음 필드를 허용합니다.

필드 유형 필수 설명
action string 예 수행할 작업: create, update, delete, move, chmod 중 하나.
file_path string 예 파일의 전체 경로.
content string 아니요 파일 콘텐츠. create, update, move에서 사용합니다. old_str 및 new_str과 함께 사용할 수 없습니다.
old_str string 아니요 update 작업에서 교체할 기존 텍스트. new_str이 필요합니다.
new_str string 아니요 update 작업에서 old_str을 대체할 텍스트.
previous_path string 아니요 원래 파일 경로. move에서 필수입니다.
encoding string 아니요 content의 인코딩: text 또는 base64. 기본값은 text입니다.
last_commit_id string 아니요 낙관적 동시성 제어에 사용하는, 파일의 마지막으로 알려진 커밋 ID.
execute_filemode boolean 아니요 파일이 실행 가능한지 여부. chmod에서 필수입니다.

부분 편집은 old_str이 정확히 한 번 나타나는 위치만 교체합니다. 두 번 이상 나타나면 주변 컨텍스트를 더 많이 제공해야 합니다. 부분 편집은 서버에서 전체 파일을 읽으므로 10 MiB보다 큰 파일에서는 지원되지 않습니다. 더 큰 파일은 전체 파일 콘텐츠를 커밋합니다.

부분 편집은 바이너리 파일이나 LFS에 저장된 파일에서는 지원되지 않습니다.

예시:

In project gitlab-org/gitlab, create README.md on branch "docs-update"
with the content "# New title" and commit message "Add README"

create_issue#

히스토리

이 도구는 work_items 툴셋에 속합니다.

save_work_item으로 대체되었습니다. save_work_item은 마일스톤 제목과 레이블 이름을 같은 위치(프로젝트와 그 상위 그룹)에서 확인하지만, 찾을 수 없는 이름에는 더 엄격합니다. create_issue는 아직 없는 레이블 이름을 새로 만들고 알 수 없는 마일스톤 제목은 조용히 버리지만, save_work_item은 찾을 수 없는 항목을 명시한 오류를 반환합니다. 이 도구는 더 이상 tools/list에 나타나지 않지만, 호출자가 마이그레이션하는 동안에는 계속 호출할 수 있습니다.

GitLab 프로젝트에 새 이슈를 만듭니다.

파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
title string 예 이슈 제목.
description string 아니요 이슈 설명.
assignee_ids array of integers 아니요 배정된 사용자 ID 배열.
milestone_id integer 아니요 마일스톤 ID.
labels array of strings 아니요 레이블 이름 배열.
confidential boolean 아니요 이슈를 기밀로 설정합니다. 기본값은 false.
epic_id integer 아니요 연결된 에픽의 ID.

예시:

Create a new issue titled "Fix login bug" in project 123 with description
"Users cannot log in with special characters in password"

get_issue#

히스토리

이 도구는 work_items 툴셋에 속합니다.

이슈와 다른 작업 항목 유형을 모두 다루는 get_work_item으로 대체되었습니다. 이 도구는 더 이상 tools/list에 나타나지 않지만, 호출자가 마이그레이션하는 동안에는 계속 호출할 수 있습니다.

특정 GitLab 이슈에 대한 자세한 정보를 가져옵니다.

파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
issue_iid integer 예 이슈의 내부 ID.

예시:

Get details for issue 42 in project 123

save_merge_request#

히스토리
  • GitLab 18.5에서 create_merge_request로 도입.
  • GitLab 18.8에서 assignee_ids, reviewer_ids, description, labels, milestone_id가 추가.
  • GitLab 19.3에서 save_merge_request로 이름이 변경되고 머지 리퀘스트를 업데이트하도록 확장되었습니다. create_merge_request와 update_merge_request 이름은 별칭으로 유지됩니다.

이 도구는 merge_requests 툴셋에 속합니다.

GitLab 프로젝트에서 머지 리퀘스트를 만들거나 업데이트합니다. merge_request_iid의 유무로 작업이 결정됩니다. 생략하면 머지 리퀘스트를 만들고, 제공하면 기존 머지 리퀘스트를 업데이트합니다.

파라미터 유형 필수 설명
project_id string 예 프로젝트의 ID 또는 전체 경로.
merge_request_iid integer 아니요 머지 리퀘스트의 내부 ID. 기존 머지 리퀘스트를 업데이트하려면 제공하고, 만들려면 생략합니다.
title string 아니요 머지 리퀘스트 제목. 만들 때 필수입니다.
source_branch string 아니요 소스 브랜치 이름. 만들 때 필수입니다.
target_branch string 아니요 대상 브랜치 이름. 만들 때 필수입니다.
target_project_id integer 아니요 대상 프로젝트의 ID. 만들 때 적용됩니다.
description string 아니요 머지 리퀘스트 설명.
labels array of strings 아니요 레이블 이름. 기존 레이블을 모두 교체합니다. 모든 레이블을 제거하려면 빈 배열을 전달합니다.
add_labels array of strings 아니요 추가할 레이블 이름. 업데이트할 때 적용됩니다.
remove_labels array of strings 아니요 제거할 레이블 이름. 업데이트할 때 적용됩니다.
assignees array of strings 아니요 배정할 사용자 이름. assignee_ids의 대안이며 둘 중 하나만 제공합니다. 모든 담당자를 제거하려면 빈 배열을 전달합니다.
assignee_ids array of integers 아니요 배정할 사용자 ID. assignees의 대안이며 둘 중 하나만 제공합니다. 모든 담당자를 제거하려면 빈 배열을 전달합니다.
reviewers array of strings 아니요 리뷰를 요청할 사용자 이름. reviewer_ids의 대안이며 둘 중 하나만 제공합니다. 모든 리뷰어를 제거하려면 빈 배열을 전달합니다.
reviewer_ids array of integers 아니요 리뷰를 요청할 사용자 ID. reviewers의 대안이며 둘 중 하나만 제공합니다. 모든 리뷰어를 제거하려면 빈 배열을 전달합니다.
milestone_id integer 아니요 마일스톤 ID.
milestone string 아니요 배정할 프로젝트 또는 상위 그룹 마일스톤의 제목. milestone_id와 함께 사용할 수 없습니다.
remove_source_branch boolean 아니요 머지 리퀘스트가 머지될 때 소스 브랜치를 제거합니다.
squash boolean 아니요 머지할 때 커밋을 하나의 커밋으로 스쿼시합니다.
state_event string 아니요 수행할 상태 전환. close 또는 reopen 중 하나. 업데이트할 때 적용됩니다.
discussion_locked boolean 아니요 머지 리퀘스트 토론을 잠급니다. 업데이트할 때 적용됩니다.
allow_collaboration boolean 아니요 대상 브랜치에 머지할 수 있는 멤버의 커밋을 허용합니다. 업데이트할 때 적용됩니다.

예시:

Create a merge request in project gitlab-org/gitlab titled "Bug fix broken specs"
from branch "fix/specs-broken" into "master" and enable squash
Update merge request 42 in project gitlab-org/gitlab to add the "bug" label and close it

get_merge_request#

히스토리
  • GitLab 18.4에서 도입.
  • GitLab 19.3에서 url을 받고 연관 데이터 패싯을 반환하도록 변경.
  • GitLab 19.6에서 호출당 둘 이상의 include 패싯을 받도록 변경.

이 도구는 merge_requests 툴셋에 속합니다.

머지 리퀘스트를 가져오며, 선택적으로 diff, 커밋, 노트, 파이프라인, 토론, 승인, 충돌도 가져옵니다. include 파라미터로 연관 데이터를 요청하지 않으면 기본 머지 리퀘스트만 반환됩니다.

파라미터 유형 필수 설명
url string 아니요 머지 리퀘스트의 GitLab URL. 이것을 제공하거나 project_id와 merge_request_iid를 제공합니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url이 없으면 필수입니다.
merge_request_iid integer 아니요 머지 리퀘스트의 내부 ID. url이 없으면 필수입니다.
include array 아니요 머지 리퀘스트와 함께 반환할 연관 패싯. diffs, commits, notes, pipelines, discussions, approvals, conflicts 중 하나 이상. 한 번의 호출에서 여러 패싯을 요청할 수 있습니다.
detail string 아니요 diff 상세 수준. 요약 개수만 반환하는 none, 파일별 추가 및 삭제 수를 반환하는 stats, 파일별 패치 텍스트와 파일별 통계를 반환하는 full_patch 중 하나. 기본값은 stats입니다. include에 diffs가 포함된 경우에만 적용됩니다. include에 다른 패싯이 있으면 full_patch로 설정할 수 없습니다.
diffs_after string 아니요 파일의 정방향 페이지네이션용 커서. include에 diffs가 포함되고 detail이 full_patch 일 때만 적용됩니다.
diffs_first integer 아니요 커서 이후로 반환할 파일 수(최대 100). include에 diffs가 포함되고 detail이 full_patch 일 때만 적용됩니다.
notes_after string 아니요 노트의 정방향 페이지네이션용 커서. include에 notes가 포함된 경우에만 적용됩니다.
notes_first integer 아니요 커서 이후로 반환할 노트 수(최대 100). include에 notes가 포함된 경우에만 적용됩니다.
notes_before string 아니요 노트의 역방향 페이지네이션용 커서. include에 notes가 포함된 경우에만 적용됩니다.
notes_last integer 아니요 커서 이전으로 반환할 노트 수(최대 100). include에 notes가 포함된 경우에만 적용됩니다.
commits_after string 아니요 커밋의 정방향 페이지네이션용 커서. include에 commits가 포함된 경우에만 적용됩니다.
commits_first integer 아니요 커서 이후로 반환할 커밋 수(최대 100). include에 commits가 포함된 경우에만 적용됩니다.
pipelines_after string 아니요 파이프라인의 정방향 페이지네이션용 커서. include에 pipelines가 포함된 경우에만 적용됩니다.
pipelines_first integer 아니요 커서 이후로 반환할 파이프라인 수(최대 100). include에 pipelines가 포함된 경우에만 적용됩니다.

diffs 패싯은 기본적으로 변경 통계를 반환합니다. 전체 합계와 파일별 추가 및 삭제 수입니다. 패치 텍스트를 가져오려면 detail을 full_patch로 설정합니다.

commits와 pipelines 패싯은 호출당 최대 100개 항목을 반환합니다. 각 응답에는 pageInfo.hasNextPage와 pageInfo.endCursor가 포함됩니다. 다음 페이지를 읽으려면 그 커서를 commits_after 또는 pipelines_after로 다시 전달합니다.

notes 패싯은 notes_last와 notes_before로 역방향 페이지네이션도 지원합니다. 최신 노트를 읽으려면 notes_first나 notes_after 없이 notes_last를 전달합니다. 한 번의 호출에서 두 방향을 함께 사용하면 오류가 반환됩니다. 각 노트는 position(diff 댓글의 파일과 줄)과 discussion(노트가 속한 스레드와 스레드의 해결 여부)을 반환합니다. 응답에는 resolvedDiscussionsCount와 resolvableDiscussionsCount도 포함됩니다.

conflicts 패싯은 Git 충돌 마커를 포함한 원시 충돌 파일 콘텐츠를 반환합니다. 머지 리퀘스트를 머지할 수 없고 소스 브랜치에 푸시할 수 있는 경우에만 사용할 수 있으며, 머지 가능 여부를 확인하기 전에는 null입니다. 상태를 확인하려면 기본 conflicts 필드를 읽습니다.

예시:

Get merge request 15 in project gitlab-org/gitlab with its commits

list_duo_agents_and_flows#

히스토리

이 도구는 duo_agent_platform 툴셋에 속합니다.

프로젝트에서 사용하도록 설정된 GitLab Duo 에이전트와 플로를 나열합니다. 플로 이름을 추측하지 않고 사용 가능한 항목을 확인할 수 있습니다. 프로젝트가 제공하는 에이전트와 플로는 프로젝트별로 구성되며 ID는 프로젝트마다 다릅니다.

각 항목에는 can_start_session이 포함됩니다. 실행 권한이 있는 플로는 true이고, 프로젝트에서 CI 세션을 실행할 수 있는 경우 기본 제공 채팅 에이전트도 true입니다. 기본 GitLab Duo 에이전트, 다른 에이전트, 외부 에이전트는 확인용으로만 나열되며 can_start_session은 항상 false입니다. 실행할 수 없는 플로나 버전이 릴리스되지 않았거나 아직 초안인 플로도 false입니다.

GitLab Ultimate 구독이 없으면 Ultimate가 필요한 기본 제공 채팅 에이전트는 목록에 나타나지 않거나 can_start_session이 false로 설정된 채 나타납니다.

can_start_session이 true인 플로에만 start_duo_session이 받는 ai_catalog_item_consumer_id가 포함됩니다. 기본 제공 채팅 에이전트를 시작하려면 해당 workflow_definition을 agent로 전달합니다. 설명은 잘릴 수 있습니다.

목록에는 프로젝트에 구성된 에이전트, 플로, 외부 에이전트와 기본 제공 채팅 에이전트가 포함됩니다. 채팅 에이전트는 페이지네이션되는 프로젝트 결과에 속하지 않는 고정 목록이므로 첫 페이지에서만 반환되며, 에이전트를 포함하지 않으면 생략됩니다. 이들은 first와 별도로 추가되므로 첫 페이지에 요청한 것보다 많은 항목이 포함될 수 있습니다. 이들에는 ai_catalog_item_consumer_id 대신 workflow_definition이 있으며, 표시 이름이 GitLab Duo로 같은 두 에이전트도 이것으로 구별합니다. 프로젝트에 구성된 항목은 workflow_definition이 null입니다.

기본 제공 채팅 에이전트는 프로젝트가 아니라 GitLab.com에서는 프로젝트의 최상위 그룹이, GitLab Self-Managed에서는 조직이 관리합니다.

파라미터 유형 필수 설명
project_id string 예 에이전트와 플로를 나열할 프로젝트의 숫자 ID 또는 전체 경로.
item_type string 아니요 agent, flow, third_party_flow 항목만 반환합니다. 생략하면 모든 종류를 반환합니다.
after string 아니요 정방향 페이지네이션용 커서.
first integer 아니요 정방향 페이지네이션으로 반환할 에이전트와 플로 수. 기본값은 20, 최댓값은 100입니다.

각 호출은 결과의 한 페이지를 반환합니다. 페이지가 더 있으면 응답에 pageInfo.endCursor가 포함되며, 이를 after로 전달할 수 있습니다.

구성되어 있지만 사용 중지된 항목은 페이지를 가져온 뒤에 제외되므로, pageInfo.hasNextPage가 여전히 true인데도 페이지에 first보다 적은 항목이 있거나 항목이 하나도 없을 수 있습니다. 빈 페이지에서 멈추지 말고 hasNextPage가 false가 될 때까지 계속 페이지를 넘깁니다.

예시:

Which Duo flows can I run in gitlab-org/gitlab?

start_duo_session#

히스토리

이 도구는 duo_agent_platform 툴셋에 속합니다.

프로젝트에서 목표를 달성하기 위해 비동기 GitLab Duo Agent Platform 세션을 시작합니다. workflow_id를 즉시 반환합니다. 해당 ID로 get_duo_session을 사용하여 진행 상황을 추적하고 최종 결과를 가져옵니다.

이 도구는 GitLab Duo Agent Platform을 사용할 수 있는 경우에만 나열됩니다. 자세한 내용은 도구 그룹 선택을 참고합니다.

세션은 커밋을 푸시하고 머지 리퀘스트를 열 수 있는 CI job에서 실행됩니다.

url 또는 project_id 중 정확히 하나를 제공합니다. flow, flow_item_id, ai_catalog_item_consumer_id, agent 중에서는 최대 하나만 제공합니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트의 전체 GitLab URL(예: https://gitlab.com/group/project). project_id와 함께 사용하지 않습니다.
project_id string 아니요 프로젝트의 숫자 ID 또는 전체 경로(예: gitlab-org/gitlab). url과 함께 사용하지 않습니다.
goal string 예 세션의 자연어 목표(예: Fix the flaky spec in issue #1234 and open a merge request). 일부 플로는 URL을 받습니다. 예를 들어 fix_pipeline/v1은 실패한 파이프라인의 URL을 받습니다.
flow string 아니요 기본 제공 플로 참조(예: developer/v1, fix_pipeline/v1). 플로나 에이전트를 지정하지 않으면 기본값은 developer/v1입니다. flow_item_id, ai_catalog_item_consumer_id, agent와 함께 사용하지 않습니다.
flow_item_id integer 아니요 프로젝트에서 사용하도록 설정된 사용자 지정 플로의 AI Catalog 항목 ID. 릴리스된 최신 버전이 실행됩니다. flow, ai_catalog_item_consumer_id, agent와 함께 사용하지 않습니다.
ai_catalog_item_consumer_id integer 아니요 실행할 플로를 구성하는 AI Catalog 항목 소비자의 ID. list_duo_agents_and_flows로 찾습니다. flow, flow_item_id, agent와 함께 사용하지 않습니다.
agent string 아니요 실행할 기본 제공 에이전트의 참조(예: analytics_agent/v1). 기본 GitLab Duo 에이전트는 시작할 수 없습니다. flow, flow_item_id, ai_catalog_item_consumer_id와 함께 사용하지 않습니다.

플로는 프로젝트 또는 프로젝트의 상위 그룹에서 사용하도록 설정되어 있어야 합니다. 플로가 사용하도록 설정되어 있지 않으면 도구가 오류를 반환합니다.

기능 플래그 뒤에 있는 플로는 해당 플래그가 활성화된 경우에만 실행됩니다. 플로가 이 조건을 충족하지 않으면 도구가 오류를 반환합니다.

일부 플로는 특정 형식의 목표를 기대하며, 도구는 세션을 시작하기 전에 형식을 확인합니다:

  • fix_pipeline/v1은 같은 프로젝트에서 실패한 파이프라인의 URL을 기대합니다. 세션은 파이프라인의 브랜치에서 실행됩니다. 파이프라인이 열려 있는 머지 리퀘스트에 속하면 플로는 해당 머지 리퀘스트에 수정 제안을 게시합니다. 그렇지 않으면 수정 내용으로 새 머지 리퀘스트를 엽니다. 목표가 프로젝트의 파이프라인이 아니면 도구가 오류를 반환하고 세션을 시작하지 않습니다.
  • code_review/v1은 머지 리퀘스트의 URL 또는 IID를 기대합니다. 세션은 머지 리퀘스트의 소스 브랜치에서 실행됩니다.

이 브랜치와 머지 리퀘스트는 GitLab UI의 파이프라인이나 머지 리퀘스트에서 플로를 시작할 때 플로가 사용하는 것과 같습니다.

기본 제공 플로를 시작하려면 flow를 사용합니다. 기본 제공 플로의 AI Catalog 항목 ID를 flow_item_id에 전달하면, 도구가 대신 사용할 flow 값을 알려 주는 오류를 반환합니다. 기본 제공 에이전트의 참조를 flow에 전달하면, 도구가 대신 사용할 agent 값을 알려 주는 오류를 반환합니다.

응답에는 get_duo_session을 호출하기 전에 얼마나 기다릴지에 대한 힌트로 poll_after_seconds가 포함됩니다.

예시:

Fix the flaky spec in issue #1234 and open an MR in gitlab-org/gitlab

list_duo_sessions#

히스토리
  • GitLab 19.3에서 도입.
  • GitLab 19.5에서 statuses 파라미터를 받도록 변경.

이 도구는 duo_agent_platform 툴셋에 속합니다.

Duo Chat 세션을 제외한 GitLab Duo Agent Platform 세션을 나열합니다. 각 세션에는 개별 상태, 목표 미리보기, 플로 정의, 생성 타임스탬프가 포함됩니다. 프로젝트 및 그룹 세션에는 세션 URL도 포함됩니다. 목표 미리보기는 잘릴 수 있습니다.

파라미터 유형 필수 설명
url string 아니요 세션을 필터링할 프로젝트의 GitLab URL. project_id와 함께 사용하지 않습니다.
project_id string 아니요 세션을 필터링할 프로젝트의 숫자 ID 또는 전체 경로. url과 함께 사용하지 않습니다.
status_group string 아니요 세션 상태 그룹. active, paused, awaiting_input, completed, failed, canceled 중 하나.
statuses array 아니요 세션 상태. created, running, paused, finished, failed, stopped, input_required, plan_approval_required, tool_call_approval_required, idle 중 하나 이상. status_group과 함께 사용하지 않습니다.
after string 아니요 정방향 페이지네이션용 커서.
first integer 아니요 정방향 페이지네이션으로 반환할 세션 수. 기본값은 20, 최댓값은 100입니다.

status_group 필터는 여러 개별 상태의 세션을 반환할 수 있습니다. 정확히 일치하는 하나 이상의 상태로 필터링하려면 대신 statuses를 사용합니다. 각 호출은 결과의 한 페이지를 반환합니다. 페이지가 더 있으면 응답에 pageInfo.endCursor가 포함되며, 이를 after로 전달할 수 있습니다.

예시:

List my active Duo Agent Platform sessions in gitlab-org/gitlab

get_duo_session#

히스토리
  • GitLab 19.4에서 도입. get_duo_workflow_status도 별칭으로 사용할 수 있습니다.
  • GitLab 19.5에서 세션이 만든 머지 리퀘스트, 작업 항목, 댓글을 반환하고, 상태에 따라 폴링 지연 시간을 달리하며, list_duo_sessions와 일치하도록 status를 밑줄로 보고(input required가 아니라 input_required)하도록 변경.
  • GitLab 19.5에서 실패한 세션이 실패한 이유와 해당 CI job 링크를 반환하도록 변경.

이 도구는 duo_agent_platform 툴셋에 속합니다.

GitLab Duo Agent Platform 세션의 상태를 확인합니다. 실행 중인 세션에는 권장 폴링 지연 시간이 포함되며, 세션이 CI job 시작을 기다리는 동안에는 이 지연 시간이 더 깁니다. 완료된 세션과 완료된 채팅 턴에는 에이전트의 최신 답변이 포함됩니다. 세션이 만든 머지 리퀘스트, 작업 항목, 댓글은 생성되는 즉시 created_merge_requests, created_work_items, created_notes로 포함됩니다. 각각은 배열이며, 해당 종류를 만들지 않았으면 비어 있고 최신 항목 최대 20개만 담습니다. 목록이 잘리면 artifacts_truncated가 잘린 목록을 알려 주고 artifact_limit가 상한을 알려 줍니다. 머지 리퀘스트의 모든 댓글을 페이지별로 확인하려면 include: ["notes"]와 함께 get_merge_request를 사용합니다. 승인을 기다리는 세션에는 send_duo_session_input으로 세션을 계속하는 방법에 대한 안내가 포함됩니다.

실패한 세션에는 다음도 포함됩니다:

  • failure_reason: 실패에 대해 기록된 이유. 기록된 이유가 없으면 null.
  • job_url: 세션을 실행한 CI job. CI job이 실행되지 않았거나 해당 로그를 읽을 수 없으면 null.

세션이 에이전트를 시작하기 전에 실패한 경우 응답은 변경 사항이 없으며 다시 시작할 수 있다고 알려 줍니다. 30일이 지난 세션에는 이 메시지가 포함되지 않습니다. 30일이 지난 체크포인트는 보관되지 않으므로, 도구는 에이전트가 세션을 실행했는지 식별할 수 없습니다.

파라미터 유형 필수 설명
workflow_id integer 예 Duo 세션의 ID. start_duo_session 또는 list_duo_sessions가 반환한 값.

예시:

Check the status of Duo session 42

send_duo_session_input#

히스토리

이 도구는 duo_agent_platform 툴셋에 속합니다.

입력을 기다리는 GitLab Duo Agent Platform 세션에 응답합니다. 대기 중인 계획이나 도구 호출을 승인하거나 거부하고, 에이전트가 한 질문에 답합니다. ai_catalog_item_consumer_id로 시작한 세션과 agent로 시작한 세션에서 작동합니다. 세션은 마지막 CI job이 끝난 뒤에 입력을 받으며, 상태가 input_required, plan_approval_required, tool_call_approval_required 중 무엇이든 대기 중이면 받을 수 있습니다.

세션은 CI job에서 계속됩니다. 응답에는 권장 폴링 지연 시간이 포함됩니다. 진행 상황을 확인하려면 같은 workflow_id로 get_duo_session을 사용합니다.

파라미터 유형 필수 설명
workflow_id integer 예 Duo 세션의 ID. list_duo_sessions 또는 get_duo_session이 반환한 값.
human_approval boolean 예 true는 대기 중인 계획이나 도구 호출을 승인합니다. true와 함께 human_message를 포함하지 않습니다. 포함하면 세션을 재개하는 대신 도구가 호출을 거부합니다. false는 거부합니다. 에이전트가 사용자의 피드백으로 계속하도록 human_message를 포함합니다. 포함하지 않으면 에이전트는 진행하지 말라는 안내를 받고 세션은 계속됩니다.
human_message string 아니요 에이전트에 대한 피드백 또는 세션이 질문을 했을 때의 답변(최대 2000자). human_approval=false와 함께 제공합니다. human_approval=true와 함께 제공하면 세션을 재개하는 대신 도구가 호출을 거부합니다.

예시:

Approve the plan for Duo session 42
Reject the plan for Duo session 42 and ask it to also add tests

list_merge_requests#

히스토리
  • GitLab 19.3에서 도입.
  • GitLab 19.4에서 group_id 파라미터와 그룹 범위가 추가.

이 도구는 merge_requests 툴셋에 속합니다.

GitLab 프로젝트 또는 그룹의 머지 리퀘스트를 나열하거나 검색하며, 간략한 머지 리퀘스트 메타데이터를 반환합니다. 그룹 범위는 항상 그룹과 그 하위 그룹에 속한 모든 프로젝트의 머지 리퀘스트를 포함하지만, 보관된 프로젝트의 머지 리퀘스트는 제외합니다. 그룹 결과에는 get_merge_request에서 사용할 수 있도록 각 머지 리퀘스트를 소유한 프로젝트 경로도 포함됩니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트 또는 그룹의 GitLab URL. url, project_id, group_id 중 정확히 하나를 제공합니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url, project_id, group_id 중 정확히 하나를 제공합니다.
group_id string 아니요 그룹의 ID 또는 전체 경로. url, project_id, group_id 중 정확히 하나를 제공합니다.
author_username string 아니요 머지 리퀘스트 작성자의 사용자 이름으로 필터링합니다.
assignee_username string 아니요 담당자의 사용자 이름으로 필터링합니다.
reviewer_username string 아니요 리뷰어의 사용자 이름으로 필터링합니다.
state string 아니요 상태로 필터링합니다. opened, closed, merged, locked, all 중 하나. 생략하면 모든 상태를 포함합니다.
scope string 아니요 인증된 사용자를 기준으로 필터링합니다. created_by_me, assigned_to_me, review_requested 중 하나. 명시적으로 지정한 사용자 이름이 해당 필드에서 우선합니다.
milestone string 아니요 마일스톤 제목으로 필터링합니다.
labels string 아니요 쉼표로 구분한 레이블 이름 목록. 이 레이블을 모두 가진 머지 리퀘스트만 반환됩니다.
search string 아니요 머지 리퀘스트 제목과 설명에서 일치를 찾는 검색어.
after string 아니요 정방향 페이지네이션용 커서.
first integer 아니요 정방향 페이지네이션으로 반환할 머지 리퀘스트 수. 기본값은 20, 최댓값은 100입니다.

단일 머지 리퀘스트의 전체 상세 정보를 가져오려면 get_merge_request를 사용합니다. 커밋을 가져오려면 include: ["commits"]와 함께 get_merge_request를 사용합니다. diff나 노트는 include: ["diffs"] 또는 include: ["notes"]를 사용합니다. 패치 텍스트를 가져오려면 detail도 full_patch로 설정합니다. 리소스 유형 전반에 걸친 전체 텍스트 검색에는 search를 사용합니다.

예시:

List my open merge requests in gitlab-org/gitlab

get_merge_request_commits#

히스토리

이 도구는 merge_requests 툴셋에 속합니다.

include: ["commits"]와 함께 사용하는 get_merge_request로 대체되었습니다. 이 도구는 더 이상 tools/list에 나타나지 않지만, 호출자가 마이그레이션하는 동안에는 계속 호출할 수 있습니다.

특정 GitLab 머지 리퀘스트의 커밋 목록을 가져옵니다.

파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
merge_request_iid integer 예 머지 리퀘스트의 내부 ID.
per_page integer 아니요 페이지당 커밋 수.
page integer 아니요 현재 페이지 번호.

예시:

Show me all commits in merge request 42 from project 123

get_merge_request_diffs#

히스토리

이 도구는 merge_requests 툴셋에 속합니다.

include: ["diffs"]와 함께 사용하는 get_merge_request로 대체되었습니다. 원시 패치 텍스트가 필요하면 detail: full_patch도 전달합니다. 이 도구는 더 이상 tools/list에 나타나지 않지만, 호출자가 마이그레이션하는 동안에는 계속 호출할 수 있습니다.

특정 GitLab 머지 리퀘스트의 diff를 가져옵니다.

파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
merge_request_iid integer 예 머지 리퀘스트의 내부 ID.
per_page integer 아니요 페이지당 diff 수.
page integer 아니요 현재 페이지 번호.

예시:

What files were changed in merge request 25 in the gitlab project?

get_merge_request_pipelines#

히스토리

이 도구는 merge_requests 툴셋에 속합니다.

include: ["pipelines"]와 함께 사용하는 get_merge_request로 대체되었습니다. 이 도구는 더 이상 tools/list에 나타나지 않지만, 호출자가 마이그레이션하는 동안에는 계속 호출할 수 있습니다.

특정 GitLab 머지 리퀘스트의 파이프라인을 가져옵니다.

파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
merge_request_iid integer 예 머지 리퀘스트의 내부 ID.

예시:

Show me all pipelines for merge request 42 in project gitlab-org/gitlab

get_merge_request_conflicts#

히스토리

이 도구는 merge_requests 툴셋에 속합니다.

include: ["conflicts"]와 함께 사용하는 get_merge_request로 대체되었습니다. 이 방식은 아래의 일반 텍스트 대신 같은 충돌을 ourPath와 theirPath 필드가 분리된 구조화된 conflictFiles 항목으로 반환합니다. 이 도구는 더 이상 tools/list에 나타나지 않지만, 호출자가 마이그레이션하는 동안에는 계속 호출할 수 있습니다.

머지할 수 없는 머지 리퀘스트의 머지 충돌 콘텐츠를 가져옵니다. 충돌이 발생한 파일에 나타나는 그대로 원시 Git 충돌 마커(<<<<<<<, =======, >>>>>>>)를 반환합니다. 각 파일의 콘텐츠는 # File: 제목 아래에 그룹화됩니다. 이름이 변경된 파일은 제목에 각 브랜치의 경로가 표시됩니다.

파라미터 유형 필수 설명
project_id string 예 프로젝트의 ID 또는 전체 경로(예: gitlab-org/gitlab).
merge_request_iid integer 예 머지 리퀘스트의 내부 ID.

머지 리퀘스트의 소스 브랜치에 푸시할 수 있는 권한이 있어야 합니다. 머지 리퀘스트에 충돌이 없거나, 머지 가능 여부를 아직 확인하지 않았거나, 브랜치 또는 diff ref가 없으면 도구가 오류를 반환합니다.

예시:

Show the conflicts for merge request 42 in project gitlab-org/gitlab

save_note#

히스토리
  • GitLab 19.2에서 도입.
  • GitLab 19.4에서 create_merge_request_note 및 create_workitem_note 도구를 대체. 두 원래 도구 이름은 별칭으로 계속 작동합니다.
  • GitLab 19.5에서 method 및 resolved 파라미터가 추가. body는 더 이상 모든 호출에 필수가 아닙니다.

이 도구는 core 툴셋에 속합니다.

인증된 사용자로서 GitLab 머지 리퀘스트나 작업 항목에 댓글을 추가하거나, 기존 토론 스레드에 답글을 달거나, 토론 스레드를 해결하거나 해결을 취소합니다.

파라미터 유형 필수 설명
url string 아니요 머지 리퀘스트 또는 작업 항목의 URL. URL이 대상 유형을 결정합니다.
project_id string 아니요 프로젝트의 ID 또는 경로. merge_request_iid와 함께, 그리고 프로젝트 수준 작업 항목에는 work_item_iid와 함께 필수입니다.
group_id string 아니요 그룹의 ID 또는 경로. 그룹 수준 작업 항목에는 work_item_iid와 함께 필수입니다.
merge_request_iid integer 아니요 머지 리퀘스트의 내부 ID. project_id와 함께 제공합니다. work_item_iid와 함께 사용할 수 없습니다.
work_item_iid integer 아니요 작업 항목의 내부 ID. project_id 또는 group_id와 함께 제공합니다. merge_request_iid와 함께 사용할 수 없습니다.
method string 아니요 수행할 쓰기 작업: create_note, reply_discussion, resolve_discussion1 중 하나. 기본값은 create_note이며, discussion_id를 지정하면 reply_discussion입니다. 선택한 메서드에 나열된 파라미터만 채우며, 다른 파라미터는 거부됩니다.
body string 아니요 노트의 콘텐츠. create_note와 reply_discussion에서 필수입니다. 퀵 액션(예: /merge)이 실행되지 않도록 줄은 /로 시작할 수 없습니다.
internal boolean 아니요 노트를 내부용으로 표시합니다(Reporter 권한 이상의 멤버에게만 표시됨). 기본값은 false입니다.
discussion_id string 아니요 답글을 달 토론(reply_discussion) 또는 해결하거나 해결을 취소할 토론(resolve_discussion). 글로벌 ID(gid://gitlab/Discussion/<id> 형식) 또는 토론 ID만 사용할 수 있습니다. 없으면 새 최상위 노트를 만듭니다.
resolved boolean 아니요 true는 토론을 해결하고, false는 해결을 취소합니다. resolve_discussion에서 필수입니다.

예시:

  • 머지 리퀘스트에 댓글 달기:

    Reply "Thanks, fixed in the latest push" to merge request 42 in project gitlab-org/gitlab
    
  • 작업 항목에 댓글 달기:

    Add a comment "This looks good to me" to work item 42 in project gitlab-org/gitlab
    
  • 작업 항목의 토론 해결하기:

    Resolve the open discussion about the acceptance criteria on work item 42 in project gitlab-org/gitlab
    

get_merge_request_notes#

히스토리

이 도구는 merge_requests 툴셋에 속합니다.

include: ["notes"]와 함께 사용하는 get_merge_request로 대체되었습니다. 이 도구는 더 이상 tools/list에 나타나지 않지만, 호출자가 마이그레이션하는 동안에는 계속 호출할 수 있습니다.

특정 GitLab 머지 리퀘스트의 노트(댓글과 시스템 노트)를 가져옵니다.

파라미터 유형 필수 설명
url string 아니요 GitLab 머지 리퀘스트의 URL. project_id와 merge_request_iid가 없으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url이 없으면 필수입니다.
merge_request_iid integer 아니요 머지 리퀘스트의 내부 ID. url이 없으면 필수입니다.
after string 아니요 정방향 페이지네이션용 커서.
before string 아니요 역방향 페이지네이션용 커서.
first integer 아니요 정방향 페이지네이션으로 반환할 노트 수.
last integer 아니요 역방향 페이지네이션으로 반환할 노트 수.

반환되는 각 노트에는 토론 ID가 포함되므로, 관련 노트를 스레드로 그룹화할 수 있습니다.

예시:

Show me all comments on merge request 5 in project gitlab-org/gitlab

save_merge_request_review#

히스토리
  • GitLab 19.4에서 도입.
  • GitLab 19.6에서 update_note 메서드가 도입.

이 도구는 merge_requests 툴셋에 속합니다.

인증된 사용자로서 머지 리퀘스트 리뷰 산출물을 작성합니다. 각 호출은 method 파라미터로 선택한 정확히 하나의 작업을 수행합니다.

메서드 동작
create_note 최상위 댓글을 추가합니다.
reply_discussion 기존 토론에 답글을 답니다.
create_diff_note 특정 diff 줄에 댓글을 답니다.
resolve_discussion 토론을 해결하거나 해결을 취소합니다.
update_note 머지 리퀘스트에 있는 노트의 텍스트를 교체합니다. 노트 작성자이거나 최소 Maintainer 권한이 있어야 합니다.
submit_review 여러 diff 댓글과 선택적 요약을 한 번의 호출로 게시합니다.
post_duo_review GitLab Duo에 머지 리퀘스트 리뷰를 요청합니다. GitLab Duo Code Review가 필요합니다.
approve 머지 리퀘스트를 승인합니다. 이미 승인한 상태에서 호출해도 already_approved 상태로 성공합니다.
unapprove 본인의 승인을 제거합니다. 이전에 승인하지 않은 상태에서 호출해도 not_approved 상태로 성공합니다.

post_duo_review, approve, unapprove의 응답에는 머지 리퀘스트의 현재 diff_head_sha가 포함되므로, 기존 승인이나 리뷰가 최신 커밋을 여전히 포함하는지 확인할 수 있습니다.

파라미터 유형 필수 설명
url string 아니요 GitLab 머지 리퀘스트의 URL 또는 #note_<id>로 끝나는 댓글 링크. project_id와 merge_request_iid가 없으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 경로. url이 없으면 필수입니다.
merge_request_iid integer 아니요 머지 리퀘스트의 내부 ID. url이 없으면 필수입니다.
method string 예 수행할 작업. 다른 메서드에 속한 파라미터는 거부됩니다.
body string 아니요 노트 텍스트. create_note, reply_discussion, create_diff_note, update_note에서 필수입니다. 퀵 액션(예: /merge)이 실행되지 않도록 줄은 /로 시작할 수 없습니다.
discussion_id string 아니요 작업할 토론. reply_discussion과 resolve_discussion에서 필수입니다. 글로벌 ID 또는 토론 ID만 사용할 수 있습니다.
note_id integer 아니요 작업할 노트. url에 댓글 앵커(#note_<id>)가 없으면 update_note에서 필수입니다. create_note가 반환한 정수 노트 ID를 사용할 수 있습니다. get_merge_request와 include: ["notes"]로 찾은 노트를 편집하려면 해당 노트의 webUrl을 url로 전달합니다. 노트는 지정한 머지 리퀘스트에 속해야 합니다. 머지 리퀘스트의 커밋에 달린 댓글은 지원되지 않습니다.
internal boolean 아니요 create_note에서 노트를 내부용으로 표시합니다.
resolved boolean 아니요 resolve_discussion에서 true는 해결, false는 해결 취소입니다. 해당 메서드에서 필수입니다.
old_path string 아니요 create_diff_note에서 변경 전 파일 경로. old_path 또는 new_path 중 하나 또는 둘 다 제공합니다.
new_path string 아니요 create_diff_note에서 변경 후 파일 경로.
old_line integer 아니요 create_diff_note에서 이전 버전의 줄 번호. old_line 또는 new_line 중 하나 또는 둘 다 제공합니다.
new_line integer 아니요 create_diff_note에서 새 버전의 줄 번호.
comments array 아니요 submit_review에서 1~20개의 diff 댓글. 각 항목은 file과 body(필수), old_line, new_line, suggestion(선택)을 받습니다. 해당 메서드에서 필수입니다. file은 변경 후 경로이며, 이름이 변경된 파일에는 대신 create_diff_note를 사용합니다.
verdict string 아니요 submit_review에서 요약 노트 앞에 붙는 전체 판정.
summary string 아니요 submit_review에서 diff 댓글 뒤에 게시되는 요약 노트.
summary_internal boolean 아니요 submit_review에서 요약 노트를 내부용으로 표시합니다.
sha string 아니요 approve에서 head SHA 가드. 값을 지정했는데 머지 리퀘스트 head와 더 이상 일치하지 않으면 승인이 거부됩니다. get_merge_request가 반환한 40자 전체 diff_head_sha를 전달합니다.

예시:

Review merge request 42 in project gitlab-org/gitlab and leave your findings as diff comments with a summary

list_milestones#

히스토리

이 도구는 core 툴셋에 속합니다.

GitLab 프로젝트 또는 그룹의 마일스톤을 나열합니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트 또는 그룹의 GitLab URL. url, project_id, group_id 중 정확히 하나를 제공합니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url, project_id, group_id 중 정확히 하나를 제공합니다.
group_id string 아니요 그룹의 ID 또는 전체 경로. url, project_id, group_id 중 정확히 하나를 제공합니다.
state string 아니요 상태로 마일스톤을 필터링합니다(active 또는 closed). 생략하면 모든 상태의 마일스톤을 반환합니다.
search string 아니요 제목으로 마일스톤을 필터링하는 검색 문자열.
include_ancestors boolean 아니요 상위 그룹의 마일스톤을 포함합니다. 프로젝트의 경우 프로젝트의 상위 그룹과 그 상위 그룹들의 마일스톤을 포함합니다.
include_descendants boolean 아니요 하위 그룹과 그 프로젝트의 마일스톤을 포함합니다. 그룹에만 적용됩니다.
first integer 아니요 커서 이후로 반환할 마일스톤 수(정방향 페이지네이션). 최댓값 100.
after string 아니요 마일스톤의 정방향 페이지네이션용 커서. 이전 응답의 pageInfo.endCursor를 사용합니다.

예시:

List the open milestones in project gitlab-org/gitlab

list_project_members#

히스토리

이 도구는 core 툴셋에 속합니다.

GitLab 프로젝트 멤버를 권한 및 액세스 수준과 함께 나열합니다.

파라미터 유형 필수 설명
project_id string 예 프로젝트의 전체 경로 또는 숫자 ID(예: gitlab-org/gitlab 또는 278964).
include_inherited boolean 아니요 상위 그룹이나 프로젝트의 하위 그룹에서 권한을 상속받는 멤버도 함께 반환합니다. 기본값은 false입니다.
query string 아니요 이름 또는 사용자 이름에 이 텍스트가 포함된 멤버만 반환합니다.
first integer 아니요 정방향 페이지네이션으로 반환할 멤버 수(기본값 20, 최댓값 100).
after string 아니요 정방향 페이지네이션용 커서.

응답은 각 멤버에 대해 사용자 ID, 사용자 이름, 이름, 숫자 access_level, 해당하는 access_level_name(예: Maintainer), 멤버십 expires_at 날짜를 반환합니다. 이메일로 초대받았지만 아직 초대를 수락하지 않은 멤버는 반환되지 않습니다.

각 호출은 결과의 한 페이지를 반환합니다. 페이지가 더 있으면 응답 metadata에 end_cursor가 포함되며, 이를 after로 전달하여 다음 페이지를 가져올 수 있습니다.

예시:

Who are the maintainers of gitlab-org/gitlab?

get_user#

히스토리

이 도구는 core 툴셋에 속합니다.

단일 GitLab 사용자를 가져옵니다. 이 도구를 사용하여 사용자 이름이나 본인 계정을 숫자 사용자 ID로 확인합니다. 예를 들어 다른 도구로 담당자나 리뷰어를 설정하기 전에 사용합니다.

username, id, me 중 정확히 하나를 제공합니다.

파라미터 유형 필수 설명
username string 아니요 조회할 사용자의 사용자 이름.
id integer 아니요 조회할 사용자의 숫자 ID.
me boolean 아니요 인증된 사용자를 조회하려면 true로 설정합니다. 설정할 때는 username과 id를 생략합니다. 이 파라미터를 사용하지 않으려면 false로 설정합니다.

응답은 사용자의 숫자 id, username, name, state, web_url을 반환합니다.

예시:

What is my GitLab user ID?

list_todos#

히스토리

이 도구는 core 툴셋에 속합니다.

리뷰 요청, 배정, 멘션 같은 할 일 항목을 나열합니다. state를 done으로 설정하지 않으면 대기 중인 할 일 항목을 반환합니다.

파라미터 유형 필수 설명
state string 아니요 상태로 필터링합니다: pending 또는 done. 기본값은 pending입니다.
action string 아니요 할 일 항목을 만든 동작으로 필터링합니다(예: review_requested, assigned, mentioned).
type string 아니요 할 일 항목 대상의 유형으로 필터링합니다(예: MERGEREQUEST, ISSUE, WORKITEM).
author_id integer 아니요 할 일 항목을 만든 사용자의 숫자 ID로 필터링합니다. 사용자 ID를 조회하려면 get_user를 사용합니다.
project_id string 아니요 프로젝트로 필터링합니다. 프로젝트의 ID 또는 전체 경로.
group_id string 아니요 그룹으로 필터링합니다. 그룹의 ID 또는 전체 경로.
first integer 아니요 정방향 페이지네이션으로 반환할 할 일 항목 수. 기본값은 20, 최댓값은 100입니다.
after string 아니요 정방향 페이지네이션용 커서. 이전 응답의 pageInfo.endCursor를 사용합니다.

각 할 일 항목에는 다음 정보가 포함됩니다.

  • 숫자 id, action, state, body, targetType, targetUrl, createdAt
  • targetEntity에 있는 대상의 name과 iid
  • 작성자
  • 할 일 항목이 속한 프로젝트 또는 그룹

할 일 항목, 작성자, 프로젝트, 그룹의 ID는 다른 도구에 다시 전달할 수 있도록 GraphQL 글로벌 ID에서 풀어낸 숫자로 반환됩니다.

예시:

Which merge requests am I asked to review?

list_user_events#

히스토리

이 도구는 core 툴셋에 속합니다.

지정한 사용자의 기여 이벤트를 가져옵니다. 에픽이나 머지 리퀘스트와 관련된 이벤트는 반환하지 않습니다. 대량 푸시 이벤트는 커밋 세부 정보를 제한해 반환합니다.

파라미터 유형 필수 설명
id string 예 사용자의 ID 또는 사용자 이름.
action string 아니요 동작 유형으로 이벤트를 필터링합니다.
target_type string 아니요 대상 유형으로 이벤트를 필터링합니다.
before string 아니요 지정한 날짜(YYYY-MM-DD) 이전에 생성된 이벤트를 반환합니다.
after string 아니요 지정한 날짜(YYYY-MM-DD) 이후에 생성된 이벤트를 반환합니다.
sort string 아니요 생성 날짜 기준 오름차순(asc) 또는 내림차순(desc)으로 결과를 정렬합니다.
page integer 아니요 페이지네이션용 페이지 번호.
per_page integer 아니요 페이지당 반환할 이벤트 수.

예시:

List recent events for user john_doe

accept_merge_request#

히스토리

이 도구는 merge_requests 툴셋에 속합니다.

머지 리퀘스트를 머지하거나, 자동으로 머지되도록 예약합니다. strategy가 없으면 머지가 즉시 시작되어 비동기로 완료됩니다. strategy가 있으면 자동 머지가 설정되고 검사를 통과하면 머지 리퀘스트가 머지됩니다. 대신 머지 리퀘스트를 승인하려면 save_merge_request_review 도구를 사용합니다.

이미 머지된 머지 리퀘스트에 대한 호출은 already_merged 상태로 성공하며, 이미 예약된 머지 리퀘스트에 strategy를 지정한 호출은 already_scheduled 상태로 성공합니다.

파라미터 유형 필수 설명
url string 아니요 머지 리퀘스트의 GitLab URL. 이것을 제공하거나 project_id와 merge_request_iid를 제공합니다.
project_id string 아니요 프로젝트의 ID 또는 경로. url이 없으면 필수입니다.
merge_request_iid integer 아니요 머지 리퀘스트의 내부 ID. url이 없으면 필수입니다.
sha string 예 head SHA 가드. 머지 리퀘스트 head와 더 이상 일치하지 않으면 머지가 거부됩니다. get_merge_request가 반환한 diff_head_sha를 전달합니다.
strategy string 아니요 자동 머지 전략(예: merge_when_checks_pass). 지정하면 즉시 머지하는 대신 자동 머지를 설정합니다.
squash boolean 아니요 머지할 때 커밋을 하나의 커밋으로 스쿼시합니다.
commit_message string 아니요 사용자 지정 머지 커밋 메시지.
squash_commit_message string 아니요 사용자 지정 스쿼시 커밋 메시지. squash가 true 일 때 적용됩니다.
should_remove_source_branch boolean 아니요 머지 후 소스 브랜치를 제거합니다.

예시:

Merge merge request 42 in project gitlab-org/gitlab once its checks pass, and remove the source branch

add_branch#

히스토리
  • GitLab 19.3에서 도입. create_branch도 별칭으로 사용할 수 있습니다.

이 도구는 repository 툴셋에 속합니다.

소스 ref에서 GitLab 프로젝트에 브랜치를 추가합니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트의 GitLab URL. 이것을 제공하거나 project_id를 제공합니다.
project_id string 아니요 프로젝트의 ID 또는 경로. url을 제공하지 않으면 필수입니다.
branch string 예 새 브랜치의 이름.
ref string 예 새 브랜치를 만들 기준이 되는 브랜치 이름 또는 커밋 SHA.

예시:

Create a branch named feature/x from main in project gitlab-org/gitlab

fork_repository#

히스토리

이 도구는 repository 툴셋에 속합니다.

GitLab 프로젝트를 네임스페이스로 포크합니다.

포크는 비동기로 생성됩니다. 응답에는 새 프로젝트 속성이 포함되며, 포크 진행 상황을 보여 주는 import_status 필드(예: scheduled)가 들어 있습니다.

호출은 다음 상태에 따라 각각의 이유로 실패합니다.

  • 409 상태: 네임스페이스에 이미 해당 프로젝트의 포크가 있는 경우.
  • 404 상태: 프로젝트나 네임스페이스가 존재하지 않거나, 프로젝트를 포크할 권한이 없는 경우.
파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
namespace_id integer 아니요 프로젝트를 포크할 네임스페이스의 ID.
namespace_path string 아니요 프로젝트를 포크할 네임스페이스의 경로.
name string 아니요 포크에 지정할 이름.
path string 아니요 포크에 지정할 경로.
description string 아니요 포크에 지정할 설명.
visibility string 아니요 포크의 공개 범위.

예시:

Fork gitlab-org/gitlab-test into my personal namespace

list_branches#

히스토리

이 도구는 repository 툴셋에 속합니다.

GitLab 프로젝트의 브랜치를 나열하며, 선택적으로 이름으로 필터링합니다.

파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
search string 아니요 이름으로 브랜치를 필터링합니다.
page integer 아니요 현재 페이지 번호. 기본값은 1입니다.
per_page integer 아니요 페이지당 항목 수. 기본값은 20입니다.

예시:

List branches in gitlab-org/gitlab whose names contain "release"

get_repository_file#

히스토리
  • GitLab 19.3에서 도입.
  • GitLab 19.6에서 최대 응답 콘텐츠가 1 MiB에서 32 KiB로 변경.
  • GitLab 19.6에서 line_byte_offset 파라미터가 도입.

이 도구는 repository 툴셋에 속합니다.

특정 ref에서 리포지터리의 단일 파일 콘텐츠를 가져옵니다.

콘텐츠는 로컬 파일 시스템이 아니라 리포지터리에서 가져옵니다. 파일은 ref에 커밋된 상태로 반환되므로, 로컬 체크아웃의 커밋되지 않은 변경 사항은 포함되지 않습니다.

파라미터 유형 필수 설명
url string 아니요 파일의 URL(예: https://gitlab.example.com/my-group/my-project/-/blob/main/app/models/user.rb). 이것을 제공하거나 project_id, file_path, ref를 제공합니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url을 제공하지 않으면 필수입니다. url도 함께 제공하는 경우 둘은 같은 프로젝트를 가리켜야 합니다.
file_path string 아니요 리포지터리 루트를 기준으로 한 파일 경로. url을 제공하지 않으면 필수입니다.
ref string 아니요 브랜치 이름, 태그 이름 또는 커밋 SHA. 기본 브랜치에는 HEAD를 사용합니다. url을 제공하지 않으면 필수입니다.
offset integer 아니요 읽기를 시작할 0부터 시작하는 줄 번호. 기본값은 0입니다.
limit integer 아니요 반환할 최대 줄 수. 기본값은 500, 최댓값은 2000입니다.
line_byte_offset integer 아니요 offset에 해당하는 줄에서 응답이 시작되는 바이트 위치. 긴 줄이 잘린 뒤에는 system_instruction의 값을 사용합니다.

응답에는 total_lines, returned_lines, truncated, size_bytes를 담은 metadata 객체가 포함됩니다. 응답이 파일의 일부만 포함하면 system_instruction에 다음 호출에서 사용할 offset 이 명시됩니다.

각 응답은 최대 32 KiB의 파일 콘텐츠를 반환합니다. 줄이 그보다 길면 응답이 줄 중간에서 끝나며, system_instruction에 줄의 나머지를 읽을 때 사용할 offset과 line_byte_offset이 명시됩니다.

이 도구는 텍스트만 반환합니다. 바이너리 파일과 Git LFS에 저장된 파일은 오류를 반환합니다. 프로젝트가 GitLab Duo 컨텍스트에서 제외한 파일도 오류를 반환합니다.

예시:

Show me app/models/user.rb from the main branch of my-group/my-project

list_repository_tree#

히스토리

이 도구는 repository 툴셋에 속합니다.

지정한 경로와 ref에서 GitLab 리포지터리의 파일과 디렉터리를 나열합니다. 항목 메타데이터만 반환하며 파일 콘텐츠는 반환하지 않습니다. 파일의 콘텐츠를 읽으려면 get_repository_file을 사용합니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트의 GitLab URL. url 또는 project_id 중 정확히 하나를 제공합니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url 또는 project_id 중 정확히 하나를 제공합니다.
path string 아니요 리포지터리 루트를 기준으로 나열할 디렉터리의 경로. 기본값은 루트입니다.
ref string 아니요 브랜치 이름, 태그 이름 또는 커밋 SHA. 기본값은 기본 브랜치입니다.
recursive boolean 아니요 모든 하위 디렉터리의 항목을 재귀적으로 나열합니다. 기본값은 false입니다.
after string 아니요 정방향 페이지네이션용 커서. 이전 응답의 endCursor를 사용합니다.

각 호출은 최대 100개의 항목을 반환합니다. pageInfo.hasNextPage가 true 이면 pageInfo.endCursor를 after로 전달하여 다음 페이지를 가져옵니다.

예시:

List the files under app/services in gitlab-org/gitlab on the default branch

get_commit#

히스토리
  • GitLab 19.3에서 도입.
  • GitLab 19.6에서 호출당 둘 이상의 include 패싯을 받도록 변경.

이 도구는 repository 툴셋에 속합니다.

단일 커밋의 메타데이터를 가져오며, 선택적으로 diff나 노트도 가져옵니다.

파라미터 유형 필수 설명
url string 아니요 GitLab 커밋의 URL. project_id와 commit_sha를 제공하지 않으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url을 제공하지 않으면 필수입니다.
commit_sha string 아니요 조회할 커밋. 전체 또는 짧은 SHA, 브랜치 이름, 태그 이름을 사용할 수 있습니다. url을 제공하지 않으면 필수입니다.
include array 아니요 인라인으로 가져올 연관 패싯. diff, notes 또는 둘 다 한 번의 호출에서 요청할 수 있습니다. 기본 메타데이터는 항상 반환됩니다.
diff_detail string 아니요 커밋 diff의 상세 수준. include에 diff가 포함된 경우에만 적용됩니다. stats 또는 full_patch 중 하나입니다. 기본값은 stats입니다.
notes_after string 아니요 다음 노트 페이지를 가져오는 토큰. include에 notes가 포함된 경우에만 적용됩니다.
notes_first integer 아니요 페이지당 반환할 노트 수(최대 100). include에 notes가 포함된 경우에만 적용됩니다.

diff_detail을 stats로 설정하면 diff 패싯은 파일별 및 요약 줄 수를 반환합니다. full_patch로 설정하면 패치 텍스트를 반환합니다.

예시:

Show me commit abc123 in gitlab-org/gitlab with its diff stats

list_commits#

히스토리

이 도구는 repository 툴셋에 속합니다.

GitLab 프로젝트의 커밋을 나열하며, 선택적으로 ref, 작성자, 경로, 날짜로 필터링합니다. 간략한 커밋 메타데이터를 반환합니다. 단일 커밋의 diff나 노트를 가져오려면 get_commit을 사용합니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트의 GitLab URL. url 또는 project_id 중 정확히 하나를 제공합니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url 또는 project_id 중 정확히 하나를 제공합니다.
ref_name string 아니요 커밋을 나열할 브랜치 또는 태그. 기본값은 기본 브랜치입니다.
author string 아니요 커밋 작성자의 이름 또는 이메일로 필터링합니다.
path string 아니요 이 파일 경로를 변경한 커밋만 반환합니다.
since string 아니요 커밋 날짜가 이 ISO 8601 날짜 또는 시간 이후인 커밋만 반환합니다.
until string 아니요 커밋 날짜가 이 ISO 8601 날짜 또는 시간 이전인 커밋만 반환합니다.
order string 아니요 정렬 방식. topo 또는 date를 사용할 수 있습니다. 기본값은 시간 역순입니다.
first_parent boolean 아니요 머지 커밋의 첫 번째 부모만 따라갑니다.
with_stats boolean 아니요 커밋별 줄 수 통계(추가, 삭제, 변경된 파일)를 포함합니다.
after string 아니요 정방향 페이지네이션용 커서. 이전 응답의 endCursor를 사용합니다.
first integer 아니요 반환할 커밋 수. 기본값은 20, 최댓값은 100입니다.

with_stats가 true이면 각 커밋마다 Gitaly 호출이 발생하므로, first의 기본값은 10 이고 with_stats를 설정한 경우 10을 넘을 수 없습니다.

예시:

List commits to app/models in gitlab-org/gitlab since 2026-08-01 by Alex

list_releases#

히스토리

이 도구는 repository 툴셋에 속합니다.

GitLab 프로젝트의 릴리스를 가장 최근에 릴리스된 순서로 나열합니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트의 GitLab URL. project_id를 제공하지 않으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url을 제공하지 않으면 필수입니다.
page integer 아니요 가져올 페이지 번호. 기본값은 1입니다.
per_page integer 아니요 페이지당 반환할 릴리스 수. 기본값은 20, 최댓값은 100입니다.
state string 아니요 릴리스 상태로 필터링합니다: released, upcoming, all. 기본값은 released입니다.

url 또는 project_id 중 정확히 하나를 제공합니다.

각 항목은 릴리스 메타데이터만 반환합니다: tag_name, name, released_at, upcoming, assets. assets 에는 릴리스 에셋 링크의 count와 그중 최대 5개의 links가 들어 있습니다. 릴리스에 에셋 링크가 5개보다 많으면 count는 실제 전체 개수를 나타냅니다. 소스 아카이브는 태그에서 파생할 수 있으므로 제외됩니다.

응답에는 page, per_page, has_more를 담은 metadata 객체도 포함됩니다. has_more로 다음 페이지를 요청할지 결정합니다.

릴리스 노트는 의도적으로 이 응답에 반환되지 않습니다.

released_at 이 미래인 릴리스는 게시된 것이 아니라 예약된 것이며, 게시된 릴리스보다 앞에 정렬됩니다. state로 어느 쪽을 가져올지 제어합니다. 예약된 릴리스는 upcoming 이 true로 설정됩니다.

릴리스의 기반이 되는 커밋을 읽으려면 해당 tag_name을 get_commit 도구에 전달합니다. 에셋을 다운로드하려면 assets.links의 url을 사용합니다.

예시:

List the most recent releases for project gitlab-org/gitlab

list_tags#

히스토리

이 도구는 repository 툴셋에 속합니다.

GitLab 프로젝트의 태그를 가장 최근에 업데이트된 순서로 나열합니다. search가 태그 이름과 정확히 일치하면 GitLab은 해당 태그를 가장 먼저 나열합니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트의 GitLab URL. project_id를 제공하지 않으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url을 제공하지 않으면 필수입니다.
search string 아니요 이름으로 태그를 필터링합니다. 시작 고정에는 ^, 끝 고정에는 $, 와일드카드에는 *를 지원합니다.
first integer 아니요 반환할 태그 수. 기본값은 20, 최댓값은 100입니다.
after string 아니요 정방향 페이지네이션용 커서. 이전 응답의 metadata.end_cursor를 사용합니다.

url 또는 project_id 중 정확히 하나를 제공합니다.

각 항목은 name과 commit을 반환하며, commit 에는 태그 끝 커밋의 sha 와 title 이 들어 있습니다. 태그가 커밋이 아닌 다른 대상을 가리키면 commit은 null입니다.

태그 메시지는 의도적으로 이 응답에 반환되지 않습니다.

응답에는 has_next_page와 end_cursor를 담은 metadata 객체도 포함됩니다. has_next_page가 true이면 end_cursor를 after로 전달하여 다음 페이지를 가져옵니다.

태그가 가리키는 전체 커밋을 읽으려면 get_commit 도구를 사용합니다.

예시:

List the most recent tags for the gitlab-org/gitlab project

get_pipeline#

히스토리
  • GitLab 19.3에서 도입.
  • artifacts 패싯이 GitLab 19.5에서 도입.
  • GitLab 19.6에서 하위 파이프라인 ID 지원이 도입.

이 도구는 ci 툴셋에 속합니다.

파이프라인을 가져오며, 선택적으로 job, 다운스트림 파이프라인, 브리지(트리거) job 또는 해당 job이 생성한 아티팩트도 가져옵니다.

파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
pipeline_id integer 예 파이프라인의 ID.
include array 아니요 파이프라인과 함께 포함할 패싯. 호출당 하나: jobs, downstream_pipelines, bridge_jobs, artifacts.
job_status string 아니요 상태로 jobs 패싯을 필터링합니다(예: failed). include가 jobs 일 때만 적용됩니다.
first integer 아니요 선택한 include 패싯에 대해 반환할 항목 수. artifacts 패싯에서는 아티팩트를 반환할 job의 수입니다. 기본값은 20, 최댓값은 100입니다.
after string 아니요 선택한 include 패싯의 정방향 페이지네이션용 커서. 이전 응답의 page_info.end_cursor를 사용합니다.

브리지 job의 downstream_pipeline은 트리거 job이 아직 다운스트림 파이프라인을 트리거하지 않은 경우와 해당 파이프라인에 액세스할 수 없는 경우 모두 생략됩니다(null).

다운스트림 파이프라인은 다른 프로젝트에 속할 수 있으므로, 각 다운스트림 파이프라인에는 project_full_path가 포함됩니다. 이 값을 후속 호출의 id로 사용합니다.

하위 파이프라인을 조사하려면 downstream_pipelines 패싯에 있는 파이프라인의 id 또는 bridge_jobs 패싯에 있는 job의 downstream_pipeline.id를 후속 호출의 pipeline_id로 사용합니다. 예를 들어 include: ["jobs"] 및 job_status: "failed"와 함께 전달하면 하위 파이프라인의 실패한 job을 찾을 수 있습니다.

artifacts 패싯은 아티팩트의 평면 목록을 반환합니다. 각 아티팩트에는 name, size, file_type, 만료 정보, 그리고 아티팩트를 생성한 job의 job_id와 job_name이 포함됩니다. 페이지네이션은 아티팩트가 아니라 파이프라인의 job 단위로 적용됩니다.

예시:

  • 파이프라인 가져오기:

    Get the status of pipeline 12345 in project gitlab-org/gitlab
    
  • 파이프라인의 실패한 job 가져오기:

    Show me the failed jobs in pipeline 12345 for project gitlab-org/gitlab
    
  • 파이프라인의 다운스트림 파이프라인 가져오기:

    Show me the downstream pipelines triggered by pipeline 12345 in project gitlab-org/gitlab
    
  • 파이프라인이 생성한 아티팩트 가져오기:

    List the artifacts of pipeline 12345 in project gitlab-org/gitlab
    

get_pipeline_jobs#

히스토리

이 도구는 ci 툴셋에 속합니다.

include: ["jobs"]와 함께 사용하는 get_pipeline으로 대체되었습니다. 이 방식은 파이프라인의 나머지 데이터와 함께 job을 한 번의 호출로 반환합니다. jobs 패싯은 job당 반환하는 필드가 더 적어서 failure_reason, duration, queued_duration, 타임스탬프를 포함하지 않습니다. 이 도구는 더 이상 tools/list에 나타나지 않지만, 호출자가 마이그레이션하는 동안에는 계속 호출할 수 있습니다.

특정 GitLab CI/CD 파이프라인의 job을 가져옵니다.

파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
pipeline_id integer 예 파이프라인의 ID.
per_page integer 아니요 페이지당 job 수.
page integer 아니요 현재 페이지 번호.

예시:

Show me all jobs in pipeline 12345 for project gitlab-org/gitlab

get_job#

히스토리
  • GitLab 19.3에서 도입.
  • GitLab 19.3에서 get_job_log에서 이름 변경. get_job_log는 별칭으로 계속 작동하며 항상 byte_limit으로 제한된 log 패싯을 반환합니다.
  • artifacts 패싯이 GitLab 19.5에서 도입.
  • GitLab 19.6에서 로그 끝부분 읽기(옵트인)가 도입.
  • GitLab 19.6에서 호출당 둘 이상의 include 패싯을 받도록 변경.

이 도구는 ci 툴셋에 속합니다.

CI/CD job의 메타데이터를 가져오며, 선택적으로 트레이스/로그 또는 job이 생성한 아티팩트도 가져옵니다.

파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
job_id integer 예 job의 ID.
include array 아니요 job과 함께 포함할 패싯: log, artifacts 또는 둘 다.
from string 아니요 로그의 start 또는 end부터 읽습니다. 기본값은 start입니다. log 패싯에만 적용됩니다. end와 byte_offset은 함께 사용할 수 없습니다.
byte_offset integer 아니요 job 로그를 읽기 시작할 바이트 오프셋. include에 log가 포함되고 from이 start일 때만 적용됩니다. 기본값은 0입니다.
byte_limit integer 아니요 반환할 job 로그의 최대 바이트 수. include에 log가 포함된 경우에만 적용됩니다. 기본값과 최댓값은 512000입니다.

로그가 byte_limit 보다 길면 응답이 전체 크기를 알려 주고 다음 구간에 사용할 byte_offset을 안내합니다.

마지막 32 KiB를 읽으려면 from: "end"와 byte_limit: 32768을 설정합니다. 응답에는 반환된 바이트 범위를 나타내는 log.metadata.returned.start와 log.metadata.returned.end가 포함됩니다. end 오프셋은 범위에 포함되지 않습니다. 앞쪽 바이트가 남아 있으면 log.system_instruction이 앞 구간을 읽기 위한 인수를 제공합니다. 꼬리 구간 요청의 파라미터를 대체하려면 from: "start"를 포함해 그 인수를 모두 사용합니다. 더 앞쪽 구간을 읽으려면 반환된 start에서 원하는 구간 크기를 빼고, 결과가 음수이면 0으로 맞춘 다음 byte_limit을 두 오프셋 사이의 거리로 설정합니다.

log.metadata.truncated는 반환된 구간 뒤에 바이트가 남아 있음을 나타냅니다. 끝까지 도달한 꼬리 구간에서는 앞쪽 바이트가 있어도 false입니다. 바이트 오프셋은 불완전한 UTF-8 문자를 대체하기 전의 원본 로그를 기준으로 합니다.

artifacts 패싯은 job이 생성한 모든 아티팩트를 name, size, file_type, 만료 정보와 함께 나열합니다.

예시:

  • job 메타데이터 가져오기:

    Get the status of job 88 in project gitlab-org/gitlab
    
  • job 로그 가져오기:

    Show me the log output for job 88 in project gitlab-org/gitlab
    
  • job 로그의 끝부분 가져오기:

    Show me the last 32 KiB of log output for job 88 in project gitlab-org/gitlab
    
  • job의 아티팩트 가져오기:

    What artifacts did job 88 in project gitlab-org/gitlab produce?
    

get_artifact_file#

히스토리
  • GitLab 19.5에서 도입.
  • GitLab 19.6에서 file_type 파라미터가 도입.

이 도구는 ci 툴셋에 속합니다.

CI/CD job의 아티팩트에 있는 파일을 텍스트로 읽습니다. 아티팩트 아카이브 안의 파일이거나, junit 또는 sast 보고서처럼 별도 파일로 저장된 보고서 아티팩트입니다. job이나 파이프라인이 생성한 항목을 확인하려면 include: artifacts와 함께 get_job 또는 get_pipeline 도구를 사용합니다.

파라미터 유형 필수 설명
url string 아니요 job의 URL. 이것을 제공하거나 project_id와 job_id를 제공합니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url을 제공하지 않으면 필수입니다.
job_id integer 아니요 job의 ID. url을 제공하지 않으면 필수입니다.
artifact_path string 아니요 아티팩트 아카이브 안의 파일 경로(예: coverage/index.html). file_type이 archive이면 필수입니다.
file_type string 아니요 읽을 아티팩트 유형. 기본값은 archive입니다. 별도 파일로 저장된 보고서의 경우 artifacts:reports 유형(예: junit 또는 sast)을 설정합니다. 이 경우 artifact_path는 필요하지 않습니다.
byte_offset integer 아니요 파일을 읽기 시작할 바이트 오프셋. 기본값은 0입니다.
byte_limit integer 아니요 반환할 최대 바이트 수. 기본값과 최댓값은 1048576(1 MB)입니다.

artifacts:reports의 보고서 아티팩트는 아카이브 안이 아니라 별도 파일로 저장됩니다. 읽으려면 file_type을 보고서 유형으로 설정합니다. 압축된 보고서는 반환되기 전에 압축이 해제됩니다.

파일이 byte_limit보다 길면 응답이 전체 크기를 알려 주고 다음 구간에 사용할 byte_offset을 안내합니다. 바이너리 파일은 반환되지 않으며, 오류에 파일 이름, 크기와 유형, 브라우저에서 볼 수 있는 위치가 표시됩니다.

예시:

  • job의 아티팩트에서 테스트 보고서 읽기:

    Read coverage/index.html from the artifacts of job 88 in project gitlab-org/gitlab
    
  • 실패한 엔드투엔드 테스트 조사:

    Find the JUnit report in the artifacts of job 88 in gitlab-org/gitlab and summarize the failures
    
  • 아카이브에 없는 보고서 아티팩트 읽기:

    Read the sast report of job 88 in gitlab-org/gitlab
    

get_pages_content#

히스토리

이 도구는 core 툴셋에 속합니다.

GitLab Pages URL에 게시된 콘텐츠를 텍스트로 읽습니다. 이 도구는 URL을 GitLab 인스턴스의 Pages 사이트에서 확인하고 현재 배포에서 파일을 읽으므로, 리포지터리 소스가 아니라 방문자가 보는 내용을 가져옵니다. 보기 권한이 있는 비공개 Pages 사이트도 읽을 수 있습니다.

파라미터 유형 필수 설명
url string 예 읽을 GitLab Pages URL(예: https://mygroup.gitlab.io/myproject/docs/).
byte_offset integer 아니요 파일을 읽기 시작할 바이트 오프셋. 기본값은 0입니다. 최댓값은 20971520(20 MB)입니다.
byte_limit integer 아니요 반환할 최대 바이트 수. 기본값과 최댓값은 1048576(1 MB)입니다.

URL은 인스턴스의 GitLab Pages가 제공하는 사이트(네임스페이스 도메인, 고유 도메인 또는 확인된 사용자 지정 도메인)를 가리켜야 합니다. 다른 호스트는 가져오지 않습니다.

/로 끝나는 URL은 해당 디렉터리의 index.html 파일을 읽습니다. 그 이름의 디렉터리가 없으면 같은 이름의 .html 파일을 읽습니다.

파일 확장자가 없는 URL은 그 이름의 디렉터리가 있으면 해당 디렉터리의 index.html 파일을 읽고, 없으면 GitLab Pages가 사이트를 제공하는 방식과 같게 같은 이름의 .html 파일로 대체합니다.

응답에는 배포 안에서 파일의 path, content_type, 그리고 사이트를 게시하는 프로젝트의 project_id가 포함됩니다. project_id는 해당 프로젝트를 볼 수 있는 경우에만 포함됩니다. 파일이 byte_limit보다 길면 응답이 전체 크기를 알려 주고 다음 구간에 사용할 byte_offset을 안내합니다. 이미지 같은 바이너리 파일은 반환되지 않습니다.

예시:

Read https://mygroup.gitlab.io/myproject/docs/api/ and summarize the authentication section

list_pipelines#

히스토리

이 도구는 ci 툴셋에 속합니다.

GitLab 프로젝트의 파이프라인을 나열하며, 선택적 필터를 사용할 수 있습니다.

파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
ref string 아니요 브랜치 또는 태그 이름. ref로 파이프라인을 필터링합니다.
status string 아니요 상태로 파이프라인을 필터링합니다(예: running, success, failed).
source string 아니요 소스로 파이프라인을 필터링합니다(예: push, web, schedule).
created_after string 아니요 지정한 날짜와 시간(ISO 8601 형식) 이후에 생성된 파이프라인을 반환합니다.
created_before string 아니요 지정한 날짜와 시간(ISO 8601 형식) 이전에 생성된 파이프라인을 반환합니다.
order_by string 아니요 id, status, ref, updated_at, user_id로 파이프라인을 정렬합니다. 기본값은 id입니다.
sort string 아니요 정렬 방향, asc 또는 desc. 기본값은 desc입니다.
page integer 아니요 현재 페이지 번호. 기본값은 1입니다.
per_page integer 아니요 페이지당 항목 수. 기본값은 20입니다.

자식 파이프라인은 기본적으로 결과에서 제외됩니다. 자식 파이프라인만 반환하려면 source를 parent_pipeline으로 설정합니다.

기본 정렬(id, desc)은 ID가 가장 높은 파이프라인을 먼저 반환합니다. ID 순서는 보통 생성 순서와 일치하지만, 둘이 항상 일치한다고 보장되지는 않습니다. 명시적인 시간 경계로 필터링하려면 created_after 또는 created_before를 사용합니다. 호출자는 결과를 페이지별로 넘기다가 대상 범위를 벗어난 첫 번째 파이프라인에서 멈출 수 있습니다.

예시:

List all failed pipelines on the main branch for project gitlab-org/gitlab

list_pipeline_schedules#

히스토리

이 도구는 ci 툴셋에 속합니다.

GitLab 프로젝트의 파이프라인 스케줄을 나열합니다.

파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
scope string 아니요 상태별로 스케줄을 필터링합니다: active 또는 inactive.
page integer 아니요 가져올 페이지 번호. 기본값은 1입니다.
per_page integer 아니요 페이지당 항목 수. 기본값은 20, 최댓값은 100입니다.

응답에는 스케줄 소유자와 Maintainer 또는 Owner 권한이 있는 사용자에게만 inputs가 포함됩니다.

예시:

List active pipeline schedules for project gitlab-org/gitlab

save_pipeline#

히스토리
  • GitLab 19.3에서 도입.
  • GitLab 19.4에서 update 작업이 도입.
  • GitLab 19.6에서 merge_request_iid 파라미터가 추가.

이 도구는 ci 툴셋에 속합니다.

GitLab 프로젝트에서 CI/CD 파이프라인을 실행, 재시도, 취소하거나 이름을 변경합니다. 파이프라인을 나열하려면 대신 list_pipelines 도구를 사용합니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트의 GitLab URL. 파이프라인을 만들 때만 사용합니다. 이것을 제공하거나 project_id를 제공합니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. 파이프라인을 만들 때만 사용합니다. 이것을 제공하거나 url을 제공합니다.
merge_request_iid integer 아니요 파이프라인을 만들 머지 리퀘스트의 내부 ID.
pipeline_id integer 아니요 대상으로 삼을 기존 파이프라인의 ID. 설정하면 action이 필요합니다. 새 파이프라인을 만들려면 생략합니다.
action string 아니요 pipeline_id에 수행할 수명 주기 작업: retry, cancel, update 중 하나. pipeline_id를 설정하면 필수입니다.
ref string 아니요 브랜치 또는 태그 이름. 브랜치나 태그에 파이프라인을 만들 때(pipeline_id와 merge_request_iid가 없을 때) 필수입니다.
name string 아니요 새 파이프라인 이름. action: "update"에서 필수입니다.
variables array 아니요 배열 형식의 파이프라인 변수([{key, value, variable_type}]).
inputs hash 아니요 키-값 쌍으로 된 파이프라인 입력 파라미터.

예시:

  • 파이프라인 만들기:

    Create a pipeline on the main branch for project gitlab-org/gitlab
    
  • 머지 리퀘스트용 파이프라인 만들기:

    Create a pipeline for merge request 42 in project gitlab-org/gitlab
    
  • 파이프라인 재시도:

    Retry failed jobs in pipeline 12345 for project gitlab-org/gitlab
    
  • 파이프라인 취소:

    Cancel pipeline 12345 in project gitlab-org/gitlab
    
  • 파이프라인 이름 변경:

    Rename pipeline 12345 to "Nightly security scan" in project gitlab-org/gitlab
    

save_pipeline_job#

히스토리

이 도구는 ci 툴셋에 속합니다.

사전 요구 사항:

  • job은 지정한 프로젝트에 속하고, 수동 상태이며, 실행할 수 있어야 합니다.
  • job을 실행할 권한이 있어야 하며, job이 배포하는 보호된 환경에 대한 액세스도 포함됩니다.
  • 변수를 전달하려면 인증된 사용자에게 프로젝트에서 파이프라인 변수를 재정의할 권한이 있어야 합니다.

save_pipeline_job은 GitLab 프로젝트의 기존 수동 CI/CD job을 실행하며, 선택적으로 CI/CD 변수를 함께 전달합니다. job을 실행하면 배포가 트리거될 수 있습니다. job을 실행하기 전에 get_job으로 확인합니다.

job의 url을 제공하거나 project_id와 job_id를 모두 제공합니다. url을 project_id, job_id 또는 둘 다와 함께 제공할 수도 있습니다. 제공한 모든 식별자는 같은 프로젝트와 job을 가리켜야 합니다.

파라미터 유형 필수 설명
url string 아니요 job의 전체 URL(예: https://gitlab.example.com/group/project/-/jobs/12345). project_id와 job_id를 제공하지 않으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 전체 경로. url을 제공하지 않으면 필수입니다.
job_id integer 아니요 실행할 수동 job의 ID. url을 제공하지 않으면 필수입니다.
variables array 아니요 배열 형식의 CI/CD 변수([{key, value, variable_type}]). 각 변수에는 key와 value가 필요합니다. 선택 사항인 variable_type은 env_var(기본값) 또는 file입니다.

다음 job 세부 정보를 반환합니다.

필드 유형 설명
id integer job ID.
name string job 이름.
status string 실행 후 job 상태(소문자, 예: pending).
stage string Stage 이름.
pipeline_id integer 파이프라인 ID.
web_url string job의 URL.
pipeline_web_url string 파이프라인의 URL.

예시:

Check job 12345 in project example/my-project, then play it with DEPLOY_ENV set to staging

manage_pipeline#

히스토리
  • GitLab 18.10에서 도입.
  • GitLab 19.3에서 list_pipelines 도구로 대체하기 위해 list 작업이 제거.
  • GitLab 19.3에서 save_pipeline 도구로 대체하기 위해 create, retry, cancel 작업이 제거.
  • GitLab 19.5에서 목록 제외. 파이프라인 이름을 변경하려면 action: "update"와 함께 save_pipeline을 사용합니다.

이 도구는 ci 툴셋에 속합니다.

Warning

이 도구는 더 이상 나열되지 않지만, 오래된 도구 목록을 가지고 있거나 도구 이름을 저장해 둔 에이전트는 계속 호출할 수 있습니다. 파이프라인 이름을 변경하려면 대신 action: "update"와 함께 save_pipeline을 사용합니다. 파이프라인 삭제를 대체하는 도구는 아직 없습니다.

GitLab 프로젝트에서 파이프라인 메타데이터를 업데이트하거나 파이프라인을 삭제합니다. 파이프라인을 만들거나 재시도하거나 취소하려면 대신 save_pipeline 도구를 사용합니다. 파이프라인을 나열하려면 대신 list_pipelines 도구를 사용합니다.

파라미터 유형 필수 설명
id string 예 프로젝트의 ID 또는 전체 경로.
pipeline_id integer 예 파이프라인의 ID. 이 파라미터만 설정하면 파이프라인과 관련 데이터를 모두 삭제합니다.
name string 아니요 파이프라인의 이름. 이 파라미터와 pipeline_id를 함께 설정하면 파이프라인 메타데이터를 업데이트합니다.

예시:

  • 파이프라인 업데이트:

    Rename pipeline 12345 to "My deploy pipeline" in project gitlab-org/gitlab
    
  • 파이프라인 삭제:

    Delete pipeline 12345 in project gitlab-org/gitlab
    

get_work_item#

히스토리
  • GitLab 19.4에서 도입.
  • discussions 패싯이 GitLab 19.5에서 도입.
  • GitLab 19.6에서 호출당 둘 이상의 include 패싯을 받도록 변경.

이 도구는 work_items 툴셋에 속합니다.

단일 작업 항목(이슈, 에픽, 태스크, 인시던트, 목표 또는 핵심 결과)을 유형, 날짜, 담당자, 레이블, 마일스톤, 부모와 함께 가져옵니다. 선택적으로 해당 노트, 토론 또는 관련된 머지 리퀘스트도 포함합니다. 작업 항목 유형이 지원하지 않는 위젯은 생략됩니다.

파라미터 유형 필수 설명
url string 아니요 작업 항목의 GitLab URL(/-/work_items/, /-/issues/, /-/epics/ URL). 이것을 제공하거나 group_id 또는 project_id와 함께 work_item_iid를 제공합니다.
group_id string 아니요 그룹의 ID 또는 경로. url과 project_id가 없으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 경로. url과 group_id가 없으면 필수입니다.
work_item_iid integer 아니요 작업 항목의 내부 ID. url이 없으면 필수입니다.
include array 아니요 반환할 연관 데이터. notes, discussions, related_merge_requests 중 하나 이상입니다. 한 번의 호출에서 여러 패싯을 요청할 수 있습니다. 최신 노트를 가져오려면 notes_first 나 notes_after 없이 notes_last를 사용합니다.
notes_first integer 아니요 커서 이후로 반환할 노트 수(정방향 페이지네이션). 기본값 100, 최댓값 100.
notes_after string 아니요 노트의 정방향 페이지네이션용 커서. 이전 응답의 pageInfo.endCursor를 사용합니다.
notes_last integer 아니요 커서 이전으로 반환할 노트 수(역방향 페이지네이션). 기본값 100, 최댓값 100.
notes_before string 아니요 노트의 역방향 페이지네이션용 커서. 이전 응답의 pageInfo.startCursor를 사용합니다.
discussions_first integer 아니요 커서 이후로 반환할 토론 수. 기본값 20, 최댓값 100.
discussions_after string 아니요 토론의 정방향 페이지네이션용 커서. 이전 응답의 pageInfo.endCursor를 사용합니다.
discussions_filter string 아니요 반환할 토론: all_notes(기본값), 시스템 노트를 제외하는 only_comments, 시스템 노트만 반환하는 only_activity.
related_merge_requests_first integer 아니요 반환할 관련 머지 리퀘스트 수. 기본값 20, 최댓값 100.
related_merge_requests_after string 아니요 관련 머지 리퀘스트의 정방향 페이지네이션용 커서.
mr_page_size integer 아니요 더 이상 사용되지 않음: 대신 related_merge_requests_first를 사용합니다.
mr_pagination_cursor string 아니요 더 이상 사용되지 않음: 대신 related_merge_requests_after를 사용합니다.

notes 패싯은 호출당 최대 100개의 노트를 반환하며 notes_* 파라미터로 양방향 페이지네이션을 지원합니다. 각 노트에는 노트가 속한 스레드의 ID인 discussion.id가 포함되므로 스레드별로 노트를 묶을 수 있습니다.

스레드 구조와 해결 상태에는 discussions를, 시간순으로 나열한 평면 기록에는 notes를 사용합니다.

discussions 패싯은 작업 항목의 스레드를 반환합니다. 각 토론에는 resolvable 및 resolved 상태와 노트가 포함되므로 아직 해결되지 않은 스레드를 찾을 수 있습니다. 해결되지 않은 스레드는 resolvable이 true이고 resolved가 false입니다. discussions_* 파라미터로 정방향 페이지네이션만 지원하며, 하나의 토론이 여러 페이지로 나뉘지 않습니다.

related_merge_requests 패싯은 에픽과 같은 그룹 작업 항목에서는 비어 있습니다.

예시:

Get issue 42 in project gitlab-org/gitlab with its related merge requests

get_workitem_notes#

히스토리

이 도구는 work_items 툴셋에 속합니다.

양방향으로 노트를 페이지네이션하는 include: ["notes"]와 함께 사용하는 get_work_item으로 대체되었습니다. 이 도구는 더 이상 tools/list에 나타나지 않지만, 호출자가 마이그레이션하는 동안에는 계속 호출할 수 있습니다.

특정 GitLab 작업 항목의 모든 노트(댓글)를 가져옵니다.

파라미터 유형 필수 설명
url string 아니요 작업 항목의 URL. group_id 또는 project_id와 work_item_iid가 없으면 필수입니다.
group_id string 아니요 그룹의 ID 또는 경로. url과 project_id가 없으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 경로. url과 group_id가 없으면 필수입니다.
work_item_iid integer 아니요 작업 항목의 내부 ID. url이 없으면 필수입니다.
after string 아니요 정방향 페이지네이션용 커서.
before string 아니요 역방향 페이지네이션용 커서.
first integer 아니요 정방향 페이지네이션으로 반환할 노트 수.
last integer 아니요 역방향 페이지네이션으로 반환할 노트 수.

예시:

Show me all comments on work item 42 in project gitlab-org/gitlab
히스토리
  • GitLab 19.0에서 도입.
  • GitLab 19.4에서 work_items_ids에 일반 iid를 사용할 수 있게 도입.

이 도구는 work_items 툴셋에 속합니다.

작업 항목을 관계 유형과 함께 하나 이상의 다른 작업 항목에 연결합니다.

파라미터 유형 필수 설명
work_items_ids array 예 연결할 작업 항목: 원본과 같은 프로젝트 또는 그룹에서 확인되는 일반 iid, 또는 다른 프로젝트나 그룹의 작업 항목에 대한 글로벌 ID(gid://gitlab/WorkItem/<id>). 최대 10개 항목.
url string 아니요 원본 작업 항목의 URL. group_id 또는 project_id와 work_item_iid가 없으면 필수입니다.
group_id string 아니요 그룹의 ID 또는 경로. url과 project_id가 없으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 경로. url과 group_id가 없으면 필수입니다.
work_item_iid integer 아니요 원본 작업 항목의 내부 ID. url이 없으면 필수입니다.
link_type string 아니요 관계 유형. relates_to, blocks, blocked_by 중 하나. 기본값은 relates_to입니다. blocks와 blocked_by 유형에는 GitLab Premium 또는 Ultimate가 필요합니다.

예시:

Mark work item 42 in project gitlab-org/gitlab as blocked by work item 40

get_saved_view_work_items#

히스토리
  • GitLab 18.11에서 도입.
  • GitLab 19.6에서 숫자 saved_view_id를 받고 표시 설정을 반환하도록 변경.

이 도구는 work_items 툴셋에 속합니다.

네임스페이스에서 저장된 뷰와 해당 작업 항목 목록을 가져옵니다. 이 도구는 저장된 뷰의 필터와 정렬 순서를 반환되는 작업 항목에 적용합니다. 출력에는 저장된 뷰의 표시 설정도 포함됩니다.

파라미터 유형 필수 설명
saved_view_id string 예 저장된 뷰의 숫자 ID(예: 42) 또는 글로벌 ID(gid://gitlab/WorkItems::SavedViews::SavedView/42).
url string 아니요 네임스페이스(프로젝트 또는 그룹)의 URL. group_id 또는 project_id가 없으면 필수입니다.
group_id string 아니요 그룹의 ID 또는 경로. url과 project_id가 없으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 경로. url과 group_id가 없으면 필수입니다.
after string 아니요 정방향 페이지네이션용 커서.
first integer 아니요 반환할 작업 항목 수. 최댓값 100.

예시:

Show me the work items in this saved view: 

list_vulnerabilities#

히스토리

이 도구는 code_security 툴셋에 속합니다.

GitLab 프로젝트의 보안 취약점을 선택적 필터와 커서 페이지네이션으로 나열합니다. 페이지네이션된 취약점 메타데이터를 반환합니다. 단일 취약점의 전체 상세 정보를 가져오려면 get_vulnerability를 사용합니다.

보안 대시보드 기능이 활성화되어 있어야 합니다.

이 도구는 라이선스가 적용되는 기능을 사용할 수 있는 경우에만 나열됩니다. 자세한 내용은 도구 그룹 선택을 참고합니다.

파라미터 유형 필수 설명
project_full_path string 예 프로젝트의 전체 경로(예: namespace/project 또는 group/subgroup/project).
severity array of strings 아니요 심각도 수준으로 필터링합니다. 생략하면 모든 심각도의 취약점을 포함합니다. CRITICAL, HIGH, MEDIUM, LOW, INFO, UNKNOWN 중 하나 이상.
report_type array of strings 아니요 보안 보고서 유형으로 필터링합니다. 생략하면 모든 보고서 유형을 포함합니다. 예: SAST, DAST, DEPENDENCY_SCANNING.
state array of strings 아니요 취약점 상태로 필터링합니다. 생략하면 모든 상태의 취약점을 포함합니다. CONFIRMED, DETECTED, DISMISSED, RESOLVED 중 하나 이상.
first integer 아니요 정방향 페이지네이션으로 반환할 취약점 수. 기본값은 20, 최댓값은 100입니다.
after string 아니요 정방향 페이지네이션용 커서. 이전 응답의 pageInfo.endCursor를 사용합니다.

예시:

List critical and high severity vulnerabilities in project gitlab-org/gitlab

get_vulnerability#

히스토리

이 도구는 code_security 툴셋에 속합니다.

제목, 상태, 설명, 심각도, 식별자를 포함하여 단일 취약점의 상세 정보를 반환합니다.

이 도구는 라이선스가 적용되는 기능을 사용할 수 있는 경우에만 나열됩니다. 자세한 내용은 도구 그룹 선택을 참고합니다.

파라미터 유형 필수 설명
vulnerability_id string 예 취약점의 숫자 ID(예: 567).

예시:

Get full details for vulnerability 567

save_vulnerability#

히스토리

이 도구는 code_security 툴셋에 속합니다.

GitLab 프로젝트의 취약점에 대해 쓰기 작업을 수행합니다.

이 도구는 라이선스가 적용되는 기능을 사용할 수 있는 경우에만 나열됩니다. 자세한 내용은 도구 그룹 선택을 참고합니다.

파라미터 유형 필수 설명
action string 예 수행할 작업. dismiss, confirm, revert_to_detected, update_severity, create_issue 중 하나.
vulnerability_id string 예 취약점의 숫자 ID(예: 567).
comment string 아니요 작업에 대한 설명. action 이 update_severity 일 때 필수입니다.
dismissal_reason string 아니요 무시 사유. ACCEPTABLE_RISK, FALSE_POSITIVE, MITIGATING_CONTROL, USED_IN_TESTS, NOT_APPLICABLE 중 하나. action 이 dismiss 일 때만 사용합니다.
severity string 아니요 새 심각도 수준. INFO, UNKNOWN, LOW, MEDIUM, HIGH, CRITICAL 중 하나. action 이 update_severity 일 때 필수입니다.
project_full_path string 아니요 프로젝트의 전체 경로(예: namespace/project). action 이 create_issue 일 때 필수입니다.

예시:

  • 취약점 무시:

    Dismiss vulnerability 123 with reason FALSE_POSITIVE
    
  • 취약점 확인:

    Mark vulnerability 456 as confirmed
    
  • 탐지됨 상태로 되돌리기:

    Revert vulnerability 789 back to detected state
    
  • 심각도 업데이트:

    Change severity of vulnerability 321 to CRITICAL with comment "Reassessed based on new intel"
    
  • 이슈 만들기:

    Create an issue for vulnerability 654 in project gitlab-org/gitlab
    

save_work_item#

히스토리
  • GitLab 19.4에서 도입.
  • GitLab 19.4에서 labels, add_labels, remove_labels, milestone_id, milestone 파라미터가 도입.
  • GitLab 19.6에서 description_edits 파라미터가 도입.

이 도구는 work_items 툴셋에 속합니다.

이슈, 태스크, 에픽과 같은 GitLab 작업 항목을 만들거나 업데이트합니다. 새 작업 항목을 만들려면 work_item_iid를 생략합니다. 기존 작업 항목을 업데이트하려면 work_item_iid 또는 작업 항목 URL을 제공합니다. 설정하려는 필드만 보내고 나머지는 생략합니다. 도구 이름 create_work_item과 update_work_item은 이 도구의 별칭입니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트, 그룹 또는 작업 항목의 GitLab URL. url, project_id, group_id 중 정확히 하나를 제공합니다.
group_id string 아니요 그룹의 ID 또는 경로. url과 project_id가 없으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 경로. url과 group_id가 없으면 필수입니다.
work_item_iid integer 아니요 업데이트할 작업 항목의 양수 내부 ID. 새 작업 항목을 만들려면 생략합니다.
title string 아니요 작업 항목의 제목. 작업 항목을 만들 때 필수입니다.
type_name string 아니요 작업 항목 유형 이름(예: Issue, Task, Epic). 작업 항목을 만들 때 필수입니다. 유효한 유형은 네임스페이스와 라이선스에 따라 달라집니다.
description string 아니요 GitLab Flavored Markdown으로 작성한 설명. 최대 1,048,576자.
description_edits array of objects 아니요 업데이트 전용. 현재 설명에 순서대로 적용할 교체 항목이며, 각 항목은 old_str과 new_str을 가집니다. 각 old_str은 정확히 한 번 일치해야 합니다. description과 함께 사용할 수 없습니다. 최대 100개 항목.
assignee_ids array of integers 아니요 작업 항목에 배정할 사용자 ID. 최대 100개 항목.
label_ids array of strings 아니요 레이블 ID 또는 글로벌 ID. 만들 때만 사용하며, 업데이트할 때는 add_label_ids 또는 remove_label_ids를 사용합니다. 최대 100개 항목.
labels array of strings 아니요 설정할 레이블 이름. 프로젝트 또는 그룹과 그 상위 그룹에서 확인됩니다. 만들 때만 사용하며, 업데이트할 때는 add_labels 또는 remove_labels를 사용합니다. 최대 100개 항목.
add_label_ids array of strings 아니요 업데이트 전용. 추가할 레이블 ID 또는 글로벌 ID. 최대 100개 항목.
add_labels array of strings 아니요 업데이트 전용. 추가할 레이블 이름. 최대 100개 항목.
remove_label_ids array of strings 아니요 업데이트 전용. 제거할 레이블 ID 또는 글로벌 ID. 최대 100개 항목.
remove_labels array of strings 아니요 업데이트 전용. 제거할 레이블 이름. 최대 100개 항목.
milestone_id string 아니요 배정할 마일스톤의 ID 또는 글로벌 ID. 프로젝트 또는 그룹과 그 상위 그룹을 기준으로 검증됩니다. 둘 다 지정하면 milestone 보다 우선합니다.
milestone string 아니요 배정할 마일스톤의 제목. 프로젝트 또는 그룹과 그 상위 그룹의 마일스톤 중에서 확인됩니다.
confidential boolean 아니요 작업 항목의 기밀 여부를 설정합니다.
start_date string 아니요 시작일. YYYY-MM-DD 형식.
due_date string 아니요 기한. YYYY-MM-DD 형식.
state string 아니요 업데이트 전용. closed는 작업 항목을 닫고, opened는 다시 엽니다.
parent_id string 아니요 부모 작업 항목의 글로벌 ID 또는 숫자 ID.
todo_action string 아니요 업데이트 전용. add는 현재 사용자의 할 일을 추가하고, mark_as_done은 할 일을 완료로 표시합니다.
todo_id string 아니요 업데이트 전용. 할 일의 글로벌 ID 또는 숫자 ID. 작업 항목의 모든 할 일을 업데이트하려면 생략합니다.
health_status string 아니요 상태(health status). onTrack, needsAttention, atRisk 중 하나. Ultimate 전용.
weight integer 아니요 작업 항목의 가중치. 0 이상이어야 합니다. Premium 및 Ultimate 전용.
clear_weight boolean 아니요 업데이트 전용. 가중치를 제거합니다. weight 보다 우선합니다. Premium 및 Ultimate 전용.
status_id string 아니요 설정할 상태의 글로벌 ID. Premium 및 Ultimate 전용.
is_fixed boolean 아니요 시작일과 기한이 고정인지 여부. false이면 날짜가 하위 항목에서 집계되며 start_date와 due_date는 무시됩니다. Premium 및 Ultimate 전용.
agent_plan string 아니요 에이전트 계획의 Markdown 콘텐츠. Premium 및 Ultimate 전용. workplan 기능이 필요합니다.
readiness_score integer 아니요 에이전트 계획의 준비도 점수, 0~100. Premium 및 Ultimate 전용. workplan 기능이 필요합니다.

예시:

Create a task "Update the onboarding guide" in project gitlab-org/gitlab and assign it to me

list_work_item_saved_views#

히스토리

이 도구는 work_items 툴셋에 속합니다.

프로젝트 또는 그룹의 작업 항목 저장된 뷰를 나열합니다. url, group_id, project_id 중 정확히 하나를 제공합니다. 결과의 각 저장된 뷰에는 숫자 id가 있습니다. 저장된 뷰 하나의 필터와 작업 항목을 가져오려면 해당 id를 get_saved_view_work_items에 전달합니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트 또는 그룹의 URL.
group_id string 아니요 그룹의 ID 또는 경로.
project_id string 아니요 프로젝트의 ID 또는 경로.
search string 아니요 이름 또는 설명으로 저장된 뷰를 검색합니다.
subscribed_only boolean 아니요 true이면 구독 중인 저장된 뷰만 반환합니다.
sort string 아니요 정렬 순서. ID는 최신순으로 정렬합니다. NAME_ASC는 이름순으로 정렬합니다. RELATIVE_POSITION은 구독 중인 뷰의 사용자 지정 순서로 정렬하며 subscribed_only: true가 필요합니다. 기본값은 ID입니다.
after string 아니요 정방향 페이지네이션용 커서.
first integer 아니요 반환할 저장된 뷰 수. 최댓값 100.

예시:

List the saved views in group gitlab-org

list_work_items#

히스토리
  • GitLab 19.4에서 도입.
  • GitLab 19.6에서 parent_iid 파라미터가 추가.

이 도구는 work_items 툴셋에 속합니다.

그룹 또는 프로젝트의 작업 항목(이슈, 인시던트, 테스트 케이스, 요구 사항, 태스크, 티켓, 목표, 핵심 결과, 에픽)을 나열하거나 검색합니다. 그룹 범위에는 하위 프로젝트와 하위 그룹의 작업 항목이 포함됩니다. 각 결과에는 ID, IID, 제목, 상태, 웹 URL, 전체 참조, 생성 및 업데이트 타임스탬프, 작업 항목 유형만 포함되며 커서 페이지네이션을 사용합니다. 작업 항목 하나를 자세히 읽으려면 get_work_item을 사용합니다.

파라미터 유형 필수 설명
url string 아니요 프로젝트 또는 그룹의 GitLab URL. url, group_id, project_id 중 정확히 하나를 제공합니다.
group_id string 아니요 그룹의 ID 또는 경로. url과 project_id가 없으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 경로. url과 group_id가 없으면 필수입니다.
state string 아니요 상태로 필터링합니다: opened, closed, all(기본값).
search string 아니요 제목과 설명에서 자유 텍스트로 검색합니다.
author_username string 아니요 작성자의 사용자 이름.
assignee_usernames array 아니요 담당자의 사용자 이름. 작업 항목이 모두와 일치해야 합니다. 최대 100개 값.
label_name array 아니요 레이블 이름. 작업 항목이 모두 가지고 있어야 합니다. 최대 100개 값.
milestone_title array 아니요 마일스톤 제목. milestone_wildcard_id와 함께 사용할 수 없습니다. 최대 100개 값.
milestone_wildcard_id string 아니요 NONE, ANY, STARTED, UPCOMING. milestone_title과 함께 사용할 수 없습니다.
types array 아니요 포함할 작업 항목 유형(예: ["ISSUE", "TASK"]).
parent_iid integer 아니요 지정한 프로젝트 또는 그룹에 있는 부모 작업 항목의 IID. 해당 항목의 직접 하위 항목을 반환합니다.
created_after string 아니요 이 시간 이후에 생성됨(ISO 8601. 날짜만 지정하면 해당 날짜의 시작, 오프셋 적용).
created_before string 아니요 이 시간 이전에 생성됨(ISO 8601. 날짜만 지정하면 해당 날짜의 시작, 오프셋 적용).
updated_after string 아니요 이 시간 이후에 업데이트됨(ISO 8601. 날짜만 지정하면 해당 날짜의 시작, 오프셋 적용).
updated_before string 아니요 이 시간 이전에 업데이트됨(ISO 8601. 날짜만 지정하면 해당 날짜의 시작, 오프셋 적용).
due_after string 아니요 기한이 이 시간 이후임(ISO 8601. 날짜만 지정하면 해당 날짜의 시작, 오프셋 적용).
due_before string 아니요 기한이 이 시간 이전임(ISO 8601. 날짜만 지정하면 해당 날짜의 시작, 오프셋 적용).
sort string 아니요 정렬 순서(예: UPDATED_DESC). 기본값 CREATED_DESC.
first integer 아니요 반환할 작업 항목 수. 기본값 20, 최댓값 100.
after string 아니요 정방향 페이지네이션용 커서.
health_status_filter string 아니요 Ultimate 전용. onTrack, needsAttention, atRisk.
status object 아니요 Ultimate 전용. 사용자 지정 상태 이름으로 필터링합니다(예: {"name": "In progress"}).

예시:

List my open tasks in the gitlab-org group updated this month.

get_work_item_types#

히스토리

이 도구는 work_items 툴셋에 속합니다.

네임스페이스(그룹 또는 프로젝트)에서 사용할 수 있는 작업 항목 유형을 나열합니다. 여기에는 시스템 정의 유형(예: Issue, Epic, Task)과 사용자 지정 유형이 포함됩니다. 반환되는 각 유형에는 글로벌 ID, 이름, 아이콘, 해당 유형에서 활성화된 위젯 유형이 포함되므로, 해당 유형이 지원하지 않는 필드를 설정하지 않도록 할 수 있습니다.

프로젝트 수준 유형의 경우 include: ["work_item_types"]와 함께 get_project를 사용하면 프로젝트와 함께 같은 데이터를 반환합니다.

파라미터 유형 필수 설명
url string 아니요 네임스페이스(프로젝트 또는 그룹)의 GitLab URL. group_id와 project_id가 없으면 필수입니다.
group_id string 아니요 그룹의 ID 또는 경로. url과 project_id가 없으면 필수입니다.
project_id string 아니요 프로젝트의 ID 또는 경로. url과 group_id가 없으면 필수입니다.

예시:

List the work item types available in the gitlab-org group

list_projects#

히스토리

이 도구는 core 툴셋에 속합니다.

group_id가 없으면 기본적으로 Guest 권한 이상을 가진 프로젝트를 나열하며, 기준을 높이려면 min_access_level을 전달합니다. group_id가 있으면 액세스 수준과 관계없이 해당 그룹과 그 하위 그룹의 모든 프로젝트를 나열합니다. min_access_level 이나 visibility를 추가하면 GitLab이 그룹의 프로젝트를 나열할 때 하위 그룹 탐색과 이러한 필터를 함께 사용하는 것을 지원하지 않으므로, 목록이 하위 그룹을 제외한 해당 그룹으로만 좁혀집니다.

파라미터 유형 필수 설명
group_id string 아니요 그룹의 ID 또는 전체 경로. 생략하면 인스턴스 전체에서 나열하며, 기본적으로 Guest 권한 이상을 가진 프로젝트를 대상으로 합니다.
min_access_level string 아니요 프로젝트가 포함되려면 본인에게 부여해야 하는 최소 액세스 수준. guest, planner, reporter, developer, maintainer, owner 중 하나.
search string 아니요 이름, 경로 또는 설명으로 프로젝트를 검색합니다.
visibility string 아니요 공개 범위 수준으로 필터링합니다: public, internal, private.
archived string 아니요 보관 상태로 필터링합니다: only, include, exclude(기본값).
after string 아니요 정방향 페이지네이션용 커서.
first integer 아니요 정방향 페이지네이션으로 반환할 프로젝트 수. 기본값은 20, 최댓값은 100입니다.

group_id를 제공하면 응답에 subgroupsIncluded가 포함됩니다. 목록이 그룹의 하위 그룹을 포함하면 true, min_access_level 또는 visibility로 목록이 해당 그룹으로만 좁혀졌으면 false입니다.

예시:

List my projects

get_group#

히스토리

이 도구는 core 툴셋에 속합니다.

단일 GitLab 그룹에 대해 다음 메타데이터를 반환합니다.

  • 숫자 ID
  • 전체 경로
  • 이름
  • 공개 범위
  • 부모
  • 웹 URL

url 또는 group_id 중 하나를 제공합니다.

파라미터 유형 필수 설명
url string 아니요 그룹의 URL.
group_id string 아니요 그룹의 ID 또는 전체 경로(예: gitlab-org/quality).

응답에는 id, fullPath, name, visibility, webUrl, parent가 포함됩니다. parent 필드에는 부모 그룹의 숫자 ID가 들어 있습니다. 최상위 그룹이거나 부모 그룹에 액세스할 수 없으면 null입니다. 그룹을 찾으려면 list_groups를 사용합니다.

예시:

What is the ID and visibility of gitlab-org/quality?

list_groups#

히스토리

이 도구는 core 툴셋에 속합니다.

그룹 계층을 탐색하고 다른 도구에서 사용할 그룹 ID와 전체 경로를 찾기 위해 그룹을 나열합니다. group_id가 없으면 이 도구는 본인이 멤버인 최상위 그룹을 나열합니다. group_id가 있으면 멤버십과 관계없이 해당 그룹의 직접 하위 그룹을 나열합니다. include_subgroups를 true로 설정하면 모든 하위 그룹으로 재귀합니다. group_id가 없을 때는 본인의 그룹을 모든 깊이에서 나열합니다. 보관된 그룹과 삭제 예정인 그룹은 제외됩니다.

파라미터 유형 필수 설명
group_id string 아니요 하위 그룹을 나열할 상위 그룹의 ID 또는 전체 경로. 생략하면 본인이 멤버인 최상위 그룹을 나열합니다.
search string 아니요 이름 또는 전체 경로로 그룹을 검색합니다.
visibility string 아니요 공개 범위 수준으로 필터링합니다: public, internal, private.
include_subgroups boolean 아니요 직접 하위 그룹만이 아니라 모든 하위 그룹을 재귀적으로 포함합니다.
after string 아니요 정방향 페이지네이션용 커서.
first integer 아니요 정방향 페이지네이션으로 반환할 그룹 수. 기본값은 20, 최댓값은 100입니다.

예시:

List the subgroups of gitlab-org
히스토리
  • GitLab 18.4에서 도입.
  • GitLab 18.6에서 그룹과 프로젝트 검색, 결과 정렬 및 순서 지정이 추가.
  • GitLab 18.8에서 gitlab_search에서 search로 이름 변경.

이 도구는 core 툴셋에 속합니다.

검색 API로 전체 GitLab 인스턴스에서 검색어를 검색합니다. 이 도구는 전역, 그룹, 프로젝트 검색에서 사용할 수 있습니다. 사용 가능한 범위는 검색 유형에 따라 다릅니다.

파라미터 유형 필수 설명
scope string 예 검색 범위(예: work_items, merge_requests, projects).
search string 예 검색어.
group_id string 아니요 검색할 그룹의 ID 또는 전체 경로.
project_id string 아니요 검색할 프로젝트의 ID 또는 전체 경로.
state string 아니요 검색 결과의 상태(work_items 및 merge_requests 용).
confidential boolean 아니요 기밀 여부로 결과를 필터링합니다(work_items 용). 기본값은 false입니다.
fields array of strings 아니요 검색할 필드 배열(work_items 및 merge_requests 용).
order_by string 아니요 결과를 정렬할 속성. 기본값은 기본 검색에서는 created_at, 고급 검색에서는 관련도입니다.
sort string 아니요 결과의 정렬 방향. 기본값은 desc입니다.
per_page integer 아니요 페이지당 결과 수. 기본값은 20입니다.
page integer 아니요 현재 페이지 번호. 기본값은 1입니다.

예시:

Search issues for "flaky test" across GitLab

search_labels#

히스토리
  • GitLab 18.9에서 도입.
  • GitLab 19.5에서 여러 검색어를 받도록 변경.
  • GitLab 19.6에서 project_id와 group_id를 받도록 변경.

이 도구는 core 툴셋에 속합니다.

GitLab 프로젝트 또는 그룹에서 레이블을 검색합니다.

파라미터 유형 필수 설명
project_id string 아니요 프로젝트의 ID 또는 경로. group_id 또는 full_path의 대안입니다.
group_id string 아니요 그룹의 ID 또는 경로. project_id 또는 full_path의 대안입니다.
full_path string 아니요 프로젝트 또는 그룹의 전체 경로(예: group/project). project_id 또는 group_id의 대안입니다. is_project가 필요합니다.
is_project boolean 아니요 full_path가 프로젝트(true)인지 그룹(false)인지 여부. full_path와 함께 사용할 때 필수입니다.
search string or array of strings 아니요 제목으로 레이블을 필터링하는 검색어 하나 또는 최대 10개의 검색어 배열. 생략하면 대신 레이블을 나열합니다. 빈 배열은 유효하지 않습니다.

project_id, group_id, full_path 중 정확히 하나를 제공합니다.

그룹 레이블을 검색하면 결과에 상위 그룹과 하위 그룹의 레이블이 포함됩니다. 여러 검색어의 결과는 중복되는 레이블 없이 하나의 목록으로 합쳐집니다.

예시:

Show me all labels in project gitlab-org/gitlab

list_wiki_pages#

히스토리

이 도구는 wikis 툴셋에 속합니다.

GitLab 프로젝트 또는 그룹의 위키 페이지를 나열합니다.

파라미터 유형 필수 설명
project_id string 아니요 프로젝트의 전체 경로 또는 숫자 ID(예: gitlab-org/gitlab 또는 278964).
group_id string 아니요 그룹의 전체 경로 또는 숫자 ID(예: gitlab-org 또는 9970).
first integer 아니요 정방향 페이지네이션으로 반환할 위키 페이지 수(최댓값 100).
after string 아니요 정방향 페이지네이션용 커서.

project_id 또는 group_id 중 하나만 제공합니다. 각 호출은 결과의 한 페이지를 반환합니다. 페이지가 더 있으면 응답에 end_cursor가 포함되며, 이를 after로 전달하여 다음 페이지를 가져올 수 있습니다.

예시:

List the wiki pages in gitlab-org/gitlab
히스토리
  • GitLab 18.5에서 code_snippet_search_graphqlapi 라는 기능 플래그와 함께 실험 기능으로 도입. 기본적으로 비활성화되어 있습니다.
  • GitLab 18.6에서 프로젝트 경로로 검색이 추가.
  • GitLab 18.7에서 실험 기능에서 베타로 변경. 기능 플래그 code_snippet_search_graphqlapi 제거.
  • GitLab 18.7에서 mcp_client 라는 기능 플래그와 함께 GitLab UI에 추가. 기본적으로 비활성화되어 있습니다.
  • GitLab 18.11에서 mcp_semantic_code_search_use_rest_api 라는 기능 플래그와 함께 REST API를 사용하도록 업데이트. 기본적으로 비활성화되어 있습니다.
  • GitLab 19.1에서 REST API 사용이 정식 출시. 기능 플래그 mcp_semantic_code_search_use_rest_api 제거.
  • GitLab 19.4에서 semantic_code_search에서 이름 변경. semantic_code_search는 별칭으로 계속 작동합니다.
  • GitLab 19.4에서 scope 파라미터가 추가.
  • GitLab 19.4에서 semantic_query 파라미터가 q로 이름 변경.
  • GitLab 19.6에서 scope 파라미터가 선택 사항으로 변경.

이 도구는 core 툴셋에 속합니다.

Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.

키워드가 아니라 의미를 기준으로 GitLab 프로젝트에서 관련 콘텐츠를 검색합니다. 정확한 심볼이나 파일 이름을 모르거나, 코드베이스 전반에서 특정 동작이 어떻게 구현되어 있는지 파악할 때 이 도구를 사용합니다. 설정 및 활성화를 포함한 자세한 내용은 시맨틱 코드 검색을 참고합니다.

파라미터 유형 필수 설명
scope string 아니요 검색할 콘텐츠 유형. code만 지원됩니다. 생략하면 code가 사용됩니다.
q string 예 자연어 검색 쿼리.
project_id string 예 프로젝트의 ID 또는 전체 경로.
directory_path string 아니요 이 디렉터리 경로 아래의 파일로 검색을 제한합니다(예: app/services/). 앞에 슬래시나 .. 세그먼트가 없는 상대 경로여야 합니다. scope가 code 일 때만 적용됩니다.
knn integer 아니요 내부적으로 조회하는 최근접 이웃 수. 기본값은 64, 최댓값은 100입니다. 값이 높을수록 지연 시간을 대가로 재현율이 향상됩니다. scope가 code 일 때만 적용됩니다.
limit integer 아니요 반환할 최대 결과 수. 기본값은 20, 최댓값은 100입니다. scope가 code 일 때만 적용됩니다.

결과는 파일별로 그룹화됩니다. 각 파일에는 콘텐츠와 관련도 점수가 있는 병합된 줄 범위가 포함됩니다. 최상의 결과를 얻으려면 일반적인 키워드나 특정 함수 또는 변수 이름을 사용하지 말고, 알고 싶은 기능이나 동작을 설명합니다.

예시:

How are authorizations managed in this project?

attach_scan_profile#

히스토리

이 도구는 code_security 툴셋에 속합니다.

지정한 보안 스캔 프로파일을 지정한 프로젝트 또는 지정한 그룹 아래의 모든 프로젝트에 연결합니다.

이 도구는 라이선스가 적용되는 기능을 사용할 수 있는 경우에만 나열됩니다. 자세한 내용은 도구 그룹 선택을 참고합니다.

파라미터 유형 필수 설명
security_scan_profile_id string 예 보안 스캔 프로파일의 글로벌 ID(예: gid://gitlab/Security::ScanProfile/1).
project_ids array of strings 아니요 프로젝트의 글로벌 ID 배열(예: [gid://gitlab/Project/1]). group_ids를 제공하지 않으면 필수입니다.
group_ids array of strings 아니요 그룹의 글로벌 ID 배열(예: [gid://gitlab/Group/1]). project_ids를 제공하지 않으면 필수입니다.

예시:

Attach `gid://gitlab/Security::ScanProfile/1` to all projects under `gid://gitlab/Group/1`.

Orbit 도구#

히스토리

orbit 툴셋에는 GitLab Orbit 명령마다 도구가 하나씩 있습니다(예: query_graph). 도구 이름, 설명, 입력 스키마는 Orbit 서버가 설정합니다. MCP 클라이언트는 GitLab MCP 서버에서 현재 도구 목록을 가져옵니다. 명령과 각 명령의 기능은 GitLab Orbit 엔드포인트 도구를 참고합니다.

이 도구는 orbit 툴셋을 요청하고 Orbit 요구 사항을 충족하는 경우에만 나열됩니다. 자세한 내용은 도구 그룹 선택을 참고합니다.

예시:

Use GitLab Orbit to list the 5 most recently updated projects in my group.

Footnotes

  1. resolve_discussion의 경우 도구는 method, 글로벌 ID 형식의 discussion_id, 새 resolved 상태, 스레드 첫 번째 노트의 web_url을 반환합니다. ↩