MCP 서버 개발 가이드라인

GitLab MCP 서버를 개발하고 사용하는 방법에 대해 설명합니다.

이 페이지에는 GitLab MCP 서버를 개발하고 사용하는 방법에 대한 정보가 포함되어 있습니다. 개발 환경 설정 # 개발 환경을 설정하려면 다음을 수행합니다: GDK에서 HTTPS를 활성화하고 구성합니다 . node 를 설치하고 mcp-remote 를 전역으로 설치합니다. GDK에는 Node.js가 포함되어 있지만, 설치된 AI 어시스턴트는 GDK 버전을 사용할 수 없습니다. AI 어시스턴트를 MCP 서버에 연결합니다 . 디버깅 및 문제 해결 # Cursor 디버깅 # 더 자세한 로깅을 위해 mcp-remote 명령에 --debug 를 추가합니다. Output을 열고 MCP:SERVERNAME 을 선택하여 MCP 서버 로그를 확인합니다. 아래 예시의 경우 MCP:user-GitLab-GDK 가 됩니다. { "mcpServers": { "GitLab-GDK": { "command": "npx", "args": [ "mcp-remote", "https://gdk.test:3443/api/v4/mcp", "--debug" ], "env": { "NODE_TLS_REJECT_UNAUTHORIZED": "0" } } } } Claude Desktop 디버깅 # Node.js 버전 확인 # Claude Desktop은 지원되지 않는 버전의 Node.js를 사용합니다. 특정 버전을 사용하는 사용자 지정 래퍼 스크립트를 생성합니다: #!/bin/bash # Force use of your Node.js version NODE_BIN="/PATH_TO_NODE_INSTALL/node/22.17.0/bin/node" MCP_REMOTE_BIN="/PATH_TO_NODE_INSTALL/node/22.17.0/bin/mcp-remote" # Run mcp-remote with your Node.js exec "$NODE_BIN" "$MCP_REMOTE_BIN" "$@" Claude Desktop 구성에서 래퍼 스크립트를 사용합니다. { "mcpServers": { "GitLab-GDK": { "command": "/PATH_TO_REMOTE_WRAPPER_SCRIPT/mcp-remote-wrapper", "args": [ "https://gdk.test:3443/api/v4/mcp", "--debug" ], "env": { "NODE_TLS_REJECT_UNAUTHORIZED": "0" } } } } mcp-remote 디버깅 # AI 어시스턴트 외부에서 mcp-remote 에서 GDK로의 인증을 테스트합니다: NODE_TLS_REJECT_UNAUTHORIZED=0 npx mcp-remote https://gdk.test:3443/api/v4/mcp --debug 브랜치를 전환하면 인증 문제가 발생할 수 있으며, 여기에는 로그에 나타나는 UNABLE_TO_VERIFY_LEAF_SIGNATURE 오류가 포함될 수 있습니다. 체인 내 신뢰할 수 없는 인증서 오류는 TLS를 사용하는 GDK 인스턴스에 특유한 것입니다. 이 오류는 Node.js에서 사용되는 htt