Conecta Claude Code a
Un comando en la terminal y un inicio de sesión en el navegador. A partir de ahí, Claude Code puede leer lo que tu teléfono acaba de capturar, explicar un flujo de inicio de sesión con los secretos ocultos y actuar sobre tus dispositivos: cada herramienta limitada a tu rol y cada acción arriesgada con confirmación.
Busymate expone todo su dashboard —454 herramientas que cubren dispositivos, tráfico capturado, ajustes, reglas, exportaciones y la granja de teléfonos— como un servidor MCP en un solo nombre de host. Claude Code habla MCP sobre HTTP de forma nativa, así que conectar lleva un único comando. La autenticación es OAuth 2.1 estándar: el cliente se registra solo, abre tu navegador, inicias sesión con tu cuenta normal de Busymate y apruebas una vez, y el token resultante es lo que lleva cada llamada a herramienta. No hay clave de API que crear, pegar ni rotar.
Esta guía recorre la conexión de principio a fin, y luego muestra los tres tipos de prompt que rinden primero: leer el feed en vivo, explicar un flujo de API capturado y actuar sobre un dispositivo. También cubre el único hábito de mantenimiento que ahorra un viaje al navegador: reconectar tras una actualización del servidor, nunca volver a autorizar.
Lo que
Claude Code en tu máquina, una cuenta de Busymate y —para tener algo que preguntar— un dispositivo que haya capturado tráfico.
Claude Code instalado, con una terminal donde se ejecute su comando.
Una cuenta de Busymate con la que puedas iniciar sesión en un navegador: la misma que usa el dashboard.
Al menos un dispositivo emparejado con tráfico reciente: un iPhone, un Android, un cliente del proxy o un Chrome capturado. La guía de iPhone es el camino más rápido.
Un rol con las capacidades que pretendes usar. Las lecturas necesitan acceso de visualización; acciones como reenviar una petición o cambiar los ajustes de un dispositivo necesitan acceso de edición sobre dispositivos que posees.
Hazlo
Dos pasos para conectar, uno para verificar, tres para sacar valor, uno para mantenerlo sano.
- 01
Añade el servidor desde tu terminal
Ejecuta el comando de abajo. Registra Busymate como servidor MCP remoto para Claude Code usando el transporte HTTP y el endpoint canónico. No hace falta nada más en el comando: ni token, ni cabecera, ni id de cliente. El descubrimiento de herramientas se sirve antes de la autenticación, así que Claude Code ya puede listar lo que ofrece el servidor.
El único comando 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
Autoriza en el navegador en la primera llamada a herramienta
Pídele a Claude Code cualquier cosa que necesite una herramienta y arranca el flujo OAuth: el cliente se registra en el servidor, abre tu navegador en el inicio de sesión propio de Busymate con un desafío PKCE, inicias sesión y apruebas, y el navegador devuelve al cliente un código de un solo uso, que lo intercambia por un token de acceso. Claude Code confirma la conexión. No haces nada de esto a mano; solo ves la página de inicio de sesión una vez.
Ese token es del mismo tipo que usan las consolas integradas del dashboard, y autentica todos los servicios de Busymate, no solo MCP. Cada cliente que conectas obtiene su propia concesión contra tu cuenta: revocable individualmente, todas actuando bajo tu único rol, todas visibles en el registro de auditoría.
- 03
Verifica con una pregunta de solo lectura
Empieza por algo que solo lea. Pregunta qué dispositivos están en línea y qué capturó uno de ellos recientemente, o qué hosts devolvieron un estado concreto en la última hora. Claude Code elige las herramientas adecuadas y la respuesta sale de tus datos reales —nombres de dispositivos, hosts, rutas, estados—, no de una suposición.
Dos primeros prompts que prueban la conexión 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
Pídele que explique un flujo de API capturado
Este es el prompt para el que existe la conexión. Nombra un host que capturaste desde tu teléfono —usa el nombre de host completo con un punto, no una marca a secas— y pregunta cómo se autentica la app. Claude Code lee las cabeceras y cuerpos reales de petición y respuesta, reconstruye el flujo y puede escribirte una reproducción ejecutable. Los tokens, cookies y credenciales del tráfico capturado se tratan como secretos y se sustituyen por marcadores en todo lo que te devuelve.
Explica el flujo de inicio de sesión que el teléfono acaba de realizar 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
Déjalo actuar, tras una puerta de confirmación
Las herramientas que cambian algo —reenviar una petición, alternar la VPN de un dispositivo, enrutar su tráfico por un proxy en otro país, editar reglas de bloqueo— llevan confirmación en el servidor: Claude Code te muestra lo que está a punto de hacer y espera tu sí. Todo se ejecuta como tú, limitado a las capacidades de tu rol y a los dispositivos que posees, así que un cliente nunca puede hacer más de lo que podrías hacer en el dashboard.
Un prompt de acción: cada escritura pregunta antes de ejecutarse 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
Combínalo con el resto de la serie
Todo lo que las otras guías hacen a mano aquí es una frase: pide una exportación HAR de un host de hoy, un mock 401 de una sola vez en un endpoint de inicio de sesión, los patrones de breakpoint actuales o una captura de pantalla de cada teléfono de la granja. Claude Code traduce las palabras a herramientas; aplican las mismas reglas de rol y confirmación.
- 07
Tras una actualización del servidor: reconecta, nunca vuelvas a autorizar
El servidor se despliega a menudo y llegan herramientas nuevas. Un cliente conectado antes de un despliegue puede tener una lista de herramientas obsoleta: una herramienta parece faltar o una descripción está desactualizada. La mayoría de los clientes recogen el cambio solos porque el servidor lo anuncia; si el tuyo no, reinicia la sesión de Claude Code. No cierres sesión ni borres el servidor: tu token sobrevive a los despliegues, y volver a consentir solo te cuesta un viaje al navegador. Si alguna vez quieres un alta limpia, elimina primero la entrada y vuelve a añadirla; la concesión sobrevive, así que no te pedirán iniciar sesión otra vez.
Un alta limpia conserva tu concesión existente bashclaude mcp remove busymate-devtools claude mcp add --transport http busymate-devtools https://mcp.busymate.dev
Qué puede
Cada uno de estos parece una caída y es el protocolo funcionando como está especificado.
El endpoint responde 401 cuando lo abro en un navegador
Así lo dicta la especificación. Una petición sin más devuelve 401 con el desafío OAuth que le dice a un cliente dónde encontrar el flujo de inicio de sesión. Los clientes MCP continúan desde ese desafío automáticamente; nada está caído.
La ventana del navegador nunca se abrió
Claude Code también imprime la URL de autorización. Cópiala en cualquier navegador; el flujo es un inicio de sesión web normal y devuelve el control al cliente cuando termina.
Las herramientas aparecen listadas pero todas las llamadas se rechazan
El descubrimiento se sirve antes de la autenticación; llamar a cualquier cosa requiere la concesión OAuth. Termina la autorización en el navegador que el cliente inició, o vuelve a lanzarla si el token fue revocado, y reintenta.
Falta una herramienta que veo en la documentación
Lista de herramientas obsoleta tras un despliegue. Reinicia la sesión para que el cliente vuelva a descubrir la superficie. Si sigue faltando, puede que tu rol no tenga la capacidad que protege esa herramienta.
Se denegó una acción sobre un dispositivo que sí puedo ver
Las acciones se limitan a los dispositivos que posees y a las capacidades de edición de tu rol. Pide a un administrador del espacio de trabajo que te conceda la capacidad, o ejecuta la acción en tu propio dispositivo.
Preguntas
¿Hay alguna clave de API que deba guardar en algún sitio?
No. El acceso es una concesión OAuth ligada a tu cuenta y a ese cliente. Revócala desde el dashboard si pierdes una máquina; no hay nada que rotar.
¿Funciona igual en Cursor, VS Code o Claude Desktop?
Sí: cualquier cliente que hable el transporte HTTP y OAuth 2.1 con registro dinámico de clientes se conecta al mismo endpoint. La página de instalación tiene la configuración lista para pegar y enlaces de un clic para cada uno.
¿Puede filtrar los tokens que ve en mi tráfico?
Las credenciales capturadas se ocultan en las explicaciones y en los fragmentos de reproducción, las lecturas se limitan a tu rol y a tus dispositivos, y las escrituras llevan confirmación. Trata una exportación HAR en bruto como sensible; las respuestas del agente no lo son.
Un comando,
Añade el servidor, aprueba una vez en el navegador y entrega el tráfico que capturó tu teléfono al agente que puede explicarlo.