n servidor de mensajería MCP expone una API de mensajería como herramientas que un agente de IA puede descubrir y llamar a través de Model Context Protocol, de modo que un asistente pueda enviar un SMS o un mensaje de WhatsApp bajo demanda. BroadNet ejecuta uno en https://mcp.broadnet.me/mcp, utilizando el transporte Streamable HTTP y un token Bearer, sobre el mismo API que sirve a WhatsApp, SMS, RCS, Telegram, Push, Email, Messenger y Instagram. Esta guía explica cómo funciona y, lo que es más importante, cómo evitar que un agente envíe mensajes a las personas equivocadas.
Conclusiones clave
- MCP es un protocolo abierto, construido sobre JSON-RPC 2.0, que permite a las aplicaciones de IA descubrir y llamar a herramientas externas. Un servidor MCP de mensajería convierte los endpoints de envío, plantilla y reporte en herramientas.
- Los servidores remotos utilizan el transporte Streamable HTTP: un endpoint HTTPS, cada mensaje de cliente es un POST HTTP. Los servidores locales suelen utilizar stdio.
- El servidor MCP BroadNet está en https://mcp.broadnet.me/mcp y rechaza cualquier solicitud sin un encabezado Authorization: Bearer.
- Un token es una credencial de envío. El agente actúa con sus permisos, exactamente igual que lo haría su propio código.
- La especificación MCP dice que SIEMPRE DEBERÍA haber un humano en el proceso que pueda denegar las llamadas a las herramientas, y que los servidores DEBEN limitar la tasa de las invocaciones de herramientas. Implemente consentimiento, horario de no molestar, límites y aprobaciones alrededor de cada herramienta de envío.
¿Qué es Model Context Protocol?
La especificación MCP describe MCP como "un protocolo abierto que permite una integración fluida entre las aplicaciones de LLM y las fuentes de datos y herramientas externas". Utiliza mensajes JSON-RPC 2.0 entre tres roles: hosts (la aplicación de IA), clientes (conectores dentro del host) y servidores (servicios que proporcionan herramientas, recursos y prompts). A partir del 26 de septiembre de 2026, la revisión más reciente de la especificación tiene fecha de 2026-07-28.
Las herramientas son la parte que importa para la mensajería. Un cliente las enumera con tools/list, el modelo elige una y el cliente la invoca con tools/call. La especificación denomina a las herramientas "controladas por el modelo": el modelo decide cuándo usarlas. Es exactamente por eso que una herramienta de envío necesita salvaguardas que el modelo no pueda eludir mediante el diálogo.
¿Cómo funciona un servidor MCP para SMS y WhatsApp?
La ruta de la solicitud tiene cinco saltos. El punto de diseño es que el servidor MCP no añade nueva capacidad de envío; expone la API que ya tiene, bajo el mismo token y los mismos controles.
- Un usuario le pide al host de IA, por ejemplo: "envía la actualización de entrega a este cliente en WhatsApp".
- El modelo selecciona una herramienta de la lista que el cliente MCP recuperó, como una herramienta de envío WhatsApp, y completa sus argumentos.
- El cliente MCP envía una solicitud tools/call como un POST HTTP a https://mcp.broadnet.me/mcp con el token Bearer.
- El servidor MCP BroadNet valida el token y llama al endpoint API BroadNet correspondiente.
- El API enruta el mensaje a WhatsApp o a la red móvil y devuelve un resultado, que viaja de vuelta al modelo como el resultado de la herramienta.
En la grabación de la demostración del equipo de producto, el cliente enumera 380 herramientas BroadNet, entre ellas send_message, post_sms_send, post_whatsapp_message_send, get_whatsapp_template_list, post_whatsapp_template_send, post_rcs_message_send y get_report_delivery. La lista exacta depende de la versión del servidor y de su cuenta; consulte la documentación del servidor MCP.
Streamable HTTP o stdio: ¿qué transporte?
La especificación define dos transportes estándar. Cuál utilice depende de dónde se ejecute el servidor, y esto decide cómo se autentica.
| stdio | Streamable HTTP | |
|---|---|---|
| Dónde se ejecuta el servidor | Como un subproceso lanzado por el cliente, en la misma máquina | Como servicio independiente, ha alcanzado más de HTTPS |
| Cómo viajan los mensajes | JSON-RPC delimitados por saltos de línea a través de la entrada y salida estándar | Cada mensaje de cliente es un POST HTTP a un único endpoint MCP; las respuestas regresan como JSON o un flujo de eventos enviados por el servidor (server-sent-events) |
| Cómo funcionan las credenciales | La especificación dice que los servidores stdio deberían leer las credenciales desde el entorno | Un encabezado Authorization: Bearer en cada solicitud; los tokens nunca deben incluirse en la cadena de consulta (query string) |
| Uso típico | Herramientas de desarrollo locales | Servicios alojados compartidos por muchos clientes, como un API de mensajería |
| BroadNet | No se ofrece | https://mcp.broadnet.me/mcp |
Para los servidores HTTP, la revisión de la especificación del 2025-06-18 también requiere que los servidores validen el encabezado Origin y recomienda que autentiquen cada conexión. La revisión más reciente (2026-07-28) hace que cada solicitud sea autónoma, transportando la versión del protocolo y las capacidades del cliente en su propia metadata; las revisiones anteriores abrían una sesión con un saludo de inicialización, y los clientes detectan qué revisión habla un servidor y recurren a la anterior.
¿Cómo se conecta un agente de IA al servidor de MCP de BroadNet?
- Obtenga un token de su cuenta BroadNet. En el portal BroadAdmin, Integraciones, luego en MCP Integration, se emite una clave temporal; una clave permanente la proporciona el administrador de su cuenta o la cuenta maestra.
- Añada el servidor a su cliente MCP. La mayoría de los clientes requieren una configuración JSON como la que se muestra a continuación. Los nombres de los campos varían ligeramente entre clientes, por lo que debe consultar la documentación de su cliente.
- Mantenga el token fuera de los archivos que suba al repositorio (commit). Utilice el soporte de variables de entorno de su cliente, tal como lo hace la configuración de abajo.
- Abra la lista de herramientas y desactive cada herramienta que el agente no necesite.
- Realice una prueba con un mensaje a un número de su propiedad antes de permitir que el agente acceda a los datos del cliente.
{ "mcpServers": { "broadnet": { "type": "http", "url": "https://mcp.broadnet.me/mcp", "headers": { "Authorization": "Bearer ${BROADNET_TOKEN}" } } }}Para probar la conexión sin un cliente, envíe usted mismo la solicitud de inicialización:
curl -X POST https://mcp.broadnet.me/mcp \ -H "Authorization: Bearer $BROADNET_TOKEN" \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"initialize", "params":{"protocolVersion":"2025-06-18","capabilities":{}, "clientInfo":{"name":"curl","version":"1.0"}}}'Sin el encabezado, el servidor rechaza la llamada a nivel de protocolo. Esta es su respuesta real a una solicitud de inicialización no autenticada, verificada el 26 de septiembre de 2026:
event: messagedata: {"jsonrpc":"2.0","id":1,"error":{"code":-32001, "message":"Authorization bearer token is required. Connect with an 'Authorization: Bearer <BroadNet token>' header."}}¿Es seguro otorgar una clave de API de mensajería a un agente de IA?
Solo con límites a su alrededor. El token es una credencial de envío: cualquier persona, o cualquier agente, que la posea puede enviar mensajes desde su cuenta, y cada envío cuesta dinero y llega a una persona real. Los agentes también actúan según instrucciones en lenguaje natural, y parte de ese texto proviene del exterior: un mensaje de cliente entrante o una página web pueden contener instrucciones que el modelo puede intentar seguir. La especificación MCP es directa al respecto. Dice que los hosts deben obtener el consentimiento explícito del usuario antes de invocar cualquier herramienta, que SIEMPRE debería haber un humano en el proceso con la capacidad de denegar las invocaciones de herramientas, y que los clientes deben tratar las anotaciones de herramientas como no confiables a menos que provengan de un servidor de confianza.
¿Qué salvaguardas evitan que un agente envíe spam a los clientes?
Coloque los controles donde el modelo no pueda eludirlos: en la configuración del cliente, en su propio middleware o en la configuración de la cuenta, no en el prompt.
| Riesgo | Control | Dónde reside |
|---|---|---|
| Enviar mensajes a alguien que no ha dado su consentimiento | Verifique el consentimiento y el estado de exclusión voluntaria antes de que se ejecute cualquier herramienta de envío | Su middleware o CRM |
| Enviar por la noche o en el día equivocado | Horario de no molestar según la zona horaria del destinatario y las reglas del mercado | Su middleware |
| Utilizar herramientas que la tarea no necesita | Habilite solo las herramientas necesarias; desactive las herramientas de plantilla, de incorporación y de cuenta | Configuración de la herramienta del cliente MCP |
| Bucles descontrolados y envíos masivos | Límites de envío por agente y límites de velocidad; la especificación requiere que los servidores limiten la velocidad de las invocaciones de las herramientas | Su middleware y el servidor |
| Mensajes duplicados después de un reintento | Conserve el ID del mensaje devuelto y verifique su estado antes de volver a enviarlo | Su lógica de agente (consulte la guía de idempotencia) |
| Marketing enviado sin revisión | Aprobación humana para cualquier envío de marketing o de múltiples destinatarios | Solicitudes de confirmación del cliente MCP |
| Instrucciones ocultas en los mensajes entrantes | Trate el texto entrante como datos; nunca permita que active un envío sin una solicitud del usuario | Diseño de prompts y reglas de aprobación en el host de IA |
| Token filtrado | Claves temporales para experimentos, variables de entorno, revocar y reemitir en caso de exposición | Administrador de la cuenta BroadNet |
| Sin registro de auditoría | Registre cada llamada a la herramienta con las entradas y los resultados | Cliente MCP; la especificación dice que los clientes deberían registrar el uso de las herramientas |
El BroadNet API no tiene un encabezado de idempotencia, por lo que un reintento tras un tiempo de espera puede enviar dos veces. El patrón seguro es almacenar el ID del mensaje que devuelve el API y verificar el estado de la entrega antes de reenviar; nuestras guías de idempotencia y reintentos muestran cómo.
¿Qué acciones de mensajería deberían requerir aprobación humana?
| Acción | Predeterminado sugerido | Por qué |
|---|---|---|
| Leer confirmaciones de entrega, listar plantillas | Automático | Solo lectura; nada llega al cliente |
| Un mensaje transaccional a un cliente conocido que lo solicitó | Automático dentro de un límite de envío, o confirmación con un clic | Bajo riesgo, alto valor, fácil de auditar |
| Cualquier mensaje de marketing | Siempre requiere aprobación humana | Riesgo de consentimiento, contenido y costo |
| Cualquier envío a más de un destinatario | Siempre requiere aprobación humana | Un error se multiplica |
| Creación o envío de plantillas WhatsApp | Aprobación humana | Las plantillas son revisadas por Meta y representan su marca |
| Herramientas de cuenta, facturación o incorporación | Desactivado | Un agente no debería cambiar la cuenta en la que se ejecuta |
MCP o un REST API simple: ¿cuál debería usar un agente?
Ambos llegan a la misma plataforma. La diferencia es quién decide qué llamada realizar.
| Servidor BroadNet MCP | BroadNet REST API | |
|---|---|---|
| Quién elige la llamada | El modelo, de la lista de herramientas | Su código |
| Endpoint | https://mcp.broadnet.me/mcp | https://api.broadnet.me, por ejemplo POST /sms/sendSms |
| Autenticación | Authorization: Bearer <token> | Authorization: Bearer <token> |
| Biblioteca del cliente | Cualquier cliente MCP que admita servidores remotos y un encabezado Authorization personalizado | Un SDK oficial, @broadnet/cpaas-sdk (TypeScript/Node.js); genere otros clientes a partir de la especificación OpenAPI |
| Ideal para | Asistentes, copilotos de operaciones, tareas ad-hoc en lenguaje natural | Flujos de producción con lógica fija: OTP, alertas, campañas |
Una división sensata: use MCP cuando una persona esté dirigiendo al agente y un mensaje de confirmación sea aceptable, y use el REST API, con el guía de inicio rápido y el generador de curl, para flujos que deben ejecutarse de la misma manera cada vez. Nuestra referencia API documenta los endpoints detrás de las herramientas MCP.
Preguntas frecuentes
¿Qué es un servidor MCP para mensajería?
Un servidor que expone un API de mensajería, como enviar SMS, enviar mensaje WhatsApp o obtener la confirmación de entrega, como herramientas que un agente de IA puede descubrir y llamar a través del Model Context Protocol.
¿Cuál es la URL del servidor BroadNet MCP?
https://mcp.broadnet.me/mcp. Utiliza el transporte MCP Streamable HTTP y requiere un encabezado Authorization: Bearer con su token BroadNet en cada solicitud.
¿Qué clientes de IA pueden conectarse a él?
Cualquier cliente MCP que pueda conectarse a un servidor remoto a través de Streamable HTTP y enviar un encabezado Authorization personalizado. La grabación de la demostración BroadNet utiliza Cursor.
¿Puede el agente enviar mensajes reales?
Sí. Las herramientas actúan con los permisos de su token, exactamente como lo harían sus propias llamadas API. Trate cada envío como real: habilite solo las herramientas que el agente necesite y requiera confirmación antes de los envíos.
¿Cómo funciona la autenticación Bearer con MCP?
Para HTTP, el cliente envía Authorization: Bearer seguido del token en cada solicitud, incluso dentro de la misma sesión, y nunca en la cadena de consulta de la URL. El servidor de BroadNet rechaza las solicitudes que no lo incluyan.
¿Cuál es la diferencia entre stdio y Streamable HTTP?
stdio ejecuta el servidor como un subproceso local e intercambia JSON-RPC delimitados por saltos de línea a través de la entrada y salida estándar. Streamable HTTP ejecuta el servidor como un servicio web donde cada mensaje de cliente es un POST HTTP a un único punto de conexión.
¿Cómo evito que un agente de IA envíe spam a los clientes?
Aplique controles de consentimiento, horario de no molestar y límites de envío fuera del modelo, habilite solo las herramientas que necesite, requiera aprobación humana para los envíos de marketing y envíos a múltiples destinatarios, y registre cada llamada a una herramienta.
¿Debería usar MCP o el REST API?
Use MCP cuando una persona dirija a un agente en lenguaje natural. Use el REST API o el TypeScript SDK para flujos de producción fijos como OTP y alertas, donde su código, y no un modelo, decide qué enviar.
Fuentes
- Model Context Protocol, Resumen de la especificación (revisión 2026-07-28), consultado el 26 de septiembre de 2026.
- Model Context Protocol, Transportes (2025-06-18) y Transportes (2026-07-28), consultado el 26 de septiembre de 2026.
- Model Context Protocol, Authorization (2025-06-18), consultado el 26 de septiembre de 2026.
- Model Context Protocol, Herramientas (2026-07-28), consultado el 26 de septiembre de 2026.
- BroadNet, documentación del servidor MCP, y una sonda en vivo de https://mcp.broadnet.me/mcp el 26 de septiembre de 2026.
Lectura relacionada: agentes de IA en la mensajería de clientes y elección de una plataforma de IA agéntica empresarial.