WebMCP — AI 에이전트로 스핀 휠 제어

WebMCP란?

WebMCP(Web Model Context Protocol)는 웹사이트가 구조화되어 호출 가능한 도구를 AI 에이전트에 선언할 수 있게 하는 브라우저 API입니다 — document.modelContext(이전의 navigator.modelContext). 에이전트는 도구의 이름, 설명, 매개변수를 읽은 다음, 스크린샷을 찍어 올바른 픽셀을 클릭하려고 하는 대신 함수처럼 호출합니다.

이는 W3C Web Machine Learning Community Group의 초기 초안입니다. 2026년 하반기 기준 Microsoft Edge에 기본 탑재되어 있으며 Chrome 149–156에서는 오리진 트라이얼로 실행됩니다(2026년 11월 16일까지). 다른 브라우저에서는 지원이 추가될 때까지 통합이 휴면 상태로 유지됩니다.

Spin and Wheel에서의 작동 방식

이 사이트의 모든 스핀 휠과 이름 팩 페이지는 브라우저가 WebMCP를 지원할 때 작은 휠 도구 집합을 등록합니다. 빙고 콜러와 빙고 번호 생성기는 대신 빙고 도구 집합(번호 호출, 되돌리기, 범위 변경, 자동 호출)을 등록하고, 그림 퀴즈 제시어 생성기는 게임 도구 집합(제시어 공개, 정답 처리, 타이머 실행, 점수 기록)을 등록합니다. 이 도구들은 화면에 보이는 바로 그 페이지를 제어합니다: 항목을 설정하면 캔버스가 업데이트되고, 번호를 호출하면 보드에 표시되며, 제시어를 공개하면 탭할 때와 똑같이 카드가 뒤집힙니다.

일반 방문자에게는 아무것도 달라지지 않습니다. WebMCP를 지원하는 에이전트가 없으면 등록은 아무 영향이 없는 작업이 되고 페이지는 다른 페이지와 똑같이 동작합니다.

사용 가능한 도구

도구 집합은 페이지 종류별로 하나씩, 총 세 가지가 있습니다. 도구 이름과 매개변수는 모든 언어에서 동일하며, 아래 설명은 각 도구가 하는 일을 알려줍니다.

휠 도구

위치: 모든 스핀 휠 — 이름 추첨기, 예/아니요, 숫자, 글자, Twister, 음식, 샷 룰렛, 팀 메이커 — 그리고 모든 이름 팩 페이지.

도구	기능	입력
`get_entries`	휠에 있는 현재 항목 목록을 반환합니다.	없음
`set_entries`	모든 항목을 새 목록으로 교체합니다 — 각 문자열이 휠의 한 구획이 됩니다.	`entries: string[]`
`spin_wheel`	휠을 돌리고 무작위로 선택된 당첨자를 반환합니다. 돌리기 전에 새 항목을 설정할 수도 있습니다.	`entries?: string[]`
`get_winner`	가장 최근 당첨자를 반환합니다.	없음

빙고 도구

위치: 빙고 콜러, 빙고 번호 생성기

도구	기능	입력
`get_bingo_state`	게임 상태를 반환합니다: 모드와 범위, 호출된 번호 수와 남은 번호 수, 글자 또는 전통 별칭이 붙은 마지막 호출, 그리고 최근 호출 목록.	없음
`call_bingo_number`	다음 번호를 중복 없이 추첨하여 B-7 또는 “22 — Two little ducks” 형식으로 반환합니다. 휠 또는 볼 애니메이션이 끝날 때까지 기다린 뒤 응답합니다.	없음
`get_called_numbers`	호출된 모든 번호를 호출 순서대로 나열합니다. 아직 드럼에 남아 있는 번호도 나열할 수 있습니다.	`includeRemaining?: boolean`
`undo_last_call`	마지막으로 호출된 번호를 드럼에 다시 넣습니다.	없음
`new_bingo_game`	호출된 번호를 모두 지우고 같은 모드에서 처음부터 다시 시작합니다. 되돌릴 수 없습니다.	없음
`set_bingo_mode`	번호 범위(75볼, 90볼, 1–100, 1–50, 1–30 또는 사용자 지정 범위)를 전환하고 새 게임을 시작합니다.	`mode: us75 \| uk90 \| n100 \| n50 \| n30 \| custom, from?, to?`
`set_auto_call`	핸즈프리 자동 호출을 시작하거나 중지합니다. 번호 생성기는 초 단위 간격도 받을 수 있으며, 휠 콜러는 10초로 고정되어 있습니다.	`enabled: boolean, seconds?: 2–120`

그림 퀴즈 도구

위치: 그림 퀴즈 제시어

도구	기능	입력
`get_pictionary_state`	라운드, 카드 공개 여부, 필터, 제시어 풀 크기, 타이머 상태, 팀과 점수를 반환합니다. 제시어 자체는 공개된 후에만 표시됩니다.	없음
`get_current_word`	카드의 제시어를 반환합니다 — 단, 화면에서 공개된 후에만 가능하므로 에이전트가 미리 훔쳐보고 제시어를 골라낼 수 없습니다.	없음
`reveal_word`	카드를 뒤집어 출제자가 제시어를 볼 수 있게 하고, 난이도와 카테고리와 함께 제시어를 반환합니다.	없음
`next_word`	턴을 끝내지 않고 공개된 제시어를 새로운 숨겨진 제시어로 교체합니다. 타이머 시작 전에만 가능합니다.	없음
`mark_correct`	팀이 정답을 맞혔을 때: 팀 모드에서는 점수를 주고, 턴을 끝내고, 타이머를 초기화한 뒤 다음 숨겨진 제시어를 뽑습니다.	없음
`skip_word`	점수 없이 턴을 끝내고 다음 숨겨진 제시어를 뽑습니다.	없음
`undo_turn`	마지막 정답 또는 건너뛰기를 되돌립니다 — 라운드, 턴, 점수가 복원됩니다. 이전 제시어는 다시 돌아오지 않습니다.	없음
`switch_team`	그리는 팀을 바꿉니다: 다음 팀으로 넘기거나 인덱스로 팀을 지정합니다.	`team?: 0–5`
`rename_team`	팀 이름을 바꿉니다(최대 24자).	`team: 0–5, name: string`
`set_pictionary_filters`	난이도, 카테고리, 대상 연령, 라운드 길이, 팀 모드 또는 소리를 변경합니다. 전달한 필드만 바뀌며, 응답에서 조건에 맞는 제시어 수를 알려줍니다.	`difficulty?: (easy\|medium\|hard)[], categories?: string[], audience?: kids\|family\|adults, timerSeconds?: 10–600, teamMode?, sound?`
`control_timer`	라운드 타이머를 시작, 일시정지, 재개 또는 초기화합니다.	`action: start \| pause \| resume \| reset`
`new_pictionary_game`	새 게임을 시작합니다: 1라운드, 점수 초기화, 새로운 숨겨진 제시어. 따로 말하지 않으면 팀 이름은 유지됩니다.	`keepTeamNames?: boolean`

사용 방법

1. WebMCP를 지원하는 브라우저 사용

Microsoft Edge 147 이상 또는 Chrome 149 이상에서 아무 휠, 빙고 또는 그림 퀴즈 페이지나 엽니다. Chrome은 2026년 11월 16일까지 오리진 트라이얼을 통해 WebMCP를 노출합니다. 로컬 테스트를 위해서는 chrome://flags/#enable-webmcp-testing을 활성화하세요. 이 페이지 상단의 배지가 현재 브라우저가 준비되었는지 알려줍니다.

2. 휠을 열고 에이전트를 준비

휠 페이지를 방문해 브라우저 내 AI 에이전트(브라우저 내장 어시스턴트나 에이전트 확장 프로그램)를 사용하세요. 휠의 도구를 자동으로 찾아냅니다 — 설정, 계정, API 키가 필요 없습니다.

3. 일상 언어로 요청

원하는 것을 에이전트에게 말하세요. 알맞은 도구를 고르고 매개변수를 채우면 휠이 화면에서 반응합니다 — 항목이 업데이트되고, 휠이 돌고, 당첨자를 알려줍니다.

프롬프트 예시

“피자, 스시, 타코를 휠에 넣고 돌려줘.”
“지금 휠에 어떤 항목이 있어?”
“휠을 돌려서 누가 이겼는지 알려줘.”
“다음 빙고 번호를 호출하고 그 별칭을 알려줘.”
“그림 퀴즈 제시어를 공개하고, 그다음 타이머를 시작해줘.”

개인정보 보호

WebMCP 도구는 전적으로 브라우저 안에서 실행됩니다. 열려 있는 페이지의 휠만 읽고 변경합니다 — 어떤 서버로도 데이터가 전송되지 않으며, 통합으로 추가 추적이 더해지지 않습니다. 이 휠에는 백엔드가 없습니다.

휠에서 사용해 보기

이름 휠을 열고 에이전트가 돌려보게 하세요.

휠 열기

WebMCP — AI 에이전트로 휠 제어하기