TagoIO | Servidor MCP
El Servidor MCP de TagoIO permite a los modelos de IA interactuar directamente con tu cuenta de TagoIO, proporcionando acceso contextual a dispositivos, datos y recursos de plataforma para mejorar los flujos de trabajo de desarrollo y el análisis inteligente de datos.
Características
- Gestión de Dispositivos: Acceso a información de dispositivos, configuraciones y datos en tiempo real
- Análisis de datos: Realiza operaciones estadísticas (sumas, medias, informes) sobre los datos almacenados
- Integración de plataformas: Recuperar usuarios, acciones, scripts de análisis y estadísticas de cuentas
- Generación de código: Generación de scripts de análisis TagoIO impulsada por IA con el contexto adecuado
- Soporte al Desarrollo: Asistencia de depuración y análisis de relación de etiquetas
Inicio Rápido
Requisitos previos
- Node.js 18+ instalado(https://nodejs.org/en/download/)
- Cuenta TagoIO con token de perfil válido o token de análisis
- Plataforma de IA o IDE compatible (ver Plataformas Soportadas)
Instalación
Configuración Manual
Crea o actualiza tu fichero de configuración MCP:
{ "mcpServers": { "@tago-io/mcp": { "command": "npx", "args": ["-y", "@tago-io/mcp-server"], "env": {"TAGOIO_TOKEN": "YOUR-TOKEN", "TAGOIO_API": "https://api.us-e1.tago.io" } } }
Parámetros de configuración:
- Sustituye
YOUR-TOKEN
por tu token de perfil TagoIO o un token de análisis- Se recomienda utilizar un token de Análisis para una mayor seguridad, ya que puedes limitar los permisos del token sólo a los recursos que necesites. Tu análisis debe estar configurado para ejecutarse de forma "Externa" para que puedas usar el token.
- Si utiliza un token de perfil, el MCP tendrá acceso instantáneo a todo su perfil, pero no se recomienda para entornos de producción.
- Actualizar el punto final de la API a
https://api.eu-w1.tago.io
para cuentas europeas
Configuración específica de la plataforma
Claude Desktop
- Descargue e instale Claude Desktop
- Copie la configuración MCP anterior
- Envía el mensaje: "Oye Claude, instala el siguiente servidor MCP" con la configuración
- Claude instalará y configurará automáticamente el servidor
Instalación con un solo clic para IDEs de desarrollo
O coloque el archivo de configuración en la ubicación adecuada para su IDE y reinicie la aplicación.
Plataforma | Ruta de configuración |
---|---|
Cursor | ~/.cursor/mcp.json |
Windsurf | ~/.codeium/windsurf/mcp_config.json |
Cline | ~/.cline/mcp_config.json |
Claude Escritorio | ~/.claude/mcp_config.json |
Autenticación
El servidor MCP requiere un TagoIO Profile Token para la autenticación:
- Inicie sesión en su cuenta TagoIO
- Navega a Configuración de la cuenta → Token de perfil
- Genere un nuevo token con los permisos apropiados
- Sustituya
YOUR-PROFILE-TOKEN
en la configuración
Nota de seguridad: Mantenga su token de perfil seguro y nunca lo envíe al control de versiones.
Puntos finales de la API
El servidor soporta instancias TagoIO tanto de EEUU como de Europa:
- US Este:
https://api.us-e1.tago.io
(por defecto) - UE Oeste:
https://api.eu-w1.tago.io
Resolución de problemas
Problemas comunes
Fallo de conexión
- Compruebe la validez de su token de perfil
- Asegúrese de que el punto final de la API es correcto para su región
Error de autenticación
- Confirme que el token de perfil o de análisis tiene los permisos necesarios
- Verifique el formato del token en el archivo de configuración
Problemas de acceso a datos
- Compruebe los permisos del dispositivo en su cuenta TagoIO
- Asegúrese de que los dispositivos tienen datos recientes disponibles
Licencia
Este proyecto está licenciado bajo la Licencia MIT - ver el archivo LICENSE para más detalles.
¿Necesitas Ayuda? Visita la Documentación de TagoIO o contacta con nuestro equipo de soporte.