Agentes

Conecte un agente de IA (Claude, Claude Code, Antigravity CLI, VS Code o Cursor) a sus cuentas en Glass Data para consultar configuraciones y eventos en la propia conversación. Una única conexión alcanza las cuentas que usted habilite, con un nivel de acceso elegido para cada cuenta. El agente accede a las cuentas mediante el protocolo MCP (Model Context Protocol) y opera con los permisos del usuario que autorizó la conexión.

La función está en fase de pruebas. Las funcionalidades y los límites de uso pueden cambiar sin aviso previo.

La conexión está destinada al uso interno, por parte de los colaboradores de la cuenta. No exponga la conexión a terceros ni la incorpore a un producto ofrecido a los clientes de la cuenta. Para ese uso, hable con soporte.

Cuentas y niveles de acceso

El agente alcanza solo las cuentas de las que usted es usuario. Para cada cuenta, usted elige un nivel de acceso al autorizar el agente. Después, puede cambiar el nivel en Cambiar los accesos.

Acceso	Qué autoriza en la cuenta
Sin acceso	ninguna operación
Leer	leer las configuraciones (tipos de evento, campos, métricas, análisis, monitoreos, reglas y listas) y los datos (lecturas de métricas, eventos e ítems de listas)
Leer y modificar	todo lo de Leer, además de crear, editar, desactivar y eliminar campos, crear borradores de regla y crear borradores de análisis con sus celdas

Los datos leídos incluyen datos personales, como emails, direcciones IP e identificadores de dispositivo, en los campos que no están configurados como sensibles.

En cada llamada, la plataforma verifica el nivel de acceso del agente en la cuenta y el perfil de acceso del usuario. Las dos verificaciones deben aprobarse. Leer y modificar exige el perfil Editor o Administración. En las cuentas en las que su perfil no permite edición, la opción aparece deshabilitada, con el perfil exigido.

Si un usuario es eliminado de una cuenta, el agente de ese usuario pierde el acceso a esa cuenta. El acceso a las demás cuentas no cambia.

Conectar un agente

En Agentes > Conectar agente, la pantalla muestra la URL del servidor MCP. La URL es la misma para todas las cuentas:

https://mcp.glassdata.io/mcp

Seleccione el agente por su logotipo. La pantalla muestra las instrucciones del agente y, cuando el agente lo exige, el client_id. Un agente fuera de la lista debe ser habilitado por soporte antes de conectarse.

Claude

Los pasos valen para claude.ai, Claude Desktop y la aplicación móvil de Claude. El formulario del conector muestra algunas etiquetas en inglés, citadas abajo como aparecen en la pantalla.

1. En Claude, abra Personalizar > Conectores y haga clic en Agregar conector personalizado.
2. Indique https://mcp.glassdata.io/mcp como URL del conector.
3. En OAuth client (cliente OAuth), elija Use your own OAuth client (usar su propio cliente OAuth). La opción preseleccionada, Use Claude’s published identity, no funciona con Glass Data.
4. Pegue el client_id mostrado en Conectar agente y deje el secreto del cliente (client secret) en blanco.
5. Mantenga Authentication (autenticación) en Sign in now y Transport (transporte) en Streamable HTTP, los valores predeterminados.
6. Haga clic en Agregar y después en Conectar.
7. En el navegador, autorice el acceso.

En los planes Team y Enterprise, un propietario de la organización agrega el conector en Configuración de la organización > Conectores, con los pasos 2 a 5. Después, cada miembro abre Personalizar > Conectores, hace clic en Conectar en el conector de Glass Data y autoriza su propio acceso.

Claude Code

1. En la terminal, ejecute el comando:

   claude mcp add --transport http glassdata https://mcp.glassdata.io/mcp
   

2. Abra Claude Code, escriba /mcp, seleccione el servidor glassdata y elija Authenticate.
3. En el navegador, autorice el acceso.

Claude Code no necesita client_id.

Antigravity CLI, VS Code y Cursor

Para estos agentes, la pantalla Conectar agente muestra un bloque de configuración con la URL y el client_id ya completados.

1. Abra el archivo de configuración del agente indicado en la pantalla.
2. Pegue el bloque de configuración en el archivo y guárdelo. Si el archivo ya tiene otros servidores, copie solo el bloque de Glass Data, según la pantalla.
3. Active el servidor en el agente, según la pantalla.
4. En el navegador, autorice el acceso.

En Antigravity CLI, la autorización termina con un código. Copie el código mostrado en el navegador y péguelo en la ventana de agy.

Autorizar el acceso

La pantalla de autorización tiene el título Conectar <agente> a sus cuentas. Debajo del título, la pantalla informa la dirección a la que volverá el navegador después de la autorización. Verifique esa dirección antes de autorizar.

1. Para cada cuenta listada, elija el Acceso: Sin acceso, Leer o Leer y modificar.
2. Haga clic en Autorizar.

La pantalla lista todas las cuentas de las que usted es usuario. La autorización exige acceso a al menos una cuenta.

Para el equipo de Glass Data, la pantalla muestra una única línea en lugar de la lista de cuentas. Al autorizar, el agente recibe acceso a todas las cuentas, con todos los permisos.

Cambiar los accesos

Agentes lista los agentes que usted conectó, con el acceso de cada agente en la cuenta actual, la fecha de la conexión y la última actividad. La última actividad se registra en intervalos de 15 minutos. La pantalla indica los agentes que nunca se usaron.

Para cambiar el acceso de un agente:

1. En Agentes, abra el menú de la fila del agente y haga clic en Editar accesos….
2. Elija el Acceso de cada cuenta. La pantalla lista todas las cuentas de las que usted es usuario.
3. Haga clic en Guardar.

El nuevo acceso vale a partir de la llamada siguiente del agente, sin nueva autorización.

Para pausar un agente sin desconectarlo, elija Sin acceso en todas las cuentas. Para retomar el uso, elija de nuevo el acceso de cada cuenta.

Desconectar de todas las cuentas, en el menú de la fila, cierra de inmediato el acceso del agente a todas las cuentas. El agente desconectado solo vuelve a operar después de una nueva autorización. Las conexiones de los otros agentes y de los otros usuarios siguen activas.

Operaciones

Cada operación recibe la cuenta sobre la que actúa, por su slug (el identificador de la cuenta, como tienda-ar). Para descubrir las cuentas, el agente consulta la operación Cuentas. Cuando falta acceso, el agente recibe un rechazo con el nombre de la cuenta y el enlace de la pantalla Agentes en la que se puede habilitar el acceso.

El agente consulta configuraciones, eventos y métricas, gestiona campos, edita borradores, compara y simula versiones y exporta eventos:

Operación	Contenido
Cuentas	lista de las cuentas del usuario, con el ambiente (producción o prueba), si la conexión está habilitada en cada cuenta y qué puede hacer el agente en ella
Cuenta	datos generales de una cuenta, el acceso de la conexión, el perfil del usuario y las operaciones retenidas, con lo que liberaría cada una
Tipos de evento	lista de los tipos y el detalle de cada uno, con sus campos y los usos de cada campo (métricas, monitoreos, rastreo de permanencia y versiones activas o en observación (shadow) de reglas y de análisis)
Campos	valores ya recibidos por un campo, incluso por un campo de lista sin ítems registrados
Eventos	conteo de los eventos de un período en bloques de tiempo, con división opcional por un campo, y las filas de evento
Reglas	lista de las reglas y el detalle de una versión, con sus condiciones y acciones
Análisis	lista de los análisis y el detalle de uno, con el efecto de cada celda y las reglas que lo ejecutan y lo registran
Métricas	lista de las métricas, el detalle de una (dimensiones, agregaciones y filtros) y los valores de un período reciente o de una ventana pasada, con la franja esperada y las alertas
Monitoreos	lista de los monitoreos y el detalle de uno, con sus criterios
Listas	lista de las listas configuradas, el detalle de una, la verificación de hasta 100 valores y la consulta de los ítems
Borradores de regla	creación de una regla, edición de las condiciones de un borrador (inclusión, cambio, reordenación y eliminación), validación del borrador y comparación de dos versiones condición por condición
Borradores de análisis	creación de un análisis, apertura de un borrador a partir de una versión existente, edición de las celdas (inclusión, cambio, reordenación y eliminación) y comparación de dos versiones celda por celda
Simulación	simulación de una versión de regla o de análisis, incluso de un borrador, y de una regla con un borrador de análisis
Exportación	inicio de una exportación de eventos, seguimiento y enlace de descarga
Gestión de campos	creación de un campo, edición (nombre, descripción, obligatoriedad, herencia y tamaño máximo), desactivación y eliminación

La consulta de eventos admite los mismos filtros de Explorar, incluida la referencia a una lista y la comparación entre campos. La consulta cubre una ventana reciente, no todo el historial de la cuenta.

La lectura de una métrica admite un período reciente o una ventana pasada, con inicio y fin en el formato ISO 8601 <inicio>/<fin>. La ventana pasada tiene hasta 3 años.

La desactivación y la eliminación de un campo siguen la misma regla del panel: se rechazan mientras algún recurso dependa del campo, según Usos. Antes de desactivar o eliminar, el agente puede verificar, sin cambiar nada, si la operación sería aceptada y qué depende del campo. El agente no activa un campo desactivado. La acción Activar es exclusiva del panel. En los campos del sistema, el agente modifica solo el nombre y la descripción.

La comparación de versiones es la misma que el panel presenta antes de la publicación. En una regla, la comparación indica las condiciones incluidas, eliminadas, modificadas y movidas. En un análisis, la comparación también indica los cambios que reinician la ventana de una celda al publicar, según Versiones de análisis.

La simulación de una regla con un borrador de análisis prueba juntos la regla nueva y el análisis nuevo que la regla ejecuta. Ninguno de los dos necesita estar publicado.

El agente no publica reglas ni análisis. La publicación sigue en el panel, mediante la comparación y publicación. Un borrador de análisis creado por el agente es un borrador común en el panel. Un borrador de regla creado por el agente cuenta en el límite de borradores abiertos.

La exportación iniciada por el agente aparece en el historial de exportaciones de la cuenta y consume el mismo límite diario de registros. El enlace de descarga vale por pocos minutos. El agente obtiene un nuevo enlace en cada consulta de la exportación.

Cada respuesta incluye la dirección del artículo correspondiente de esta documentación. El agente consulta la referencia en lugar de deducir el comportamiento de la plataforma.

Preguntas típicas

• “¿Qué cuentas tengo en Glass Data?”
• “En la cuenta tienda-ar, ¿qué regla decide los pagos?”
• “Compara la tasa de aprobación de ayer en las cuentas tienda-ar y tienda-mx.”
• “En la cuenta tienda-ar, ¿qué métricas existen sobre el campo status?”
• “En la cuenta tienda-ar, simula la regla de pagos con una condición nueva sobre el BIN antes de que yo la revise en el panel.”

Límites de uso

Las consultas de datos del agente consumen un límite por hora, por usuario y por cuenta. Las exportaciones tienen un límite propio. El cuadro Límites de esta hora, en la pantalla Agentes, presenta el consumo de la cuenta actual en Consultas y en Exportaciones.

Las consultas realizadas en el panel consumen el mismo límite de consultas, pero no se bloquean. Al agotar un límite, el agente recibe un rechazo con el tiempo restante hasta la renovación. Cada límite se renueva una hora después de la primera consulta del período.

Además de esos límites, las llamadas tienen límite por usuario y por cuenta en una ventana de tiempo, con un valor propio para cada operación. Al superar el límite, el agente recibe un rechazo y vuelve a operar en la ventana siguiente.

El agente de un usuario ejecuta como máximo 2 operaciones al mismo tiempo. Una tercera llamada simultánea se rechaza, y el agente repite la llamada enseguida.

Solución de problemas

El agente dice que la cuenta no está habilitada

La conexión no tiene acceso a la cuenta. En Agentes, abra Editar accesos… en el menú de la fila del agente y elija Leer o Leer y modificar en la cuenta. El agente pasa a acceder a la cuenta en la llamada siguiente.

El agente dice que el perfil no permite la operación

Su perfil de acceso en la cuenta no cubre la operación. Un ejemplo es cambiar un campo con el perfil Analista. El rechazo informa el perfil exigido. Pida ese perfil a un usuario con el perfil Administración en la cuenta. Cambiar el acceso del agente no lo resuelve, porque la barrera es el perfil del usuario.

El agente no encuentra la cuenta

Pida al agente que liste las cuentas. Si la cuenta no aparece en la lista, usted no es usuario de esa cuenta. Pida una invitación a un usuario con el perfil Administración en la cuenta.

En Claude, la autorización falla porque el cliente no es reconocido

El conector se creó con Use Claude’s published identity, la opción preseleccionada del formulario. En Personalizar > Conectores, edite el conector de Glass Data y elija Use your own OAuth client. Después, pegue el client_id mostrado en Conectar agente y deje el secreto del cliente en blanco.

La autorización falla porque el cliente no es reconocido

El agente envió un client_id incorrecto. En el formulario del agente, indique el client_id mostrado en Conectar agente, no el nombre del agente. Si el agente no aparece en Conectar agente, hable con soporte.

El agente rechaza una consulta por límite de uso

El agente agotó el límite de la hora. El rechazo informa el tiempo restante hasta la renovación. El consumo aparece en Límites de esta hora, en la pantalla Agentes. Consulte Límites de uso.