InfoGrab DocsInfoGrab Docs

에이전트 도구 거버넌스

요약

이 기능은 베타입니다. 도구 거버넌스는 실행 경계에 위치합니다. 백그라운드 플로에 대한 적용은 기능 플래그로 제어됩니다. 도구는 세 가지 작업 범주로 분류됩니다. 에이전트 도구 거버넌스(사람 참여형 가드레일)를 사용하면 관리자가 각 에이전트 도구를 실행하는 순간에 어떻게 적용할지 정의할 수 있습니다.

히스토리
  • GitLab 19.1에서 gitlab_duo_governance_settings라는 기능 플래그와 함께 베타로 도입되었습니다. 기본적으로 활성화되어 있습니다.
  • GitLab 19.3에서 Developer Flow와 같은 백그라운드 플로에 기능 플래그와 함께 추가되었습니다. 기능 플래그 이름은 duo_workflow_background_tool_governance입니다. 기본적으로 비활성화되어 있습니다.
  • 기능 플래그 gitlab_duo_governance_settings가 GitLab 19.4에서 제거되었습니다.
  • 로컬 파일 읽기의 기본값이 GitLab 19.5에서 Always Ask에서 Always Allow로 변경되었습니다.
  • 탭별 권한이 GitLab 19.6에서 도입되었습니다.
Warning

이 기능은 베타입니다. 사전 고지 없이 변경될 수 있습니다. 자세한 내용은 GitLab 테스트 계약을 참고합니다.

도구 거버넌스는 실행 경계에 위치합니다. 에이전트가 프로젝트에 승인된 뒤 도구를 호출하기 전에, 거버넌스 계층이 사용자의 권한과 도구의 작업 범주에 맞게 구성된 규칙을 조회하고, 그 결과로 정해진 모드를 적용합니다.

Feature flag

백그라운드 플로에 대한 적용은 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.

도구는 세 가지 작업 범주로 분류됩니다.

  • Read: 정보를 조회하거나 표시하기만 하는 도구입니다.
  • Write: 리소스를 생성하거나 수정하는 도구입니다.
  • Delete: 리소스를 삭제하거나 되돌릴 수 없게 제거하는 도구입니다.

에이전트 도구 거버넌스(사람 참여형 가드레일)를 사용하면 관리자가 각 에이전트 도구를 실행하는 순간에 어떻게 적용할지 정의할 수 있습니다. 에이전트가 검토 없이 어떤 도구든 호출하도록 허용하는 대신, 각 도구를 다음 세 가지 모드 중 하나로 구성할 수 있습니다.

  • Always Allow: 도구가 사용자에게 묻지 않고 조용히 실행됩니다.
  • Always Ask: 사용자에게 인라인 승인 카드가 표시되며, 작업이 진행되기 전에 사용자가 작업을 승인하거나 거부해야 합니다.
  • Always Deny: 도구가 완전히 차단되어 에이전트에게 보이지 않습니다. 에이전트는 해당 도구를 보지 못하고 사용자에게도 승인을 묻지 않습니다.

이 기능은 Agentic Chat과 IDE 확장 프로그램에 적용됩니다. 플로의 경우 거버넌스 적용은 플로가 실행되는 위치에 따라 달라집니다.

  • IDE 확장 프로그램에서 실행되는 플로는 GitLab이 거버넌스 규칙을 적용합니다.
  • Developer Flow와 같은 백그라운드 플로는 duo_workflow_background_tool_governance 기능 플래그가 활성화된 경우 GitLab이 거버넌스 규칙을 적용합니다.

접근 유형#

각 도구는 접근 유형마다 별도의 모드를 가집니다. 접근 유형은 에이전트가 누구로서 동작하는지, 그리고 어디에서 실행되는지에 따라 정해집니다.

Cloud access : GitLab에서 사용자로서 실행됩니다. 예를 들어 GitLab UI의 GitLab Duo Agentic Chat입니다.

Local access : 사용자의 컴퓨터에서 사용자로서 실행됩니다. 예를 들어 IDE 확장 프로그램과 GitLab Duo CLI입니다.

Background access : 서비스 계정으로서 누구도 기다리지 않고 GitLab에서 실행됩니다. 예를 들어 자동화나 멘션으로 시작된 플로와 코드 리뷰입니다.

Note

로컬 접근 모드는 GitLab MCP 서버에 대한 호출에만 적용됩니다. 로컬 파일 도구와 같은 IDE 확장 프로그램이나 GitLab Duo CLI의 기본 제공 도구에는 적용되지 않습니다.

기본 거버넌스 매트릭스#

분류 모드
Read (GitLab 리소스) Always Allow
Read (로컬 파일) Always Allow
Read (에이전트 세션) Always Allow
Write Always Ask
Delete Always Ask

GitLab MCP 서버 도구#

히스토리
  • GitLab 19.4에서 duo_mcp_tool_governance라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • GitLab 19.4에서 GitLab.com, GitLab Self-Managed, GitLab Dedicated에 활성화되었습니다.
Feature flag

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

GitLab MCP 서버가 노출하는 도구는 GitLab Duo Agent Platform 도구와 함께 Tool management 탭에 출처가 mcp로 표시됩니다. 이 도구들의 모드도 같은 방식으로 설정하며, 자세한 내용은 그룹의 도구 거버넌스 구성에 나와 있습니다.

Note

도구 거버넌스는 GitLab Duo 에이전트가 GitLab MCP 서버 도구를 호출할 때 적용됩니다. GitLab MCP 서버에 직접 연결하는 Claude Desktop, Claude Code, Cursor와 같은 서드파티 MCP 클라이언트에도 적용됩니다. 이러한 클라이언트에 대해 서버는 Always Deny를 적용하고, Always Ask를 어떻게 처리할지는 클라이언트가 결정합니다. 이러한 클라이언트가 받는 도구를 제한하려면 도구 그룹(툴셋) 선택을 참고합니다.

각 도구는 자신이 선언한 어노테이션에 따라 작업 범주로 분류됩니다. 따로 관리하는 목록을 갱신할 필요가 없으므로, 새로 추가된 MCP 도구는 자동으로 거버넌스 대상이 됩니다.

도구가 선언한 값 범주
destructiveHint: true Delete
readOnlyHint: true Read
readOnlyHint: false Write
어노테이션 없음 Delete

destructiveHint: true와 readOnlyHint: true를 모두 선언한 도구는 Delete로 분류됩니다. 범주는 표에 나온 순서대로 결정되므로 가장 제한적인 선언이 우선합니다. 탭에 표시되는 도구는 GitLab 에디션, 라이선스, 활성화된 기능에 따라서도 달라집니다. 이 요소들이 MCP 서버가 노출하는 도구를 결정하기 때문입니다.

많은 기능이 GitLab Duo Agent Platform 도구와 MCP 서버 도구로 모두 존재합니다. 두 도구의 이름이 달라도 하나의 모드가 둘 다 제어합니다. 예를 들어 create_merge_request의 모드를 설정하면 MCP 서버 도구 save_merge_request에도 적용됩니다. 모드는 GitLab Duo Agent Platform 도구에 설정합니다. MCP 서버 도구를 따로 찾아 설정할 필요가 없습니다.

모드를 설정하지 않으면 동작은 바뀌지 않습니다. 읽기 전용 MCP 도구는 계속 사전 승인된 상태이고, 쓰기 및 삭제 MCP 도구는 여전히 승인을 요청합니다.

Always Deny 적용#

히스토리
  • GitLab 19.6에서 duo_mcp_server_governance_rule_enforcement라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • GitLab 19.6에서 GitLab.com, GitLab Self-Managed, GitLab Dedicated에 활성화되었습니다.
Feature flag

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

Always Deny는 GitLab MCP 서버에 연결하는 클라이언트가 아니라 서버가 적용합니다. Claude Code나 Cursor와 같은 서드파티 클라이언트는 거부된 도구를 호출할 수 있습니다. 서버는 도구가 실행되기 전에 호출을 거부하고, 거부된 도구의 이름이 담긴 도구 실행 오류(isError: true)로 응답합니다. 사용자가 읽을 수 있는 경우 오류에는 호출을 거부한 그룹이나 프로젝트의 이름도 담깁니다.

서버가 확인하는 접근 유형은 도구를 호출하는 주체에 따라 달라집니다.

  • 서드파티 클라이언트, GitLab Duo CLI, 자동화로 시작된 외부 에이전트의 경우, 서버는 IDE 확장 프로그램에 적용되는 모드와 같은 로컬 접근에 설정된 모드를 사용합니다.
  • GitLab Duo Agentic Chat과 기타 플로의 경우, 서버는 세션이 자체 도구에 사용하는 접근 유형을 사용합니다. 예를 들어 GitLab UI의 Agentic Chat에서 보낸 호출은 클라우드 접근에 설정된 모드를 사용합니다.

세션의 워크플로가 삭제되었거나 사용자가 더 이상 접근할 수 없으면 서버는 거버넌스가 적용된 그룹과 프로젝트의 도구에 대한 호출을 거부하고, 해당 도구를 도구 목록에서 제외합니다.

확인은 서버에서 이루어지므로 클라이언트 구성으로 모드를 우회할 수 없으며, 거부된 도구를 직접 호출해도 여전히 실패합니다. GitLab MCP 서버의 감사 이벤트가 켜져 있으면 GitLab은 거부된 호출을 AI 감사 이벤트로 기록합니다.

규칙은 호출이 인수에서 지정한 그룹이나 프로젝트를 기준으로 적용되므로, 도구가 그룹이나 프로젝트 하나를 식별할 수 있어야 합니다. get_mcp_server_version처럼 프로젝트나 그룹에 작용하지 않는 도구는 이 방식으로 거버넌스를 적용할 수 없으며 항상 실행됩니다. 호출이 존재하지 않거나 접근할 수 없는 프로젝트나 그룹을 지정하면 그 규칙은 확인되지 않고, 도구가 자체 오류를 반환합니다.

여러 프로젝트나 그룹에 작용하는 도구는 각각의 규칙을 기준으로 확인하며, 그중 하나에서라도 거부되면 호출이 차단됩니다. 예를 들어 save_merge_request는 project_id의 프로젝트와 target_project_id의 프로젝트를 모두 확인하므로, 두 프로젝트 중 어느 한쪽에 거부 규칙이 있으면 호출이 차단됩니다. 가장 제한적인 규칙이 우선하므로 여러 컨테이너를 지정해 거부 규칙을 우회할 수 없습니다. 거부 규칙은 절대적인 차단이 아니라 표준 GitLab 권한과 함께 작동하는 하나의 계층으로 취급해야 합니다.

그룹을 지정한 호출은 그 그룹에 속한 프로젝트의 규칙도 함께 확인합니다. 해당 프로젝트 중 하나에 거부 규칙이 있으면, 사용자가 그 프로젝트에 접근할 수 없어도 호출이 차단됩니다.

거부된 도구는 서버가 알리는 도구 목록에도 포함되지 않으므로 클라이언트가 해당 도구를 제안하지 않습니다. 목록 요청은 어떤 프로젝트나 그룹도 지정하지 않습니다. 따라서 해당 규칙은 기본 GitLab Duo 네임스페이스를 기준으로 확인되며, 기본 네임스페이스가 없으면 목록은 필터링되지 않습니다. 해당 네임스페이스에 설정된 규칙만 적용됩니다. 그 네임스페이스에 속한 프로젝트에 설정된 규칙은 목록에서 도구를 숨기지 않습니다. 어느 경우든 적용에는 영향이 없습니다. 거부된 도구는 목록에 있었더라도 호출될 때 거부됩니다.

Always Ask#

Always Ask는 GitLab MCP 서버가 적용하지 않습니다. Always Ask로 설정된 도구는 클라이언트가 먼저 사용자에게 확인하도록 요청하는 어노테이션과 함께 나열됩니다. 규칙을 적용할지는 클라이언트의 구현이 결정합니다. Always Ask로 설정한 도구에만 어노테이션이 붙습니다. Default로 둔 도구는 UI에 "Default (uses Always Ask)"로 표시되더라도 어노테이션이 붙지 않습니다.

이는 GitLab MCP 서버에 연결하는 클라이언트에만 적용됩니다. GitLab Duo Agent Platform에서는 Always Ask가 에이전트를 일시 중지하고 사용자에게 승인을 요청합니다. 자세한 내용은 승인 프롬프트(Always Ask)를 참고합니다.

클라이언트 Always Deny Always Ask
Claude Code 2.1.199 이상 적용됨 확인을 요청함
Claude Code 2.1.199 미만 적용됨 묻지 않고 실행함
Cursor, Windsurf, 기타 MCP 클라이언트 적용됨 묻지 않고 실행함

서버가 호출을 거부하므로 Always Deny는 모든 클라이언트에 적용됩니다. 모든 클라이언트에 걸쳐 더 강한 적용이 필요하면 Always Ask 대신 Always Deny를 사용합니다.

GitLab Duo CLI 도구#

히스토리
  • GitLab 19.6에서 duo_cli_first_party_tools라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다. 이 기능은 테스트용으로 제공되며 프로덕션 환경에서 사용할 준비가 되지 않았습니다.

GitLab Duo CLI는 자체 로컬 MCP 서버에서 일부 도구를 에이전트에 제공합니다. 이 도구들은 Tool management 탭에 출처가 mcp이고 범주가 Duo CLI로 표시됩니다. 이 도구들의 모드도 다른 도구와 같은 방식으로 설정합니다.

도구 ID 설명 기본 모드
Duo CLI Code Review mcp__duo__review GitLab Duo CLI에서 로컬 코드 변경 사항을 리뷰합니다. Always Allow

GitLab Duo CLI 9.33.0 이상에서는 다음과 같이 동작합니다.

  • 그룹에서 로컬 접근에 대한 도구 거버넌스를 켜지 않았더라도 로컬 접근에 설정한 모드가 이 도구들에 적용됩니다.
  • Always Allow로 설정된 도구는 승인 프롬프트 없이 실행됩니다.
  • Allow external MCP tools 설정이 꺼져 있어도 이 도구들을 사용할 수 있습니다.

이전 버전의 GitLab Duo CLI는 이 도구들을 다른 외부 MCP 도구와 똑같이 취급합니다.

승인 프롬프트(Always Ask)#

GitLab Duo Agent Platform 에이전트가 Always Ask로 구성된 도구를 호출하면 실행이 일시 중지되고 인라인 승인 카드가 표시됩니다. 카드에는 다음이 표시됩니다.

  • 호출되는 도구의 이름.
  • 도구가 수행할 작업에 대한 설명.
  • Approve 및 Reject 버튼.

승인하면 도구가 실행되고 에이전트가 계속 진행합니다. 거부하면 도구가 실행되지 않습니다. 에이전트는 거부 신호를 받으며, 대안적인 접근을 시도하거나 중단할 수 있습니다.

거부 메시지(Always Deny)#

에이전트가 사용자의 권한에서 Always Deny로 구성된 도구를 호출하려 하면 해당 도구는 에이전트에게 노출되지 않습니다. 에이전트의 계획에 거부된 도구가 필요하면, 거버넌스 정책 때문에 도구를 사용할 수 없다는 오류를 받습니다.

규칙 확인과 계단식 적용#

규칙은 가장 구체적인 것부터 가장 덜 구체적인 것 순서로 다음과 같이 확인됩니다.

  1. 프로젝트 수준 규칙(구성된 경우).
  2. 그룹 수준 규칙(구성된 경우).
  3. 기본 매트릭스 값.

프로젝트 수준 규칙은 같은 도구에 대한 그룹 수준 규칙을 재정의하지만, 그룹 수준 규칙과 같거나 더 엄격하기만 할 수 있습니다. 그룹 수준 규칙은 기본값을 재정의합니다. 어느 수준에도 규칙이 구성되어 있지 않으면 도구는 기본 거버넌스 매트릭스 값을 사용합니다.

페일 클로즈드(fail-closed) 원칙이 적용됩니다. 거버넌스 서비스가 규칙을 확인하는 중에 지속적인 오류를 만나면, 에이전트는 실행을 조용히 허용하지 않고 도구를 받지 못합니다.

GitLab Duo CLI의 자동 모드#

히스토리
  • 로컬 접근에 대한 도구 거버넌스가 GitLab 19.3에서 duo_workflow_local_tool_governance라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
Feature flag

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

최상위 그룹에서 로컬 접근에 대한 도구 거버넌스를 켜 두면, 규칙은 자동 모드에서도 그대로 적용됩니다.

  • Always ask로 설정된 도구는 여전히 승인을 요청합니다.
  • Always deny로 설정된 도구는 실행되지 않습니다.

최상위 그룹에서 로컬 접근에 대한 도구 거버넌스를 켜지 않았다면 자동 모드는 승인 없이 도구를 실행합니다. GitLab Duo CLI 9.33.0 이상에서는 GitLab Duo CLI 도구에 설정한 모드가 계속 적용됩니다.

그룹의 도구 거버넌스 구성#

그룹 수준 규칙은 프로젝트 수준에서 재정의하지 않는 한 그룹의 모든 프로젝트에 적용됩니다.

사전 요구 사항:

  • 최상위 그룹의 Owner 권한이 있어야 하며, 이 권한에는 read_ai_tool_rule 권한이 포함됩니다. 이 권한이 없으면 Tool management 탭에 규칙 대신 메시지가 표시됩니다.

그룹의 도구 거버넌스 규칙을 구성하려면 다음을 수행합니다.

  1. 상단 표시줄에서 Search or go to를 선택하고 최상위 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 AI > Governance를 선택합니다.
  3. 각 도구에 대해 Mode 드롭다운 목록에서 모드를 선택합니다. Always Allow, Always Ask, Always Deny 중 하나입니다.
  4. Save changes를 선택합니다.

변경 사항은 프로젝트 수준 재정의가 없는 모든 하위 그룹과 프로젝트에 적용됩니다.

프로젝트의 도구 거버넌스 구성#

프로젝트 수준 규칙은 해당 프로젝트 안에서 같은 도구에 대한 그룹 수준 규칙을 재정의합니다.

사전 요구 사항:

  • 프로젝트의 Maintainer 또는 Owner 권한이 있어야 합니다.

프로젝트의 도구 거버넌스 규칙을 구성하려면 다음을 수행합니다.

  1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Governance를 선택합니다.
  3. 각 도구에 대해 드롭다운에서 모드를 선택합니다. Always Allow, Always Ask, Always Deny 중 하나입니다.
  4. Save changes를 선택합니다.

Model Context Protocol(MCP) 서버 차단#

히스토리
  • GitLab 19.3에서 mcp_server_block_enforcement라는 기능 플래그와 함께 베타로 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • GitLab Self-Managed와 GitLab Dedicated에 대한 적용이 GitLab 19.4에서 도입되었으며, 세션의 도구 구성을 만들 때 적용됩니다. 기본적으로 활성화되어 있습니다.
  • GitLab 19.4에서 GitLab.com, GitLab Self-Managed, GitLab Dedicated에 활성화되었습니다.
Warning

이 기능은 베타입니다. 사전 고지 없이 변경될 수 있습니다. 자세한 내용은 GitLab 테스트 계약을 참고합니다.

도구별 거버넌스 외에도 그룹 Owner는 특정 외부 MCP 서버의 모든 도구를 차단할 수 있습니다. MCP 서버가 차단되면 개별 도구 거버넌스 설정이나 사용자 승인과 관계없이 해당 서버의 어떤 도구도 호출할 수 없습니다.

Feature flag

MCP 서버 차단의 적용은 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.

인스턴스에서 적용이 활성화되어 있지 않으면 MCP Registry에는 서버가 차단된 것으로 계속 표시됩니다. 하지만 차단 자체는 효력이 없으므로 해당 서버의 도구를 GitLab Duo Agentic Chat에서 계속 사용할 수 있습니다.

차단은 채팅 세션의 도구를 구성할 때 적용되며, 이는 모든 사용자 메시지, 도구 승인, 새 세션마다 이루어집니다. 실제로는 차단이 사용자의 다음 동작에서 효력을 냅니다. 차단이 적용되는 시점에 승인을 기다리던 도구 호출은 실행되지 않고, 다음 메시지부터는 차단된 서버의 도구가 에이전트에게 전혀 제공되지 않습니다. 이미 실행 중인 도구 호출은 완료됩니다.

도구가 거부되는 것이 아니라 조용히 제거되므로 에이전트는 정책 메시지를 받지 않습니다. 에이전트는 누락된 도구를 자기 말로 설명하며, 서버가 다시 허용된 뒤에도 기존 대화 중인 에이전트는 이전 대화 내용을 근거로 서버가 차단되었다고 계속 말할 수 있습니다. 새 대화를 시작하거나 에이전트에게 도구를 다시 시도하도록 요청합니다.

차단은 UI의 GitLab Duo Agentic Chat에 적용됩니다. IDE와 CLI 클라이언트는 로컬 구성 파일로 MCP 서버를 구성하며, 이 설정은 그것을 제어하지 않습니다.

이는 Always Deny 도구 거버넌스 모드와 다릅니다.

  • Always Deny는 개별 도구에 적용되며 프로젝트나 그룹별로 구성합니다.
  • MCP 서버 차단은 해당 서버의 모든 도구에 적용되며 MCP Registry에서 구성합니다. 이 차단은 모든 사용자 승인이나 도구 거버넌스 설정을 재정의합니다.

MCP 서버 차단#

그룹 또는 프로젝트 수준에서 MCP 서버를 차단할 수 있습니다.

  • 그룹 수준: 그룹의 모든 프로젝트와 하위 그룹에서 서버를 차단합니다. 그룹 수준에서 서버가 차단되면 프로젝트 수준 설정으로 차단을 해제할 수 없습니다.
  • 프로젝트 수준: 해당 프로젝트에서만 서버를 차단합니다.

그룹의 MCP 서버 차단#

사전 요구 사항:

  • 최상위 그룹의 Owner 권한이 있어야 합니다.

그룹의 MCP 서버를 차단하려면 다음을 수행합니다.

  1. 상단 표시줄에서 Search or go to를 선택하고 최상위 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 AI > Governance를 선택합니다.
  3. MCP Registry 탭을 선택합니다.
  4. 차단할 MCP 서버를 찾아 Block을 선택합니다.

차단은 각 사용자의 다음 메시지 또는 새 채팅 세션부터 적용됩니다. 차단된 서버의 도구는 그룹과 그 하위 그룹 및 프로젝트의 모든 사용자에게서 제거됩니다.

프로젝트의 MCP 서버 차단#

사전 요구 사항:

  • 프로젝트의 Owner 권한이 있어야 합니다.

프로젝트의 MCP 서버를 차단하려면 다음을 수행합니다.

  1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Governance를 선택합니다.
  3. MCP Registry 탭을 선택합니다.
  4. 차단할 MCP 서버를 찾아 Block을 선택합니다.

차단은 각 사용자의 다음 메시지 또는 새 채팅 세션부터 적용됩니다. 차단된 서버의 도구는 프로젝트의 모든 사용자에게서 제거됩니다. 같은 서버가 상위 그룹에서도 차단되어 있으면, 그룹 차단이 해제될 때까지 프로젝트에서 허용해도 효과가 없습니다. MCP Registry는 이러한 서버를 상위 그룹에 의해 차단된 것으로 표시합니다.

알려진 문제#

  • 백그라운드 접근은 Always Allow와 Always Deny만 지원합니다. 백그라운드 플로에는 승인 프롬프트에 응답할 사용자가 없으므로 Always Ask는 적용되지 않습니다. 백그라운드 접근 규칙이 구성되지 않은 도구는 기본적으로 Always Allow입니다.
  • GitLab MCP 서버가 제공하는 search 도구는 GitLab Duo Agent Platform이 별도의 더 좁은 검색 도구로 노출하는 기능을 하나로 모으며, 툴셋에서 그 도구들을 대체합니다. search가 사용 가능한 동안에는 더 좁은 도구에 구성한 규칙이 효력이 없으며, Tool management 탭에 여전히 허용으로 표시되는 Always Allow도 마찬가지입니다. search를 Always Deny로 설정하면 통합된 도구가 제거되고, 기본적으로 허용되는 더 좁은 도구가 다시 나타나므로 검색은 계속 사용할 수 있습니다. search가 대체하는 검색 도구를 제거하려면 gitlab_issue_search, gitlab_blob_search, gitlab_merge_request_search도 Always Deny로 설정합니다. gitlab_commit_search, gitlab_documentation_search와 같은 다른 검색 도구는 각자의 규칙이 있으며 기본적으로 허용된 상태로 유지됩니다. 거버넌스는 gitlab_merge_request_search와 list_merge_requests를 하나의 도구로 취급하므로, gitlab_merge_request_search를 거부하면 list_merge_requests 도구도 거부됩니다.
  • GitLab 19.4에서는 search를 Always Deny로 설정하면 더 좁은 도구를 복원하지 않고 search만 제거되어, 에이전트에 이슈 검색과 코드 검색이 모두 없는 상태가 되었습니다. 이 문제는 GitLab 19.5에서 해결되었으며, search를 거부하면 gitlab_issue_search, gitlab_blob_search, gitlab_merge_request_search가 복원됩니다.

관련 주제#

에이전트 도구 거버넌스

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

요약

이 기능은 베타입니다. 도구 거버넌스는 실행 경계에 위치합니다. 백그라운드 플로에 대한 적용은 기능 플래그로 제어됩니다. 도구는 세 가지 작업 범주로 분류됩니다. 에이전트 도구 거버넌스(사람 참여형 가드레일)를 사용하면 관리자가 각 에이전트 도구를 실행하는 순간에 어떻게 적용할지 정의할 수 있습니다.

히스토리
  • GitLab 19.1에서 gitlab_duo_governance_settings라는 기능 플래그와 함께 베타로 도입되었습니다. 기본적으로 활성화되어 있습니다.
  • GitLab 19.3에서 Developer Flow와 같은 백그라운드 플로에 기능 플래그와 함께 추가되었습니다. 기능 플래그 이름은 duo_workflow_background_tool_governance입니다. 기본적으로 비활성화되어 있습니다.
  • 기능 플래그 gitlab_duo_governance_settings가 GitLab 19.4에서 제거되었습니다.
  • 로컬 파일 읽기의 기본값이 GitLab 19.5에서 Always Ask에서 Always Allow로 변경되었습니다.
  • 탭별 권한이 GitLab 19.6에서 도입되었습니다.
Warning

이 기능은 베타입니다. 사전 고지 없이 변경될 수 있습니다. 자세한 내용은 GitLab 테스트 계약을 참고합니다.

도구 거버넌스는 실행 경계에 위치합니다. 에이전트가 프로젝트에 승인된 뒤 도구를 호출하기 전에, 거버넌스 계층이 사용자의 권한과 도구의 작업 범주에 맞게 구성된 규칙을 조회하고, 그 결과로 정해진 모드를 적용합니다.

Feature flag

백그라운드 플로에 대한 적용은 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.

도구는 세 가지 작업 범주로 분류됩니다.

  • Read: 정보를 조회하거나 표시하기만 하는 도구입니다.
  • Write: 리소스를 생성하거나 수정하는 도구입니다.
  • Delete: 리소스를 삭제하거나 되돌릴 수 없게 제거하는 도구입니다.

에이전트 도구 거버넌스(사람 참여형 가드레일)를 사용하면 관리자가 각 에이전트 도구를 실행하는 순간에 어떻게 적용할지 정의할 수 있습니다. 에이전트가 검토 없이 어떤 도구든 호출하도록 허용하는 대신, 각 도구를 다음 세 가지 모드 중 하나로 구성할 수 있습니다.

  • Always Allow: 도구가 사용자에게 묻지 않고 조용히 실행됩니다.
  • Always Ask: 사용자에게 인라인 승인 카드가 표시되며, 작업이 진행되기 전에 사용자가 작업을 승인하거나 거부해야 합니다.
  • Always Deny: 도구가 완전히 차단되어 에이전트에게 보이지 않습니다. 에이전트는 해당 도구를 보지 못하고 사용자에게도 승인을 묻지 않습니다.

이 기능은 Agentic Chat과 IDE 확장 프로그램에 적용됩니다. 플로의 경우 거버넌스 적용은 플로가 실행되는 위치에 따라 달라집니다.

  • IDE 확장 프로그램에서 실행되는 플로는 GitLab이 거버넌스 규칙을 적용합니다.
  • Developer Flow와 같은 백그라운드 플로는 duo_workflow_background_tool_governance 기능 플래그가 활성화된 경우 GitLab이 거버넌스 규칙을 적용합니다.

접근 유형#

각 도구는 접근 유형마다 별도의 모드를 가집니다. 접근 유형은 에이전트가 누구로서 동작하는지, 그리고 어디에서 실행되는지에 따라 정해집니다.

Cloud access : GitLab에서 사용자로서 실행됩니다. 예를 들어 GitLab UI의 GitLab Duo Agentic Chat입니다.

Local access : 사용자의 컴퓨터에서 사용자로서 실행됩니다. 예를 들어 IDE 확장 프로그램과 GitLab Duo CLI입니다.

Background access : 서비스 계정으로서 누구도 기다리지 않고 GitLab에서 실행됩니다. 예를 들어 자동화나 멘션으로 시작된 플로와 코드 리뷰입니다.

Note

로컬 접근 모드는 GitLab MCP 서버에 대한 호출에만 적용됩니다. 로컬 파일 도구와 같은 IDE 확장 프로그램이나 GitLab Duo CLI의 기본 제공 도구에는 적용되지 않습니다.

기본 거버넌스 매트릭스#

분류 모드
Read (GitLab 리소스) Always Allow
Read (로컬 파일) Always Allow
Read (에이전트 세션) Always Allow
Write Always Ask
Delete Always Ask

GitLab MCP 서버 도구#

히스토리
  • GitLab 19.4에서 duo_mcp_tool_governance라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • GitLab 19.4에서 GitLab.com, GitLab Self-Managed, GitLab Dedicated에 활성화되었습니다.
Feature flag

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

GitLab MCP 서버가 노출하는 도구는 GitLab Duo Agent Platform 도구와 함께 Tool management 탭에 출처가 mcp로 표시됩니다. 이 도구들의 모드도 같은 방식으로 설정하며, 자세한 내용은 그룹의 도구 거버넌스 구성에 나와 있습니다.

Note

도구 거버넌스는 GitLab Duo 에이전트가 GitLab MCP 서버 도구를 호출할 때 적용됩니다. GitLab MCP 서버에 직접 연결하는 Claude Desktop, Claude Code, Cursor와 같은 서드파티 MCP 클라이언트에도 적용됩니다. 이러한 클라이언트에 대해 서버는 Always Deny를 적용하고, Always Ask를 어떻게 처리할지는 클라이언트가 결정합니다. 이러한 클라이언트가 받는 도구를 제한하려면 도구 그룹(툴셋) 선택을 참고합니다.

각 도구는 자신이 선언한 어노테이션에 따라 작업 범주로 분류됩니다. 따로 관리하는 목록을 갱신할 필요가 없으므로, 새로 추가된 MCP 도구는 자동으로 거버넌스 대상이 됩니다.

도구가 선언한 값 범주
destructiveHint: true Delete
readOnlyHint: true Read
readOnlyHint: false Write
어노테이션 없음 Delete

destructiveHint: true와 readOnlyHint: true를 모두 선언한 도구는 Delete로 분류됩니다. 범주는 표에 나온 순서대로 결정되므로 가장 제한적인 선언이 우선합니다. 탭에 표시되는 도구는 GitLab 에디션, 라이선스, 활성화된 기능에 따라서도 달라집니다. 이 요소들이 MCP 서버가 노출하는 도구를 결정하기 때문입니다.

많은 기능이 GitLab Duo Agent Platform 도구와 MCP 서버 도구로 모두 존재합니다. 두 도구의 이름이 달라도 하나의 모드가 둘 다 제어합니다. 예를 들어 create_merge_request의 모드를 설정하면 MCP 서버 도구 save_merge_request에도 적용됩니다. 모드는 GitLab Duo Agent Platform 도구에 설정합니다. MCP 서버 도구를 따로 찾아 설정할 필요가 없습니다.

모드를 설정하지 않으면 동작은 바뀌지 않습니다. 읽기 전용 MCP 도구는 계속 사전 승인된 상태이고, 쓰기 및 삭제 MCP 도구는 여전히 승인을 요청합니다.

Always Deny 적용#

히스토리
  • GitLab 19.6에서 duo_mcp_server_governance_rule_enforcement라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • GitLab 19.6에서 GitLab.com, GitLab Self-Managed, GitLab Dedicated에 활성화되었습니다.
Feature flag

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

Always Deny는 GitLab MCP 서버에 연결하는 클라이언트가 아니라 서버가 적용합니다. Claude Code나 Cursor와 같은 서드파티 클라이언트는 거부된 도구를 호출할 수 있습니다. 서버는 도구가 실행되기 전에 호출을 거부하고, 거부된 도구의 이름이 담긴 도구 실행 오류(isError: true)로 응답합니다. 사용자가 읽을 수 있는 경우 오류에는 호출을 거부한 그룹이나 프로젝트의 이름도 담깁니다.

서버가 확인하는 접근 유형은 도구를 호출하는 주체에 따라 달라집니다.

  • 서드파티 클라이언트, GitLab Duo CLI, 자동화로 시작된 외부 에이전트의 경우, 서버는 IDE 확장 프로그램에 적용되는 모드와 같은 로컬 접근에 설정된 모드를 사용합니다.
  • GitLab Duo Agentic Chat과 기타 플로의 경우, 서버는 세션이 자체 도구에 사용하는 접근 유형을 사용합니다. 예를 들어 GitLab UI의 Agentic Chat에서 보낸 호출은 클라우드 접근에 설정된 모드를 사용합니다.

세션의 워크플로가 삭제되었거나 사용자가 더 이상 접근할 수 없으면 서버는 거버넌스가 적용된 그룹과 프로젝트의 도구에 대한 호출을 거부하고, 해당 도구를 도구 목록에서 제외합니다.

확인은 서버에서 이루어지므로 클라이언트 구성으로 모드를 우회할 수 없으며, 거부된 도구를 직접 호출해도 여전히 실패합니다. GitLab MCP 서버의 감사 이벤트가 켜져 있으면 GitLab은 거부된 호출을 AI 감사 이벤트로 기록합니다.

규칙은 호출이 인수에서 지정한 그룹이나 프로젝트를 기준으로 적용되므로, 도구가 그룹이나 프로젝트 하나를 식별할 수 있어야 합니다. get_mcp_server_version처럼 프로젝트나 그룹에 작용하지 않는 도구는 이 방식으로 거버넌스를 적용할 수 없으며 항상 실행됩니다. 호출이 존재하지 않거나 접근할 수 없는 프로젝트나 그룹을 지정하면 그 규칙은 확인되지 않고, 도구가 자체 오류를 반환합니다.

여러 프로젝트나 그룹에 작용하는 도구는 각각의 규칙을 기준으로 확인하며, 그중 하나에서라도 거부되면 호출이 차단됩니다. 예를 들어 save_merge_request는 project_id의 프로젝트와 target_project_id의 프로젝트를 모두 확인하므로, 두 프로젝트 중 어느 한쪽에 거부 규칙이 있으면 호출이 차단됩니다. 가장 제한적인 규칙이 우선하므로 여러 컨테이너를 지정해 거부 규칙을 우회할 수 없습니다. 거부 규칙은 절대적인 차단이 아니라 표준 GitLab 권한과 함께 작동하는 하나의 계층으로 취급해야 합니다.

그룹을 지정한 호출은 그 그룹에 속한 프로젝트의 규칙도 함께 확인합니다. 해당 프로젝트 중 하나에 거부 규칙이 있으면, 사용자가 그 프로젝트에 접근할 수 없어도 호출이 차단됩니다.

거부된 도구는 서버가 알리는 도구 목록에도 포함되지 않으므로 클라이언트가 해당 도구를 제안하지 않습니다. 목록 요청은 어떤 프로젝트나 그룹도 지정하지 않습니다. 따라서 해당 규칙은 기본 GitLab Duo 네임스페이스를 기준으로 확인되며, 기본 네임스페이스가 없으면 목록은 필터링되지 않습니다. 해당 네임스페이스에 설정된 규칙만 적용됩니다. 그 네임스페이스에 속한 프로젝트에 설정된 규칙은 목록에서 도구를 숨기지 않습니다. 어느 경우든 적용에는 영향이 없습니다. 거부된 도구는 목록에 있었더라도 호출될 때 거부됩니다.

Always Ask#

Always Ask는 GitLab MCP 서버가 적용하지 않습니다. Always Ask로 설정된 도구는 클라이언트가 먼저 사용자에게 확인하도록 요청하는 어노테이션과 함께 나열됩니다. 규칙을 적용할지는 클라이언트의 구현이 결정합니다. Always Ask로 설정한 도구에만 어노테이션이 붙습니다. Default로 둔 도구는 UI에 "Default (uses Always Ask)"로 표시되더라도 어노테이션이 붙지 않습니다.

이는 GitLab MCP 서버에 연결하는 클라이언트에만 적용됩니다. GitLab Duo Agent Platform에서는 Always Ask가 에이전트를 일시 중지하고 사용자에게 승인을 요청합니다. 자세한 내용은 승인 프롬프트(Always Ask)를 참고합니다.

클라이언트 Always Deny Always Ask
Claude Code 2.1.199 이상 적용됨 확인을 요청함
Claude Code 2.1.199 미만 적용됨 묻지 않고 실행함
Cursor, Windsurf, 기타 MCP 클라이언트 적용됨 묻지 않고 실행함

서버가 호출을 거부하므로 Always Deny는 모든 클라이언트에 적용됩니다. 모든 클라이언트에 걸쳐 더 강한 적용이 필요하면 Always Ask 대신 Always Deny를 사용합니다.

GitLab Duo CLI 도구#

히스토리
  • GitLab 19.6에서 duo_cli_first_party_tools라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다. 이 기능은 테스트용으로 제공되며 프로덕션 환경에서 사용할 준비가 되지 않았습니다.

GitLab Duo CLI는 자체 로컬 MCP 서버에서 일부 도구를 에이전트에 제공합니다. 이 도구들은 Tool management 탭에 출처가 mcp이고 범주가 Duo CLI로 표시됩니다. 이 도구들의 모드도 다른 도구와 같은 방식으로 설정합니다.

도구 ID 설명 기본 모드
Duo CLI Code Review mcp__duo__review GitLab Duo CLI에서 로컬 코드 변경 사항을 리뷰합니다. Always Allow

GitLab Duo CLI 9.33.0 이상에서는 다음과 같이 동작합니다.

  • 그룹에서 로컬 접근에 대한 도구 거버넌스를 켜지 않았더라도 로컬 접근에 설정한 모드가 이 도구들에 적용됩니다.
  • Always Allow로 설정된 도구는 승인 프롬프트 없이 실행됩니다.
  • Allow external MCP tools 설정이 꺼져 있어도 이 도구들을 사용할 수 있습니다.

이전 버전의 GitLab Duo CLI는 이 도구들을 다른 외부 MCP 도구와 똑같이 취급합니다.

승인 프롬프트(Always Ask)#

GitLab Duo Agent Platform 에이전트가 Always Ask로 구성된 도구를 호출하면 실행이 일시 중지되고 인라인 승인 카드가 표시됩니다. 카드에는 다음이 표시됩니다.

  • 호출되는 도구의 이름.
  • 도구가 수행할 작업에 대한 설명.
  • Approve 및 Reject 버튼.

승인하면 도구가 실행되고 에이전트가 계속 진행합니다. 거부하면 도구가 실행되지 않습니다. 에이전트는 거부 신호를 받으며, 대안적인 접근을 시도하거나 중단할 수 있습니다.

거부 메시지(Always Deny)#

에이전트가 사용자의 권한에서 Always Deny로 구성된 도구를 호출하려 하면 해당 도구는 에이전트에게 노출되지 않습니다. 에이전트의 계획에 거부된 도구가 필요하면, 거버넌스 정책 때문에 도구를 사용할 수 없다는 오류를 받습니다.

규칙 확인과 계단식 적용#

규칙은 가장 구체적인 것부터 가장 덜 구체적인 것 순서로 다음과 같이 확인됩니다.

  1. 프로젝트 수준 규칙(구성된 경우).
  2. 그룹 수준 규칙(구성된 경우).
  3. 기본 매트릭스 값.

프로젝트 수준 규칙은 같은 도구에 대한 그룹 수준 규칙을 재정의하지만, 그룹 수준 규칙과 같거나 더 엄격하기만 할 수 있습니다. 그룹 수준 규칙은 기본값을 재정의합니다. 어느 수준에도 규칙이 구성되어 있지 않으면 도구는 기본 거버넌스 매트릭스 값을 사용합니다.

페일 클로즈드(fail-closed) 원칙이 적용됩니다. 거버넌스 서비스가 규칙을 확인하는 중에 지속적인 오류를 만나면, 에이전트는 실행을 조용히 허용하지 않고 도구를 받지 못합니다.

GitLab Duo CLI의 자동 모드#

히스토리
  • 로컬 접근에 대한 도구 거버넌스가 GitLab 19.3에서 duo_workflow_local_tool_governance라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
Feature flag

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

최상위 그룹에서 로컬 접근에 대한 도구 거버넌스를 켜 두면, 규칙은 자동 모드에서도 그대로 적용됩니다.

  • Always ask로 설정된 도구는 여전히 승인을 요청합니다.
  • Always deny로 설정된 도구는 실행되지 않습니다.

최상위 그룹에서 로컬 접근에 대한 도구 거버넌스를 켜지 않았다면 자동 모드는 승인 없이 도구를 실행합니다. GitLab Duo CLI 9.33.0 이상에서는 GitLab Duo CLI 도구에 설정한 모드가 계속 적용됩니다.

그룹의 도구 거버넌스 구성#

그룹 수준 규칙은 프로젝트 수준에서 재정의하지 않는 한 그룹의 모든 프로젝트에 적용됩니다.

사전 요구 사항:

  • 최상위 그룹의 Owner 권한이 있어야 하며, 이 권한에는 read_ai_tool_rule 권한이 포함됩니다. 이 권한이 없으면 Tool management 탭에 규칙 대신 메시지가 표시됩니다.

그룹의 도구 거버넌스 규칙을 구성하려면 다음을 수행합니다.

  1. 상단 표시줄에서 Search or go to를 선택하고 최상위 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 AI > Governance를 선택합니다.
  3. 각 도구에 대해 Mode 드롭다운 목록에서 모드를 선택합니다. Always Allow, Always Ask, Always Deny 중 하나입니다.
  4. Save changes를 선택합니다.

변경 사항은 프로젝트 수준 재정의가 없는 모든 하위 그룹과 프로젝트에 적용됩니다.

프로젝트의 도구 거버넌스 구성#

프로젝트 수준 규칙은 해당 프로젝트 안에서 같은 도구에 대한 그룹 수준 규칙을 재정의합니다.

사전 요구 사항:

  • 프로젝트의 Maintainer 또는 Owner 권한이 있어야 합니다.

프로젝트의 도구 거버넌스 규칙을 구성하려면 다음을 수행합니다.

  1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Governance를 선택합니다.
  3. 각 도구에 대해 드롭다운에서 모드를 선택합니다. Always Allow, Always Ask, Always Deny 중 하나입니다.
  4. Save changes를 선택합니다.

Model Context Protocol(MCP) 서버 차단#

히스토리
  • GitLab 19.3에서 mcp_server_block_enforcement라는 기능 플래그와 함께 베타로 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • GitLab Self-Managed와 GitLab Dedicated에 대한 적용이 GitLab 19.4에서 도입되었으며, 세션의 도구 구성을 만들 때 적용됩니다. 기본적으로 활성화되어 있습니다.
  • GitLab 19.4에서 GitLab.com, GitLab Self-Managed, GitLab Dedicated에 활성화되었습니다.
Warning

이 기능은 베타입니다. 사전 고지 없이 변경될 수 있습니다. 자세한 내용은 GitLab 테스트 계약을 참고합니다.

도구별 거버넌스 외에도 그룹 Owner는 특정 외부 MCP 서버의 모든 도구를 차단할 수 있습니다. MCP 서버가 차단되면 개별 도구 거버넌스 설정이나 사용자 승인과 관계없이 해당 서버의 어떤 도구도 호출할 수 없습니다.

Feature flag

MCP 서버 차단의 적용은 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.

인스턴스에서 적용이 활성화되어 있지 않으면 MCP Registry에는 서버가 차단된 것으로 계속 표시됩니다. 하지만 차단 자체는 효력이 없으므로 해당 서버의 도구를 GitLab Duo Agentic Chat에서 계속 사용할 수 있습니다.

차단은 채팅 세션의 도구를 구성할 때 적용되며, 이는 모든 사용자 메시지, 도구 승인, 새 세션마다 이루어집니다. 실제로는 차단이 사용자의 다음 동작에서 효력을 냅니다. 차단이 적용되는 시점에 승인을 기다리던 도구 호출은 실행되지 않고, 다음 메시지부터는 차단된 서버의 도구가 에이전트에게 전혀 제공되지 않습니다. 이미 실행 중인 도구 호출은 완료됩니다.

도구가 거부되는 것이 아니라 조용히 제거되므로 에이전트는 정책 메시지를 받지 않습니다. 에이전트는 누락된 도구를 자기 말로 설명하며, 서버가 다시 허용된 뒤에도 기존 대화 중인 에이전트는 이전 대화 내용을 근거로 서버가 차단되었다고 계속 말할 수 있습니다. 새 대화를 시작하거나 에이전트에게 도구를 다시 시도하도록 요청합니다.

차단은 UI의 GitLab Duo Agentic Chat에 적용됩니다. IDE와 CLI 클라이언트는 로컬 구성 파일로 MCP 서버를 구성하며, 이 설정은 그것을 제어하지 않습니다.

이는 Always Deny 도구 거버넌스 모드와 다릅니다.

  • Always Deny는 개별 도구에 적용되며 프로젝트나 그룹별로 구성합니다.
  • MCP 서버 차단은 해당 서버의 모든 도구에 적용되며 MCP Registry에서 구성합니다. 이 차단은 모든 사용자 승인이나 도구 거버넌스 설정을 재정의합니다.

MCP 서버 차단#

그룹 또는 프로젝트 수준에서 MCP 서버를 차단할 수 있습니다.

  • 그룹 수준: 그룹의 모든 프로젝트와 하위 그룹에서 서버를 차단합니다. 그룹 수준에서 서버가 차단되면 프로젝트 수준 설정으로 차단을 해제할 수 없습니다.
  • 프로젝트 수준: 해당 프로젝트에서만 서버를 차단합니다.

그룹의 MCP 서버 차단#

사전 요구 사항:

  • 최상위 그룹의 Owner 권한이 있어야 합니다.

그룹의 MCP 서버를 차단하려면 다음을 수행합니다.

  1. 상단 표시줄에서 Search or go to를 선택하고 최상위 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 AI > Governance를 선택합니다.
  3. MCP Registry 탭을 선택합니다.
  4. 차단할 MCP 서버를 찾아 Block을 선택합니다.

차단은 각 사용자의 다음 메시지 또는 새 채팅 세션부터 적용됩니다. 차단된 서버의 도구는 그룹과 그 하위 그룹 및 프로젝트의 모든 사용자에게서 제거됩니다.

프로젝트의 MCP 서버 차단#

사전 요구 사항:

  • 프로젝트의 Owner 권한이 있어야 합니다.

프로젝트의 MCP 서버를 차단하려면 다음을 수행합니다.

  1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Governance를 선택합니다.
  3. MCP Registry 탭을 선택합니다.
  4. 차단할 MCP 서버를 찾아 Block을 선택합니다.

차단은 각 사용자의 다음 메시지 또는 새 채팅 세션부터 적용됩니다. 차단된 서버의 도구는 프로젝트의 모든 사용자에게서 제거됩니다. 같은 서버가 상위 그룹에서도 차단되어 있으면, 그룹 차단이 해제될 때까지 프로젝트에서 허용해도 효과가 없습니다. MCP Registry는 이러한 서버를 상위 그룹에 의해 차단된 것으로 표시합니다.

알려진 문제#

  • 백그라운드 접근은 Always Allow와 Always Deny만 지원합니다. 백그라운드 플로에는 승인 프롬프트에 응답할 사용자가 없으므로 Always Ask는 적용되지 않습니다. 백그라운드 접근 규칙이 구성되지 않은 도구는 기본적으로 Always Allow입니다.
  • GitLab MCP 서버가 제공하는 search 도구는 GitLab Duo Agent Platform이 별도의 더 좁은 검색 도구로 노출하는 기능을 하나로 모으며, 툴셋에서 그 도구들을 대체합니다. search가 사용 가능한 동안에는 더 좁은 도구에 구성한 규칙이 효력이 없으며, Tool management 탭에 여전히 허용으로 표시되는 Always Allow도 마찬가지입니다. search를 Always Deny로 설정하면 통합된 도구가 제거되고, 기본적으로 허용되는 더 좁은 도구가 다시 나타나므로 검색은 계속 사용할 수 있습니다. search가 대체하는 검색 도구를 제거하려면 gitlab_issue_search, gitlab_blob_search, gitlab_merge_request_search도 Always Deny로 설정합니다. gitlab_commit_search, gitlab_documentation_search와 같은 다른 검색 도구는 각자의 규칙이 있으며 기본적으로 허용된 상태로 유지됩니다. 거버넌스는 gitlab_merge_request_search와 list_merge_requests를 하나의 도구로 취급하므로, gitlab_merge_request_search를 거부하면 list_merge_requests 도구도 거부됩니다.
  • GitLab 19.4에서는 search를 Always Deny로 설정하면 더 좁은 도구를 복원하지 않고 search만 제거되어, 에이전트에 이슈 검색과 코드 검색이 모두 없는 상태가 되었습니다. 이 문제는 GitLab 19.5에서 해결되었으며, search를 거부하면 gitlab_issue_search, gitlab_blob_search, gitlab_merge_request_search가 복원됩니다.

관련 주제#