Claude Code をつなぐ、
ターミナルのコマンド 1 つとブラウザでのサインイン 1 回。その後 Claude Code は、スマートフォンがたった今キャプチャした通信を読み、シークレットを伏せたままログインフローを説明し、端末に対して操作を実行できます。すべてのツールはあなたのロールに制限され、リスクのある操作はすべて確認ゲートの先にあります。
Busymate はダッシュボード全体、つまり端末、キャプチャした通信、設定、ルール、エクスポート、スマートフォンファームをカバーする 454 個のツールを、単一ホスト名の MCP サーバーとして公開しています。Claude Code は HTTP 上の MCP をネイティブに話すので、接続はコマンド 1 つです。認証は標準の OAuth 2.1 で、クライアントが自身を登録し、ブラウザを開き、普段の Busymate アカウントでサインインして一度承認すると、得られたトークンをすべてのツール呼び出しが携えます。作成・貼り付け・ローテーションが必要な API キーは存在しません。
このガイドは接続を最初から最後まで通して説明し、その後、最初に成果が出る 3 種類のプロンプト、すなわちライブフィードを読む、キャプチャした API フローを説明させる、端末に対して操作するを紹介します。ブラウザへの往復を 1 回省ける唯一のメンテナンス習慣、サーバー更新後は再接続するだけで再認可しない、も扱います。
必要な
あなたのマシン上の Claude Code、Busymate アカウント、そして尋ねる対象として、通信をキャプチャ済みの端末。
インストール済みの Claude Code と、そのコマンドを実行するターミナル。
ブラウザでサインインできる Busymate アカウント。ダッシュボードで使うものと同じです。
最近の通信があるペアリング済み端末が最低 1 台。iPhone、Android、プロキシのクライアント、キャプチャ中の Chrome のいずれか。iPhone ガイドが最短の道です。
使う予定の権限を持つロール。読み取りには閲覧アクセスが、リクエストの再送や端末設定の変更などの操作には、自分が所有する端末への編集アクセスが必要です。
順番どおりに
接続に 2 ステップ、確認に 1 ステップ、価値を引き出すのに 3 ステップ、健全に保つのに 1 ステップ。
- 01
ターミナルからサーバーを追加する
以下のコマンドを実行します。HTTP トランスポートと正規のエンドポイントを使い、Busymate を Claude Code のリモート MCP サーバーとして登録します。コマンドにはほかに何も要りません。トークンもヘッダーもクライアント ID も不要です。ツール検出は認証前に提供されるので、Claude Code はサーバーが提供するものをすぐに一覧できます。
唯一のコマンド bash# Claude Code — add the server, then authorize in your browser on the first tool call claude mcp add --transport http busymate-devtools https://mcp.busymate.dev - 02
最初のツール呼び出しでブラウザから認可する
ツールが必要な依頼を Claude Code にすると OAuth フローが始まります。クライアントがサーバーに登録し、PKCE チャレンジ付きで Busymate 自身のサインインページをブラウザで開き、あなたがサインインして承認すると、ブラウザがワンタイムコードをクライアントに返し、クライアントはそれをアクセストークンと交換します。Claude Code が接続を確認します。これらを手動で行うことはなく、サインインページを見るのは一度だけです。
このトークンはダッシュボード内蔵コンソールが使うものと同じ種類で、MCP だけでなくすべての Busymate サービスを認証します。接続する各クライアントはあなたのアカウントに対して個別の許可を得ます。個別に取り消せ、すべてあなたの単一ロールのもとで動作し、すべて監査ログに残ります。
- 03
読み取り専用の質問で確認する
読むだけのことから始めましょう。どの端末がオンラインで、そのうち 1 台が最近何をキャプチャしたか、あるいは直近 1 時間にどのホストが特定のステータスを返したかを尋ねます。Claude Code は適切なツールを選び、答えは推測ではなく、端末名、ホスト、パス、ステータスといったあなたの実データから返ってきます。
接続を証明する最初の 2 つのプロンプト textWhich of my devices are online right now, and what did the iPhone capture in the last 10 minutes? Across all my devices, which hosts returned 401 in the last hour? - 04
キャプチャした API フローを説明させる
この接続はこのプロンプトのために存在します。スマートフォンからキャプチャしたホストを、ブランド名だけでなくドット付きの完全なホスト名で指定し、アプリがどう認証しているか尋ねてください。Claude Code は実際のリクエストとレスポンスのヘッダーとボディを読み、フローを再構築し、実行可能な再現コードを書けます。キャプチャした通信内のトークン、Cookie、認証情報はシークレットとして扱われ、返されるすべての内容でプレースホルダーに置き換えられます。
スマートフォンがたった今行ったログインフローを説明させる textLook at the captured traffic for identity.example.com and tell me exactly how the app authenticates — the endpoint, the headers it needs, and the request body shape. Then write a curl command that reproduces the login call. - 05
操作させる、ただし確認ゲートの先で
何かを変更するツール、つまりリクエストの再送、端末の VPN の切り替え、別の国の上流プロキシ経由への通信ルーティング、ブロックルールの編集などは、サーバー側で確認ゲートがかかります。Claude Code は実行しようとしている内容を提示し、あなたの承諾を待ちます。すべてはあなたとして実行され、ロールの権限と所有する端末に制限されるので、クライアントがダッシュボードであなたにできる以上のことをすることはありません。
操作プロンプト。書き込みはすべて実行前に確認します textResend the last failed checkout request from my iPhone, then route that phone through a proxy in Germany and confirm its public IP changed. - 06
シリーズの他のガイドと組み合わせる
他のガイドが手作業で行うことは、ここでは一文で済みます。今日のあるホストの HAR エクスポート、ログインエンドポイントでの一回限りの 401 モック、現在のブレークポイントパターン、ファーム内の全端末のスクリーンショットを頼んでください。Claude Code が言葉をツールに対応づけ、同じロールと確認のルールが適用されます。
- 07
サーバー更新後は再接続する。再認可はしない
サーバーは頻繁に再デプロイされ、新しいツールが追加されます。デプロイ前に接続したクライアントは古いツール一覧を保持していることがあり、ツールが見当たらなかったり説明が古かったりします。サーバーが変更を通知するため多くのクライアントは自動で追従しますが、そうでなければ Claude Code のセッションを再起動してください。サインアウトやサーバーの削除はしないでください。トークンはデプロイをまたいで有効で、再同意はブラウザへの往復を 1 回増やすだけです。クリーンに追加し直したい場合は、先にエントリを削除してから再追加してください。許可は残るので、再びサインインを求められることはありません。
クリーンな再追加でも既存の許可は保持されます bashclaude mcp remove busymate-devtools claude mcp add --transport http busymate-devtools https://mcp.busymate.dev
うまくいかない
どれも障害のように見えますが、プロトコルが仕様どおりに動いているだけです。
エンドポイントをブラウザで開くと 401 が返る
それが仕様です。素のリクエストには、サインインフローの場所をクライアントに伝える OAuth チャレンジ付きの 401 が返ります。MCP クライアントはそのチャレンジから自動で続行します。何も止まっていません。
ブラウザウィンドウが開かなかった
Claude Code は認可 URL も出力します。任意のブラウザにコピーしてください。フローは通常のウェブサインインで、完了するとクライアントに制御が戻ります。
ツールは一覧されるが、すべての呼び出しが拒否される
検出は認証前に提供されますが、何かを呼び出すには OAuth の許可が必要です。クライアントが開始したブラウザ認可を完了するか、トークンが取り消されている場合は再度実行してから、やり直してください。
ドキュメントにあるツールが見当たらない
デプロイ後の古いツール一覧です。セッションを再起動してクライアントに再検出させてください。それでも見当たらなければ、そのツールを保護する権限がロールにないのかもしれません。
見えている端末への操作が拒否された
操作は自分が所有する端末とロールの編集権限に制限されます。ワークスペース管理者に権限の付与を依頼するか、自分の端末で操作を実行してください。
よくある
どこかに保管しておくべき API キーはありますか？
ありません。アクセスはあなたのアカウントとそのクライアントに紐づく OAuth の許可です。マシンを紛失したらダッシュボードから取り消してください。ローテーションが必要なものはありません。
Cursor、VS Code、Claude Desktop でも同じように動きますか？
はい。HTTP トランスポートと動的クライアント登録付き OAuth 2.1 を話すクライアントなら、同じエンドポイントに接続できます。インストールページにはそれぞれ向けのコピー用設定とワンクリックリンクがあります。
通信内のトークンを漏らす可能性はありますか？
キャプチャした認証情報は説明と再現スニペットの中で伏せられ、読み取りはロールと端末に制限され、書き込みは確認ゲート付きです。生の HAR エクスポートは機密として扱ってください。エージェントの回答はそうではありません。