Conecta agentes de IA a BroadNet con MCP.

Qué es el servidor MCP

El Model Context Protocol (MCP) es un estándar abierto que permite a los asistentes de IA descubrir e invocar herramientas externas. El servidor MCP de BroadNet es un servidor remoto: tu cliente se conecta por HTTPS, lista las herramientas disponibles y las invoca en tu nombre.

Las herramientas corresponden a la misma API de BroadNet documentada en la referencia de la API y en la especificación OpenAPI: envío de mensajes, plantillas de WhatsApp, confirmaciones de entrega. El agente actúa con los permisos del token que le das, exactamente como lo haría tu propio código.

Dos servidores MCP: conocimiento y mensajería

BroadNet opera dos servidores MCP. El servidor de mensajería que describe esta página actúa sobre su cuenta. El servidor de conocimiento es público: un agente puede consultarle la cobertura de BroadNet, las reglas de Sender ID, las tarifas de lista publicadas, la normativa y los datos de la empresa sin iniciar sesión.

Pruebe el servidor de conocimiento desde una terminal: el handshake initialize y después una llamada a una herramienta.

curl -X POST https://www.broadnet.me/mcp \
  -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"}}}'

curl -X POST https://www.broadnet.me/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"sender_id_rules","arguments":{"country":"ae"}}}'

Endpoint y autenticación

Hay un único endpoint para todas las cuentas: https://mcp.broadnet.me/mcp. Cada solicitud debe incluir tu token de BroadNet en una cabecera Authorization.

El token se obtiene desde tu cuenta de BroadNet. En la demo se genera en el portal BroadAdmin, en Integrations → MCP Integration, con «Get temporary key»; el portal indica que una clave permanente la emite el administrador de tu cuenta o la cuenta principal.

Una solicitud sin la cabecera se rechaza a nivel de protocolo; esta es la respuesta real del servidor a una llamada initialize sin autenticar:

event: message
data: {"jsonrpc":"2.0","id":1,"error":{"code":-32001,
  "message":"Authorization bearer token is required. Connect with an
  'Authorization: Bearer <BroadNet token>' header."}}

Conectar un cliente MCP

La mayoría de los clientes MCP aceptan una configuración JSON con la URL del servidor y las cabeceras de la solicitud. Una entrada típica es así:

{
  "mcpServers": {
    "broadnet": {
      "type": "http",
      "url": "https://mcp.broadnet.me/mcp",
      "headers": {
        "Authorization": "Bearer ${BROADNET_TOKEN}"
      }
    }
  }
}

Para probar la conexión sin un cliente, envía tú mismo la solicitud MCP initialize:

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"}}}'

Qué muestra la demo

La grabación del equipo de producto recorre el flujo completo en cinco pasos, con Cursor como cliente MCP:

1. 1
   Iniciar sesión

   Accede al portal BroadAdmin con tu cuenta de BroadNet.

2. 2
   Obtener una clave y la configuración

   Abre Integrations → MCP Integration, genera una clave temporal y copia la configuración de cliente ya preparada.

3. 3
   Añadir el servidor al cliente

   En el cliente MCP, añade un nuevo servidor MCP y pega la configuración en mcp.json: URL https://mcp.broadnet.me/mcp con la cabecera Bearer.

4. 4
   Revisar las herramientas

   El cliente se conecta y lista las herramientas de BroadNet; cada una se puede activar o desactivar.

5. 5
   Pedirlo en lenguaje natural

   El usuario pide al agente que envíe un mensaje de WhatsApp a un número. El agente elige la herramienta de envío de WhatsApp, la API responde HTTP 200 con el mensaje aceptado y el mensaje llega a WhatsApp desde la cuenta de empresa.

En la grabación, el cliente muestra 380 herramientas de BroadNet, entre ellas send_message, post_sms_send, post_whatsapp_message_send, get_whatsapp_template_list, post_whatsapp_template_send, post_rcs_message_send, post_telegram_message_send, post_instagram_message_send, post_messenger_message_send, post_push_message_send y get_report_delivery. La lista exacta depende de la versión del servidor y de tu cuenta.

Una versión narrada de la misma grabación añade una tarjeta de resumen: un único endpoint MCP y los mismos pasos de copiar y pegar para cada agente.

Notas de seguridad

• El token es una credencial de envío

  Quien lo tenga puede enviar mensajes desde tu cuenta. Guárdalo como una contraseña, nunca en un archivo compartido o subido al repositorio.

• Usa claves temporales para las pruebas

  Usa una clave temporal mientras pruebas y pide una clave permanente al administrador de tu cuenta solo para un agente en producción.

• Activa solo las herramientas necesarias

  Los clientes MCP permiten desactivar herramientas una a una. Un agente que solo envía SMS no necesita herramientas de plantillas, alta o cuenta.

• Mantén a una persona en el proceso

  Los agentes actúan según instrucciones en lenguaje natural. Haz que el cliente pida confirmación antes de las herramientas que envían mensajes, sobre todo a muchos destinatarios.

• Revoca un token filtrado

  Si un token queda expuesto, contacta con el administrador de tu cuenta o con el soporte de BroadNet para revocarlo y emitir uno nuevo.

Relacionado

Preguntas