히스토리

• GitLab 18.10에 도입 ai_catalog_mcp_servers라는 플래그와 함께. 기본적으로 비활성화됩니다.

AI Catalog의 커스텀 에이전트는 Model Context Protocol(MCP)을 통해 외부 데이터 소스 및 서드파티 서비스(예: Jira 또는 Linear)에 연결할 수 있습니다.

이 기능은 실험입니다. 이슈 593219에서 피드백을 공유해 주세요.

AI Catalog의 MCP 서버를 사용하면 다음을 수행할 수 있습니다:

• 조직의 카탈로그에 MCP 서버 추가(이름, URL 및 전송 유형).
• MCP 서버를 커스텀 에이전트와 연결.
• 각 에이전트에 연결된 MCP 서버 확인.
• OAuth 지원 MCP 서버로 인증.

전용 MCP 탭이 Agents 및 Flows와 함께 AI Catalog 네비게이션에 표시됩니다. 네임스페이스에서 활성화된 에이전트와 연결된 MCP 서버는 그룹 및 프로젝트 레벨 모두에서 AI > MCP servers 아래에서도 사용 가능합니다.

사전 요구 사항#

• GitLab Duo Agent Platform의 사전 요구 사항을 충족해야 합니다.
• GitLab.com에서는 GitLab Duo 실험 및 베타 기능을 활성화한 최상위 그룹의 멤버여야 합니다.
• GitLab Self-Managed에서는 인스턴스에 GitLab Duo 실험 및 베타 기능이 활성화되어 있어야 합니다.
• GitLab Self-Managed 및 GitLab Dedicated에서는 관리자가 mcp_client 기능 플래그를 활성화했어야 합니다.
• MCP 서버는 다음 조건을 충족해야 합니다:
  • 검증된 또는 파트너 MCP 서버. 임의 URL은 허용되지 않습니다.
  • 원격 MCP 서버.

AI Catalog에 MCP 서버 추가#

사전 요구 사항:

• 인스턴스에 대한 관리자 액세스.

GitLab Self-Managed 및 GitLab Dedicated에서 인스턴스 관리자는 사용 가능한 MCP 서버 목록에서 자신의 인스턴스에 대한 MCP 서버를 AI Catalog에 추가할 수 있습니다.

AI Catalog에 MCP 서버를 추가하려면:

1. 왼쪽 사이드바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. Build > AI Catalog을 선택합니다.
3. MCP 탭을 선택합니다.
4. New MCP server를 선택합니다.
5. 필드를 완성합니다:
   • Name: MCP 서버에 대한 설명적인 이름(예: Jira).
   • Description(선택 사항): 서버가 제공하는 것에 대한 간단한 설명.
   • URL: MCP 서버의 HTTP 엔드포인트.
   • Homepage URL(선택 사항): MCP 서버의 홈페이지 또는 문서 URL.
   • Transport: HTTP를 선택합니다. HTTP 전송만 지원됩니다. SSE 및 stdio 전송은 사용할 수 없습니다.
   • Authentication type: 다음 중 하나를 선택합니다:
     • None: 인증이 필요하지 않습니다.
     • OAuth: OAuth 2.0으로 인증합니다. 서버가 OAuth 2.0 Dynamic Client Registration을 지원하는 경우 GitLab은 첫 번째 연결 시 OAuth 클라이언트로 자동 등록됩니다.
6. Create MCP server를 선택합니다.

이제 MCP 서버가 조직의 카탈로그에서 사용 가능하며 에이전트와 연결할 수 있습니다.

MCP 서버 편집#

사전 요구 사항:

• 인스턴스에 대한 관리자 액세스.

GitLab Self-Managed 및 GitLab Dedicated에서 인스턴스 관리자는 자신의 인스턴스에 대해 AI Catalog의 MCP 서버를 편집할 수 있습니다.

MCP 서버를 편집하려면:

1. 왼쪽 사이드바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. Build > AI Catalog을 선택합니다.
3. MCP 탭을 선택합니다.
4. 편집하려는 MCP 서버를 선택합니다.
5. Edit를 선택합니다.
6. 필요에 따라 필드를 업데이트합니다.
7. Save changes를 선택합니다.

MCP 서버를 커스텀 에이전트에 연결#

커스텀 에이전트에 MCP 서버를 연결하려면:

1. 왼쪽 사이드바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. Build > AI Catalog을 선택합니다.
3. Agents 탭을 선택합니다.
4. 구성하려는 에이전트를 선택한 다음 Edit를 선택합니다.
5. MCP servers 섹션에서 이 에이전트와 연결할 MCP 서버를 선택합니다.
6. Save changes를 선택합니다.

이제 에이전트는 실행 중에 연결된 MCP 서버가 제공하는 모든 도구를 사용할 수 있습니다.

에이전트가 특정 MCP 서버 도구를 사용하지 못하도록 제한할 수 없습니다.

커스텀 에이전트에 연결된 MCP 서버 보기#

커스텀 에이전트에 연결된 MCP 서버를 보려면:

1. 왼쪽 사이드바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. Build > AI Catalog을 선택합니다.
3. Agents 탭을 선택합니다.
4. 에이전트를 선택합니다.

에이전트 상세 페이지에 연결된 모든 MCP 서버가 나열됩니다.

네임스페이스의 MCP 서버 보기#

AI > MCP servers 페이지는 네임스페이스에서 활성화된 에이전트와 연결된 모든 MCP 서버를 표시합니다. 각 서버는 해당 서버를 사용하는 에이전트 수를 표시하며, 에이전트 이름은 마우스 오버 시 툴팁으로 표시됩니다.

이 페이지는 그룹 및 프로젝트 레벨 모두에서 사용 가능합니다:

• 그룹 레벨은 그룹 전반의 에이전트와 연결된 MCP 서버를 표시합니다.
• 프로젝트 레벨은 프로젝트에 구성된 에이전트와 연결된 MCP 서버를 표시합니다.

그룹 또는 프로젝트 레벨에서 MCP 서버를 보려면:

1. 왼쪽 사이드바에서 Search or go to를 선택하고 그룹 또는 프로젝트를 찾습니다.
2. AI > MCP servers를 선택합니다.

아직 인증하지 않은 OAuth 지원 서버의 경우 Connect 옵션이 표시됩니다.

MCP 서버로 인증#

OAuth 지원 MCP 서버로 인증하려면:

1. 왼쪽 사이드바에서 Search or go to를 선택하고 그룹 또는 프로젝트를 찾습니다.
2. AI > MCP servers를 선택합니다.
3. MCP 서버를 찾아 Connect를 선택합니다.
4. MCP 서버의 인증 페이지에서 인증 요청을 검토하고 승인합니다.
5. GitLab은 향후 요청을 위해 액세스 토큰을 안전하게 저장합니다.

서버가 OAuth 2.0 Dynamic Client Registration을 지원하는 경우 GitLab은 첫 번째 연결 시 OAuth 클라이언트로 자동 등록됩니다. OAuth 자격 증명을 수동으로 제공할 필요가 없습니다.

커스텀 에이전트에서 MCP 서버 연결 해제#

히스토리

• GitLab 18.11에서 도입.

MCP 서버를 연결된 모든 커스텀 에이전트에서 연결 해제할 수 있습니다. 특정 에이전트에서만 MCP 서버를 연결 해제할 수는 없습니다.

연결 해제 후에도 기존 커스텀 에이전트 채팅은 MCP 서버에서 이미 가져온 콘텐츠를 계속 참조할 수 있습니다. 그러나 에이전트는 더 이상 새 콘텐츠를 가져오거나 어떤 작업도 수행할 수 없습니다.

1. 왼쪽 사이드바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. Build > AI Catalog를 선택합니다.
3. MCP 탭을 선택합니다.
4. 연결 해제할 MCP 서버에 대해 Disconnect를 선택합니다.
5. 확인 대화 상자에서 Disconnect를 선택합니다.

사용 가능한 MCP 서버#

AI Catalog에서 커스텀 에이전트에 다음 MCP 서버를 추가할 수 있습니다. 카탈로그에 제안된 더 많은 서버는 이슈 591969를 참조하세요.

Linear#

Linear MCP 서버를 사용하면 AI 에이전트와 워크플로우가 이슈, 프로젝트 및 댓글 찾기, 생성, 업데이트를 포함하여 Linear 데이터와 실시간으로 상호 작용할 수 있습니다.

Atlassian#

Atlassian MCP 서버를 사용하면 AI 에이전트와 워크플로우가 이슈, 페이지 및 프로젝트 콘텐츠 검색, 생성, 업데이트를 포함하여 Jira 및 Confluence 데이터와 실시간으로 상호 작용할 수 있습니다.

연결하기 전에 Atlassian 인스턴스가 GitLab을 신뢰하도록 구성합니다:

1. Atlassian에서 관리 페이지로 이동합니다.
2. Apps > AI Settings > Rovo MCP Server를 선택합니다.
3. 신뢰할 수 있는 도메인 목록에 https://gitlab.com/**을 추가합니다.

Context7#

Context7 MCP는 소스에서 최신 버전별 문서 및 코드 예시를 가져와 프롬프트에 추가합니다.

관련 주제#

• GitLab MCP 서버

문제 해결#

AI Catalog의 MCP 서버로 작업할 때 다음 문제가 발생할 수 있습니다.

아웃바운드 요청 제한으로 인한 MCP 서버 문제#

GitLab은 웹훅 및 통합과 같은 다른 아웃바운드 요청을 검증하는 것과 동일한 방식으로 MCP 서버의 URL을 검증합니다. GitLab Self-Managed 인스턴스가 아웃바운드 요청을 제한하는 경우, URL 자체가 유효하더라도 MCP 서버를 추가, 편집 또는 연결하려는 시도가 실패할 수 있습니다.

이 문제를 해결하는 방법은 MCP 서비스가 호스팅되는 위치에 따라 달라집니다.

자세한 문제 해결 정보는 아웃바운드 요청 필터링을 참조하세요.

공개 MCP 서버#

공개 MCP 서버는 검증된 또는 파트너 서버이거나, 인터넷을 통해 연결할 수 있는 자체 서버일 수 있습니다.

인스턴스가 허용 목록에 있는 요청을 제외한 모든 아웃바운드 요청을 차단하는 경우, 인스턴스 관리자에게 MCP 서버의 도메인 또는 IP 주소를 아웃바운드 요청 허용 목록에 추가하도록 요청하세요.

인스턴스가 이러한 제한을 적용하지 않는 경우 추가 조치가 필요하지 않습니다.

내부 또는 로컬 MCP 서버#

내부 또는 로컬 MCP 서버는 localhost에서 실행되거나 사설 또는 내부 네트워크에서 실행되는 서버일 수 있습니다.

기본적으로 GitLab은 서버 측 요청 위조로부터 보호하기 위해 로컬 및 사설 네트워크 주소로의 요청을 차단합니다.

요청을 허용하려면 인스턴스 관리자에게 다음 중 하나를 수행하도록 요청하세요:

• 웹훅 및 통합에서 로컬 네트워크로의 요청 허용. 이렇게 하면 MCP 서버뿐만 아니라 모든 로컬 및 사설 네트워크 주소로의 요청이 허용됩니다.
• MCP 서버의 도메인 또는 IP 주소(필요한 경우 포트 포함)만 아웃바운드 요청 허용 목록에 추가합니다. 이 옵션은 전체 로컬 네트워크에 대한 액세스를 열지 않으므로 더 제한적입니다.