Cloudflare가 WebMCP를 개발자 프리뷰로 제공하면서, 사이트 운영 방식에 새로운 선택지가 생겼습니다.
별도의 코드 변경 없이 브라우저 안에서 에이전트가 도구를 호출할 수 있게 해 주는 방식입니다.
목차
이번 글에서는 무엇이 바뀌는지, 어떻게 작동하는지, 그리고 Cloudflare 개발 프리뷰에서 무엇을 확인할 수 있는지 정리합니다.
핵심은 기존 웹사이트를 다시 만들지 않아도 된다는 점입니다.
Cloudflare는 페이지 가장자리에 작은 브리지(bridge)를 추가해, 방문자의 브라우저 에이전트 도구가 사이트가 노출한 도구를 발견하고 사용할 수 있게 만듭니다.
WebMCP가 바꾸는 웹사이트와 에이전트의 관계
웹은 사람이 페이지를 읽고, 버튼을 클릭하고, 폼을 채우는 구조를 전제로 만들어졌습니다.
이제는 사람이 아닌 AI 에이전트가 방문하는 경우가 늘고 있습니다.
기존의 크롤링 방식은 내용을 서버로 복사해 가는 데 그치기 쉬웠습니다.
원본 사이트에는 트래픽도, 정당한 인지도도 충분히 남기지 못하는 경우가 많았습니다.
WebMCP는 이런 흐름을 다른 방식으로 바꾸려는 시도입니다.
브라우저 안에서 에이전트가 페이지를 탐색하는 대신, 사이트가 직접 도구를 노출해 에이전트가 그 도구를 호출하도록 설계합니다.
에이전트는 인간 사용자의 시각적 탐색 경로를 그대로 따라갈 필요가 없고, 작업 자체에 토큰을 쓰게 됩니다.
이 표준은 실험적으로 Chrome 146에 포함되어 있으며, 페이지에서는 document.modelContext 로 나타난다.
중요한 점은 표준이 존재한다는 사실만으로 자동 동작하지는 않는다는 것입니다.
사이트가 직접 구현해야 하며, 그 구현 부담을 줄이기 위해 Cloudflare가 이번 프리뷰를 제공합니다.
Cloudflare 개발 프리뷰에서 가능한 것
Cloudflare 개발 프리뷰의 목적은 WebMCP를 더 단순하게 쓰는 데 있습니다.
일반적으로는 노출할 도구를 설계하고, 인터페이스에 연결하고, 표준 변화에 맞춰 계속 유지해야 합니다.
이번 프리뷰는 그 과정을 하나의 설정으로 줄였습니다.
이 기능은 tool pack 단위로 구성됩니다.
관련된 도구들을 묶어서 한 번에 활성화하는 방식이며, Cloudflare는 앞으로 더 많은 pack을 추가할 수 있도록 설계했습니다.
사이트 운영자는 새로 배포하지 않아도 필요한 pack을 켜는 식으로 확장할 수 있습니다.
현재 프리뷰에는 두 개의 pack이 포함되어 있으며, 둘 다 브라우저 안에서만 실행됩니다.
Cloudflare의 서버로 다시 왕복하지 않습니다.
이 점은 성능과 동작 범위를 이해하는 데 중요합니다.
포함된 두 가지 pack
- Content Credentials
- 이미지의 콘텐츠 프로비넌스 메타데이터를 로컬에서 읽는다.
첫 몇 KB 수준의 메타데이터를 확인해 요약하거나 자세히 해석한다.
Site MCP Server
- 사이트가 이미 갖고 있는 MCP 서버와 연결한다.
- 방문자의 브라우저와 같은 출처에서, 기존 세션을 사용해 직접 통신한다.
이 구조 덕분에 WebMCP는 단순한 실험 기능이 아니라, 사이트가 브라우저 에이전트 도구를 어떻게 제공할지 시험해 보는 실제적인 통로가됩니다.
WebMCP는 어떻게 동작하나
Cloudflare의 구현은 origin 앞단에서 작동합니다.
사이트 코드 자체는 건드리지 않습니다.
정적 사이트든 싱글 페이지 앱이든 같은 방식으로 동작한다는 점도 특징입니다.
1) 엣지에서 HTML에 브리지 주입
Cloudflare 대시보드에서 WebMCP를 켜면, HTMLRewriter가 각 HTML 응답에 한 줄을 추가합니다.
그 한 줄은 브리지 스크립트를 가리키는 참조이며, 이 스크립트 역시 Cloudflare가 엣지에서 제공합니다.
즉, 페이지의 본문이나 서버 코드는 그대로 두고, 필요한 연결부만 Cloudflare가 삽입합니다.
이 방식은 origin의 변경 없이 도구 노출을 가능하게 합니다.
이때 data-packs 속성에는 활성화할 pack 목록이 들어가고, 기존 MCP 서버가 있다면 data-mcp-url이 해당 서버 주소를 가리킵니다.
기본값은 같은 origin의 /mcp 입니다.
2) 브리지 스크립트가 도구를 등록
페이지 안에서 실행되는 브리지는 WebMCP 표면을 확인한 뒤, 브라우저가 해당 표면을 제공하지 않으면 아무 일도 하지 않고 종료합니다.
브라우저가 이를 지원하지 않아도 기존 페이지 동작은 그대로 유지됩니다.
지원하는 경우에는 data-packs에 적힌 pack들을 하나의 도구 목록으로 합쳐 등록합니다.
각 pack은 MCP 도구 설명과 처리기를 포함하며, 정적 pack은 도구를 미리 선언하고, 동적 pack은 시작 시점에 도구를 찾아낸 뒤 등록합니다.
Cloudflare는 이 과정에서 Model Context Protocol의 Tool과 CallToolResult 타입을 그대로 사용합니다.
이미 MCP 서버와 통신하는 에이전트라면, 별도의 특수 처리 없이 페이지의 도구도 같은 방식으로 다룰 수 있습니다.
콘텐츠 메타데이터를 읽는 방식
이번 프리뷰에서 눈에 띄는 부분은 이미지 메타데이터를 다루는 방식입니다.
Content Credentials pack은 C2PA 참여자를 위한 자격 정보를 읽는 용도로도 사용할 수 있습니다.
scan_images_c2pa
이 도구는 사이트의 이미지를 훑어서 각 이미지에 대한 짧은 요약을 반환합니다.
에이전트가 사이트 안의 여러 이미지를 빠르게 파악해야 할 때 쓰기 좋습니다.
inspect_image_c2pa
이 도구는 한 이미지의 전체 매니페스트를 더 자세히 해석합니다.
편집 이력, 명시된 작성자, 서명 인증서 같은 항목을 읽어냅니다.
지금 단계에서는 암호학적 검증까지 수행하지 않습니다.
결과에는 signatureVerified: false가 포함됩니다.
이 표시는 디코딩된 주장과 실제 검증된 서명을 혼동하지 않게 하기 위한 장치입니다.
즉, 읽을 수는 있지만 검증 완료라고 단정하지는 않습니다.
이런 설계는 WebMCP가 단순히 “무언가를 읽는 기능”이 아니라, 에이전트가 이해 가능한 형태의 도구를 제공하는 인프라라는 점을 보여줍니다.
사이트 운영자가 확인할 점
WebMCP를 켜는 절차는 Cloudflare 대시보드에서 시작합니다.
Agent Readiness 안의 해당 주제 항목에서 도메인별로 활성화할 수 있고, 사용할 pack도 선택할 수 있습니다.
현재는 Content Credentials와 Site MCP 서버가 기본으로 포함되며, 이후 더 많은 pack이 추가될 예정입니다.
중요한 점은 배포가 필요 없다는 것입니다.
origin의 코드를 바꾸지 않아도 되고, 별도 릴리스도 필요 없습니다.
설정을 바꾸면 다음 HTML 응답부터 브리지가 포함됩니다.
실제로 적용됐는지 확인하려면 HTML 페이지를 요청해 Cloudflare가 주입한 라인을 보면 됩니다.
이 과정은 페이지의 나머지 동작을 건드리지 않으므로, 기존 서비스 운영과 병행하기에도 부담이 적습니다.
확인 흐름을 간단히 정리하면
- Cloudflare 대시보드에서 해당 주제를 켠다.
- 필요한 pack을 선택한다.
- HTML 응답에 브리지 참조가 들어갔는지 확인한다.
- 브라우저 에이전트가 노출된 도구를 발견하는지 시험한다.
BrowserRun으로 테스트하는 방법
Cloudflare는 자체 원격 브라우저인 BrowserRun도 이미 해당 주제를 지원하도록 만들었습니다.
별도 에이전트를 준비하지 않아도, BrowserRun을 사이트 URL에 연결해 도구가 등록되는지 확인할 수 있습니다.
이 점은 Cloudflare 개발 프리뷰의 활용도를 높여 줍니다.
사이트 운영자는 브라우저 에이전트 도구가 실제로 어떻게 노출되는지 확인할 수 있고, 방문자의 에이전트가 보는 것과 비슷한 흐름으로 테스트할 수 있습니다.
중요한 건 환경에 따라 동작이 달라지지 않는다는 점입니다.
브라우저가 로컬에서 실행되든, 클라우드에서 헤드리스로 실행되든 도구의 동작 방식은 같습니다.
이런 일관성은 실험 단계에서 특히 유용합니다.
왜 이런 접근이 필요한가
Cloudflare가 이 기능을 만든 이유는 인터넷이 인간 중심에서 에이전트 중심으로 일부 이동하고 있기 때문입니다.
사이트를 다시 구축하지 않고도 새로운 방문자를 맞이할 수 있는 도구가 필요하다고 본 것입니다.
기존의 스크래핑 방식은 원본 사이트에 가치가 충분히 돌아가지 않는 경우가 많았습니다.
반면 해당 주제는 사이트가 직접 도구를 노출하고, 에이전트가 그 도구를 호출하는 구조를 제공합니다.
Cloudflare는 이를 통해 웹이 인간만을 전제로 하지 않아도 계속 작동할 수 있다고 보고 있습니다.
다만 이것은 완성형 기능이 아니라 개발자 프리뷰입니다.
지금 단계에서는 사용 경험을 시험하고, 어떤 pack이 유용한지, 어떤 흐름이 자연스러운지 확인하는 것이 핵심입니다.
Cloudflare도 피드백을 요청하고 있습니다.
핵심 정리
사이트가 에이전트에게 직접 도구를 노출하도록 하는 브라우저 표준이며, Cloudflare는 이를 Cloudflare 개발 프리뷰로 쉽게 켤 수 있게 했습니다.
코드 변경 없이 엣지에서 브리지를 주입하고, 브라우저 안에서 도구를 등록해 작동시키는 방식입니다.
이미지를 읽는 Content Credentials, 기존 MCP 서버와 연결하는 Site MCP 서버가 포함되어 있으며, 앞으로 더 많은 pack이 추가될 수 있습니다.
브라우저 에이전트 도구를 사이트에 더 자연스럽게 연결하고 싶다면, 지금 단계의 해당 주제는 주목할 만한 출발점입니다.