MCP サーバーを有効にする
Settings → MCP を開き、ローカル MCP サーバーを有効にします。待ち受けるのは http://127.0.0.1:<port>/mcp だけです。
ワンクリックで Claude Code のプラグインと MCP ツールが入ります。Claude デスクトップアプリでは、Codex のパネルと同じように、会話の横のブラウザペインにスマホのライブ画面が開きます。StupidMirror はモデルを内蔵しておらず、モデルの API キーも不要です。

Settings → MCP Automation の Connect Claude Code で、プラグインと MCP ツールがワンクリックで入ります。Codex は Connect Codex で同じように設定できます。インストール済みの部分はスキップされます。ほかの MCP クライアントは生成された設定を使います。
Settings → MCP を開き、ローカル MCP サーバーを有効にします。待ち受けるのは http://127.0.0.1:<port>/mcp だけです。
Connect Claude Code(または Connect Codex)でワンクリック接続できます。ほかの MCP クライアントは Advanced connection settings · Other AI clients を開きます。
Claude デスクトップアプリの Code タブで新しいローカルセッションを開きます。Claude ははじめてデバイスを扱うとき、ブラウザペインにライブビューアを自分で開きます。映像、デバイスの切り替え、手動操作は Codex のパネルと同じです。Claude アプリをゲートウェイ経由で使っている場合も同様です。ターミナルでは、ビューアのリンクを Claude に聞いてください。手動で設定するクライアントは、エンドポイント、Bearer 認証、240 秒のツールタイムアウトを含む生成済みの設定をコピーします。
StupidMirror を開いたまま、「接続中のデバイスを一覧にして、iPhone のミラーリングを始めて。タップはせずに、押せる要素をハイライトして。」と試してください。
list_devices、show_screen、connect_control で対象を見つけ、必要なセッションを準備します。
observe_screen と find_any_element がライブ画面をローカル OCR で読み取り、必要なときだけアクセシビリティ情報を取得します。
tap_text、tap_element、replace_text、swipe で、観察した内容や指定したジェスチャを実行します。
wait_for、assert_screen、observe_screen で実機の結果を確かめます。
highlight_clickable_elements と highlight_elements は Mac のミラー上に対象を描くだけで、入力は送りません。
install_app で .app、.ipa、.apk をインストールし、open_url でディープリンクを開きます。start_recording はミラーを最長 10 分の .mp4 に保存します。
キャプチャ、再生、OCR はこの Mac で行われ、StupidMirror がミラーの内容を自らモデル提供元へアップロードすることはありません。MCP でつないだ AI クライアントは、要求したスクリーンショットとツールの結果を受け取り、その後の扱いはクライアントのデータ設定に従います。Bearer トークンをローテーションすると、以前の認証情報は使えなくなります。
不要です。StupidMirror はモデルを内蔵していません。モデルは MCP クライアント側のものを使い、StupidMirror はデバイスを扱うツールを提供します。
Claude Code と Codex は、ワンクリックでプラグインと MCP ツールが入ります。ほかの MCP クライアントは、Bearer 認証を含む生成済みの設定で接続できます。
Claude デスクトップアプリの Code タブにあるブラウザペインに、この Mac が配信するページとして表示されます。Claude はプロジェクトの .claude/launch.json に stupidmirror-viewer を追加して開きます。注釈は Codex の機能です。Claude ではブラウザペインで要素を選ぶか、スクリーンショットを添付してください。
初回のコントロールの準備に時間がかかることがあるため、生成される設定ではツールのタイムアウトを 240 秒にしています。
device_id を渡します。先に list_devices を呼ぶと識別子がわかります。
入力欄にフォーカスしたら、そのまま replace_text か clear_text を使い、追記には type_text を使います。アクセシビリティのスナップショットはフォーカス中の入力欄を乱すことがあり、置き換えでは結果の値を検証します。
Apple Vision OCR は標準で中国語と英語を読み取り、高速と高精度の 2 つのモードがあります。キャプチャの経路とは別に、必要なときだけ動きます。