MCP · Instalación

Conecta tu agente de IA

Pega mcp.busymate.dev una vez. 454 herramientas. Sin claves de API.

Un clic, o un pegado

Pick your client

Cursor y VS Code en un clic. Los demás pegan la misma URL y autorizan en el primer uso.

Claude Code

Añade el servidor desde tu terminal. La primera llamada a una herramienta abre tu navegador para autorizar.

  1. 01

    Ejecuta el comando de abajo en tu terminal — se añade solo a este proyecto de forma predeterminada; agrega --scope user para tenerlo disponible en todos tus proyectos.

  2. 02

    La primera llamada a una herramienta abre tu navegador para iniciar sesión y autorizar — aprueba, y Claude Code confirmará la conexión.

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

Verificar:Ejecuta claude mcp list (o /mcp dentro de Claude Code) — busymate-devtools aparecerá como conectado, y las 454 herramientas estarán listas para usarse.

Claude.ai & Claude Desktop

Ajustes → Conectores → Añadir conector personalizado, pega la URL, pulsa Conectar y autoriza en el navegador. Sin archivos que editar.

  1. 01

    Abre Ajustes → Conectores, pulsa + y elige Añadir conector personalizado.

  2. 02

    Pega la URL de abajo como la URL del servidor remoto y pulsa Añadir — deja en blanco los campos de OAuth Client ID/Secret, Busymate no los necesita.

  3. 03

    Claude abrirá tu navegador para iniciar sesión — aprueba, y el conector aparecerá como conectado.

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

Verificar:Abre el conector de nuevo — mostrará las 454 herramientas, y Claude podrá usarlas en medio de la conversación.

Cursor
Añadir a Cursor

Un clic lo añade y autoriza por OAuth. O añádelo a mano en ~/.cursor/mcp.json (global) o en un .cursor/mcp.json de proyecto:

  1. 01

    Haz clic en Add to Cursor para la instalación con un clic, o añade el bloque de abajo a ~/.cursor/mcp.json (global) o al .cursor/mcp.json de un proyecto manualmente.

  2. 02

    Abre Cursor Settings → MCP y activa el servidor si aún no lo está.

  3. 03

    La primera llamada a una herramienta abre tu navegador para autorizar — Cursor completa el intercambio OAuth por sí mismo, así que no hay que pegar ningún client ID ni secreto.

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

Verificar:En Cursor Settings → MCP, busymate-devtools aparecerá como activado, con el número de herramientas junto a él.

VS Code (Copilot)
Instalar en VS Code

Un clic lo instala en VS Code. O añádelo a mano en un .vscode/mcp.json del workspace (la clave raíz es servers):

  1. 01

    Haz clic en Install in VS Code para la instalación con un clic, o añade el bloque de abajo a un .vscode/mcp.json del workspace — o ejecuta MCP: Open User Configuration para añadirlo en todos los workspaces.

  2. 02

    La primera vez, VS Code te pedirá confiar en el servidor — apruébalo, y luego pulsa Start en el code lens encima de la entrada (o ejecuta MCP: List Servers desde la paleta de comandos).

  3. 03

    VS Code abrirá tu navegador para el intercambio OAuth — inicia sesión y aprueba.

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

Verificar:Ejecuta MCP: List Servers desde la paleta de comandos — busymate-devtools aparecerá como Running, con las 454 herramientas listadas.

ChatGPT

Donde los conectores en modo desarrollador estén disponibles: Ajustes → Conectores → Añadir, pega la URL y autoriza. La disponibilidad varía por plan.

  1. 01

    Activa los conectores en modo desarrollador — en los ajustes de ChatGPT, busca Developer mode o Connectors (el menú exacto ha cambiado de sitio antes; requiere un plan Plus, Pro o Business o superior, y un administrador del workspace puede restringirlo).

  2. 02

    Añade un conector personalizado y pega la URL de abajo.

  3. 03

    Autoriza en la pestaña del navegador que se abrirá.

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

Verificar:El conector aparecerá como conectado. Pídele a ChatGPT que use una herramienta de Busymate DevTools y debería llamarla sin errores.

Cualquier otro cliente MCP

El transporte Streamable-HTTP es estándar — Continue, Cline, Zed o tu propio bot usan la misma configuración. Apúntalo a la URL:

  1. 01

    Confirma que tu cliente habla el transporte Streamable HTTP (no solo stdio) y admite OAuth 2.1 con Dynamic Client Registration — la mayoría de los clientes actuales lo hacen.

  2. 02

    Apúntalo a la URL de abajo, en el formato de configuración que espere tu cliente — el bloque usa la forma común mcpServers que la mayoría de los clientes leen directamente.

  3. 03

    Autoriza el aviso del navegador la primera vez que lo uses, igual que con todos los clientes anteriores.

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

Verificar:Una llamada a tools/list devolverá las 454 herramientas una vez que hayas autorizado el acceso.

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.

Cómo se mantiene seguro

Your account, your rules

El acceso es OAuth 2.1 con registro dinámico de clientes y PKCE — sin claves pegadas, sin secreto compartido. El único token que recibe un agente autentica todas las superficies de Busymate (MCP, REST, WebSockets, Edge Functions) y está acotado a tu propio rol: un agente solo puede hacer lo que tú podrías hacer en el panel.

  • con alcance RBAC
  • con confirmación previa
  • secretos censurados

OAuth 2.1, sin claves

Registro dinámico de clientes (RFC 7591) + PKCE (S256) + rotación de refresh. Los usuarios autorizan en el navegador contra el login de Busymate — no hay clave de API que pegar ni filtrar.

Acotado a tu rol

Cada llamada la autoriza la propia base de datos (RBAC). Las herramientas destructivas exigen una confirmación explícita, y los valores secretos nunca se devuelven — son de solo escritura y van censurados.

Completamente auditado

Cada llamada a una herramienta — cada agente, cada acción — aterriza en el registro de auditoría de tu cuenta, así que siempre puedes ver qué hizo un agente en tu nombre.

Leer más: PrivacidadTérminosel modelo de RBAC y registro de auditoría

Las 454 herramientas

What your agent can drive

Si una persona puede hacerlo en la interfaz, un agente puede hacerlo por MCP.

Captura e inspecciona tráfico

Busca, inspecciona, etiqueta, exporta (HAR), resume y borra peticiones y respuestas capturadas — por dispositivo o en toda tu flota.

Controla dispositivos

Lista, renombra, desempareja, activa la VPN, fija el tipo de conexión o enruta la salida de un dispositivo por un proxy ascendente.

Maneja un navegador remoto

Passthrough crudo del Chrome DevTools Protocol — abre, evalúa, captura pantalla y snapshotea el Chrome de un dispositivo conectado.

Automatiza granjas de móviles

Automatización de granjas Android e iOS — toca, escribe, desliza, instala y gestiona el ciclo de vida de apps, con espejo en vivo.

Programa y moldea peticiones

Scripts de petición/respuesta aislados, reglas de bloqueo automático, puntos de interrupción y dominios en pausa — muta o sintetiza tráfico en vuelo.

Opera la plataforma

Roles y capacidades (RBAC), administración de beta TestFlight, facturación, un registro de auditoría consultable, notificaciones, tareas, espacios de trabajo y la memoria de equipo de BusyBro.

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

Añade mcp.busymate.dev, autoriza una vez y llama a cualquiera de las 454 herramientas.

Ask your mate