한국어

MCP 서버

gori는 내장 MCP(Model Context Protocol) 서버를 제공합니다. TUI에 채팅 창을 넣는 대신, gori는 프로젝트를 깔끔한 도구 인터페이스로 노출합니다. 덕분에 MCP를 지원하는 어떤 에이전트든(Claude, Codex, Grok 등) 트래픽을 읽고 도구를 구동할 수 있습니다.

에이전트 · MCP로 구동하는 gori

나users API에서 IDOR를 찾아 기록해줘.

→ list_history path~/v1/users status:200

← 플로우 14개, customer 및 admin 토큰

→ send_request GET /v1/users/2 · customer 토큰

← 200 {"id":2,"email":"other-tenant@example.com"}, 호출자의 행이 아님

→ create_issue "IDOR on /v1/users/{id}" severity:high

✓ 이슈 기록됨; 재현을 위해 요청이 Repeater 세션으로 저장됨.

gori mcp

서버는 stdio 위에서 JSON-RPC 2.0으로 통신합니다. STDOUT은 프로토콜을, STDERR은 로그를 전달합니다. 도구 결과에는 하위 호환용 텍스트가 담기며, 페이로드가 JSON이면 MCP structuredContent도 함께 들어갑니다.

프로젝트 선택

cd /path/to/my-repository && gori mcp # path-binds this Git workspace to its own gori project
gori mcp --project my-engagement   # serve a named project's database
gori mcp --db /path/to/project.db  # serve a specific database file
gori mcp --use-active-project      # explicitly serve the active TUI/MRU project

명시적 선택자가 없으면, gori는 가장 가까운 Git 루트를 찾아 그 정규 경로를 격리된 프로젝트에 바인딩합니다. 이 바인딩은 디렉터리 이름이 같은 두 리포지토리가 하나의 데이터베이스를 공유하는 것을 막습니다. 프로세스가 Git 워크스페이스 밖에 있으면, gori는 무관한 활성 프로젝트를 슬그머니 제공하지 않고 오류를 내며 멈춥니다. --project, --db, GORI_MCP_PROJECT, GORI_MCP_DB, 또는 명시적 옵트인인 --use-active-project를 전달하세요.

데이터를 사용하기 전에 project_info를 호출하세요. 선택된 프로젝트, 데이터베이스 경로, 워크스페이스 루트, 선택 출처를 보고합니다.

읽기 전용 모드

기본적으로 서버는 실시간 요청을 보내고 이슈를 기록하는 액션 도구도 노출합니다. 읽기 도구만 노출하려면(신뢰할 수 없는 에이전트에게 프로젝트를 넘길 때 안전합니다) 읽기 전용으로 시작하세요.

gori mcp --read-only

에이전트에 설치하기

gori는 널리 쓰이는 클라이언트의 MCP 설정을 대신 작성해 줍니다.

플래그 클라이언트 작성되는 설정
--install-claude Claude Desktop ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
--install-claude-code Claude Code ~/.claude.json (mcpServers.gori)
--install-codex OpenAI Codex ~/.codex/config.toml ([mcp_servers.gori])
--install-agy Antigravity CLI ~/.gemini/antigravity-cli/mcp_config.json
--install-grok Grok ~/.grok/config.toml ([mcp_servers.gori]) 
gori mcp --install-claude-code
gori mcp --install-codex
gori mcp --install-grok

Codex와 Grok은 JSON이 아니라 [mcp_servers.gori] 테이블이 있는 TOML을 사용합니다. 설치 후 클라이언트를 재시작하거나 세션을 다시 열어 MCP 서버를 다시 로드하세요.

클라이언트가 리포지토리 디렉터리 밖에서 MCP를 시작한다면, 설치를 프로젝트에 고정하세요. 예: gori mcp --project my-engagement --install-codex.

도구

읽기 도구(항상 사용 가능):

도구 용도
list_history 최신순으로 플로우 나열, 선택적 QL과 페이지네이션 포함
list_events 작업 수명주기와 에이전트 활동을 추가 전용 피드로 전방 커서 조회. 플로우가 여전히 전체 스트림이며, 이 피드는 플로우 행을 중복하지 않음
get_flow 한 플로우의 전체 요청 + 응답
get_response_body_chunk 인라인 64 KiB 상한을 넘는 디코드(또는 원시) 플로우/Repeater 응답을 페이지 단위로 조회
list_sitemap 고유 엔드포인트(host, method, path)
list_issues / get_issue 트리아지된 이슈 읽기
list_scope 현재 스코프 include/exclude 규칙
intercept_list / intercept_get 라이브 인터셉트 큐와 홀드된 항목 하나의 전체 내용 조회
list_projects 이 호스트의 모든 gori 프로젝트
list_notes / get_note 프로젝트 노트 읽기
list_rules 프로젝트의 Match & Replace 규칙을 적용 순서로 나열
decode input에 대해 인코드/디코드/해시/압축 체인을 실행(순수 변환; 네트워크나 상태 없음)
jwt_decode / jwt_encode / jwt_attacks JWT 디코드, 재서명, 공격 페이로드 생성(순수 계산; --read-only에서도 사용 가능)
sequence_analyze 붙여넣은 토큰 목록의 무작위성 / 예측 가능성 평가(순수)
oast_presets / oast_payload / oast_poll OAST 프로바이더 나열, 현재 페이로드 조회, 실행 중인 리스너의 콜백 폴링
discover_status / discover_results Discover 실행의 진행 상황과 결과
project_info 플로우 / 이슈 개수, 데이터베이스, 워크스페이스 바인딩, 선택 출처
get_current_context 사용자가 지금 TUI에서 보고 있는 것
get_repeater_context Repeater 워크벤치 상태와 저장된 세션
ql_reference 쿼리 언어 레퍼런스
ql_explain 쿼리를 실행하지 않고 진단. 요청을 쓰기 전에 필터를 점검할 때 사용

액션 도구(--read-only로 비활성화됨):

도구 용도
send_request HTTP 요청 전송 / 재전송(액티브; 기본적으로 History에 기록, $KEY 환경 토큰을 확장, 명시적으로 요청하지 않는 한 민감한 응답 헤더 값을 가림)
send_websocket 저장된 WebSocket Repeater 세션을 실행하고 응답을 수집
create_repeater / update_repeater / delete_repeater Repeater 세션 관리
create_issue / update_issue 이슈 기록 및 갱신
create_note / update_note / delete_note 프로젝트 노트 관리
create_rule / update_rule / set_rule_enabled / delete_rule Match & Replace 규칙 생성, 편집, 토글, 삭제(이동 중인 요청/응답 헤드 또는 본문 재작성)
preview_rule 규칙을 만들기 전에, 저장된 플로우 중 몇 개가 바뀌었을지 추정
create_project / switch_project / delete_project 프로젝트 생성 또는 다시 열기, 이 서버를 다른 프로젝트로 전환, 프로젝트 삭제. 삭제는 2단계로, dry_run 후 확인 토큰 필요
fuzz_start / fuzz_status / fuzz_results / fuzz_stop Fuzzer 구동
mine_start / mine_status / mine_results / mine_stop Param Miner 구동
sequence_start / sequence_status / sequence_results / sequence_stop 라이브 리플레이로 토큰을 수집해 평가(결과는 리포트만 반환, 토큰은 반환하지 않음)
discover_start / discover_stop 엔드포인트 스파이더링 & 브루트포스(discover_status / discover_results로 폴링)
oast_start / oast_stop OAST 페이로드 등록 후 콜백 폴링(oast_poll로 히트 조회)
list_jobs / get_job / stop_job 작업 종류를 가로질러 처리: 이번 세션이 시작한 모든 fuzz와 mine 작업 나열, 또는 id로 하나를 조회하고 중지
intercept_forward / intercept_forward_edit / intercept_drop 홀드된 메시지를 바이트 그대로 내보내거나, 수정한 와이어 바이트로 내보내거나, 드롭
intercept_toggle / intercept_set_filter / intercept_set_direction 캐치 활성화 및 해제, 조건 쿼리 설정, 홀드할 방향 선택

액션 도구는 안전을 위해 상한이 있습니다: fuzz, mine, sequence, discover 작업은 총 요청 수, 동시성, 저장 결과 수가 제한됩니다. create_rule로 생성된 규칙은 gori run과 새로 열린 TUI에 적용됩니다. 이미 실행 중인 TUI는 규칙을 다시 로드한 뒤에만 적용합니다.

라이브 인터셉트

에이전트가 나중에 History를 읽는 대신, 인터셉트 루프 안에 나란히 앉을 수 있습니다. 캡처 락을 쥔 TUI 세션이 홀드된 메시지를 에이전트 쪽으로 미러링하고 에이전트가 보낸 명령을 받아 처리하므로, intercept_list → intercept_get → intercept_forward_edit은 직접 손으로 도는 것과 같은 루프입니다.

변경을 일으키는 쪽(intercept_forward, intercept_forward_edit, intercept_drop, intercept_toggle, intercept_set_filter, intercept_set_direction)은 --read-only에서 비활성화되며, 라이브 캡처 세션이 락을 쥐고 있지 않으면 모두 거부합니다. 프록시가 실제로 트래픽을 홀드하고 있지 않으면 내보낼 것 자체가 없기 때문입니다.

에이전트의 행동은 조용히 지나가지 않고 드러납니다. 각 행동은 에이전트에서 온 것으로 표시되어 알림 센터에 남고 사용자 본인의 행동과 다르게 렌더링되므로, 다른 탭을 보는 동안 코파일럿이 트래픽에 무엇을 했는지 확인할 수 있습니다.

에이전트를 켜둔 채 자리를 뜨기 전에 알아둘 안전 규칙이 하나 있습니다. 홀드된 메시지는 원래 사람의 결정을 무한히 기다립니다. 키보드 앞에 사람만 있을 때는 그게 맞는 동작입니다. 하지만 해당 세션에서 에이전트가 인터셉트 큐에 붙고 나면, gori는 아무도 보고 있지 않은 항목에 대해 30초 자동 포워드를 켭니다. 홀드 도중 죽은 클라이언트가 연결을 영영 막아버리지 못하게 하기 위해서입니다. 에이전트가 붙지 않은 세션은 자동 포워드를 하지 않습니다.

MCP 이음새인 이유

gori는 의도적으로 도구 내 AI 챗을 두지 않습니다. 지능은 도구 바깥, 곧 MCP로 접근할 수 있는 곳에 있습니다. 덕분에 모델을 직접 고를 수 있고, 트래픽이 의도치 않은 곳으로 흘러가지 않으며, 동일한 인터페이스가 스크립트와 에이전트 양쪽을 모두 지원합니다. gori run은 비대화형 경로를, MCP는 대화형 에이전트 경로를 담당합니다.

다음 단계