Códigos SMS para agentes de IA: lee códigos de verificación por MCP

Conecta tu agente

El inicio de sesión es OAuth 2.1 con registro dinámico de clientes: apuntas el cliente a la URL, se abre una ventana del navegador, confirmas con un código enviado a tu correo (o al teléfono de tu cuenta) y pulsas Permitir. No hay que pegar ningún client ID ni secreto.

claude mcp add --transport http busysms https://busysms.net/mcp

codex mcp add busysms --url https://busysms.net/mcp

[mcp_servers.busysms]
url = "https://busysms.net/mcp"

En la app de Claude, abre Customize → Connectors → + Add → Add custom connector, ponle el nombre BusySMS y pega https://busysms.net/mcp. Otros clientes MCP, Grok incluido, lo añaden como servidor HTTP remoto con la misma URL. Un cliente que no admita OAuth puede enviar en su lugar una clave de API bsk_live_ como token Bearer.

Un flujo típico de un agente

1. 1

   Lanza el inicio de sesión

   El agente rellena el formulario de acceso o llama al servicio, y el servicio envía un código por SMS a tu número.

2. 2

   Espera el código

   Llama a wait_for_code de inmediato, pasando phone o sender cuando tienes varios números.

3. 3

   Usa el código

   Escribe el código y sigue adelante. Si no llega nada, no recibe nada y puede reintentar o preguntarte, en lugar de adivinar.

Un prompt tan sencillo como este funciona con cualquier agente conectado:

Sign in to staging.example.com as +44 7700 900123.
When the site asks for the SMS code, call BusySMS wait_for_code
with phone 447700900123, enter the code, and tell me when you are in.

Varios números, números compartidos y cuando los códigos no llegan

Con más de un número en tu cuenta, o con un número que un compañero ha compartido contigo, «el siguiente código» es ambiguo. Pasa phone con el número que recibe, para que no se devuelva un código de otro inicio de sesión en otro número, o sender con parte del nombre del remitente. Los números compartidos funcionan como los tuyos: cuando aceptas una invitación, las herramientas de códigos incluyen sus códigos nuevos.

Si los códigos no llegan en absoluto, pide al agente que ejecute diagnose_my_gateway: compara lo que está registrado, verificado y en línea, y sugiere el siguiente paso. test_my_gateway va más allá y comprueba todo el recorrido de principio a fin. Deja que el agente te pregunte antes, porque envía un SMS real a tu número.

Seguridad integrada en las herramientas

• Solo tus teléfonos. Cada herramienta está limitada a tu cuenta y a los números compartidos contigo. Un agente no puede leer los mensajes de nadie más.
• Ningún secreto en la conversación. create_api_key crea una clave REST pero nunca la devuelve: recibes un enlace de un solo uso, válido durante 15 minutos, que abres tú. El texto de un SMS puede llevar instrucciones escritas por un desconocido, así que una clave de larga duración nunca debe entrar en el contexto del agente.
• Los cambios requieren una sesión iniciada. Las herramientas que cambian cosas, como probar tu pasarela, compartir un número o revocar una clave, no se pueden usar con una clave de API.
• Mensajes solo para ti. send_sms_to_me y send_email_to_me no tienen argumento de destinatario; solo pueden llegar al número y a la dirección de tu propia cuenta.

Qué necesita el agente por tu parte

• Un teléfono con la SIM: Android con la app de BusySMS, o un iPhone con una automatización de Atajos.
• El número verificado en BusySMS.
• Una prueba o una suscripción activa. Sin ella, las herramientas que leen códigos devuelven un error de facturación, mientras que list_devices sigue funcionando para que el agente pueda explicarte por qué.

¿Aún no tienes cuenta?

Las herramientas públicas responden preguntas sobre el producto sin iniciar sesión (precios, pasos de configuración, requisitos del dispositivo, solución de problemas), así que un asistente puede explicarte con precisión qué hace BusySMS antes de que te registres. Leer códigos requiere una cuenta: $5 por número verificado al mes tras 7 días de prueba gratis.

Dudas

Preguntas frecuentes