이 튜토리얼에서는 Claude Desktop 애플리케이션을 GitLab의 MCP(Model Context Protocol) 서버에 연결하는 방법을 안내합니다.

완료 후 Claude Desktop을 사용하여 다음 작업을 수행할 수 있습니다:

• GitLab 이슈 생성
• 머지 리퀘스트 검색
• 저장소 파일 읽기
• GitLab 프로젝트와 관련된 기타 작업

시작하기 전에#

다음이 필요합니다:

• Claude Desktop 앱 (macOS 또는 Windows용). Claude Desktop을 다운로드하세요.
• GitLab 계정. 계정이 없으면 GitLab.com에서 무료 계정을 만드세요.
• GitLab 개인 액세스 토큰. 토큰이 없으면 개인 액세스 토큰을 생성하세요.
  • api 범위를 활성화합니다.
• Node.js 18 이상. Node.js가 설치되어 있지 않으면 Node.js를 다운로드하고 설치하세요.

Claude Desktop을 GitLab MCP 서버에 연결#

Claude Desktop에서 GitLab 기능을 활성화하려면 애플리케이션 구성 파일을 편집해야 합니다.

1. Claude Desktop을 엽니다.

2. Claude 메뉴 > 설정 > 개발자를 선택합니다.

3. 구성 편집을 선택합니다. 파일이 텍스트 편집기에서 열립니다.

4. 파일의 내용을 다음으로 바꿉니다. <gitlab.example.com>을 GitLab 인스턴스의 호스트 이름으로 교체합니다. GitLab.com의 경우 gitlab.com을 사용하세요:

   {
     "mcpServers": {
       "GitLab": {
         "command": "npx",
         "args": ["-y", "mcp-remote", "https://<gitlab.example.com>/api/v4/mcp"]
       }
     }
   }
   

5. 파일을 저장하고 Claude Desktop을 다시 시작합니다.

Claude Desktop이 시작되면 GitLab 서버에 연결됩니다. 연결되면 GitLab 로그인 페이지가 있는 브라우저 창이 열립니다.

GitLab으로 인증#

1. 개인 액세스 토큰을 복사합니다.
2. 브라우저 창에 표시된 개인 액세스 토큰 필드에 붙여넣습니다.
3. 토큰 제출을 선택합니다.

인증에 성공하면 Claude Desktop에서 GitLab 도구를 사용할 수 있습니다.

Claude Desktop에서 GitLab 도구 사용#

Claude Desktop은 이제 GitLab과 통합되었습니다. MCP 서버가 제공하는 도구를 사용하여 Claude Desktop에서 GitLab 작업을 수행할 수 있습니다.

사용 가능한 GitLab 도구 보기#

MCP 서버가 제공하는 GitLab 도구를 보려면:

1. Claude Desktop에서 새 대화를 시작합니다.
2. 도구 아이콘을 선택합니다.
3. 사용 가능한 GitLab 도구 목록이 표시됩니다.

이슈 생성#

예를 들어, GitLab 이슈를 만들려면:

1. Claude Desktop에서 새 대화를 시작합니다.

2. Claude에게 이슈를 생성하도록 요청합니다. 예를 들어:

   my-namespace/my-project 프로젝트에 "Homepage navigation is broken"이라는 제목으로 이슈를 생성해 주세요.
   

3. Claude가 GitLab 도구를 사용하여 이슈를 생성합니다.

문제 해결#

Claude Desktop에 연결 오류가 표시됨#

GitLab 인스턴스에 연결하는 데 문제가 있는 경우:

• claude_desktop_config.json 파일의 URL이 올바른지 확인합니다.
• GitLab 인스턴스에 액세스할 수 있는지 확인합니다.
• Node.js 버전 18 이상이 설치되어 있는지 확인합니다.

도구 권한 오류#

특정 GitLab 작업을 수행하려고 할 때 권한 오류가 발생하면:

• 개인 액세스 토큰에 api 범위가 있는지 확인합니다.
• 해당 GitLab 프로젝트 또는 그룹에 대한 충분한 권한이 있는지 확인합니다.

관련 주제#

• GitLab MCP 서버
• 개인 액세스 토큰
• Model Context Protocol