Pick
Cursor と VS Code はワンクリック。ほかは同じ URL を貼って初回に認可するだけ。
Claude Code
ターミナルからサーバーを追加。最初のツール呼び出しでブラウザが開き、認可できます。
- 01
以下のコマンドをターミナルで実行してください — デフォルトではこのプロジェクトにのみ追加されます。すべてのプロジェクトで使えるようにするには
--scope userを付けてください。 - 02
最初のツール呼び出しでブラウザが開き、サインインして承認するよう求められます。承認すると、Claude Code が接続を確認します。
# Claude Code — add the server, then authorize in your browser:
claude mcp add --transport http busymate-devtools https://mcp.busymate.dev確認:claude mcp list（または Claude Code 内で /mcp）を実行してください — busymate-devtools が接続済みと表示され、454 個のツールすべてが呼び出し可能になります。
Claude.ai & Claude Desktop
Settings → Connectors → Add custom connector で URL を貼り付け、Connect をクリックしてブラウザで認可。編集するファイルはありません。
- 01
設定 → コネクタを開き、+ をクリックしてカスタムコネクタを追加を選びます。
- 02
以下の URL をリモートサーバー URL として貼り付け、Add をクリックしてください — OAuth Client ID/Secret 欄は空のままで構いません。Busymate では不要です。
- 03
Claude がブラウザを開いてサインインを求めます — 承認すると、コネクタが接続済みと表示されます。
https://mcp.busymate.dev確認:コネクタを再度開くと、454 個のツールがすべて一覧表示され、Claude は会話の途中でもそれらを呼び出せます。
Cursor
ワンクリックで追加し、OAuth で認可。手動で ~/.cursor/mcp.json（グローバル）またはプロジェクトの .cursor/mcp.json に追加することもできます：
- 01
ワンクリックでインストールするにはAdd to Cursorをクリックしてください。または以下のブロックを手動で
~/.cursor/mcp.json（グローバル）またはプロジェクトの.cursor/mcp.jsonに追加してください。 - 02
Cursor Settings → MCP を開き、まだ有効になっていなければサーバーを有効にしてください。
- 03
最初のツール呼び出しで承認のためブラウザが開きます — OAuth のやり取りは Cursor 自身が完了させるため、client ID や secret を貼り付ける必要はありません。
{
"mcpServers": {
"busymate-devtools": {
"url": "https://mcp.busymate.dev"
}
}
}確認:Cursor Settings → MCP に busymate-devtools が有効として表示され、隣にツール数が示されます。
VS Code (Copilot)
ワンクリックで VS Code にインストール。手動でワークスペースの .vscode/mcp.json に追加することもできます（ルートキーは servers）：
- 01
ワンクリックでインストールするにはInstall in VS Codeをクリックしてください。または以下のブロックをワークスペースの
.vscode/mcp.jsonに追加するか、すべてのワークスペースに追加するにはMCP: Open User Configurationを実行してください。 - 02
初回、VS Code はサーバーを信頼するか確認します — 承認し、エントリ上部の code lens にあるStartをクリックしてください（またはコマンドパレットからMCP: List Serversを実行）。
- 03
VS Code が OAuth のやり取りのためブラウザを開きます — サインインして承認してください。
{
"servers": {
"busymate-devtools": {
"type": "http",
"url": "https://mcp.busymate.dev"
}
}
}確認:コマンドパレットからMCP: List Serversを実行してください — busymate-devtools がRunningと表示され、454 個のツールすべてが一覧表示されます。
ChatGPT
開発者モードのコネクターが使える環境では：Settings → Connectors → Add で URL を貼り付けて認可。利用可否はプランによります。
- 01
デベロッパーモードのコネクタを有効にします — ChatGPT の設定でDeveloper modeまたはConnectorsを検索してください（メニューの正確な位置は以前変更されています。Plus、Pro、Business 以上のプランが必要で、ワークスペース管理者が制限できます）。
- 02
カスタムコネクタを追加し、以下の URL を貼り付けてください。
- 03
開いたブラウザタブで承認してください。
https://mcp.busymate.dev確認:コネクタが接続済みと表示されます。ChatGPT に Busymate DevTools のツールを使うよう依頼すると、エラーなく呼び出せるはずです。
その他の MCP クライアント
Streamable-HTTP トランスポートは標準仕様——Continue、Cline、Zed、自作ボットも同じ設定を使います。この URL に向けてください：
- 01
お使いのクライアントが Streamable HTTP トランスポート（stdio のみではなく）に対応し、Dynamic Client Registration を用いた OAuth 2.1 をサポートしていることを確認してください — 現行のほとんどのクライアントは対応しています。
- 02
お使いのクライアントが期待する設定形式で、以下の URL を指定してください — このブロックは、多くのクライアントが直接読み取れる一般的な
mcpServers形式です。 - 03
初回利用時にブラウザのプロンプトで承認してください。上記のどのクライアントでも同じです。
{
"mcpServers": {
"busymate-devtools": {
"url": "https://mcp.busymate.dev"
}
}
}確認:承認が完了すると、tools/list の呼び出しで 454 個のツールすべてが返されます。
What happens on
The whole OAuth 2.1 flow, demystified — four steps, all standard, no console to visit first.
- 01
Your client registers itself
Dynamic Client Registration (RFC 7591): the client POSTs its own metadata and receives a client id. There's nothing to create in a console first.
- 02
You authorize in the browser
A browser window opens on Busymate's own sign-in. You approve once; PKCE protects the code exchange end to end.
- 03
Tools appear
The client lists the tools and your agent starts calling them — as you, scoped to your role, with destructive tools confirm-gated.
- 04
The token keeps working
Refresh rotation keeps the grant alive, and the same token also authenticates REST, WebSockets and Edge Functions. Revoke it any time — every call it made is in your audit trail.
Your account,
アクセスは Dynamic Client Registration と PKCE を備えた OAuth 2.1——貼り付けキーも共有シークレットもありません。エージェントが受け取る唯一のトークンがすべての Busymate サーフェス（MCP、REST、WebSockets、Edge Functions）を認証し、あなたのロールにスコープされます：エージェントにできるのは、あなたがダッシュボードでできることだけです。
- RBAC スコープ
- 確認ゲート付き
- シークレットは秘匿
OAuth 2.1、キーレス
Dynamic Client Registration（RFC 7591）+ PKCE（S256）+ リフレッシュローテーション。ユーザーは Busymate のサインインでブラウザ認可します——貼り付けたり漏らしたりする API キーは存在しません。
ロールにスコープ
すべての呼び出しはデータベース自身が認可（RBAC）。破壊的なツールは明示的な確認を要求し、シークレット値は決して返されません——書き込み専用で伏せ字化されます。
完全監査ログ
すべてのツール呼び出し——すべてのエージェント、すべてのアクション——がアカウントの監査ログに記録され、エージェントが代わりに何をしたかをいつでも確認できます。
続きを読む: プライバシー利用規約RBAC と監査ログのモデル
What your agent can
人が UI でできることは、エージェントも MCP でできます。
トラフィックのキャプチャと検査
キャプチャしたリクエストとレスポンスの検索・検査・タグ付け・エクスポート（HAR）・要約・削除——デバイス単位でもフリート全体でも。
デバイスの制御
一覧・名前変更・ペア解除・VPN 切替・接続タイプ設定、デバイスの送信をアップストリームプロキシ経由にすることも。
リモートブラウザの操縦
生の Chrome DevTools Protocol パススルー——接続中デバイスの Chrome を開く・評価・スクリーンショット・スナップショット。
スマホファームの自動化
Android / iOS デバイスファームの自動化——タップ・入力・スワイプ・インストール・アプリライフサイクル管理をライブミラーリング付きで。
リクエストのスクリプト化と成形
サンドボックスのリクエスト/レスポンススクリプト、自動ブロックルール、ブレークポイント、一時停止ドメイン——トラフィックを飛行中に改変・合成できます。
プラットフォームの運営
ロールと権限（RBAC）、TestFlight ベータ管理、課金、クエリ可能な監査ログ、通知、To-Do、ワークスペース、BusyBro チームメモリ。
If something
The answers below cover every first-connect snag we've actually seen — most are the protocol working as designed.
The endpoint answers 401 in my browser — is it down?
No — that's the spec working. A bare GET on mcp.busymate.dev returns 401 with the OAuth challenge, because the URL is the OAuth resource identifier your client reads to find the sign-in flow. MCP clients proceed from that challenge automatically.
My client lists the tools but every call fails.
Tool discovery is served before authentication; calling anything requires OAuth. Finish the browser authorization your client started (or trigger it again if the token was revoked), then retry the call.
The browser window never opened.
Most clients also print the authorization URL — copy it into any browser. The flow is a normal web sign-in and hands control back to the client when it finishes.
Should I use mcp.busymate.dev or mcp.busymate.net?
Use mcp.busymate.dev for new configs. The older mcp.busymate.net serves the same server permanently and OAuth issues host-matched metadata on whichever host you connected to — existing setups never break.
Claude Code says the server already exists.
Remove the old entry first — claude mcp remove busymate-devtools — then add it again. Your OAuth grant survives; you won't have to re-authorize.
Do I need separate credentials for a bot and my editor?
No. Each client registers itself and gets its own OAuth grant against your account — individually revocable, all acting under your one role, all visible in the audit trail.