사용자 지정 도구

사용자 지정 도구는 워크스페이스 안의 스크립트를 MCP 도구로 공개하는 방식입니다. AI 에이전트에 자유로운 브라우저 조작만 넘기는 대신, “이 프로젝트에서 허용하려는 작업”을 이름 붙은 도구로 제공할 수 있습니다.

사용 위치

• 특정 사이트의 검색 폼 열기
• 정해진 추출 처리 실행
• 가져온 데이터를 워크스페이스 저장소에 저장
• 큐 항목 처리
• 프로젝트 고유 검증이나 보고서 생성

도구 문맥

사용자 지정 도구로 호출된 스크립트에서는 g.tool.args에서 AI 에이전트가 전달한 인수를 가져올 수 있습니다.

const args = g.tool.args ?? {};
await g.nav.navigateToUrl(args.url);
await g.dom.waitForDomStable();

const html = await g.page.getDom();
g.store.put("captures", args.url, { html });

안전성

사용자 지정 도구도 MCP 시작 실행으로 취급됩니다. 도구 호출은 감사 로그에 남고, 도메인 제어와 승인 설정의 대상이 됩니다. 인증 정보의 복호화 값은 MCP 시작 스크립트에서 직접 읽을 수 없습니다.

설계 팁

• 인수는 작고 명확하게 유지
• 실패 이유를 로그에 남기기
• 결과를 워크스페이스 저장소나 Workflow Ledger에 남기기
• 사이트별 전제 조건 문서화
• 너무 범용적인 “무엇이든 실행” 도구 피하기

관련 페이지:

• MCP 통합
• 워크스페이스
• AI, HTTP 및 도구 API