MCP 통합

Guida에는 Model Context Protocol 서버가 내장되어 있습니다. MCP 지원 클라이언트는 브라우저 탭 조사, 작업 요청, 스크립트 실행, 워크스페이스 도구 사용을 수행할 수 있습니다. Guida는 그 동안 승인, 도메인 제어, 감사 로그, 인증 정보 분리를 사용자가 볼 수 있는 형태로 유지합니다.

작동 방식

Guida의 MCP 서버는 로컬 loopback에서 실행됩니다. 기본 연결 대상은 다음과 같습니다.

http://127.0.0.1:9315/

이는 로컬 AI 도구용 작업 표면입니다. 사설 네트워크 너머의 원격 제어는 별도 기능인 Remote Ops API이며 MCP가 아닙니다.

대표 도구

분류	예	용도
Browser	Navigate, Click, EnterText, SelectOption, WaitForDomStable, GetDom, ExecuteJs	페이지 조작
Tabs	GetTabs, NewTab, CloseTab, SetActiveTab	탭 제어
Screenshots	Screenshot, ScreenshotElement, ScreenshotFullPage	시각적 증적
Data	StorePut, StoreGet, StoreSearch, StoreDelete	워크스페이스 저장소
Queues	QueueEnqueue, QueueDequeue, QueueCommit, QueueAbort	작업 큐
Workers	WorkersStart, WorkersStop, WorkersStatus	배치 처리
Workflow Ledger	ListRuns, QueryItems, StageStateCounts, ReconcileRun, RetryItem	실행 상태, 복구, 증적
Scripts	ExecuteScript, ExecuteScriptAwait, ExecuteScriptFile	스크립트 실행
Network	NetworkSearch, NetworkGetById, WaitForRequest	통신 조사
LLM	LlmPrompt	로컬 LLM 추론
Custom Tools	GetWorkspaceTools, ExecuteWorkspaceTool, ReloadWorkspaceTools	워크스페이스별 도구

세 가지 안전 계층

허용된 도메인

MCP 탐색의 도메인 검사는 기본으로 켜져 있습니다. Navigate와 CreateTab의 대상 URL은 허용된 도메인이어야 합니다. 허용되지 않은 도메인으로 이동하려고 하면 Guida는 승인 요청을 만들고, 차단, 한 번만 허용, 세션 동안 허용, 허용 목록 추가를 선택할 수 있게 합니다.

Approval Center

감독 대상 도구는 실행 전에 명시적 승인이 필요합니다. Guida는 보류 중인 요청을 Approval Center와 도구 모음 표시로 보여 주고, 구체적인 도구 이름과 매개변수를 표시합니다.

감사 로그

MCP 도구 호출은 mcp-audit.db에 기록됩니다. 도구 이름, 매개변수, 결과, 소요 시간, 오류를 확인할 수 있습니다. AI에는 이 감사 로그를 읽거나 검색하거나 삭제하는 MCP 도구가 제공되지 않습니다.

인증 정보

인증 정보 값은 MCP 도구를 통해 공개되지 않습니다. MCP 시작 스크립트는 g.secrets.getSecret()을 사용할 수 없으므로, AI가 스크립트를 통해 복호화된 값을 꺼내는 경로도 차단됩니다.