Shipvo

@shipvo/mcp

AI エージェント（Claude、Cursor、Claude Code、PiPilot など）がスマートフォンなしで Shipvo アプリを使えるようにします。アプリを開き、画面をアクセシビリティツリーとして読み取り、タップ、入力、スクロール、戻る操作、スクリーンショットの撮影を行い、アプリがバックエンドに送信した内容を読み取れます。さらに、オーナー API を使ってコンテンツ、価格、オファーを変更し、すべてのスマートフォンに公開できます。

{ "mcpServers": { "shipvo": {
  "command": "npx", "args": ["-y", "@shipvo/mcp"],
  "env": { "PN_SIM": "http://localhost:4545", "PN_OWNER_TOKEN": "…optional…" } } } }

まずシミュレーターを起動してください（アプリ内で shipvo sim を実行します）。ホスト版ではローカルのセットアップは不要です：{ "url": "https://<host>/mcp/<key>" }。

ツール：list_apps、open_app、screen、tap、type、scroll、back、screenshot、set_device、push_notification、notifications、open_notification、device_log、end_session、owner_describe、owner_command。

ネイティブ機能はスマートフォンなしで動作します。シミュレートされたデバイス（@shipvo/device を参照）では、権限ダイアログ、カメラ、指紋認証プロンプト、決済プロンプト、通知バナー、共有シートが、ツリー内に実際のダイアログとして表示されます。set_device では、スマートフォンが備える機能（位置情報、視界内のバーコード、指紋が一致するかどうか、決済が承認されるかどうか、ネットワークがオフかどうか）を設定できます。

シミュレーターには、スマートフォンに表示される内容だけが表示されます。横向きのレールには表示中の項目が並ぶため、エージェントはデバイスと同じように、レールの ref を指定してスワイプします（scroll right）。実際の Android エミュレーターおよび iPhone シミュレーターとの比較結果については、docs/parity-results.md を参照してください。

リモート（Streamable HTTP）

シミュレーターを実行する場所でサーバーを起動し、HTTPS の背後に配置してください（Cloudflare Tunnel で十分です）。

PN_API_KEYS="key-for-claude,key-for-pipilot" shipvo-mcp --http 8787

クライアントはコマンドの代わりに URL で接続します。

{ "mcpServers": { "shipvo": { "url": "https://sim.shipvo.dev/mcp", "headers": { "Authorization": "Bearer key-for-claude" } } } }

各クライアント接続にはそれぞれ独自の MCP セッションが割り当てられ、各 open_app にはそれぞれ独自のスマートフォンが割り当てられます。有効なキーを持たないリクエストは拒否されます。sim.shipvo.dev のホスト版では、アカウントごとにスコープ（test、owner、read）付きのキーが発行されます。