GitHub MCP 서버로 비밀 검색

GitHub MCP(모델 컨텍스트 프로토콜) 서버를 사용하면 secret scanning을(를) 에이전트 모드, GitHub Copilot, 및 기타 MCP 호환 도구에서 직접 GitHub Copilot 명령 줄 인터페이스 (CLI) 실행할 수 있습니다. 작업할 때 노출된 키, 토큰 및 자격 증명에 대한 코드를 검사하고 푸시하기 전에 수정합니다.

비밀 검색 도구는 GitHub 원격 MCP 서버를 통해서만 사용할 수 있습니다. 로컬 MCP 서버 구성은 지원되지 않습니다.

이는 JetBrains, Claude Code, Cursor 및 Windsurf를 비롯한 Visual Studio CodeMCP 호환 에이전트 또는 IDE에서 작동합니다. 환경은 클라이언트마다 다릅니다.

필수 조건

• GitHub Secret Protection 는 리포지토리에 대해 사용하도록 설정되어 있습니다.
• GitHub MCP 서버 는 IDE 또는 에이전트에 연결됩니다. GitHub MCP 서버 설정을(를) 참조하세요.
• 조직의 보안 구성 은 검색된 비밀 유형과 푸시 보호가 적용되는지 여부를 결정합니다. MCP 도구는 조직의 푸시 보호 구성을 준수합니다(리포지토리 수준 푸시 보호 설정은 사용되지 않음).

1단계: 도구 설치 및 구성

secret_protection 도구 집합 활성화

도구 집합 secret_protection을(를) 활성화하여 에이전트가 스캐닝 도구를 사용할 수 있도록 합니다. 기본 도구 집합에는 포함되지 않습니다.

이 run_secret_scanning 도구는 현재 secret_protection가 아닌 copilot 도구 집합에 연결되어 있습니다. MCP 구성에서 secret_protection 도구 집합과 함께 run_secret_scanning을 추가 도구로 명시적으로 포함해야 합니다.

copilot mcp --toolsets=secret_protection --tools=run_secret_scanning

{
  "servers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "X-MCP-Toolsets": "secret_protection",
        "X-MCP-Tools": "run_secret_scanning"
      }
    }
  }
}

{
  "servers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "X-MCP-Toolsets": "secret_protection",
        "X-MCP-Tools": "run_secret_scanning"
      }
    }
  }
}

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "GitHub-MCP-Toolsets": "secret_protection",
        "GitHub-MCP-Tools": "run_secret_scanning"
      }
    }
  }
}

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "GitHub-MCP-Toolsets": "secret_protection",
        "GitHub-MCP-Tools": "run_secret_scanning"
      }
    }
  }
}

(선택 사항) Advanced Security 플러그 인 설치

플러그인은/secret-scanningGitHub Copilot 명령 줄 인터페이스 (CLI)에서 간편한 스캔 경험을 위한 슬래시 명령을 제공합니다.Visual Studio Code 플러그인은 MCP 도구를 사용하므로 secret_protection 도구 집합을 사용하도록 설정해야 합니다.

플러그 인을 설치하기 위한 지침:

• 의 경우 GitHub Copilot 명령 줄 인터페이스 (CLI)에 대한 플러그 인 찾기 및 설치 GitHub Copilot 명령 줄 인터페이스 (CLI)을 참조하세요.
• 자세한 내용은 Visual Studio Code 설명서의 플러그 인 검색 및 설치 를 Visual Studio Code 참조하세요.

2단계: 코드 검사

도구 집합을 사용하도록 설정하면 클라이언트에 따라 여러 가지 방법으로 검사를 트리거할 수 있습니다.

자연어 프롬프트입니다. MCP 호환 에이전트에서 다음을 요청할 수 있습니다.

"현재 변경 내용에서 노출된 비밀을 검사하고 커밋하기 전에 업데이트해야 하는 파일과 줄을 표시합니다."

secret scanning을(를) 제가 마지막 커밋 이후에 변경한 파일에서 실행하고, 신뢰도가 높은 결과를 요약해 주세요.

슬래시 명령(플러그 인 필요 Advanced Security ). 1단계에서 선택적 플러그 인을 설치한 경우 다음을 사용할 수도 있습니다.

"/secret-scanning 자격 증명, 키 또는 토큰에 대해 준비된 차이 검토 및 환경 변수를 사용하여 대체를 제안합니다."

직접 도구 호출: 클라이언트에서 직접 검색 도구를 호출할 수도 있습니다.

에이전트는 다음을 반환합니다.

• 찾은 비밀의 유형
• 검색된 파일 및 줄
• 자격 증명 제거 또는 회전과 같은 수정 단계

푸시 보호를 사용하도록 설정하면 MCP 서버는 커밋, 끌어오기 요청 또는 파일 만들기와 같이 사용자가 대신 수행하는 모든 작업에 비밀이 포함되지 않도록 차단합니다. 푸시 보호 및 GitHub MCP 서버 작업을(를) 참조하세요.

Troubleshooting

추가 읽기

• GitHub MCP 서버에 대한 도구 집합 구성