TagoIO

Interactúa con tu cuenta de TagoIO para acceder a dispositivos, datos y recursos de la plataforma para desarrollo y análisis inteligente de datos.

GitHub

Prueba este MCPPatrocinado

Documentación

TagoIO

TagoIO | Servidor MCP

Trabaja en tu cuenta de TagoIO simplemente preguntando. Tu asistente de IA lee tus dispositivos, datos, paneles y análisis, y realiza los cambios que le pidas, desde tu IDE o herramienta de chat.

Comienza aquí

Obtén un token. Genera un Token de Perfil en Configuración de Perfil de TagoIO.
Añade el servidor a tu cliente. Usa un botón de instalación de arriba, o copia la configuración para tu herramienta desde Configuración del cliente.
Haz una pregunta. Prueba: "Lista mis dispositivos y dime cuáles dejaron de enviar datos esta semana."

Tu cliente se conecta al servidor alojado de TagoIO en https://mcp.ai.tago.io. También puedes ejecutar el servidor tú mismo.

Lo que puedes pedir

El servidor le da a tu asistente alrededor de 80 capacidades enfocadas en tu cuenta. Tú describes el resultado y él elige las herramientas. Algunas cosas que funcionan bien hoy:

Entiende tu flota

"¿Qué dispositivos no han enviado datos en los últimos 7 días?"
"Muéstrame los últimos 50 registros del Medidor de Agua 12 y resume la variable de flujo."
"Crea un dispositivo en mi red LoRaWAN y luego dame su token."

Depura sin cambiar de pestaña

"El análisis del Informe Diario falló anoche. Lee la consola y dime por qué."
"Corrige el error que encontraste, sube el script y ejecútalo una vez para confirmar."
"Un cliente dice que su panel está vacío. Inicia sesión como ese usuario y verifica qué ve."

Crea paneles a partir de una descripción

"Crea un panel para mi flota de cadena de frío: un mapa de las unidades, un gráfico de líneas de temperatura de las últimas 24 horas y una tarjeta para el nivel de batería."
"Este indicador no muestra ningún valor. Compara su configuración con las variables que el dispositivo realmente envía."

Desenreda permisos

"Mi análisis recibe un error de permiso al escribir en la entidad Sites. ¿Qué política necesita?"
"Muéstrame todas las políticas de acceso que tocan a los usuarios de TagoRUN."

Mantén la cuenta ordenada

"¿Qué tan cerca estoy de mi límite de registros de datos este mes?"
"Encuentra archivos almacenados con más de un año y mayores de 5 MB, y luego elimínalos."

Escribe código con la documentación en contexto

"Encuentra el ejemplo oficial para analizar el payload de un Dragino LHT65 y adáptalo a mi dispositivo."

El servidor lee y escribe. Eliminar datos, rotar credenciales y subir scripts pasan por el flujo de confirmación de tu asistente, así que apruebas cada cambio antes de que se aplique.

Configuración del cliente

Cada configuración a continuación apunta al servidor alojado. Reemplaza YOUR-TAGOIO-TOKEN con tu Token de Perfil.

Cliente	Dónde vive la configuración
VS Code / GitHub Copilot	`.vscode/mcp.json` o Configuración de Usuario
Claude Code	`claude mcp add-json` CLI
Claude Desktop	`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS), `%APPDATA%\Claude\claude_desktop_config.json` (Windows)
Cursor	`~/.cursor/mcp.json`
Windsurf	`~/.codeium/windsurf/mcp_config.json`
IDE de JetBrains	Configuración > Herramientas > Asistente de IA > MCP
CLI de Google Gemini	`~/.gemini/settings.json`
CLI de Amazon Q	`~/.aws/amazonq/mcp.json`
Warp	`~/.warp/mcp.json`
Kiro	`.kiro/mcp.json`
OpenAI Agents / ChatGPT	Interfaz del Agent Builder

VS Code / GitHub Copilot

Añádelo a .vscode/mcp.json para un proyecto, o a la Configuración de Usuario para todos. VS Code Insiders usa la misma configuración, y Copilot lee el mismo archivo.

{
  "servers": {
    "@tago-io/mcp": {
      "type": "http",
      "url": "https://mcp.ai.tago.io",
      "headers": {
        "Authorization": "Bearer ${input:tagoToken}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "tagoToken",
      "description": "TagoIO Profile Token",
      "password": true
    }
  ]
}

Claude Code

claude mcp add-json tagoio '{"type":"http","url":"https://mcp.ai.tago.io","headers":{"Authorization":"Bearer YOUR-TAGOIO-TOKEN"}}'

Claude Desktop

Conéctate a través del puente mcp-remote.

{
  "mcpServers": {
    "@tago-io/mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.ai.tago.io",
        "--header",
        "Authorization: Bearer YOUR-TAGOIO-TOKEN"
      ]
    }
  }
}

Cursor

{
  "mcpServers": {
    "@tago-io/mcp": {
      "url": "https://mcp.ai.tago.io",
      "headers": {
        "Authorization": "Bearer YOUR-TAGOIO-TOKEN"
      }
    }
  }
}

Windsurf

{
  "mcpServers": {
    "@tago-io/mcp": {
      "serverUrl": "https://mcp.ai.tago.io",
      "headers": {
        "Authorization": "Bearer YOUR-TAGOIO-TOKEN"
      }
    }
  }
}

IDE de JetBrains

Abre Configuración > Herramientas > Asistente de IA > Model Context Protocol (MCP), añade un servidor y pega:

{
  "servers": {
    "@tago-io/mcp": {
      "url": "https://mcp.ai.tago.io",
      "requestInit": {
        "headers": {
          "Authorization": "Bearer YOUR-TAGOIO-TOKEN"
        }
      }
    }
  }
}

CLI de Google Gemini

{
  "mcpServers": {
    "@tago-io/mcp": {
      "httpUrl": "https://mcp.ai.tago.io",
      "headers": {
        "Authorization": "Bearer YOUR-TAGOIO-TOKEN"
      }
    }
  }
}

CLI de Amazon Q

{
  "mcpServers": {
    "@tago-io/mcp": {
      "url": "https://mcp.ai.tago.io",
      "headers": {
        "Authorization": "Bearer YOUR-TAGOIO-TOKEN"
      }
    }
  }
}

Warp

Conéctate a través del puente mcp-remote.

{
  "mcpServers": {
    "@tago-io/mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.ai.tago.io",
        "--header",
        "Authorization: Bearer YOUR-TAGOIO-TOKEN"
      ]
    }
  }
}

Kiro

Conéctate a través del puente mcp-remote, en .kiro/mcp.json en la raíz de tu proyecto.

{
  "mcpServers": {
    "@tago-io/mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.ai.tago.io",
        "--header",
        "Authorization: Bearer YOUR-TAGOIO-TOKEN"
      ]
    }
  }
}

OpenAI Agents / ChatGPT

En la configuración de MCP del Agent Builder o ChatGPT:

URL del servidor: https://mcp.ai.tago.io
Protocolo: Streamable HTTP
Autenticación: cabecera Authorization: Bearer YOUR-TAGOIO-TOKEN

Elegir un token

Token	Dónde obtenerlo	Qué alcanza
Perfil	Configuración de Perfil	Todo tu perfil. Comienza aquí.
Análisis	Análisis > tu análisis, configurado para ejecutarse "Externo"	Solo lo que ese análisis puede alcanzar. Adecuado para entornos compartidos y de producción donde el acceso se controla mediante IAM.
Dispositivo	El propio dispositivo	Los datos de ese dispositivo. Las solicitudes a nivel de cuenta devuelven un error de permiso.

Regiones y endpoints

Las solicitudes van a US East por defecto. Configura la cabecera x-tagoio-region para llegar a un endpoint diferente:

Valor	Destino
`us-e1`	US East (predeterminado)
`eu-w1`	EU West
`https://api.your-instance.io`	Tu instancia dedicada de TagoDeploy

x-tagoio-region: eu-w1

Para TagoDeploy, pasa el endpoint completo de la API de tu instancia a través de https://. Esto funciona en el servidor alojado, así que una instancia dedicada necesita la misma configuración de una línea que una región pública.

Por STDIO no hay cabeceras. Configura TAGOIO_API con tu endpoint en su lugar.

Ejecútalo localmente

Ejecuta el servidor en tu propia máquina para trabajar sin conexión, o cuando tu red bloquee conexiones salientes. Instala Node.js 22.12 o más reciente, y luego:

npx -y @tago-io/mcp-server        # STDIO, what desktop apps and IDEs expect
npx -y @tago-io/mcp-server http   # HTTP on port 3000

STDIO lee el token del entorno:

{
  "mcpServers": {
    "@tago-io/mcp": {
      "command": "npx",
      "args": ["-y", "@tago-io/mcp-server"],
      "env": {
        "TAGOIO_TOKEN": "YOUR-TAGOIO-TOKEN"
      }
    }
  }
}

Para Claude Code:

claude mcp add @tago-io/mcp-server -e TAGOIO_TOKEN=YOUR-TAGOIO-TOKEN -- npx -y @tago-io/mcp-server

El modo HTTP toma el token por solicitud, así que varias personas pueden compartir un servidor con sus propias credenciales. Configura el puerto con MCP_PORT, y verifica GET /health para confirmar que el servidor está activo. Para apuntar cualquier configuración de este README a tu servidor local, cambia la URL por http://localhost:3000. Ejecuta npx -y @tago-io/mcp-server --help para la lista completa de opciones.

Escribir widgets personalizados

Los widgets personalizados son componentes de React con un contrato de autoría estricto: un envoltorio de proveedor, dependencias fijadas de npm:, un marcador // tailwind. El servidor valida tu código contra ese contrato e informa qué lo incumple.

La habilidad de widget personalizado enseña el contrato en sí, con ejemplos prácticos. Instálala para Claude Code:

# all projects
mkdir -p ~/.claude/skills/custom-widget-development
curl -fsSL https://raw.githubusercontent.com/tago-io/mcp-server/master/skills/custom-widget-development/SKILL.md \
  -o ~/.claude/skills/custom-widget-development/SKILL.md

# one project
mkdir -p .claude/skills/custom-widget-development
curl -fsSL https://raw.githubusercontent.com/tago-io/mcp-server/master/skills/custom-widget-development/SKILL.md \
  -o .claude/skills/custom-widget-development/SKILL.md

Para otros clientes, coloca el mismo archivo donde ese cliente cargue habilidades o indicaciones reutilizables.

Tu token y tus datos

El servidor elimina tu token de cada resultado, error, descarga de script y salida de consola antes de que llegue a tu asistente. Los valores de variables de entorno, tokens de análisis generados y URLs de archivos firmados reciben el mismo tratamiento.

Algunas configuraciones permanecen en el administrador de TagoIO: configuración del entorno de TagoRUN, SSO y dominios personalizados, correos de prueba y creación de usuarios anónimos.

Solución de problemas

No se conecta. Confirma que el token sigue siendo válido y que https://mcp.ai.tago.io es accesible desde tu red. Si tu cuenta vive en EU West, configura la cabecera x-tagoio-region.

Error de autenticación. Por HTTP la cabecera se lee como Bearer YOUR-TOKEN, con el espacio. Por STDIO el token va en TAGOIO_TOKEN. Si el formato es correcto, el token puede carecer de permiso para lo que pediste.

Una solicitud vuelve vacía. Dos causas habituales: el dispositivo no tiene datos en el período que preguntaste, o tu perfil no tiene acceso a ese dispositivo.

El puente falla (Claude Desktop, Warp, Kiro). Verifica Node.js 22.12 o más reciente, y luego ejecuta el puente manualmente para leer el error real:

npx -y mcp-remote https://mcp.ai.tago.io --header "Authorization: Bearer YOUR-TOKEN"

Referencia completa de herramientas

Cada herramienta que el servidor expone, agrupada por dominio. Cada una lleva sus propios parámetros, límites y anotación de lectura o escritura en la descripción que tu cliente lee.

Dominio	Herramientas
Dispositivos	`search_devices`, `get_device`, `create_device`, `update_device`, `delete_device`, `configure_device`
Datos de dispositivos	`read_device_data`, `send_device_data`, `edit_device_data`, `delete_device_data`
Acciones	`search_actions`, `get_action`, `create_action`, `update_action`, `delete_action`
Análisis	`search_analyses`, `get_analysis`, `create_analysis`, `update_analysis`, `delete_analysis`, `upload_analysis_script`, `download_analysis_script`, `run_analysis`, `read_analysis_console`
Paneles y widgets	`search_dashboards`, `get_dashboard`, `create_dashboard`, `update_dashboard`, `delete_dashboard`, `get_widget`, `create_widget`, `update_widget`, `delete_widget`, `widget_schema_lookup`, `validate_widget_configuration`, `get_custom_widget_code`, `upload_custom_widget_code`
Entidades	`search_entities`, `get_entity`, `create_entity`, `update_entity`, `delete_entity`, `update_entity_schema`
Datos de entidades	`read_entity_data`, `send_entity_data`, `edit_entity_data`, `delete_entity_data`, `empty_entity_data`
Usuarios de ejecución	`search_run_users`, `get_run_user`, `create_run_user`, `update_run_user`, `delete_run_user`, `login_as_run_user`
Notificaciones de usuarios de ejecución	`read_run_user_notifications`, `send_run_user_notification`, `update_run_user_notification`, `delete_run_user_notification`
Archivos	`search_files`, `delete_files`
Gestión de accesos	`search_access_policies`, `get_access_policy`, `lookup_access_permissions`, `create_analysis_access_policy`, `create_run_user_access_policy`, `update_analysis_access_policy`, `update_run_user_access_policy`, `delete_access_policy`
Perfil	`get_profile`, `get_profile_limits`, `get_profile_statistics`, `search_secrets`
Conectores y redes	`search_connectors`, `get_connector`, `search_networks`, `get_network`
Documentación y ejemplos	`platform_overview`, `search_docs`, `read_doc`, `search_code_examples`, `get_code_example`

Contribuir

Las issues y pull requests son bienvenidas. Las instrucciones para agentes están en AGENTS.md.

Licencia

MIT. Consulta el archivo LICENSE.

Creado por el equipo de TagoIO. ¿Necesitas ayuda? Consulta la documentación de TagoIO o contacta con soporte.