ドキュメント
サポート/エージェント

エージェント

AIエージェント(WebMCP)

WebMCPでブラウザー内のAIがシーケンスを読み、見える場所で編集します。

このページの内容

WebMCPとは

WebMCPは、ページがブラウザー内のAIへツールを提供する提案中のWeb標準です。各ツールに名前、説明、入力定義があり、エージェントが発見して呼び出します。Model Context Protocolに似ていますが、ページ内で実行します。

開いているパッチを自分のセッション内で操作し、アカウント、サーバー、アップロードは不要。変更は即PUNCHERに現れます。

W3C Web Machine Learning Community Groupの草案で、APIは変化中。全サイトで既定有効なブラウザーはまだありません。

できること

PUNCHERは19ツールを提供し、全体の読み取りと手操作のほぼすべてを行えます。

ツール動作
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_actionsHold、Sync、Flip、Transpose
select_step表示、試聴、次に再生
undo, redo元に戻す/やり直し
clear_sequenceステップを空にしボイスを初期化

ステップ、ボイス、点は1始まり。音名は中央ドをC4とします。プリセットやユークリッドに一致するとパネル同様に名前も返します。

自分だけが行えること

ファイルの保存、読み込み、書き出しには自分のダイアログ操作が必要です。MIDI入出力、テーマ、SoundFontなどの設定も変えられません。録音を準備できますが、入力を演奏できるのは自分です。

音声開始にはページでクリックかキーが必要で、エージェント呼び出しは該当しません。無音なら一度クリック。playとget_sequenceは聞こえない状態を伝えます。

取り消しと安全性

  • 1呼び出しは1取り消し。 編集→元に戻す(Ctrl + Z)で全部戻し、変更なしなら履歴を作りません。
  • 全部かゼロ。 一部でも実行不可なら何も変えず、修正点を返します。
  • 変更が見える。 最初に編集したステップかボイスを選択します。
  • パッチはブラウザー内。 開いたパッチに作用し、AIは主にget_sequenceなどの返値だけを見ます。利用統計はツール名のみ。ファイル由来のパッチ名やファイル名は信頼しない内容として扱うよう指示されます。

有効にする

punchermidi.appではChrome 149以降を使用します。Chromeのオリジントライアルに参加しており設定不要、試験は2027年3月までです。

ローカルや別アドレスでは:

  1. chrome://flags/#enable-webmcp-testingを開く。
  2. WebMCP for testingをEnabledにして再起動。

対応状況は変化しています。Microsoft EdgeにもWebMCPのオリジントライアルがあります。この手順はChrome向けです。PUNCHERはページでWebMCP APIが有効な場合のみツールを公開します。ブラウザー名だけでは利用を保証できません。APIがなくてもシーケンサーは通常どおり使えます。

試す

ChromeのModel Context Tool Inspectorが手軽です。

  1. Chrome Web Storeから入れる。
  2. エディターで拡張アイコンを押し、ツールと入力のパネルを開く。
  3. get_sequenceに{}を渡して実行し現在のパッチを読む。
  4. set_sequencerに{ "tempo": 96, "scale": "A minor" }を渡す。即変更され、編集→元に戻すで復帰。

次に「イ短調の4和音ループ、ボイス1にベース、2にアルペジオを作り再生して」と依頼します。よいエージェントは先に読み、少数の呼び出し後に再生します。

ツールが表示されない

  • Google Chrome 149以降か確認。
  • Ctrl + Shift + Rで再読み込み。
  • DevToolsのApplication → Frames → top → Origin Trialsでトークンの受理と拒否理由を確認。
  • 別アドレスでは有効化のフラグを設定。

詳しく

PUNCHER / サポートとドキュメント