WebMCP란
WebMCP는 페이지가 브라우저에서 실행되는 AI 에이전트에게 도구를 제공할 수 있게 하는 웹 표준 제안입니다. 각 도구에는 이름, 설명, 받는 입력에 대한 설명이 있습니다. 에이전트는 페이지의 도구를 찾아 호출하며, Model Context Protocol로 도구를 호출하는 것과 비슷하지만 도구가 페이지 안에서 직접 실행된다는 점이 다릅니다.
즉 에이전트는 여러분이 보는 것, 곧 여러분의 세션에서 열려 있는 패치 위에서 작업하며, 계정, 서버, 업로드가 필요 없습니다. 에이전트가 바꾸는 모든 것은 바뀌는 즉시 PUNCHER에 나타납니다.
WebMCP는 W3C Web Machine Learning Community Group의 초안입니다. API는 아직 바뀌는 중이며, 모든 사이트에 대해 이를 켜 주는 브라우저는 아직 없습니다.
에이전트가 할 수 있는 일
PUNCHER는 열아홉 가지 도구를 제공합니다. 에이전트는 이 도구로 시퀀스 전체를 읽고, 손으로 바꿀 수 있는 거의 모든 것을 바꿀 수 있습니다.
| 도구 | 하는 일 |
|---|---|
get_sequence | 설정, 보이스와 패턴, 내용이 있는 모든 스텝, 모듈레이션, 트랜스포트, 선택 항목까지 전부 읽습니다 |
set_steps | 원하는 만큼의 스텝에 노트, 조옮김, 쉼표와 건너뛰기, 점프, CC 엔벨로프를 설정합니다 |
set_voices | 보이스의 설정, 패턴, 도트의 옵션을 설정합니다 |
list_rhythm_presets | 보이스의 프리셋 패널에 있는 이름 붙은 리듬을 그룹, 레이트, 도트와 함께 나열합니다 |
apply_rhythm_preset | 프리셋 패널에서 고를 때처럼 이름 붙은 리듬을 보이스에 적용합니다 |
set_euclidean | 패널의 히트, 길이, 회전처럼, 히트 개수를 패턴 위에 최대한 고르게 펼친 다음 돌립니다 |
transform_pattern | 패널의 편집 바가 하는 일, 즉 뒤집기, 반전, 미러, 두 배, 절반, 랜덤, 지우기, 채우기를 합니다 |
set_sequencer | 템포, 스텝 수, 레이트, 방향, 루프, 스케일 등 시퀀서의 나머지 설정을 바꿉니다 |
set_modulations | 기어처럼 설정을 CC에 묶어, 스텝 엔벨로프가 그 설정을 모듈레이션하게 합니다 |
step_menu | 스텝을 마우스 오른쪽 버튼으로 클릭하면 나오는 복사, 붙여넣기, 앞이나 뒤에 삽입, 지우기, 삭제를 합니다 |
play, pause, stop | 트랜스포트 |
set_recording | 녹음 버튼과 녹음이 들어가는 스텝 |
set_actions | 홀드, 싱크, 플립, 조옮김 |
select_step | 스텝을 클릭할 때 일어나는 일, 즉 스텝을 보여 주거나, 소리를 내거나, 다음에 재생하도록 합니다 |
undo, redo | 편집 → 실행 취소와 다시 실행 |
clear_sequence | 스텝을 비우고 보이스를 초기화합니다 |
스텝, 보이스, 도트는 PUNCHER가 보여 주는 대로 1부터 번호가 매겨집니다. 노트는 이름으로 표기하며 C4가 가운데 도입니다. 보이스의 도트가 프리셋이나 유클리드 리듬일 때는 프리셋 패널처럼 도구가 그 옆에 어느 쪽인지 알려 줍니다.
여러분의 몫으로 남는 것
에이전트는 파일을 저장하거나 열거나 내보낼 수 없습니다. 파일 대화 상자에서 여러분의 클릭이 필요하기 때문입니다. 설정, 즉 MIDI 출력과 입력, 테마, SoundFont도 바꿀 수 없습니다. 녹음을 시작할 수는 있지만, 그 안으로 연주해 넣는 것은 여러분만 할 수 있습니다.
브라우저는 또한 페이지에서 클릭하거나 키를 누른 뒤에야 오디오를 시작하며, 에이전트의 호출은 이에 해당하지 않습니다. 내장 신스에서 소리가 나지 않으면 PUNCHER의 아무 곳이나 한 번 클릭하세요. play와 get_sequence는 아무것도 들리지 않을 상황이면 에이전트에게 알려 줍니다.
실행 취소와 안전
- 모든 요청은 한 번의 실행 취소 단계입니다. 한 번의 호출이 얼마나 많이 바꾸든 편집 → 실행 취소(Ctrl + Z)로 한 번에 되돌릴 수 있습니다. 아무것도 바꾸지 않은 호출은 기록을 남기지 않습니다.
- 전부 아니면 전무. 요청의 일부라도 처리할 수 없으면 아무것도 바뀌지 않고, 에이전트는 무엇을 고쳐야 하는지 전달받습니다.
- 바뀌는 모습이 보입니다. 에이전트가 처음 편집하는 스텝이나 보이스가 선택되므로 변경 내용이 화면에 보입니다.
- 패치는 브라우저에 남습니다. 도구는 페이지에 열려 있는 패치에서 동작합니다. 에이전트는 호출이 돌려주는 것, 주로
get_sequence를 통해서만 내용을 보며, PUNCHER의 사용 통계에는 어떤 도구가 호출되었는지만 기록됩니다. 패치와 파일 이름은 열어 본 어떤 파일에서든 올 수 있으므로, 에이전트에게는 이를 신뢰할 수 없는 콘텐츠로 다루라고 알려 줍니다.
켜는 방법
punchermidi.app에서는 Chrome 149 이상을 사용하세요. PUNCHER는 Chrome의 WebMCP 오리진 트라이얼에 참여하고 있어, 이 사이트에서는 따로 설정하지 않아도 API가 켜집니다. 트라이얼은 2027년 3월까지 진행됩니다.
PUNCHER를 자신의 컴퓨터나 다른 주소에서 실행한다면 대신 Chrome의 테스트용 플래그가 필요합니다.
chrome://flags/#enable-webmcp-testing을 여세요.- WebMCP for testing을 Enabled로 설정하고 Chrome을 다시 시작하세요.
브라우저 지원은 변하고 있으며 Microsoft Edge도 WebMCP 원본 평가판을 제공합니다. 위 설정은 Chrome용입니다. PUNCHER는 페이지에서 WebMCP API가 활성화된 경우에만 도구를 제공합니다. 브라우저 이름만으로 사용 가능 여부를 보장할 수 없습니다. API가 없어도 시퀀서는 정상 작동합니다.
직접 해 보기
도구를 가장 빨리 확인하는 방법은 Chrome의 Model Context Tool Inspector 확장 프로그램입니다.
- Chrome 웹 스토어에서 설치하세요.
- 에디터를 열고 확장 프로그램 아이콘을 클릭해 사이드 패널을 여세요. PUNCHER의 도구가 각각 받는 입력과 함께 나열됩니다.
get_sequence를 고르고{}를 입력해 실행하세요. 현재 패치가 돌아옵니다.set_sequencer를 고르고{ "tempo": 96, "scale": "A minor" }를 실행하세요. 그리드 위 시퀀서의 설정이 즉시 따라 바뀌며, 편집 → 실행 취소로 되돌릴 수 있습니다.
그런 다음 에이전트에게 음악적인 것을 부탁해 보세요. 예를 들어 "A 마이너로 네 코드 루프를 만들고, 보이스 1에는 베이스, 보이스 2에는 아르페지오를 넣은 다음 재생해 줘." 같은 식입니다. 좋은 에이전트는 먼저 시퀀스를 읽고, 몇 번 호출한 다음 결과를 재생합니다.
도구가 나타나지 않는다면
- 다른 브라우저가 아니라 Google Chrome 149 이상을 쓰고 있는지 확인하세요.
- Ctrl + Shift + R로 에디터를 새로 고침하세요.
- DevTools에서 Application → Frames → top을 여세요. Origin Trials 아래에 Chrome이 PUNCHER의 WebMCP 토큰을 받아들였는지, 아니라면 이유가 무엇인지 표시됩니다.
- punchermidi.app이 아닌 곳, 자신의 컴퓨터를 포함해, 켜는 방법에 설명된 플래그를 켜세요.
더 알아보기
- WebMCP 사양, W3C Web Machine Learning Community Group의 초안
- GitHub의 WebMCP, 설명서, 이슈, 제안이 있습니다
- WebMCP 얼리 프리뷰, Chrome의 발표와 문서 및 데모 신청
- 오리진 트라이얼, Chrome이 실제 사이트에서 새 기능을 시험하는 방법
- Model Context Tool Inspector, 확장 프로그램의 소스와 사용 안내
- Model Context Protocol, WebMCP의 모델이 된 프로토콜