MCP 서버 개발 가이드라인

MCP 서버 개발 가이드라인에 대해 설명합니다.

이 페이지는 GitLab MCP 서버를 개발하고 사용하는 방법에 대한 정보를 포함합니다. 개발 환경 설정 # 개발 환경을 설정하려면: GDK에서 HTTPS 활성화 및 구성 . node 를 설치하고 mcp-remote 를 전역으로 설치합니다. GDK에는 Node.js가 포함되어 있지만 설치된 AI 어시스턴트는 GDK 버전을 사용할 수 없습니다. AI 어시스턴트를 MCP 서버에 연결 . 디버깅 및 문제 해결 # Cursor 디버그 # 더 자세한 로깅을 위해 mcp-remote 명령에 --debug 를 추가합니다. 출력을 열고 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 인스턴스에 특정합니다. 이 오류는 npx를 통한 Node.js 및 mcp-remote 라이브러리의 https 클라이언트에서 발