Tienes dispositivos que reportan datos a TagoIO las veinticuatro horas. Tienes dashboards que los muestran y una API que los entrega. Y ahora tienes asistentes de IA como Claude, que son realmente buenos razonando sobre datos, escribiendo scripts y respondiendo preguntas en lenguaje natural. El movimiento obvio es apuntar uno a tu plataforma de IoT y empezar a preguntarle cosas.
Pero hay una brecha. Los dashboards y las APIs todavía exigen que sepas dónde mirar y cómo consultar. Un dashboard muestra lo que alguien decidió poner en él. La API responde preguntas que ya sabes formular. Un asistente de IA solo ayuda si puede alcanzar de verdad tus datos en vivo, entender la estructura de tus dispositivos y ejecutar consultas en tu nombre. Sin una conexión con tus datos reales, solo está adivinando.
Por eso necesitas un cable entre el asistente y tus datos de IoT. Ese cable es el Model Context Protocol (MCP), y el TagoIO MCP Server es la implementación que conecta un cliente de IA con tu cuenta. Esta guía recorre la configuración de principio a fin, con Claude Desktop como cliente de ejemplo.
Qué hace MCP, en breve
El Model Context Protocol es un estándar abierto que permite a los asistentes de IA comunicarse con herramientas y fuentes de datos externas mediante una interfaz consistente. En lugar de que cada aplicación invente su propio formato de plugin, MCP le da al asistente una forma estándar de descubrir lo que un servidor puede hacer y de invocarlo. Si quieres todo el contexto, lee nuestro artículo complementario, Qué es el Model Context Protocol (MCP) para IoT.
En el caso de TagoIO, el servidor MCP expone tus dispositivos y datos para que un asistente pueda leerlos, responder preguntas en lenguaje natural e incluso generar scripts de Analysis y dashboards a partir de una descripción. El asistente hace el razonamiento. El servidor MCP hace el alcance.
Requisitos previos
Antes de empezar, asegúrate de tener estas cuatro cosas:
- Una cuenta de TagoIO. El plan gratuito cubre 5 dispositivos y 5 dashboards, más que suficiente para probar esto. Regístrate en tago.io si no tienes una.
- Un token de TagoIO. El servidor MCP se autentica con tu cuenta mediante un token. Crea uno acotado a lo que realmente necesitas (más sobre el acotamiento más adelante).
- El TagoIO MCP Server. Es de código abierto, con un repositorio público en GitHub y un artículo en el centro de ayuda.
- Un cliente compatible con MCP. Esta guía usa Claude Desktop, pero el mismo servidor funciona con las apps de Claude, ChatGPT, Cursor, Windsurf y las extensiones de IA de VS Code.
Instala y configura el TagoIO MCP Server
El TagoIO MCP Server admite dos modos de transporte, y cuál elijas depende de dónde quieras que se ejecute.
Modo local (stdio)
En modo local, el servidor MCP se ejecuta como un proceso en tu propia máquina y se comunica con el cliente por entrada y salida estándar (stdio). El cliente lanza el servidor, el servidor habla con TagoIO usando tu token, y todo permanece local salvo las llamadas a la API de TagoIO. Es la configuración más sencilla y un buen punto de partida para un único desarrollador trabajando en una sola máquina.
Configuras el modo local indicándole a tu cliente cómo iniciar el servidor y pasándole tu token de TagoIO. El comando exacto y la forma de proporcionar el token están documentados en el artículo del centro de ayuda de TagoIO MCP, así que sigue las instrucciones actuales de ahí en lugar de copiar una opción que pueda haber cambiado entre versiones.
Modo remoto (HTTP)
La versión 3.0.0 del TagoIO MCP Server añadió soporte remoto por HTTP además del stdio local. En este modo el servidor es accesible por HTTP, así que apuntas el cliente a un endpoint en lugar de lanzar un proceso local. Es útil cuando quieres una configuración compartida, cuando el cliente y el servidor viven en máquinas distintas, o cuando no quieres ejecutar un proceso local en absoluto.
El modo remoto cambia dónde vive tu token y cómo se aseguran las conexiones, así que revisa la documentación para la configuración HTTP y trata el endpoint y el token con el mismo cuidado que cualquier credencial de producción.
Si lo único que necesitas es acceso programático desde tu propio código, no necesitas MCP en absoluto. La API REST de TagoIO sigue siendo la herramienta adecuada para eso. MCP se gana su lugar cuando quieres flujos de trabajo en lenguaje natural y asistidos por IA sobre tus datos.
Conecta Claude Desktop
Claude Desktop lee sus servidores MCP desde un archivo de configuración. Para añadir el servidor de TagoIO, editas ese archivo y agregas una entrada que nombra el servidor y le dice a Claude cómo alcanzarlo: para el modo local, el comando para lanzar el servidor y tu token; para el modo remoto, el endpoint HTTP.
La estructura es un objeto JSON con una entrada por cada servidor MCP. Le das un nombre al servidor de TagoIO, especificas el transporte y proporcionas las credenciales. El artículo del centro de ayuda de TagoIO muestra el bloque de configuración actual para pegar, incluidos los nombres exactos de los campos. Úsalo como tu fuente de verdad, luego guarda el archivo y reinicia Claude Desktop para que detecte el nuevo servidor.
La misma idea aplica a los demás clientes. ChatGPT, Cursor, Windsurf y las extensiones de IA de VS Code tienen cada uno su propio lugar para registrar un servidor MCP, pero la información que proporcionas es la misma: un nombre, un modo de transporte y tu token o endpoint.
Verifica que funciona
Después de reiniciar tu cliente, confirma la conexión antes de confiar en ella.
- Comprueba que el cliente lista el servidor de TagoIO como conectado. La mayoría de los clientes muestran las herramientas o servidores MCP disponibles en algún lugar de su interfaz.
- Haz una pregunta sencilla que requiera alcanzar tu cuenta, como listar tus dispositivos. Si el asistente responde con los nombres reales de tus dispositivos, el cable está vivo.
- Si algo se ve raro, el Live Inspector de TagoIO es útil para confirmar que los datos fluyen del lado del dispositivo, de modo que puedas saber si el problema está en el dispositivo, en los datos o en la conexión MCP.
Prompts de ejemplo para probar
Una vez conectado, el valor se nota en lo que puedes preguntar. Algunos prompts para probar:
- “Lista mis dispositivos y dime cuáles no han reportado datos en las últimas 24 horas.”
- “Muéstrame las últimas lecturas de temperatura del dispositivo X y resume la tendencia de la última semana.”
- “Escribe un script de Analysis de TagoIO que envíe una alerta cuando el valor de un sensor cruce un umbral.”
- “Crea un diseño de dashboard que muestre el estado de todos mis dispositivos de un vistazo.”
El asistente usa el servidor MCP para leer tus datos en los dos primeros casos, y su propio razonamiento más el contexto de TagoIO para generar el script y el dashboard. Tú sigues revisando lo que produce. Los scripts de Analysis y los dashboards generados son un punto de partida, no algo para poner en producción sin leerlo.
Acotamiento del token y seguridad
El servidor MCP actúa con los permisos del token que le des, así que el acotamiento importa.
- Dale al token el mínimo privilegio. Si el asistente solo necesita leer datos, no le entregues un token capaz de borrar dispositivos.
- Trata el token como un secreto. No lo pegues en chats compartidos, no lo subas a un repositorio ni lo pongas en una captura de pantalla. En modo remoto, ten especial cuidado con dónde se guarda el token y quién puede alcanzar el endpoint.
- Rota los tokens si sospechas que se han expuesto, y elimina los que ya no uses.
La comodidad de poder preguntarle cualquier cosa a un asistente es real, pero opera con el acceso que le concedas. Concédelo de forma deliberada.
Solución de problemas comunes
- El cliente no muestra el servidor de TagoIO. Vuelve a revisar el archivo de configuración en busca de JSON válido (una coma o un corchete que falta es la causa habitual) y asegúrate de haber reiniciado el cliente después de editarlo.
- El servidor se conecta pero no puede leer datos. Casi siempre es el token: o es incorrecto, o ha expirado, o está demasiado acotado para lo que pediste. Verifica el token en tu cuenta de TagoIO.
- El modo local no arranca. Confirma que el comando y cualquier runtime del que dependa están instalados y en tu path, luego revisa el artículo del centro de ayuda para conocer el comando de arranque actual.
- El modo remoto agota el tiempo de espera. Confirma que el endpoint es accesible desde tu máquina y que nada en el medio está bloqueando la conexión.
- Los datos se ven obsoletos o vacíos. Usa el Live Inspector para confirmar que el dispositivo está enviando de verdad, para que no estés depurando la conexión cuando el problema real está en el dispositivo.
Los mismos pasos aplican en otros lugares
Todo lo anterior usó Claude Desktop, pero nada de ello es específico de Claude. ChatGPT, Cursor, Windsurf y las extensiones de IA de VS Code son todos compatibles con MCP y se conectan al TagoIO MCP Server de la misma manera. Elige el cliente que ya usas. El servidor, el token y los datos son los mismos del otro lado.
Resumen
Los dashboards y las APIs siguen siendo las herramientas adecuadas cuando sabes exactamente qué quieres y cómo pedirlo. MCP llena el vacío cuando prefieres preguntar en lenguaje natural y dejar que un asistente de IA haga el alcance y el razonamiento. Para configurarlo: consigue una cuenta de TagoIO y un token acotado, instala el TagoIO MCP Server en modo local o remoto, regístralo en la configuración de tu cliente, verifica la conexión con un prompt sencillo y mantén tu token bien protegido. Luego pregúntale a tu asistente sobre tus dispositivos y deja que trabaje contra tus datos reales.
Recursos
- Documentación del TagoIO MCP Server
- Qué es el Model Context Protocol (MCP) para IoT, el artículo complementario
- Precios y planes de TagoIO
