히스토리

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

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

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

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

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

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

사전 요구 사항#

• GitLab Duo Agent Platform의 사전 요구 사항을 충족해야 합니다.
• GitLab Duo 실험 및 베타 기능을 활성화한 최상위 그룹의 멤버여야 합니다.
• MCP 서버를 추가하거나 편집하려면 인스턴스 관리자여야 합니다.
• MCP 서버는 다음 조건을 충족해야 합니다:
  • 검증된 또는 파트너 MCP 서버. 임의 URL은 허용되지 않습니다.
  • 원격 MCP 서버.

AI Catalog에 MCP 서버 추가#

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 서버 편집#

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 서버#

다음 MCP 서버를 AI Catalog에 추가할 수 있습니다. 카탈로그에 제안된 더 많은 서버는 이슈 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 서버