사용 방법
- WebMCP API를 제공하는 브라우저를 사용합니다(Chrome의 오리진 트라이얼).
- 편집기를 일반 탭으로 엽니다 — 도구는 최상위 페이지에서만 등록됩니다.
- 브라우저의 AI 에이전트에게 문서를 열거나 읽거나 변환하거나 내보내 달라고 요청합니다.
- WebMCP 도구의 편집과 변환은 로컬에서 실행되지만, 브라우저 에이전트는 문서 텍스트나 내보낸 파일을 받아 자신의 AI 서비스에 보낼 수 있습니다. 기밀 내용을 공유하기 전에 에이전트의 데이터 정책을 확인하세요.
대부분의 웹 앱은 AI 에이전트에게 불투명합니다. 버튼이 늘어선 페이지가 보일 뿐이라 어느 것이 파일을 변환하는지 추측하고, 클릭이 제대로 들어갔기를 바라야 합니다. W3C Web Machine Learning Community Group의 제안인 WebMCP는, 페이지가 자신이 할 수 있는 일을 타입이 붙은 입력을 가진 구조화된 호출 가능 도구로 선언하게 해 그 추측을 통째로 없앱니다. 이 편집기는 일곱 개를 선언합니다.
open_document_url, open_document_buffer, create_document, save_document, get_document_text, set_readonly, get_document_state. WebMCP 도구의 편집과 변환은 로컬에서 실행되지만, 브라우저 에이전트는 문서 텍스트나 내보낸 파일을 받아 자신의 AI 서비스에 보낼 수 있습니다. 기밀 내용을 공유하기 전에 에이전트의 데이터 정책을 확인하세요.
내장 AI 어시스턴트는 아직 완성되지 않았으며 출시된 기능이 아닙니다. 임베드 호스트는 내보낸 파일을 받아 자체 정책에 따라 업로드할 수 있습니다.
의도한 제약이 두 가지 있습니다. 도구는 편집기가 최상위 페이지일 때만 등록됩니다 — 교차 출처 iframe에서는 임베드하는 페이지가 allow="tools"를 부여해야 하는데 이는 임베드의 취지와 충돌하므로, 임베드된 편집기는 postMessage API로 다룹니다. 그리고 전문 읽기는 워드 문서에서 제공됩니다. 스프레드시트와 프레젠테이션은 이 엔진에서 전문을 공개하지 않으므로, 에이전트가 「빈 파일」로 오해할 수 있는 빈 응답 대신 그 사실을 분명히 알립니다.
자주 묻는 질문
WebMCP가 무엇인가요?
W3C Web Machine Learning Community Group의 제안으로, 웹 페이지가 구조화된 도구를 등록하면 브라우저 내 AI 에이전트가 화면을 해석하고 클릭할 필요 없이 그것을 직접 호출할 수 있게 합니다.
이 편집기는 어떤 도구를 등록하나요?
일곱 개입니다: open_document_url, open_document_buffer, create_document, save_document, get_document_text, set_readonly, get_document_state. URL이나 바이트에서 열기, 새 문서 만들기, 내보내기와 변환, 본문 읽기, 읽기 전용 전환, 현재 상태 보고를 다룹니다.
어떤 브라우저가 지원하나요?
WebMCP는 Chrome에서 오리진 트라이얼로 제공됩니다. Firefox와 Safari는 지원을 밝히지 않았습니다. API가 없는 환경에서는 아무것도 등록되지 않고 동작도 달라지지 않습니다.
에이전트가 작업할 때 문서가 업로드되나요?
WebMCP 도구의 편집과 변환은 로컬에서 실행되지만, 브라우저 에이전트는 문서 텍스트나 내보낸 파일을 받아 자신의 AI 서비스에 보낼 수 있습니다. 기밀 내용을 공유하기 전에 에이전트의 데이터 정책을 확인하세요.
에이전트가 문서 내용을 읽을 수 있나요?
워드 문서라면 get_document_text가 본문을 돌려주므로 아무것도 내보내지 않고 내용에 대한 질문에 답할 수 있습니다. 스프레드시트와 프레젠테이션은 이 엔진에서 전문을 읽을 수 없어, 빈 응답 대신 그 사실을 알립니다.
다른 사이트에 임베드된 경우에도 동작하나요?
설계상 동작하지 않습니다. 도구는 최상위 페이지에서만 등록됩니다. 임베드된 편집기는 postMessage Embed API로 다루세요.
에이전트가 파일을 PDF로 변환할 수 있나요?
네. save_document가 출력 형식을 받으므로 에이전트가 DOCX·XLSX·PPTX를 열어 PDF를 내보낼 수 있습니다. 모두 기기에서 이루어집니다.
계정이나 API 키가 필요한가요?
WebMCP 도구에는 계정이나 API 키가 필요하지 않습니다. 기본 파일 열기, 편집, 형식 변환은 브라우저에서 로컬로 실행되며 문서 업로드가 필수는 아닙니다. 내장 AI 어시스턴트는 아직 완성되지 않았으며 출시된 기능이 아닙니다. 임베드 호스트는 내보낸 파일을 받아 자체 정책에 따라 업로드할 수 있습니다.