WebMCP

Alexandra Klepper

François Beaufort

Kasper Kulikowski

게시일: 2026년 5월 18일, 최종 업데이트: 2026년 10월 7일

WebMCP는 AI 에이전트를 위한 구조화된 도구를 빌드하고 노출하는 데 도움이 되는 제안된 웹 표준입니다. WebMCP는 JavaScript를 제공하고 HTML 양식 요소에 주석을 달아 에이전트가 페이지 기능과 상호작용하는 방식을 정확히 파악하여 사용자 환경을 지원합니다. 이렇게 하면 에이전트 작동의 성능과 안정성이 크게 향상될 수 있습니다.

AI 에이전트는 새로운 기술입니다. 복잡하고 기술적인 작업을 더 잘 완료하도록 도울 수 있습니다 WebMCP는 에이전트 작업 완료의 정확성을 높여주며 점진적 개선으로 추가할 수 있습니다.

설명하듯이	웹	확장 프로그램	Chrome 상태	의도
GitHub	오리진 트라이얼		View	실험 의도

WebMCP를 사용하는 이유

WebMCP는 웹 애플리케이션과 에이전트 간의 격차를 해소하는 상호작용 규칙을 제공하여 효율성, 안정성, 작업 완료율을 개선합니다. 에이전트가 버튼이나 필드와 같은 요소를 검토하여 목적을 파악하는 대신 웹사이트에서 요소의 목적을 선언하므로 의도한 대로 사용됩니다.

이는 여러 단계가 있을 수 있고 각 단계를 에이전트가 해석할 수 있는 작동보다 더 안정적입니다.

웹사이트는 tool를 정의하여 검색 또는 구매와 같은 명시적인 목적을 공유할 수 있습니다. 도구는 웹페이지에서 시각적으로 실행되므로 사용자는 작업이 예상대로 완료되었다는 신뢰를 얻을 수 있습니다. 또한 브랜드와 인간 중심 디자인 선택을 그대로 유지합니다.

WebMCP는 다음을 지원합니다.

• 탐색: 페이지가 checkout 또는 filter_results와 같은 에이전트에 도구를 등록하는 표준 방법입니다.
• JSON 스키마: 입력 및 예상 출력의 명시적 정의로, 할루시네이션이나 오해를 줄입니다.
• 상태: 현재 페이지 컨텍스트에 대한 공유된 이해로, 에이전트가 실시간으로 작업할 수 있는 리소스를 파악할 수 있습니다.

Google의 목표는 에이전트 기능이 있는 모든 브라우저에서 구현하고 활용할 수 있는 API를 빌드하여 사용자가 더 쉽게 작업을 완료할 수 있도록 하는 것입니다. GitHub에서 이 프로세스를 따라 진행할 수 있습니다.

사용 사례

WebMCP를 사용하는 방법은 다양합니다. 예를 들면 다음과 같습니다.

• 고객이 지원을 받도록 돕습니다. 고객에게 소프트웨어를 제공하는 경우 다양한 질문에 대응하기 위해 복잡한 지원 흐름이 있을 수 있습니다. WebMCP를 사용하면 상담사가 적절한 양식으로 더 빠르게 이동하고 사용자가 제공한 정보로 필드를 채울 수 있습니다.
• 여행 예약 개선 상담사가 복잡한 다구간 및 다인원 여행을 더 적은 단계로 예약할 수 있도록 지원합니다.

구매와 같은 일부 작업은 민감할 수 있습니다. 확인 대화상자를 통해 사용자 상호작용을 요청하는 명령어를 포함할 수 있습니다.

실제로는 도구로 다음 작업을 수행할 수 있습니다.

• 구조화된 양식 작성: 상담사가 사용자와의 대화에서 수집한 데이터를 양식 필드에 올바르게 매핑하는 데 도움이 되는 submit_application 도구를 빌드합니다. 예를 들어 필드에 성명이 필요한지 아니면 성과 이름이 별도로 필요한지 구분할 수 있습니다.
• 인간 우선 인터페이스에서 상담사 상호작용 지원: 특정 필드는 인간 사용자를 위해 설계되었지만 에이전트가 이해하지 못할 수 있습니다. 예약 또는 이벤트 예약에서 복잡한 날짜 및 시간 선택을 허용하는 date_pick 도구를 빌드할 수 있습니다.
• 더 빠른 애플리케이션 디버깅: 개발자 설정 페이지에서 run_diagnostics 도구를 빌드할 수 있으므로 에이전트가 중첩된 메뉴 뒤에 숨겨진 수정사항을 트리거할 수 있습니다.

사용 사례가 누락되었나요? 아니면 WebMCP에 공유하고 싶은 아이디어가 있으신가요? GitHub에서 질문을 제기하고 토론에 참여하세요.

시작하기

Chrome 149에서 WebMCP 오리진 트라이얼에 참여하세요. 오리진 트라이얼을 시작하는 방법을 자세히 알아보세요.

로컬 WebMCP

WebMCP는 로컬 개발을 위한 Chrome 플래그로 사용할 수 있습니다.

1. Chrome을 열고 chrome://flags/#enable-webmcp-testing으로 이동합니다.
2. 플래그를 Enabled로 설정합니다.
3. Chrome을 다시 실행하여 변경사항을 적용합니다.

WebMCP API 사용

웹사이트 도구를 설정하는 데 사용할 수 있는 API는 두 가지입니다.

• 명령형 API: 양식 입력, 탐색 도구, 상태 관리 또는 기타 함수와 같은 표준 JavaScript를 사용하여 다양한 유형의 도구를 정의합니다.
• 선언적 API: 표준 HTML 양식에 주석을 추가하여 WebMCP 도구를 만듭니다.

Chrome DevTools를 사용하여 WebMCP 도구를 디버그하고 브라우저가 JSON 스키마를 파싱하는 방식을 검증할 수 있습니다.

제한사항

WebMCP는 에이전트와 인간이 복잡한 작업을 더 간단하게 수행할 수 있도록 하는 것을 목표로 하지만 다음과 같은 제한사항이 있습니다.

• 헤드리스 탐색: 헤드리스 환경에서 WebMCP 도구를 실행할 수 있지만 이 API는 주로 휴먼인더루프가 있는 로컬 브라우저 워크플로를 위해 설계되었습니다.
• 복잡한 인터페이스의 오버헤드: 사이트가 매우 복잡한 경우 애플리케이션 및 인터페이스 상태를 처리하기 위해 자바스크립트를 리팩터링하거나 추가해야 할 수 있습니다.
• 도구 검색 가능성: 클라이언트와 브라우저는 사이트를 직접 방문해야 호출 가능한 도구가 있는지 알 수 있습니다.

권한 정책

두 API 모두 tools 권한 정책에 의해 제어됩니다. 정책은 기본적으로 self로 설정되어 최상위 및 동일 출처 컨텍스트에서 도구 등록을 허용하고 교차 출처 iframe의 경우 사용 중지합니다.

교차 출처 iframe에서 WebMCP 도구를 허용하려면 iframe에 allow="tools" 속성을 추가하세요.

데모

명령형 및 선언적 구현을 모두 다루는 데모의 예는 다음과 같습니다.

• WebMCP zaMaker는 WebMCP Imperative API를 사용합니다.
• 여행 데모(React)는 WebMCP Imperative API를 사용합니다.
• Le Petit Bistro 데모는 WebMCP 선언적 API를 사용합니다.

GitHub에서 데모 소스 코드를 검토하고 살펴볼 수도 있습니다.

에이전트를 모방하여 도구 테스트

Google은 데모 및 애플리케이션에서 WebMCP 도구가 어떻게 작동하는지 확인할 수 있도록 두 가지 Chrome 확장 프로그램을 빌드했습니다.

에이전트 Chrome 확장 프로그램 예시를 설치하여 자연어 프롬프트로 WebMCP 도구를 검사, 모니터링, 실행합니다. 특히 이 확장 프로그램은 항상 WebMCP 주석을 신뢰하므로 에이전트에게 민감한 작업을 알릴 수 있습니다. 이는 주석에 따라 도구가 다르게 작동할 수 있음을 보여줍니다.

기본적으로 이 확장 프로그램은 AI SDK가 포함된 소형 Node 서버를 사용합니다. API 키가 필요하며 로컬 서버에 유지됩니다. 프롬프트는 기본적으로 gemini-3.6-flash 모델로 전송되지만 확장 프로그램의 .env 파일에서 모델 선택 및 API 제공업체를 수정할 수 있습니다. OpenAI, Google, Anthropic의 필드가 있으며, 다른 제공업체의 모델을 사용하도록 확장 프로그램을 맞춤설정할 수도 있습니다.

또는 Prompt API와 함께 클라이언트 측 모델을 사용할 수 있습니다. 이 경우 API 키가 필요하지 않으며 데이터가 기기에 유지됩니다. 이렇게 하려면 chrome://flags/#prompt-api-tool-use를 사용 설정합니다.

Model Context Tool Inspector 확장 프로그램을 설치하여 에이전트를 실험하고 실시간 데모 또는 자체 애플리케이션에서 WebMCP 도구가 어떻게 작동하는지 확인합니다. 자연어 프롬프트를 사용하여 에이전트가 WebMCP 도구와 예상대로 상호작용하는지 확인합니다.

Gemini를 사용하여 도구를 호출하려면 확장 프로그램 인터페이스에서 제공하는 API 키가 있어야 합니다. 프롬프트는 기본적으로 gemini-3.6-flash 모델로 전송됩니다. 다른 Gemini 모델을 선택하여 실험하거나 확장 프로그램 코드를 맞춤설정하여 다른 제공업체의 모델을 사용할 수 있습니다.

참여 및 의견 공유

WebMCP는 현재 활발히 논의 중이며 향후 변경될 수 있습니다. 이러한 API를 사용해 보고 의견이 있으면 알려주세요.

• WebMCP 오리진 트라이얼에 참여하고 Chrome 상태에서 Chrome 구현을 따르세요.
• WebMCP 설명서를 읽고 질문을 제기하고 토론에 참여하세요.
• WebMCP 권장사항을 읽어보세요.
• WebMCP 도구 보안 가이드 및 권장사항을 읽어보세요.
• Chrome 구현에 관한 의견이 있으면 Chromium 버그를 신고해 주세요.