WebMCP: 파일 변환기를 AI 에이전트가 호출할 수 있는 도구로 만들기

편집자 주(2026-05). Chrome 150은 navigator.modelContext를 더 이상 사용하지 않고 document.modelContext를 채택했습니다(WebMCP 사양 PR #184 기준). 이 글의 예제는 Chrome 팀이 권장하는 전방 호환 기능 감지 패턴을 사용합니다:
const modelContext = document.modelContext || navigator.modelContext;
if (modelContext) {
  // Register tools...
}
WebConverter 자체 통합도 정확히 이 폴백을 사용하므로, 이전 식별자를 제공하는 브라우저에서도 계속 작동합니다.

Model Context Protocol(MCP)은 AI 에이전트가 도구를 호출하는 방식을 표준화했습니다. WebMCP는 그 아이디어를 오픈 웹으로 가져옵니다. 별도의 서버 프로세스 대신, 웹사이트 자체가 브라우저 API — document.modelContext — 를 통해 도구를 노출하여 브라우저 내 에이전트가 이를 발견하고 호출할 수 있습니다. 우리는 방금 WebConverter용 WebMCP 통합을 출시하여, 사이트가 할 수 있는 모든 변환을 여전히 100% 브라우저 내에서 로컬로 실행되는 에이전트 호출 가능 도구로 만들었습니다.

WebMCP란 무엇인가요?

WebMCP는 Google과 Microsoft의 엔지니어들이 설계한 W3C Web Machine Learning Community Group의 웹 표준 초안입니다. 브라우저의 navigator 객체에 새로운 진입점 하나를 정의합니다: document.modelContext. 페이지는 registerTool()을 호출하여 이름이 있는 도구를 게시하고 — 설명과 입력용 JSON Schema와 함께 — 도구가 호출될 때 브라우저(또는 브라우저를 통해 동작하는 에이전트)가 호출하는 execute() 함수를 제공합니다.

기존 MCP와의 핵심 차이점: 별도의 전송 계층도, localhost 서버도, 관리할 토큰도 없습니다. 도구는 페이지 자체의 JavaScript 그 자체입니다. 프라이버시 우선 변환기에게 이는 결정적입니다 — 에이전트는 권한을 얻지만, 파일은 탭을 벗어나지 않습니다.

"File Converter MCP"가 중요한 이유

오늘날 AI 어시스턴트에 파일 변환을 요청하면 보통 세 가지 나쁜 선택지밖에 없습니다: 파일을 타사 API에 업로드하거나, 데이터에 접근하는 서버 측 도구를 실행하거나, 거부하는 것입니다. WebMCP 기반 변환기는 이 계산을 바꿉니다: 업로드 없음, API 키 없음, 속도 제한 없음, 비용 없음, 그리고 업로드-처리-다운로드 왕복이 결코 발생하지 않으므로 탄소 배출이 거의 제로입니다.

우리가 노출한 도구

WebConverter는 document.modelContext를 통해 두 가지 도구를 등록합니다: list_supported_formats는 에이전트가 유효한 변환을 계획할 수 있도록 읽을 수 있는 입력 형식과 쓸 수 있는 출력 형식을 반환합니다. 그리고 convert_image는 base64 파일과 대상 형식을 받아 변환된 파일을 base64와 data: URL로 반환합니다. 이 도구들이 기존 Worker 파이프라인을 감싸기 때문에, 이미지 변환기가 할 수 있는 모든 것을 이제 에이전트도 할 수 있습니다.

구축 방법

이 통합은 사이트 전체에 로드되는 작은 단일 지연 스크립트입니다. 도구 디스크립터를 정의하고, document.modelContext가 존재할 때 사양 API로 등록하며, 동일한 정의를 미러링하는 작은 프로그래밍 방식 레지스트리도 노출합니다 — 문서화된 자동화 연결점으로, 네이티브 API가 아직 출시되지 않은 브라우저에서도 도구를 테스트하고 사용할 수 있게 합니다. 전체가 감싸여 있어 누락된 Worker나 차단된 WASM이 호스트 페이지에 예외를 던지는 일이 결코 없으며, 추가되는 것은 단 몇 킬로바이트뿐입니다 — 새로운 WebAssembly는 없습니다.

신뢰와 안전성에 대한 참고

에이전트 호출 가능 도구는 면밀한 검토가 필요합니다. WebConverter의 도구는 설계상 읽기 전용입니다: 바이트를 받고 바이트를 반환합니다. 디스크에 쓰지 않고, 네트워크 요청을 하지 않으며, 다른 탭을 읽지 않고, 무엇도 영구 저장하지 않습니다. convert_image를 호출하는 에이전트는 사람이 "변환"을 클릭하는 것과 정확히 동일한 권한을 가집니다 — 단 1비트도 더 없습니다.

사용해 보기

WebMCP 페이지를 열면 convert_image 도구를 구동하는 라이브 데모와 도구 스키마의 전체 참조를 볼 수 있습니다. 에이전트를 구축하고 있다면, 이것이 정직하고 비공개적이며 비용이 들지 않는 파일 변환 도구의 모습입니다 — 그리고 그것은 그저 하나의 웹페이지입니다.

이미지를 변환할 준비가 되셨나요?

무료로 WebConverter 사용해 보기