매트록 (Matlock) 로고 매트록(Matlock)
무료 스캔

매트록 (Matlock) — 에이전트 및 개발자 도구. (사용 설명서 및 운영 레퍼런스)

AI 코딩 에이전트 및 오케스트레이터 안내: 27개 로컬 stdio MCP 도구 카탈로그, 2경로 HTTP 402 잠금 해제, seq_matlock / cold_box 경계 샌드박스 규칙 및 완료 계약은 파트 II: 머신 및 자율 에이전트 운영 사양으로 바로 이동하여 확인하십시오.

제품: 매트록 (Matlock) — 에이전트 및 개발자 도구. (효율적으로. 정확하게. 원칙대로.)
포지셔닝: 변조 방지 Safeguard 테스트 봉인, 경계 Pre-CI 샌드박스, 1클릭 CLI 자동화 및 27개 도구 로컬 stdio MCP를 갖춘 < 50ms 로컬 다중 언어 AST, MITRE CWE, IEEE Std 1003.1 POSIX, CISA SSDF 및 AICPA SOC 2 Trust Services Criteria 기술적 코드 검증(클라우드 소스 업로드 0, 개방 포트 0, git commit 차단 0).
발행처: 매트록 (Matlock) by Dutch P2P © 2026.
이용 환경: 데스크톱 커맨드 센터(Windows, Linux, GoogleBook 지원; macOS arm64 (헤드리스 matlock-mcp 준비 완료) — 언제든 ? 또는 F1) · 웹 커맨드 센터 · 무료 브라우저 스캔 · 문서 · 온라인 설명서 · MCP URI matlock://help/appliance-manual

적용 범위 및 법적 고지: 매트록 (Matlock)은 공개된 업계 사양 및 벤치마크(MITRE CWE, CISA SSDF, IEEE Std 1003.1 POSIX, 자동화 Pre-CI 무결성 게이트 및 AICPA SOC 2 Trust Services Criteria 기술 통제)에 비추어 기술적 코드베이스 및 파이프라인 통제를 평가합니다. 매트록 (Matlock)은 결함 없는 소프트웨어를 보증하지 않으며, 공식 제3자 인증 보고서를 발행하거나 독립 공인회계사(CPA) 법인의 인증을 제공하지 않습니다.

파트 I: 사람 운영자 가이드 및 워크벤치

1. 빠른 용어집 및 핵심 워크플로

2. 화면 구성, 테마 및 내비게이션

3. 탐색된 스크립트, 스타터 템플릿, 맞춤 검사 및 별표 즐겨찾기

4. 자동 진행 루틴, 컴퓨터 명령 및 로컬 알림

카드WindowsLinux비고
Shutdown in 30 minutesshutdown.exe /s /t 1800shutdown -h +3030분 지연, /f 미사용; Cancel shutdown과 한 쌍
Cancel shutdownshutdown.exe /ashutdown -c1클릭 즉시 취소
Clean temporary files사용자 temp 폴더만, 사용 중 제외~/.cache 및 /tmp의 1일 초과 파일프로젝트 파일은 절대 건드리지 않음
Check disk spaceGet-PSDrive -PSProvider FileSystemdf -h읽기 전용
Optimize disk (defrag or trim)Optimize-Volume -DriveLetter C -Verbosefstrim -av관리자/root 필요; UAC/sudo 창 없이 안전 중단
Backup copyrobocopy . "<backup-folder>" /MIRrsync -a --delete ./ "<backup-folder>/".git 유지, 캐시 생략; robocopy 0–7 = 통과
Find a Word & Expose Itfindstr /s /i /m /c:"Aluminium" *.dartgrep -rnI "Aluminium" --include="*.dart" .대소문자 구분 없는 편집 가능 재귀 검색
Lines Over 250 Catchfor /r %i in (*.dart) do ... find /c /v ""find . -name "*.dart" -exec awk '... c>250 ...' {} +250줄 초과 파일 목록 읽기 전용 스캔

5. 최다 오류순 아코디언, 카테고리 단독 재실행, 무시 및 복사

6. 영구 변조 방지 세이프가드, 테스트 무결성 및 복원

7. 가로 상태 점수·커버리지 바 및 모듈화 기준

8. 2단 분류 설정 및 봉인 상태 복구

오른쪽 상단 Settings를 클릭하면 2단 창(왼쪽 6개 카테고리 탐색 레일 + 오른쪽 간결한 제어판; 각 헤더의 ? 아이콘으로 해당 설명서 섹션 바로 열기)이 열립니다:

  1. Appearance: 언어(9개 언어 + 복사 문구 언어), 테마(System Default, Light, Dark Slate), 바탕화면 바로가기, Windows 닫기 시 시스템 트레이로 최소화.
  2. Project & Runner: 모듈화 조정 다이얼(Grade A..Minimum), 로컬 프로필 Open folder(비공개 로컬 OS 사용자 프로필 폴더), 초기 설정 배너 다시 표시(Set up for me 다시 열기), Keep Quick Run history, Reset Ignore Registry.
  3. Safeguard & Restore: Allow Matlock to restore tests, 사람 전용 세이프가드 자동 복원 스위치, Sync across my computers(암호 구문 봉인 폴더 동기화).
  4. Email Alerts: 로컬 email_smtp 및 custom_script 알림 스테이션 + Test Email.
  5. AI Agent (MCP): MCP Server (stdio) 스위치(기본 꺼짐), 양방향 브리지 "헤드리스와 동기화"(백그라운드 폴링 0으로 에이전트 생성 카드 불러오기 및 상시 지침 게시 1클릭 수행), Test MCP Connection, Copy MCP Config & Agent Instructions, Copy a question for my phone AI, Agent Email Bridge.
  6. License & Updates: 24자리 키 Activate / Move license to this device, Automatically check for updates(MATLOCK_OFFLINE=1은 모든 외부 통신 차단), Send anonymous crash diagnostics(기본 꺼짐; MATLOCK_NO_TELEMETRY=1), Copy diagnostic info, Free up memory, Share Matlock, Contact us(dutch@dutchp2p.com), Dutch P2P Tools.
  7. 봉인 상태 복구 (Reset Ignore Registry): 외부 편집으로 integrity_seal:MUTE_SEAL_TAMPERED 또는 storage_recovery:BAK_AUTO_RESTORE가 발생하면 Settings -> Project & Runner -> Storage & backup -> Reset Ignore Registry를 여세요.

9. AI 에이전트 연결 (데스크톱 MCP 및 모바일/채팅 안내)

{
  "mcpServers": {
    "matlock": {
      "command": "matlock.exe",
      "args": ["mcp", "--stdio"]
    }
  }
}

10. 내장 표준 레퍼런스 (10개 생태계 + Pre-CI)

모든 내장 검사는 매트록 (Matlock)에 컴파일되어 있으며 MITRE CWE, CISA SSDF (NIST SP 800-218), IEEE Std 1003.1 POSIX, Pre-CI 게이트, AICPA SOC 2 Trust Services Criteria 기술 통제에 기반합니다:

생태계 및 영역매트록 (Matlock) 검사 항목 및 예방하는 프로덕션 장애
다중 언어 코어 & Dart / Flutter무음 catch 블록(CWE-391), null/경계 위험(CWE-476/CWE-125), 미대기 async 경쟁, 스트림/타이머/컨트롤러 누수(CWE-401), 무한 재시도(CWE-835), 하드코딩 비밀키(CWE-798), 로그 비밀 노출(CWE-532), 다중 언어 HTTP/SMTP/CLI/CI의 TLS 인증서 검증 우회(CWE-295 / [MITRE T1557]), SQLi(CWE-89), SSRF(CWE-918), XXE(CWE-611), 미서명 JWT(CWE-347), 오픈 리다이렉트(CWE-601), 타임아웃 누락, 경로 탐색(CWE-22), 빈 테스트(CWE-362).
Java (.java)고정 암호키(CWE-798), 명령/SQL 인젝션(CWE-78/CWE-89), 위험한 역직렬화(CWE-502), 취약 암호(CWE-327), 삼킨 예외(CWE-391), JDBC/스트림 누수(CWE-404), 문자열 == 버그, 급작스러운 System.exit, 루프 내 sleep.
Python (.py)고정 시크릿(CWE-798), 셸/SQL 인젝션(CWE-78/CWE-89), 위험한 pickle/yaml 로드(CWE-502), 약한 해시(CWE-328), 빈 except(CWE-391), 가변 기본 인자, 기술자 누수(CWE-775), async def 내 동기 호출, 빈 테스트.
Rust (.rs)내장 비밀정보(CWE-798), 포맷된 셸/SQL 문자열(CWE-78/CWE-89), 무방비 unsafe 캐스트, TLS 검증 해제(CWE-295), 프로덕션 .unwrap()/todo!() 패닉, 비동기 내 블로킹 sleep, 의도적 누수(CWE-401), 버려진 Result, 빈 테스트.
Go (.go)고정 토큰(CWE-798), 연결된 exec/SQL(CWE-78/CWE-89), InsecureSkipVerify(CWE-295), 약한 난수(CWE-330), 무시된 오류(CWE-252), 루프 내 defer 누수 및 미취소 컨텍스트(CWE-404), HTTP 타임아웃 누락, 프로덕션 panic, 빈 테스트.
TypeScript & JavaScript (.ts, .tsx, .js, .jsx)노출된 시크릿(CWE-798), DOM XSS / eval 싱크(CWE-79/CWE-95), 셸 보간(CWE-78), 프로토타입 오염(CWE-1321), 빈 .catch()(CWE-391), 타입 억제, NaN 비교 버그, 동기 I/O 정지, 남은 debugger, 리스너/타이머 누수(CWE-401).
C & C++ (.c, .cpp, .cc, .h, .hpp)고정 시크릿(CWE-798), 경계 없는 FFI/버퍼 복사(CWE-787/CWE-120), 포맷 문자열 버그(CWE-134), system() 인젝션(CWE-78), new[]/delete 불일치(CWE-762), 해제 후 사용(CWE-416), 예외 던지는 소멸자, 미결합 스레드.
Kotlin & Android (.kt, .kts)고정 시크릿(CWE-798), SQL 문자열 연결(CWE-89), 취약한 WebView 브리지, 우회된 TLS(CWE-295), 전체 읽기 가능 설정(CWE-276), GlobalScope 누수(CWE-401), 메인 스레드 정지, !! 충돌, 삼킨 CancellationException, 손상된 ZIP/APK 헤더(CWE-190).
C# & .NET (.cs)해제되지 않은 IDisposable 핸들(CWE-404), async void 비정상 종료, 매개변수화되지 않은 SQL/명령 문자열(CWE-89/CWE-78), TLS 인증서 검증 비활성화(CWE-295), 삼켜진 예외(CWE-391), 동기 .Result/.Wait() 교착 상태 및 빈 껍데기 테스트.
SQL & 스토리지 엔진 (.sql)와일드카드 권한(CWE-250), 동적 SQL 연결(CWE-89), DDL 평문 비밀번호(CWE-256), OS 명령 탈출(CWE-78), 비활성 RLS, 조건 없는 DELETE/UPDATE, 비멱등 마이그레이션, 깊은 OFFSET 스캔, 무방비 테이블 잠금.
크로스 OS Pre-CI, Bash/Shell (.sh), PowerShell (.ps1), Dockerfile & GitHub Actions YAML대소문자 경로 충돌(POSIX.1), CRLF 셔뱅, Bash/POSIX 이식성 함정 및 PowerShell $ErrorActionPreference / LASTEXITCODE 오류, 미고정 Dockerfile 태그 및 루트 컨테이너 위험, HTML/자산 용량 초과, Windows .cmd/.bat 실행 함정, 핸들 누수(CWE-775), 고정 경로 구분자, 미추적 import, 락파일 불일치, 미고정 GitHub Actions YAML 권한, 워크플로 인젝션, +x 누락.
모듈화 & 맞춤 검사사람 전용 모듈화 조정 다이얼(Grade A <= 60~Minimum <= 1000, 기본값 Grade C <= 250 파일 / <= 80 함수; CWE-1080 / CWE-1120) 및 OS 프로필에 저장된 패턴·스크립트 검사.

11. Workstation Pro 라이선스, 웹 미리보기 및 무료 브라우저 스캔

12. Linux, GoogleBook, 업데이트, 개인정보 보호 및 지원

파트 II: 머신 및 자율 에이전트 운영 사양

A. 에이전트 진입점 및 전송 설정

{
  "mcpServers": {
    "matlock": {
      "command": "matlock-mcp",
      "args": ["--stdio", "--headless", "--no-coverage"]
    }
  }
}

B. 사용량 측정, M2M 스웜 액세스 및 Pro 잠금 해제

C. 27개 로컬 MCP 도구 전체 카탈로그

  1. matlock_run_scan(target_path?, changed_only?, dedup_by_rule?, if_none_match?, agent_id?, rule_id?, category?, pillar?, file_filter?, include_generated?, compact?, cursor?, rule_code?, transaction_signature?): Index 0(readOnlyHint: true) < 50ms AST, CWE, POSIX, Pre-CI 스캔으로 file:line:col(col >= 1), cwe, mitre_attack, 5줄 diff 처방 반환(CLI matlock-mcp scan . --format=sarif SARIF 2.1.0 출력 지원).
  2. matlock_describe_project(target_path?, mode?): 선택적 워크스페이스 프로필(0 크레딧, readOnlyHint: true); mode: "tool_bag"(또는 CLI matlock-mcp toolbag [--json])를 전달하면 [LOCKED](실행 전용) 대 [MODIFIABLE](개선 가능) 작업 카드, 시퀀스, [NEW]/[UPDATED] 배지, [UNAVAILABLE IN CONTAINER] 표시, 상시 지침 및 발신 알림 준비 상태를 ~350–550 토큰으로 조회합니다.
  3. matlock_get_scan_results(target_path?, cursor?, pillar?, rule_code?): 페이지 단위 결과(25건/페이지; 데스크톱은 잠금 해제 전까지 세이프가드 줄 숨김; --headless 가스 탱크는 좌표 열람 허용).
  4. matlock_qualify_test(file | files, target_path?, dry_run?, baseline_only?, wait_if_busy?, max_wait_seconds?): 1~5개 테스트 파일(test_file / test_files)을 3개 관문(>= 1 어서션 실행 통과, 분석기 경고 0 + 줄 상한, 매트록 (Matlock) 위반 0)으로 검증 후 세이프가드 봉인, 또는 베이스라인 봉인(baseline_only: true).
  5. matlock_get_test_integrity(target_path?, reverify?, include_archive?, id?, include_text?, note_for_id?, note?): 삭제된 테스트 무결성 기록 조회 및 에이전트 설명 메모 추가(해제 권한 0).
  6. matlock_get_history(target_path?, limit?): 읽기 전용 점수 및 수정 내역 기록.
  7. matlock_read_appliance_manual(section_id?, standard_id?, query?, locale?): 오프라인 설명서(9개 언어) 및 CWE/POSIX/SSDF/SOC2/결과 코드 조회(0 크레딧, 네트워크 0).
  8. matlock_list_custom_tests: 사용자 정의 맞춤 검사 목록.
  9. matlock_register_custom_test: 패턴 또는 스크립트 맞춤 검사 저장.
  10. matlock_delete_custom_test: 잠금 해제된 맞춤 검사 삭제(내장 검사는 불변).
  11. matlock_list_actions: 작업 카드(favorite/잠금/승인 플래그 포함) 및 미설정 recommendedTemplates(unconfiguredTemplate: true) 목록.
  12. matlock_register_action(id, command, name?, favorite?): 잠금 해제된 작업 또는 스타터 템플릿(tpl_github, tpl_save_drive, tpl_cloud_sync, tpl_save_backup, tpl_defrag_optimize, tpl_shut_down)을 프로그래밍·수정하고 unconfiguredTemplate을 해제하며 즐겨찾기(favorite: true | false)를 고정/해제(데스크톱 Require Approval 강제).
  13. matlock_register_sealed_script: 하위 에이전트 수정으로부터 빌드/테스트 명령 봉인(Locked by User).
  14. matlock_run_action(id, working_dir?, async?, send_alert?, cold_box?): OS 작업 트리 격리 아래 명령 실행(async: true 비차단 실행, send_alert, USB robocopy/rsync, 클라우드 R2/S3/GCS/Azure 및 맞춤 git push 카드 지원; Matlock 테스트 실행 내 내장 git push는 0개).
  15. matlock_get_action_status(id?): 실시간 상태, 종료 코드 및 async: true 백그라운드 작업용 요약 상태 캡슐 조회.
  16. matlock_stop_action(id?, stop_sequence?): 활성 프로세스 트리 즉시 종료(stop_sequence: true로 활성 시퀀스 전체 안전 중지).
  17. matlock_delete_action: 잠금 해제된 작업 카드 삭제.
  18. matlock_list_sequences: 다단계 루틴 목록.
  19. matlock_register_sequence(id, name?, step_ids?, commands?, insert_step_id?, insert_command?, insert_step_name?, insert_at_index?, remove_step_index?, failure_policy?, always_run?, favorite?): 잠금 해제된 시퀀스를 직렬 구성·수정하며 원하는 작업이나 alert::<id>를 정확한 0 기반 위치 insert_at_index에 failure_policy("stop" | "stop_and_alert" | "continue_and_alert"), always_run, favorite: true | false와 함께 삽입.
  20. matlock_run_sequence(id, file?, async?, send_alert?, cold_box?, deep?, include_coverage?): seq_matlock 또는 seq_fast_verify 실행(file 단일 테스트 파일 실행, async: true 완료 시 자동 웨이크 비차단 실행, send_alert 알림 지원; 빠른 스프린트는 기본값 cold_box: false; 외부 저장·클라우드 동기화·백업·push·릴리스 빌드 직전에는 cold_box: true로 이미 검증된 경우 < 15ms 내 반환하며, deep: true로 전체 정리 및 커버리지 재측정 실행).
  21. matlock_delete_sequence: 잠금 해제된 루틴 삭제.
  22. matlock_list_alerts: 로컬 알림 채널 목록(비밀정보 마스킹).
  23. matlock_set_alert: 발신 전용 Native Dart TLS 1.2/1.3 email_smtp(글로벌 프리셋, OS 키체인 또는 암호 구문 봉인 로컬 컨테이너 볼트) 또는 custom_script 알림 구성.
  24. matlock_trigger_alert(id, status, task_completed, uncovered_issues, next_move): 필수 3문항 핸드셰이크와 함께 로컬 알림 발송.
  25. matlock_delete_alert: 잠금 해제된 알림 카드 삭제.
  26. matlock_purchase_license(transaction_signature?, license_key?, target_path?, network?, runs?, lid?): 자율 에이전트 스웜 종량제 할당량(https://matlock.dutchp2p.com/ko/agents 참조) 정산 또는 약 34,000원* ($24.99 USD/년) 24자리 Pro license_key 등록.
  27. matlock_report_issue(category, subject, description, tool_context?, output_dump?): 비동기 정제 피드백/위시리스트 전송(0 크레딧, CONTINUE_IMMEDIATELY).

D. 경계 Cold Box 샌드박스, 3회 루프 제한 및 완료 핸드셰이크

E. AI 코딩 에이전트를 위한 기계 판독 가능 사양 (YAML)

product: "Matlock — Agent & Developer Tools. (Efficient. Exact. By the book.)"
pinned_version: "v1.0.0+1"
web_command_center: "https://matlock.dutchp2p.com/ko/app"
free_local_scan: "https://matlock.dutchp2p.com/ko/#wasm-instant-audit"
docs_hub: "https://matlock.dutchp2p.com/ko/docs"
online_manual: "https://matlock.dutchp2p.com/ko/manual"
public_repository: "https://github.com/Dutchp2p/matlock-public"
online_operational_map: "https://matlock.dutchp2p.com/llms.txt"
mcp_resource_uri: "matlock://help/appliance-manual"
mcp_stdio_command: "npx -y @dutchp2p/matlock-mcp | uvx matlock-mcp | matlock.exe mcp --stdio (Windows) | matlock mcp --stdio (.deb) or /path/to/matlock-linux-x64.AppImage mcp --stdio (Linux & GoogleBook) | matlock-mcp --stdio --headless --no-coverage (Linux x64, Windows x64 & macOS arm64)"
network_ports: 0
git_hooks_installed: 0
builtin_git_push_in_test_runs: false
custom_push_deploy_actions_allowed: true
mcp_tools_count: 27
primary_pipeline:
  card: "Matlock"
  sequence_id: "seq_matlock"
  entry_tool_index_0: "matlock_run_scan"
  badge_svg_url: "https://matlock.dutchp2p.com/badge/verified.svg"
  stages: "Clean -> Get -> Format -> Lint -> Analyze/Compile -> Test -> Coverage (depth 0..2)"
  cold_box_default: false
  cold_box_boundary_triggers: ["before external git push", "before cloud-drive save", "before removable backup", "before release compile"]
modularity_tuning_dial:
  person_only_sealed_os_settings: true
  default_tier: "Grade C (<= 250 / <= 80 fn)"
  tiers: ["Grade A (<= 60 / <= 25 fn)", "Grade B (<= 100 / <= 40 fn)", "Grade C (<= 250 / <= 80 fn)", "Grade D (<= 500 / <= 120 fn)", "Minimum (<= 1000 / <= 250 fn)"]
ignore_scopes_5: ["file:line:code", "file:code", "*:code", "file", "folder/"]
lock_governance:
  safeguarded: "Read & Run Only (auto-reverts unauthorized edits + Envelope tamper alert)"
  unlocked: "AI agent can modify (Read, Write, Modify & Run)"
os_storage:
  scope: "private_user_profile_outside_repo"
  env_override: "MATLOCK_STATE_DIR"

F. 에이전트 운영 원칙 및 실행 경계

맨 위로 돌아가기