문제 해결
Snyk Studio 또는 Snyk의 MCP 서버를 사용하는 통합에 문제가 발생하면 여기에 제공된 문제 해결 단계를 시도해 보십시오.
Snyk CLI 버전 호환성 확인
CLI를 다운로드하거나 업데이트한 후 snyk version을 실행합니다. 버전은 v1.1298.0 이상이어야 합니다.
Snyk은 최신 버전을 사용할 것을 권장합니다.
Snyk CLI 경로 및 권한 확인
Snyk은 snyk 실행 파일의 절대 경로를 지정할 것을 권장합니다. mcpconfig.json에서 경로가 올바른지 확인할 수 있습니다.
Snyk CLI 바이너리에 실행 권한이 있는지 확인하십시오.
기본 리포지토리 스캔 (중요한 진단)
기본 리포지토리 스캔은 많은 문제에 대한 핵심 단계입니다. 복잡한 MCP 통합 문제를 의심하기 전에 MCP 서버를 실행하는 데 사용하는 Snyk CLI가 터미널에서 직접 리포지토리를 스캔할 수 있는지 확인하십시오.
프로젝트의 루트 디렉토리로 이동하여 다음을 실행합니다.
/path/to/your/snykCli test- 오픈소스 취약점의 경우/path/to/your/snykCli code test- 코드 문제의 경우
이러한 직접 스캔이 실패하면 해당 문제(예: 인증, 조직 설정 및 조직에 대한 Snyk Code 활성화)를 먼저 해결한 다음 새 스캔을 시작하십시오.
인증 문제
Snyk MCP 서버와 통합되는 클라이언트 애플리케이션과 같은 일부 MCP 호스트는 MCP 서버 프로세스를 제한하여 Snyk 인증 흐름(예: 브라우저 기반 로그인)을 방해할 수 있습니다.
이 문제를 해결하려면 다음 완화 전략을 사용하십시오.
stdio대신sse전송 모드에서 Snyk MCP 서버를 시작하십시오:snyk mcp -t sse --experimental을 실행하고mcpconfig.json파일에 URL을 설정합니다.SNYK_TOKEN=<TOKEN>환경 변수를 통해 인증 토큰을 제공하여 Snyk에 인증하십시오. 토큰을 얻으려면 Snyk Personal Access Token을 생성하거나 Snyk 웹 인터페이스에서 직접 Snyk API Token을 검색하십시오. Personal Access Token에 대한 자세한 내용은 API 인증을 참조하고 Snyk API Token에 대한 자세한 내용은 Snyk API 토큰 획득 및 사용을 참조하십시오.
Snyk 조직 구성
Snyk 계정이 여러 조직의 일부이거나 스캔이 예상된 위치에 나타나지 않는 경우 올바른 Snyk 조직이 구성되었는지 확인하십시오. 다음을 사용하여 이를 설정할 수 있습니다.
명령
snyk config set org=<YOUR_ORG_ID>환경 변수
SNYK_CFG_ORG=<YOUR_ORG_ID>
환경 변수 전파
SNYK_TOKEN, SNYK_CFG_ORG 및 프록시 설정과 같은 필수 환경 변수가 Snyk MCP 서버 프로세스로 올바르게 전파되었는지 확인하십시오.
프록시 구성
회사 프록시 뒤에 있는 경우 http_proxy 및 https_proxy 환경 변수가 올바르게 설정되어 있고 Snyk CLI 및 MCP 서버 프로세스에서 액세스할 수 있는지 확인하십시오.
SSE 전송 세부 사항
snyk mcp -t sse 명령을 통해 SSE를 사용하는 경우 로컬 방화벽이 Snyk MCP SSE 서버에서 사용하는 포트로 들어오는 연결을 차단하고 있는지 확인하십시오.
폴더 신뢰
폴더 신뢰와 관련된 문제가 발생하는 경우 다음을 사용하여 이 기능을 비활성화할 수 있습니다.
--disable-trust CLI 플래그.
SSE 전송을 사용할 때는 MCP 서버를 로컬에서만 실행할 수 있습니다.
상세 로깅 및 디버깅
다음 제안을 사용하여 Snyk CLI 디버그 출력을 개선하고 확장하여 MCP 관련 문제를 해결하십시오.
snyk mcp서버를 시작하든 직접 테스트 스캔을 수행하든(기본 리포지토리 스캔 참조) 유용한 더 자세한 Snyk CLI 로그를 보려면 Snyk 명령에 상세 매개변수를 추가할 수 있습니다.여기에는 디버그 수준 출력에
-d또는--debug플래그를 사용하는 것이 포함됩니다. 예:snyk mcp -t sse -dsnyk test -dsnyk code test -d
훨씬 더 세분화된 추적 수준 로깅을 위해
--log-level=trace옵션을 사용하거나SNYK_LOG_LEVEL=trace환경 변수를 설정할 수 있습니다.snyk mcp -t sse -d --log-level=traceSNYK_LOG_LEVEL=trace snyk mcp -t sse -d
AI 도구, IDE 또는 MCP 클라이언트 애플리케이션에서 MCP 클라이언트 및 호스트 로그를 검사하십시오. 이 로그에는 Snyk MCP 서버 연결 또는 통신과 관련된 오류가 포함될 수 있습니다.
Last updated