
AI 에이전트에 VirusTotal 위협 인텔리전스를 제공하는 MCP 서버: 파일, URL, 도메인 및 IP 보고서, 분석 제출, VTAI를 통한 영수증 복구.
공식 VirusTotal MCP 서버는 에이전트가 링크를 열거나, 다운로드한 파일을 실행하거나, 의심스러운 인프라를 조사하기 전에 위협 인텔리전스를 제공합니다. vt-mcp는 MCP 클라이언트를 VTAI에 연결하며, 파일, URL, 도메인 및 IP 주소에 대한 보고서, 파일 및 네트워크 분석 제출, 그리고 접수 결과 복구 기능을 제공합니다.
현재 접근 한도 내에서 무료 VTAI 서비스를 사용하세요. 자체 VirusTotal API 키는 필요하지 않습니다.
호환되는 원격 MCP 클라이언트에서 **https://ai.virustotal.com/mcp**를 사용하세요. VTAI 계정으로 로그인하고 연결 권한을 승인하면 됩니다. 로컬 Python 설치, 정적 토큰 또는 개인 VirusTotal API 키는 필요하지 않습니다.
공식 플러그인에는 OAuth 연결, 위협 인텔리전스 스킬, 그리고 파일 해시, URL, 도메인 및 IP 주소에 대한 기존 보고서가 포함되어 있습니다. 훅이나 번들 스크립트는 포함되지 않으며, 로컬 파일은 해시로 검사됩니다.
claude plugin marketplace add VirusTotal/virustotal-mcp
claude plugin install virustotal@virustotal
Claude Code 2.1.283 이상이 필요합니다. 이 플러그인은 별도의 Node.js 설치가 필요하지 않으며, 훅이나 번들 스크립트를 실행하지 않습니다. 플러그인에는 https://ai.virustotal.com/mcp가 포함되어 있습니다.
기존의 수동 연결을 플러그인으로 교체하는 경우, 무언가를 제거하기 전에 마이그레이션 및 복구 가이드를 읽어보십시오. 불확실한 제출 건은 먼저 원래 연결을 통해 복구하십시오. 해당 대안을 선택하는 경우에는 작동하는 수동 연결을 유지하십시오.
새 세션을 시작하거나 /reload-plugins를 사용한 다음, 필요할 때 브라우저
로그인을 완료하려면 /mcp를 사용하십시오. 플러그인은 이미 MCP 연결을 제공하므로
중복으로 추가하지 마십시오. 플러그인 설정, 파일 검사 및 제출 옵션을 참조하십시오.
플러그인 스킬 없이 원격 연결을 사용하려면 다음을 사용하십시오:
claude mcp add --transport http virustotal https://ai.virustotal.com/mcp
Claude Code를 열고 /mcp를 실행한 뒤 virustotal을 선택하고 브라우저 로그인을 완료하세요.
Claude Code OAuth 지침과
VirusTotal 연결 가이드를 참고하세요.
이 대안 또는 플러그인을 선택하세요. 서버를 추가하면 구성되며, 연결이 제대로 작동하는지 확인하려면 인증을 완료하고 도구 호출을 수행하세요.
OAuth 연결은 로그인한 VTAI 계정의 무료 할당량을 공유하며, 각 연결에 대해 승인된
권한을 사용합니다. 기존 Agent Token은 해당 권한과 할당량을 유지합니다. 클라이언트에
구성 가능한 HTTP 헤더가 필요한 경우 OAuth 대신 보호된 Authorization: Bearer 또는
x-apikey 자격 증명 하나를 사용하세요. 다른 로컬 클라이언트는 아래의
stdio 설치를 사용할 수 있습니다.
~/.config/vt-mcp/token)에 저장하세요. MCP 서버의 환경 변수 VTAI_TOKEN_FILE을 해당 경로로 설정하고 명령을 vt-mcp로 설정하세요. 파일에는 토큰만 포함되어야 하며, 토큰 자체를 채팅, 명령 인수 또는 프로젝트 파일에 절대 넣지 마세요.| 클라이언트 | 설정 |
|---|---|
Antigravity CLI (agy) | MCP 및 스킬이 포함된 마켓플레이스 플러그인, 로컬 stdio 또는 네이티브 OAuth 레시피 |
| Claude Code | 위협 인텔리전스 스킬이 포함된 OAuth 플러그인, HTTP 또는 로컬 stdio |
| Codex | HTTP 또는 로컬 stdio |
| ChatGPT | 게시된 VirusTotal 플러그인 설치 · 연결 가이드 |
| Cursor | HTTP 레시피 |
| VS Code with GitHub Copilot | HTTP 레시피 |
| GitHub Copilot CLI | HTTP OAuth 레시피 또는 로컬 stdio |
| Devin CLI | HTTP OAuth 레시피 또는 로컬 stdio |
| Windsurf / Devin Desktop | Cascade HTTP 레시피 |
| Antigravity IDE | 로컬 stdio 구성 또는 네이티브 OAuth 레시피 |
| Gemini CLI | OAuth 확장 설치 |
| Gemini Apps | 사용자 지정 MCP 연결 및 선택적 가져오기 가능한 스킬, Google의 계정 및 지역별 제공 여부에 따름; 호스팅 워크플로 검증 완료 대기 중 |
| Grok Build | 수동 플러그인 설치; OAuth, 보고서 및 갱신 검증 완료 |
| Kimi Code | 수동 플러그인 설치; 외부 모델을 통한 OAuth, 보고서 및 사전 갱신 검증 완료 |
GitHub Copilot CLI 및 Devin CLI의 원격 OAuth 구성은 각 공식 문서를 따릅니다. OAuth로 인증된 VirusTotal 도구 워크플로는 두 클라이언트 모두에서 아직 검증되지 않았습니다.
Qwen Code, Mistral Vibe Work, Grok 웹 및 xAI Responses API에 대한 추가 원격 클라이언트 레시피와 해당 검증 제한 사항을 참조하세요. Qwen Code 0.25.1은 VTAI와의 OAuth 자격 증명 저장 호환성 문제가 알려져 있으며, 브라우저 동의만으로는 연결이 완료되지 않습니다.
클라이언트 검증 가이드는 문서화된 구성, 로컬 전송 검사, 그리고 모델과 함께 수행한 워크플로를 구분합니다. 레시피는 모든 클라이언트에서 완전한 검증을 주장하는 것이 아닙니다. 다른 에이전트는 동일한 MCP 엔드포인트 또는 VTAI API를 직접 사용할 수 있습니다.
ChatGPT에서는 게시된 VirusTotal 플러그인을 설치하고, 메시지가 표시되면 Google로 연결한 다음, 새 채팅에서 @VirusTotal을 선택하세요. 게시된 플러그인에는 개발자 모드가 필요하지 않지만, 계정 및 워크스페이스 정책은 여전히 적용됩니다. 연결 가이드에는 별도의 사용자 지정 앱 대안과 검증 한계가 포함되어 있습니다. 최초 OAuth 동의, IP 보고서, 자동 토큰 갱신은 2026-09-24에 별도로 검증되었으며, 게시가 모든 워크플로를 검증하는 것은 아닙니다.
첫 번째 쿼리로 에이전트에게 다음과 같이 요청하세요:
VirusTotal을 사용하여 virustotal.com의 도메인 보고서를 가져와. 출처, 분석 날짜, 커버리지, 보고서 링크를 보여줘.
ChatGPT에서는 프롬프트 앞에 @VirusTotal을 붙이세요. 보고서 조회는 로컬 파일을 읽거나 업로드하지 않습니다. 보고서가 없으면 알 수 없음으로 남으며, 탐지 결과가 0건이라고 해서 안전이 입증되는 것은 아닙니다.
로컬 stdio의 경우 uv를 설치하고 다음을 실행하세요:
uv tool install --python 3.12 --default-index https://pypi.org/simple 'vt-mcp==0.9.9'
vt-mcp --version
로컬 MCP 서버는 Linux, macOS 및 Windows를 지원하며, 두 가지 파일 제출 도구를 모두 포함합니다. Windows 제출 영수증은 로컬 NTFS 저장소를 요구하며, 네트워크 공유와 재분석 지점(reparse point)은 거부됩니다. 별도의 vt-mcp guard 명령은 Linux 전용으로 유지됩니다.
자동 클라이언트 구성을 위해서는 설정 가이드에서 Agy, Claude Code 또는 Codex를 선택한 다음, 해당 Agent Token 대안을 열고 운영 체제를 선택하십시오. 설치 프로그램은 소유자 전용 POSIX 권한 또는 Windows 사용자 전용 ACL을 사용하여 토큰을 보호합니다.
이 명령은 격리된 도구 환경에서 공식 PyPI 인덱스로부터 패키지를 설치합니다. Python 3.12 이상이 필요합니다. vt-mcp를 MCP 클라이언트의 PATH에 유지하거나 절대 실행 파일 경로를 사용하십시오. 이 패키지는 클라이언트 구성을 수정하지 않습니다.