매트록 (Matlock) 로고 매트록(Matlock)
페이지 내 실전 운영 가이드

실전에서의 매트록 작동 방식 (2분 설정 완료)

매트록 — 에이전트 및 개발자 도구. 효율적으로. 정확하게. 원칙대로. 아무 프로젝트 폴더에 매트록을 지정하여 50ms 미만 AST, MITRE CWE, IEEE Std 1003.1 POSIX, CISA SSDF 및 AICPA SOC 2 TSC 검증, 세이프가드 테스트 보호, Cold Box 샌드박스, GitHub Action PR 출처 증명을 실행하세요.

01 · 50ms 미만 로컬 소스 및 Pre-CI 스캔 실행

찾아보기를 통해 로컬 프로젝트 폴더를 선택(또는 브라우저 WASM 스캐너에 드롭)하고 매트록을 실행하세요. 매트록이 로컬 메모리에서 밀리초 단위로 소스 트리를 직접 스캔하여 미테스트 다크 코드 파일, 비대한 모놀리식 모듈, 노출된 비밀키(비밀 값 자체는 표시하지 않고 상대 경로 folder/file:line만 보고서에 무료 표시), 표준 기반 커밋 전 검사를 매트록 전송 0바이트로 드러냅니다. 매트록은 MITRE CWE, CISA SSDF, IEEE Std 1003.1 POSIX, 자동 Pre-CI 무결성 게이트 및 AICPA SOC 2 Trust Services Criteria 기술 통제에 비추어 기술적 코드베이스와 파이프라인 통제를 평가합니다(기술 통제에 한하며 CPA 인증이 아님).

02 · 27개 도구 로컬 및 클라우드 헤드리스 MCP (설정 -> AI 에이전트 (MCP))

매트록은 기본적으로 프로젝트를 읽기만 합니다(설정에서 복원을 켠 경우에도 줄 단위 미리보기를 승인한 뒤에만 기록된 테스트를 되돌립니다). 상위 점수 회복 항목을 따라가거나, 에이전트 프롬프트 복사를 누르거나, 설정 -> AI 에이전트 (MCP)를 열어 MCP 서버(stdio)와 선택적 이메일 브리지를 켜서(Linux, macOS arm64, Windows 및 클라우드 컨테이너에서는 matlock-mcp --stdio --headless 실행 가능) Kimi Code CLI, Qwen Code, DeepSeek, Antigravity, VS Code, Visual Studio, Cursor, Windsurf, Cline, Claude Code, Gemini, Copilot, Android Studio, IntelliJ, Ollama, vLLM, SGLang, LM Studio와 연결하세요. 어시스턴트는 50ms 미만 matlock_run_scan, 단일 테스트 파일 검증 matlock_run_sequence(file: ""), async: true 비차단 백그라운드 실행(완료 시 자동 웨이크 및 matlock_get_action_status 요약 캡슐), stop_sequence 중지를 사용할 수 있습니다. 화면 안내는 앱 내 ? 또는 F1, matlock_read_appliance_manual(0 크레딧), 또는 /ko/manual.md를 활용하세요.

03 · 작업 카드, 저장 지점, 이메일 알림 및 PR 검증 배지

왼쪽 레일에서 매트록을 클릭해 Clean -> Get -> Format -> Lint -> Analyze/Build -> 커버리지 포함 Test를 통합 실행하거나, 상시 도킹형 터미널과 CLI 바(카드로 저장 및 연결 / 알림)를 쓰거나, USB·외장 드라이브 저장 지점(Windows는 robocopy /MIR /MT:16, Linux/GoogleBook은 rsync -a --delete / /), 클라우드 스토리지(rclone / AWS S3 / Cloudflare R2 / GCS / Azure Blob), 데스크톱 물리적 Approve & Run 승인이 적용된 GitHub 푸시(git push origin main)를 작업 카드 및 20단계 시퀀스로 구성하세요. 설정 -> 이메일 알림에서는 글로벌 프리셋(Gmail / Workspace, Microsoft 365 / Outlook, iCloud, Yahoo, Zoho, QQ / 163 인증 코드, Fastmail, GMX / Web.de, 로컬 Proton Mail Bridge 127.0.0.1:1025)과 OS 키체인/보관함에 암호화된 앱 비밀번호로 발신 전용 네이티브 TLS 1.2/1.3 SMTP를 설정하고, 단계별 오류 시(stop_and_alert / continue_and_alert) 또는 무조건 완료 시(always / send_alert) 트리거를 지정할 수 있습니다. CI/CD PR에서는 Dutchp2p/matlock-public@v1과 https://matlock.dutchp2p.com/badge/verified.svg 배지를 사용하세요.

04 · AI의 규칙 변조를 막는 세이프가드

모든 사용자 테스트, 작업, 시퀀스, 알림은 기본적으로 "세이프가드됨(읽기 및 실행 전용)"으로 설정되어 저장소 밖 OS 사용자 프로필에 로컬 봉인(Windows DPAPI + Linux 0600 HMAC-SHA256)됩니다. AI가 테스트를 실행할 수는 있지만 세이프가드된 규칙을 몰래 수정하거나 약화시키려는 시도는 즉시 감지·보류되어 1클릭으로 복원됩니다.

검증된 기준선 건너뛰기 (<105ms) + 세이프가드 및 클린룸 이상 래치.

05 · 계정·이메일 저장 없는 오프라인 Pro 활성화

매트록 Pro (Matlock Pro)(약 34,000원* ($24.99 USD / 년) 정액, 자동 갱신 없음)는 사용자 계정이나 비밀번호가 필요 없습니다. MoonPay 및 Transak 카드 결제, 안내형 PayPal PYUSD 이체(기존 PayPal 잔액 또는 체크카드 사용), 또는 원클릭 Web3 USD 스테이블코인(Solana USDC, Base USDC, Polygon USDC)으로 결제를 완료하세요. 연속된 24자 활성화 키(예: i34324h32HNbN4u9Kp7xYz8Q — 더블 클릭하여 복사)가 비공개 /receipt/ 기록 및 matlock@dutchp2p.com 발송 선택형 1회용 영수증 이메일(영구 이메일 저장 0초)과 함께 화면에 즉시 표시됩니다. 데스크톱 앱의 설정 -> 라이선스 -> 활성화에 키를 한 번 붙여넣으면 암호화 서명된 오프라인 라이선스가 기기에 바인딩되며, 연 1회 셀프 서비스 PC 이전이 포함됩니다.

매트록 적용 환경

세 가지 배포 현실. 하나의 결정론적 엔진.

격리된 클라우드 에이전트 컨테이너, 자율형 IDE/M2M 루프, 로컬 개발자 워크스테이션을 위해 설계되었습니다.

01 · 클라우드 VM 및 장시간 샌드박스

클라우드 VM 및 장시간 에이전트 샌드박스

격리된 클라우드 스웜과 장기 실행 에이전트를 위한 컨테이너형 헤드리스 MCP. 클라우드 샌드박스는 실행 격리를 해결할 뿐 코드 정확성을 보장하지 않습니다. 클라우드 VM은 에이전트가 개발자 노트북을 망가뜨리는 일은 막아주지만, PR에 비밀키를 유출하거나 마일스톤 통과를 위해 테스트를 약화하거나 12시간 실행 동안 자기 실수를 다시 읽느라 $500어치 토큰을 태우는 일은 막지 못합니다. 매트록은 컨테이너 내부의 결정론적 거버너로서 헤드리스·영지식 방식으로 동작하며 AWS, Google Cloud, Cloudflare, Azure, Docker, 로컬 워크스테이션 어디서든 300토큰 미만으로 CWE/POSIX 좌표를 반환해 에이전트를 정직하고 경제적으로 유지합니다.

02 · IDE MCP 및 M2M 에이전트 파이프라인

IDE MCP 및 자율형 M2M 에이전트 파이프라인

코더 LLM 위에 리뷰어 LLM을 겹쳐 쌓으면 패스당 15,000–40,000토큰이 소모되고도 파일 간 누수와 경쟁 상태를 놓칩니다. 매트록 (Matlock) Pro(약 34,000원* ($24.99 USD / 년), MATLOCK_LICENSE_KEY 기반 $0.00/실행 무제한 헤드리스 실행 및 "헤드리스와 동기화" 포함)는 AST, MITRE CWE, IEEE POSIX.1, Flutter 3.50, TLS 및 Cold Box 경쟁 검사를 50 ms 미만의 네이티브 코드로 오프로드해 정확한 file:line:col diff와 2단계 루프 브레이커를 제공합니다.

03 · 1인 개발자, 바이브 코더 및 리드

1인 개발자, 바이브 코더 및 엔지니어링 리드

에이전트가 한나절에 수천 줄을 작성하는 환경에서 개발자가 터미널 명령어를 다시 치거나, git push 시 키 유출을 걱정하거나, AICPA SOC 2 TSC 및 HIPAA 기술 준비도를 어림짐작할 필요는 없습니다. 데스크톱 세이프가드는 조용한 테스트 약화를 차단하고, "헤드리스와 동기화"가 카드를 양방향 공유하며, 원클릭 USB/클라우드/GitHub 루틴이 비공개 발신 전용 SMTP 이메일 알림 및 외부 전송 0바이트로 실행됩니다.

카테고리 비교

매트록 Pro vs. CLI 린터 vs. 엔터프라이즈 클라우드 스캐너

수동 CLI 스크립트 작성이나 좌석당 SaaS 요금 없는 결정론적 워크스테이션 및 컨테이너 검증.

역량 항목 매트록 Pro (약 34,000원* ($24.99 USD / 년)) CLI 린터 ($0 — 수동) 기업용 클라우드 스캐너 ($288–$864+/좌석/년)
연간 요금 약 34,000원* ($24.99 USD / 년) 정액 · $0 무료 스캔 $0 수동 설정 $288–$864+/좌석/년
Cold Box 멀티스레드 샌드박스 경쟁 상태 및 클린룸 CI 파손 노출 정적 린트만 수행 푸시 후 원격 대기열
영지식 프라이버시 외부 전송 0바이트 (워크스테이션 또는 자체 컨테이너) 봉인 없는 로컬 설정 벤더 서버로 소스 업로드
헤드리스 및 클라우드 컨테이너 로컬 IDE + AWS, GCP, Cloudflare, Azure 및 Docker 수동 컨테이너 연결 외부 SaaS 토큰 통신
결정론적 엔진 컴파일된 AST 바이너리 (LLM 위 LLM 아님) 단일 언어별 개별 규칙 클라우드 규칙 + 종량제 AI
토큰 절약 300토큰 미만 vs. LLM 평균 15k–40k (최대 95%+* 절감) 수 kB 규모의 원시 로그 장황한 API 페이로드
표준 및 통제 준비도* MITRE CWE, IEEE POSIX.1, CISA SSDF, AICPA SOC 2 및 HIPAA* 문법 및 스타일만 검사 별도 상위 컴플라이언스 요금제
다중 언어 및 교차 OS 10개 언어 스택 · 모든 타깃 OS 언어마다 별도 도구 필요 좌석 등급별 차등 제한
세이프가드 테스트 보호 조용한 테스트 약화 및 건너뛰기 차단 인라인 무시 주석 편집 가능 로컬 테스트 봉인 없음
편집 가능한 원클릭 루틴 시퀀서, 실패 시 중지 및 백업/종료 수동 셸 스크립트 작성 스캐너 기능만 제공
27개 도구 MCP 및 이메일 알림 네이티브 stdio MCP + 로컬 SMTP 리포트 없음 클라우드 웹훅만 지원
저전력 CPU/RAM 및 업데이트 여유 CPU 코어 1개 확보 · 데몬 0 · 지속 업데이트 수동 업그레이드 상주형 백그라운드 에이전트
CI / PR 게이트 및 SARIF 2.1.0 Action + 배지 + SARIF (업로드 없음)* 수동 CLI 래퍼* 클라우드 저장소 접근 필요*

* 토큰 절감 폭은 저장소 크기와 컨텍스트 창에 따라 달라집니다. 표준 매핑은 MITRE CWE, IEEE Std 1003.1 POSIX, CISA SSDF, AICPA SOC 2 TSC 및 HIPAA 보안 규칙(45 CFR § 164.312) 기술적 보호조치에 대응합니다(기술적 코드베이스 통제만 해당하며 공식 CPA, HIPAA 또는 법적 인증이 아님).

다크 코드 & PRE-CI 진단 용어집

AI 다크 코드의 실제 모습, 피해, 그리고 매트록의 사전 차단 원리

고속 AI 코딩 세션에서 자주 유입되는 실제 프로덕션 장애와 매트록 (Matlock) 로컬 감사 + 워크어웨이 검증이 git push 전에 이를 막아내는 방법.

AI 다크 코드 위험 징후 프로덕션 및 CI 장애 영향 매트록 (Matlock) 로컬 감사 & 워크어웨이 해법
1. 미테스트 다크 코드와 조용한 오류 은폐 — AI가 대응하는 단위 테스트 없이 새 프로덕션 서비스를 만들고 조용한 오류 은폐(CWE-391)와 닫히지 않은 비동기 타이머·스트림(CWE-401)을 남김. 조용한 데이터 유실, UI 멈춤, 백그라운드 메모리 누수가 발생하며 실제 고객이 장애를 겪을 때까지 발견되지 않음. 매트록 (Matlock) 로컬 감사가 모든 프로덕션 파일을 테스트 스위트와 대조하고 CISA/MITRE CWE 벤치마크에 따라 조용한 오류 은폐와 미해제 비동기 핸들을 색출.
2. 250줄 초과 만능 객체와 // ignore 우회 — 에이전트가 한 파일에 500줄 이상의 뒤섞인 책임을 몰아넣거나 미완성 TODO 스텁을 남기고 // ignore: 주석으로 일반 린터를 침묵시킴. 코드 이해 부채가 급증하고 후속 AI 수정 시 인접 기능이 연쇄 파손되며 미완성 스텁으로 인해 앱 스토어 심사에서 자동 거절됨. 250줄 파일 상한(CWE-1080)을 강제하고 인라인 억제 주석을 완전히 무시하며 1클릭 모듈 분리 프롬프트를 제공.
3. 크로스 OS CI 함정 및 자격 증명 노출 — Windows에서만 통과하는 POSIX 경로 이식성 오류, CRLF 셸 스크립트, Git 미추적 로컬 파일, 락파일 불일치, 노출된 API 자격 증명(CWE-798). 푸시 10분 뒤 Linux GitHub Actions 파이프라인이 깨지거나 공개 저장소 봇이 몇 초 만에 노출된 키를 탈취해 보안 사고 유발. 독립 Pre-CI 게이트가 git push 실행 전에 로컬에서 IEEE POSIX 이식성 명세, CISA SSDF 벤치마크 및 자동 Pre-CI 무결성 검사를 강제 적용.
공식 배포 채널

Windows, Linux 및 GoogleBook용 매트록 다운로드

네이티브 컴파일 데스크톱 애플리케이션. 브라우저 의존성 제로, localhost 소켓 제로, 진단 스캔 평생 무료.

Windows 10 및 Windows 11 (x64)

공식 Microsoft Store(앱 ID: 9P5VNWVWLM4N)를 통해서만 독점 배포됩니다. Microsoft 서명으로 자동 업데이트를 지원하며 SmartScreen 경고가 없습니다.

Linux 데스크톱 및 GoogleBook (.deb & AppImage)

FUSE가 필요 없는 matlock-linux-x64.deb(Ubuntu 22.04+, Debian 12+, GoogleBook Linux 지원) 및 휴대용 matlock-linux-x64.AppImage(Fedora, Arch, Ubuntu, Debian 지원)로 패키징된 네이티브 GTK3 Flutter 데스크톱 바이너리. AppImage · .deb (GoogleBook / Debian) · SHA256SUMS

chmod +x matlock-linux-x64.AppImage && ./matlock-linux-x64.AppImage
sudo apt install ./matlock-linux-x64.deb

매트록 Pro 라이선스 활성화 및 기기 이전 방법

매트록 (Matlock) 데스크톱 앱 안에서 "업그레이드"를 클릭하거나 가격 페이지(/ko/pricing)를 방문하면 결제 세션을 위한 고유한 연속 24자 라이선스 키(예: i34324h32HNbN4u9Kp7xYz8Q — 하이픈이 전혀 없어 더블 클릭하면 전체 키가 한 번에 선택됨)가 생성됩니다. 이 키를 복사해 보관하세요.

매트록 (Matlock)은 암호화 서명된 오프라인 라이선스를 저장소 외부의 비공개 로컬 사용자 프로필 저장소에 저장하고 컴퓨터에서 로컬로 봉인합니다. 이후 앱을 실행할 때마다 내 CPU에서 100% 오프라인으로 검증되며 외부로 확인 요청을 보내지 않습니다.

컨테이너 및 MicroVM 2줄 빠른 실행

Cloudflare ContainerHarness / Codex cloudflare/debian-trixie, Docker, E2B, Firecracker용 벤더 중립 헤드리스 부트스트랩 (SHA-256 검증):

curl -sSfLO https://matlock.dutchp2p.com/agent-install.sh && curl -sSfLO https://matlock.dutchp2p.com/agent-install.sh.sha256 && (sha256sum -c agent-install.sh.sha256 2>/dev/null || shasum -a 256 -c agent-install.sh.sha256) && sh ./agent-install.sh
export PATH="$HOME/.local/bin:$PATH" && matlock-mcp --stdio --headless --no-coverage
개발자 및 에이전트 FAQ

자주 묻는 질문

커밋 전 검증, 세이프가드 테스트 보호, 토큰 절약, 컴플라이언스 준비도 및 클라우드·로컬 에이전트 설정에 대한 명쾌한 답변입니다.

AI가 생성한 코드가 프로덕션 배포 준비가 되었는지 어떻게 확인하나요?

모든 커밋이나 릴리스 전에 매트록을 실행하세요. 로컬 또는 컨테이너 내부에서 50 ms 미만에 MITRE CWE, IEEE POSIX.1, CISA SSDF 및 250줄 모듈성 기준으로 AST를 점검한 뒤 멀티스레드 Cold Box 샌드박스에서 컴파일러와 테스트를 실행합니다.

코딩 에이전트가 통과만 하려고 테스트를 약화하거나 건너뛰는 것을 어떻게 막나요?

매트록 세이프가드는 검증된 단위 테스트의 위변조 감지 기준선을 저장소 바깥의 OS 저장소에 보관하며, 이곳에서는 인라인 무시 주석이 작동하지 않습니다. 에이전트가 단언문을 제거·건너뛰기·완화하면 매트록이 즉시 경고하고 원본 테스트를 복원할 수 있습니다.

에이전트 위에 에이전트를 겹치지 않고도 AI 코딩 토큰과 연산 비용을 줄이려면 어떻게 하나요?

두 번째 LLM에게 다중 파일 수정을 검토하게 하면 패스당 15,000–40,000개의 컨텍스트 토큰이 소모됩니다. 매트록은 MCP(matlock_run_scan)를 통해 결정론적 AST, CWE, POSIX 검사를 네이티브 코드로 오프로드하여 중복 제거된 file:line:col 좌표와 5줄 수리 diff를 300토큰 미만으로 반환합니다(최대 95%+ 절감).

git push 전에 유출된 API 키, CWE 보안 버그, Linux CI 실패를 어떻게 잡아내나요?

이 페이지에서 무료 브라우저 내 WebAssembly 스캔(노출된 비밀 정보의 file:line 위치 무료 표시)을 실행하거나 로컬에서 매트록 데스크톱 앱을 실행하세요. 매트록은 git push 전에 하드코딩된 키(CWE-798), 인젝션 싱크, CRLF 셸 함정, 락파일 불일치, Windows-Linux 경로 파손을 잡아냅니다.

HIPAA 또는 AICPA SOC 2 민감 프로젝트와 AWS, Google Cloud, Cloudflare 컨테이너 안에서도 사용할 수 있나요?

네 — 매트록으로 전송되는 소스 코드는 언제나 0바이트이며, MATLOCK_OFFLINE=1은 워크스테이션이나 AWS, Google Cloud, Cloudflare, Azure, Docker 컨테이너 안에서 엄격한 망분리 모드를 강제합니다. 매트록은 MITRE CWE, CISA SSDF, AICPA SOC 2 TSC 및 HIPAA 보안 규칙(45 CFR 164.312) 기술적 보호조치에 매핑된 기술 코드 통제를 평가합니다(기술 통제에 한하며 CPA 또는 법적 인증이 아님).

매트록은 어떤 프로그래밍 언어, 운영체제, IDE 및 AI 모델과 작동하나요?

매트록은 모든 타깃 OS를 대상으로 10개 생태계(Dart/Flutter, TypeScript/JS/Node, Python, Rust, Go, Java/Kotlin, C/C++, C#/.NET, SQL, Shell/YAML/Docker)를 검증합니다. 27개 도구를 갖춘 MCP 서버는 Windows 10/11, Linux, GoogleBook 및 헤드리스 macOS Apple Silicon에서 Claude, Gemini, Codex, Cursor, Copilot, Kimi, Qwen, DeepSeek, GLM, Windsurf, Cline, VS Code, JetBrains, Ollama를 연결합니다.

질문, 오탐 제보 또는 라이선스 문의가 있으신가요?

이메일 대기열과 스팸 필터를 거치지 마세요. 계정 가입 없이 질문, 버그 신고 또는 결제 문의를 비공개 지원 대기열로 곧바로 보낼 수 있습니다.

지원 및 질문함 열기

모든 IDE, 에이전트 및 컨테이너 연결 (20개)

Aider

~/.aider.conf.yml · CLI

Amazon Q Developer

~/.aws/amazonq/mcp.json · IDE / AWS

Antigravity

.mcp.json · Carbon / Hydrogen · Orchestrator

Claude Code

.mcp.json · claude mcp add · CLI / Desktop

Cline / Roo Code

cline_mcp_settings.json · VS Code

Cloudflare ContainerHarness, Sandbox & Browser Run (Kitesurf)

stdio MCP + MATLOCK_LICENSE_KEY · matlock_audit.mjs · Edge / Browser

Codex CLI

~/.codex/config.toml · CLI

Continue

~/.continue/config.yaml · IDE

Copilot (GitHub / VS Code & Agentic Workflows)

.vscode/mcp.json · Dutchp2p/matlock-public@v1 · --format=sarif · IDE / CI

Cursor

.cursor/mcp.json · IDE

Devin

Workspace MCP · stdio · Cloud Agent

Docker / Cloud Container

docker | podman | nerdctl | finch · OCI / Cloud

Gemini CLI

~/.gemini/settings.json · CLI

JetBrains AI / Junie

Settings -> MCP Servers · IDE

Kimi Code

~/.kimi/mcp.json · IDE / CLI

Ollama / Local & OpenRouter

Local stdio MCP + CLI · Local / Router

OpenHands

config.toml [mcp] · Agent

Qwen Code

~/.qwen/settings.json · IDE / CLI

Windsurf

~/.codeium/windsurf/mcp_config.json · IDE

Zed

~/.config/zed/settings.json · IDE