GitLab MCP 서버 문제 해결

GitLab MCP 서버의 일반적인 문제를 해결합니다.

GitLab MCP 서버를 사용할 때 다음과 같은 문제가 발생할 수 있습니다. 오류: 403 Forbidden # GitLab MCP 서버를 시작할 때 이 오류가 발생할 수 있습니다. OAuth 플로가 완료된 뒤 POST /api/v4/mcp 또는 GET /api/v4/mcp 가 403 Forbidden 을 반환할 때도 이 오류가 발생할 수 있습니다. GitLab 19.4 및 이전 버전에서는 같은 문제가 404 Not Found 를 대신 반환합니다. 두 상태 코드의 원인은 같습니다. 이 문제를 해결하려면 GitLab MCP 서버 사전 요구 사항 을 충족하는지 확인합니다. 원인을 찾으려면 응답 본문의 메시지를 확인합니다. 관리자는 mcp.log 파일에서 denial_reason 필드도 확인할 수 있습니다. MCP server disabled for this instance ( denial_reason : instance_setting_disabled ): GitLab Self-Managed에서 관리자가 해당 인스턴스의 MCP 서버를 껐습니다 . MCP server not enabled for any of your groups ( denial_reason : no_enabled_namespace ): GitLab.com에서 사용자가 속한 최상위 그룹 중 MCP 서버가 켜진 그룹이 없습니다. Note 404 Project Not Found 와 같이 REST 기반 도구 호출에서 반환되는 404 오류는 JSON-RPC 응답 본문에 isError: true 와 함께 표시되며, mcp.log 에는 tool_status 가 not_found 로 설정되어 기록됩니다. 그 밖의 도구 호출 실패도 응답 본문에 isError: true 와 함께 표시되며, mcp.log 에는 발생한 일을 설명하는 tool_status 와 함께 기록됩니다. 오류: Server's protocol version is not supported: 2025-06-18 # GitLab 18.6 및 이전 버전에서는 MCP 클라이언트 라이브러리가 GitLab MCP 서버 프로토콜 사양을 지원하지 않을 때 이 오류가 발생할 수 있습니다. 이 문제를 해결하려면 AI 도구 공급자에게 클라이언트 구현을 업데이트하도록 요청합니다. 오류: 429 Too Many Requests # MCP 클라이언트가 동작을 멈추고 일반적인 HTTP 또는 연결 오류를 보고할 수 있으며, 속도 제한 기간이 초기화될 때까지 모든 요청이 실패합니다. 이는 속도 제한을 초과했을 때 발생합니다. MCP 서버 속도 제한 또는 인증된 API 속도 제한이 해당하며, MCP 서버 요청은 두 제한 모두에 계산되기 때문입니다. GitLab은 요청이 MCP 서버에 도달하기 전에 거부하므로 어떤 도구도 실행되지 않습니다. rate_limited 도구 결과 와 달리 오류 결과를 담은 200 OK 가 아닙니다. 응답은 콘텐츠 유형이 text/plain 인 HTTP 429 이며, 기본적으로 본문은 Retry later 입니다. JSON-RPC 메