Busymate DevTools — home

MCP · Installazione

Collega il tuo agente IA

Incolla mcp.busymate.dev una volta. 454 tool. Niente chiavi API.

Scegli il tuo clientCosa fa il server MCP

Un clic, o un incolla

Pick your client

Cursor e VS Code in un clic. Tutti gli altri incollano lo stesso URL e autorizzano al primo uso.

Claude Code

Aggiungi il server dal terminale. La prima chiamata a un tool apre il browser per autorizzare.

  1. 01

    Esegui il comando qui sotto nel terminale — per impostazione predefinita viene aggiunto solo a questo progetto; aggiungi --scope user per renderlo disponibile in ogni progetto.

  2. 02

    La prima chiamata a uno strumento apre il browser per accedere e autorizzare — approva, e Claude Code confermerà la connessione.

Terminale
bash
# Claude Code — add the server, then authorize in your browser:
claude mcp add --transport http busymate-devtools https://mcp.busymate.dev

Verifica:Esegui claude mcp list (o /mcp dentro Claude Code) — busymate-devtools risulterà connesso, e tutti i 454 strumenti saranno pronti all'uso.

Claude.ai & Claude Desktop

Settings → Connectors → Add custom connector, incolla l’URL, clicca Connect e autorizza nel browser. Nessun file da modificare.

  1. 01

    Apri Impostazioni → Connettori, clicca su + e scegli Aggiungi connettore personalizzato.

  2. 02

    Incolla l'URL qui sotto come URL del server remoto e clicca su Add — lascia vuoti i campi OAuth Client ID/Secret, Busymate non ne ha bisogno.

  3. 03

    Claude apre il browser per accedere — approva, e il connettore risulterà connesso.

URL del connettore
text
https://mcp.busymate.dev

Verifica:Riapri il connettore — elenca tutti i 454 strumenti, e Claude può richiamarli anche a metà conversazione.

Cursor
Aggiungi a Cursor

Un clic lo aggiunge e autorizza via OAuth. Oppure aggiungilo a mano in ~/.cursor/mcp.json (globale) o in un .cursor/mcp.json di progetto:

  1. 01

    Clicca su Add to Cursor per l'installazione con un clic, oppure aggiungi manualmente il blocco qui sotto a ~/.cursor/mcp.json (globale) o al .cursor/mcp.json di un progetto.

  2. 02

    Apri Cursor Settings → MCP e attiva il server se non è già abilitato.

  3. 03

    La prima chiamata a uno strumento apre il browser per l'autorizzazione — Cursor completa da solo lo scambio OAuth, quindi non c'è nessun client ID o secret da incollare.

~/.cursor/mcp.json (or .cursor/mcp.json in a project)
json
{
  "mcpServers": {
    "busymate-devtools": {
      "url": "https://mcp.busymate.dev"
    }
  }
}

Verifica:In Cursor Settings → MCP, busymate-devtools risulterà abilitato, con il numero di strumenti mostrato a fianco.

VS Code (Copilot)
Installa in VS Code

Un clic lo installa in VS Code. Oppure aggiungilo a mano a un .vscode/mcp.json del workspace (la chiave radice è servers):

  1. 01

    Clicca su Install in VS Code per l'installazione con un clic, oppure aggiungi il blocco qui sotto a un .vscode/mcp.json del workspace — oppure esegui MCP: Open User Configuration per aggiungerlo a ogni workspace.

  2. 02

    La prima volta VS Code chiede di fidarsi del server — approva, poi clicca su Start nel code lens sopra la voce (oppure esegui MCP: List Servers dalla Command Palette).

  3. 03

    VS Code apre il browser per lo scambio OAuth — accedi e approva.

.vscode/mcp.json (root key: servers)
json
{
  "servers": {
    "busymate-devtools": {
      "type": "http",
      "url": "https://mcp.busymate.dev"
    }
  }
}

Verifica:Esegui MCP: List Servers dalla Command Palette — busymate-devtools mostrerà Running, con tutti i 454 strumenti elencati.

ChatGPT

Dove i connettori developer-mode sono disponibili: Settings → Connectors → Add, incolla l’URL e autorizza. La disponibilità varia in base al piano.

  1. 01

    Attiva i connettori in modalità sviluppatore — nelle impostazioni di ChatGPT, cerca Developer mode o Connectors (la posizione esatta nel menu è già cambiata; richiede un piano Plus, Pro o Business o superiore, e un admin del workspace può limitarlo).

  2. 02

    Aggiungi un connettore personalizzato e incolla l'URL qui sotto.

  3. 03

    Autorizza nella scheda del browser che si apre.

URL del connettore
text
https://mcp.busymate.dev

Verifica:Il connettore risulterà connesso. Chiedi a ChatGPT di usare uno strumento di Busymate DevTools: dovrebbe richiamarlo senza errori.

Qualsiasi altro client MCP

Il trasporto Streamable-HTTP è standard — Continue, Cline, Zed o il tuo bot usano la stessa config. Puntala all’URL:

  1. 01

    Verifica che il tuo client supporti il trasporto Streamable HTTP (non solo stdio) e OAuth 2.1 con Dynamic Client Registration — la maggior parte dei client attuali lo fa.

  2. 02

    Puntalo all'URL qui sotto, nel formato di configurazione che il tuo client si aspetta — il blocco usa la forma comune mcpServers, letta direttamente dalla maggior parte dei client.

  3. 03

    Autorizza la richiesta del browser al primo utilizzo, come per ogni client visto sopra.

mcp.json
json
{
  "mcpServers": {
    "busymate-devtools": {
      "url": "https://mcp.busymate.dev"
    }
  }
}

Verifica:Una chiamata a tools/list restituisce tutti i 454 strumenti una volta autorizzato l'accesso.

The handshake

What happens on first connect

The whole OAuth 2.1 flow, demystified — four steps, all standard, no console to visit first.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

Come resta sicuro

Your account, your rules

L’accesso è OAuth 2.1 con Dynamic Client Registration e PKCE — niente chiavi incollate, niente segreti condivisi. L’unico token che un agente riceve autentica ogni superficie Busymate (MCP, REST, WebSocket, Edge Function) ed è limitato al tuo ruolo: un agente può fare solo ciò che potresti fare tu nella dashboard.

  • con ambito RBAC
  • con conferma obbligatoria
  • segreti oscurati

OAuth 2.1, senza chiavi

Dynamic Client Registration (RFC 7591) + PKCE (S256) + rotazione dei refresh. Gli utenti autorizzano nel browser contro il sign-in di Busymate — non c’è nessuna API key da incollare o far trapelare.

Limitato al tuo ruolo

Ogni chiamata è autorizzata dal database stesso (RBAC). I tool distruttivi richiedono una conferma esplicita, e i valori dei secret non vengono mai restituiti — sono write-only e oscurati.

Interamente audit-loggato

Ogni chiamata a un tool — ogni agente, ogni azione — finisce nell’audit trail del tuo account, così puoi sempre vedere cosa ha fatto un agente per tuo conto.

Leggi di più: PrivacyTerminiil modello RBAC e audit trail

I 454 tool

What your agent can drive

Se un umano può farlo nella UI, un agente può farlo via MCP.

Cattura e ispeziona il traffico

Cerca, ispeziona, tagga, esporta (HAR), riassumi ed elimina richieste e risposte catturate — per dispositivo o su tutta la flotta.

Controlla i dispositivi

Elenca, rinomina, disaccoppia, attiva/disattiva la VPN, imposta un tipo di connessione o instrada l’egress di un dispositivo attraverso un proxy upstream.

Guida un browser remoto

Passthrough grezzo del Chrome DevTools Protocol — apri, valuta, fai screenshot e snapshot del Chrome di un dispositivo connesso.

Automatizza le phone farm

Automazione di device farm Android e iOS — tap, digitazione, swipe, installazioni e gestione del ciclo di vita delle app, con mirroring live.

Scripta e modella le richieste

Script request/response sandboxed, regole di auto-blocco, breakpoint e domini in pausa — muta o sintetizza il traffico in volo.

Gestisci la piattaforma

Ruoli e capability (RBAC), amministrazione beta TestFlight, billing, un audit trail interrogabile, notifiche, to-do, workspace e la memoria di team di BusyBro.

Correlatila panoramica del server MCPla REST API di cattura di reteil modello RBAC e audit trail

Troubleshooting

If something looks stuck

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.

Connect in under a minute

Aggiungi mcp.busymate.dev, autorizza una volta e chiama uno qualsiasi dei 454 tool.

Inizia gratisProva la demo dal vivoLeggi la guida Connect
Ask your mate