--- title: "Guía rápida para desarrolladores: conéctate a ConnectMQ | ConnectMQ" description: "Conecta tu primer cliente MQTT a ConnectMQ: endpoints y puertos, y ejemplos de código para Python, Node.js, navegadores, ESP32, Go y la CLI de mosquitto." url: "https://connectmq.com/es/desarrolladores/" language: "es" --- Guía rápida para desarrolladores # Tu primer mensaje en tres pasos ConnectMQ habla MQTT estándar, así que la biblioteca cliente que ya conoces funciona sin cambios. Consigue tus credenciales, elige un ejemplo y conéctate. [Obtener credenciales](https://app.connectmq.com/signup) [Ver ejemplos de código](#samples) 1. ## Regístrate Crea tu cuenta en [app.connectmq.com](https://app.connectmq.com/signup) y abre tu broker. 2. ## Crea credenciales Añade un usuario y una contraseña para tu dispositivo o servicio y permite los topics que necesita. 3. ## Conéctate Usa uno de los ejemplos de abajo: sustituye YOUR\_USERNAME y YOUR\_PASSWORD y ejecútalo. Endpoints ## Puertos y protocolos Usa TLS (8883) para dispositivos y servicios, y WebSockets seguros (8084) para navegadores. MQTT**1883**`mqtt://broker.connectmq.com:1883`TCP MQTT sobre TLS**8883**`mqtts://broker.connectmq.com:8883`TCP + TLS WebSocket**8083**`ws://broker.connectmq.com:8083/mqtt`Navegadores (páginas HTTP) WebSocket seguro**8084**`wss://broker.connectmq.com:8084/mqtt`Navegadores (páginas HTTPS) Ejemplos de código ## Copia, pega y conéctate Cada ejemplo se conecta mediante TLS (o WebSockets seguros en el navegador), se suscribe a `devices/+/telemetry` y publica una lectura en JSON. [Todos los ejemplos de código](https://connectmq.com/es/ejemplos-de-codigo/) client.py · pip install "paho-mqtt>=2.0" ``` import paho.mqtt.client as mqtt def on_connect(client, userdata, flags, reason_code, properties): print("Connected:", reason_code) client.subscribe("devices/+/telemetry", qos=1) client.publish("devices/sensor-1/telemetry", '{"temperature": 21.5}', qos=1) def on_message(client, userdata, msg): print(msg.topic, msg.payload.decode()) client = mqtt.Client(mqtt.CallbackAPIVersion.VERSION2, client_id="sensor-1") client.username_pw_set("YOUR_USERNAME", "YOUR_PASSWORD") client.tls_set() # TLS on port 8883 client.on_connect = on_connect client.on_message = on_message client.connect("broker.connectmq.com", 8883) client.loop_forever() ``` client.mjs · npm install mqtt ``` import mqtt from 'mqtt'; const client = await mqtt.connectAsync('mqtts://broker.connectmq.com:8883', { clientId: 'service-1', username: 'YOUR_USERNAME', password: 'YOUR_PASSWORD', }); client.on('message', (topic, payload) => { console.log(topic, payload.toString()); }); await client.subscribeAsync('devices/+/telemetry', { qos: 1 }); await client.publishAsync('devices/sensor-1/telemetry', JSON.stringify({ temperature: 21.5 }), { qos: 1 }); ``` dashboard.js · npm install mqtt ``` import mqtt from 'mqtt'; // Browsers connect over secure WebSockets. const client = mqtt.connect('wss://broker.connectmq.com:8084/mqtt', { username: 'YOUR_USERNAME', password: 'YOUR_PASSWORD', }); client.on('connect', () => client.subscribe('devices/+/telemetry')); client.on('message', (topic, payload) => { document.querySelector('#log').textContent += `${topic}: ${payload}\n`; }); ``` sketch.ino · Arduino Library Manager → PubSubClient ``` #include #include #include WiFiClientSecure net; PubSubClient mqtt(net); void setup() { WiFi.begin("YOUR_WIFI", "YOUR_WIFI_PASSWORD"); while (WiFi.status() != WL_CONNECTED) delay(250); net.setInsecure(); // for a first test; use net.setCACert(...) in production mqtt.setServer("broker.connectmq.com", 8883); } void loop() { if (!mqtt.connected()) { mqtt.connect("esp32-01", "YOUR_USERNAME", "YOUR_PASSWORD"); } mqtt.loop(); static unsigned long last = 0; if (millis() - last > 5000) { last = millis(); mqtt.publish("devices/esp32-01/telemetry", "{\"temperature\":21.5}"); } } ``` main.go · go get github.com/eclipse/paho.mqtt.golang ``` package main import ( "fmt" mqtt "github.com/eclipse/paho.mqtt.golang" ) func main() { opts := mqtt.NewClientOptions(). AddBroker("ssl://broker.connectmq.com:8883"). SetClientID("go-service"). SetUsername("YOUR_USERNAME"). SetPassword("YOUR_PASSWORD") client := mqtt.NewClient(opts) if token := client.Connect(); token.Wait() && token.Error() != nil { panic(token.Error()) } client.Subscribe("devices/+/telemetry", 1, func(_ mqtt.Client, m mqtt.Message) { fmt.Println(m.Topic(), string(m.Payload())) }) client.Publish("devices/sensor-1/telemetry", 1, false, `{"temperature":21.5}`).Wait() select {} } ``` terminal · apt install mosquitto-clients · brew install mosquitto ``` # Subscribe (terminal 1) mosquitto_sub -h broker.connectmq.com -p 8883 --tls-use-os-certs \ -u YOUR_USERNAME -P YOUR_PASSWORD -t 'devices/#' -v # Publish (terminal 2) mosquitto_pub -h broker.connectmq.com -p 8883 --tls-use-os-certs \ -u YOUR_USERNAME -P YOUR_PASSWORD \ -t devices/sensor-1/telemetry -m '{"temperature":21.5}' ``` ## Preguntas frecuentes para desarrolladores ¿Qué puerto debo usar? Usa el 8883 (MQTT sobre TLS) para dispositivos y servicios, y el 8084 (WebSockets seguros, ruta /mqtt) para aplicaciones de navegador. El 1883 y el 8083 no están cifrados y son solo para pruebas rápidas. ¿Dónde encuentro mi usuario y mi contraseña? En tu panel de ConnectMQ en app.connectmq.com, después de registrarte. Crea credenciales independientes para cada dispositivo o servicio. Mi cliente no se conecta, ¿qué debo comprobar? Comprueba que el puerto corresponde al protocolo (TLS en el 8883, WSS en el 8084 con la ruta /mqtt), que las credenciales son correctas y que cada cliente usa un client ID único. ## ¿Listo para conectar tu primer dispositivo? Crea una cuenta, obtén las credenciales de tu broker y conecta tu primer dispositivo, sin servidores que instalar, parchear ni escalar. [Empezar](https://app.connectmq.com/signup) [Ver precios](https://connectmq.com/es/precios/) ## Artículos [Todos los artículos](https://connectmq.com/es/blog/) Tutoriales de IoT ### [Servidor MQTT público gratuito para pruebas: conéctate a broker.connectmq.com en minutos](https://connectmq.com/es/blog/broker-mqtt-publico-gratuito/) broker.connectmq.com es un servidor MQTT público gratuito para pruebas y aprendizaje. Aquí tienes los puertos, las reglas de acceso anónimo, los límites y ejemplos listos para copiar para la CLI, Python, Node.js y el navegador. 20 de septiembre de 20268 min de lectura Tutoriales de IoT ### [MQTT sobre WebSocket: conecta un navegador a un broker MQTT con MQTT.js](https://connectmq.com/es/blog/mqtt-sobre-websocket/) Los navegadores no pueden abrir sockets TCP directos, así que las aplicaciones web hablan MQTT sobre WebSocket. Construye un cliente de navegador y un cliente Node.js funcionales contra broker.connectmq.com y aprende a resolver los errores de conexión más comunes. 29 de septiembre de 20269 min de lectura Tutoriales de IoT ### [Tutorial ESP32 MQTT: publica datos de sensores y controla un LED con Arduino IDE](https://connectmq.com/es/blog/tutorial-esp32-mqtt/) Conecta un ESP32 a un broker MQTT con Arduino IDE y PubSubClient, publica lecturas de temperatura en JSON, controla el LED integrado desde la línea de comandos y pasa a TLS con credenciales del portal. 23 de agosto de 202610 min de lectura