Agentes

Conecte um agente de IA (Claude, Claude Code, Antigravity CLI, VS Code ou Cursor) às suas contas na Glass Data para consultar configurações e eventos na própria conversa. Uma única conexão alcança as contas que você habilitar, com um nível de acesso escolhido para cada conta. O agente acessa as contas pelo protocolo MCP (Model Context Protocol) e opera com as permissões do usuário que autorizou a conexão.

O recurso está em fase de testes. As funcionalidades e os limites de uso podem mudar sem aviso prévio.

A conexão destina-se ao uso interno, pelos colaboradores da conta. Não exponha a conexão a terceiros nem a incorpore a um produto oferecido aos clientes da conta. Para esse uso, fale com o suporte.

Contas e níveis de acesso

O agente alcança apenas as contas das quais você é usuário. Para cada conta, você escolhe um nível de acesso ao autorizar o agente. Depois, você pode alterar o nível em Alterar os acessos.

Acesso	O que autoriza na conta
Sem acesso	nenhuma operação
Ler	ler as configurações (tipos de evento, campos, métricas, análises, monitoramentos, regras e listas) e os dados (leituras de métricas, eventos e itens de listas)
Ler e alterar	tudo de Ler, além de criar, editar, desativar e remover campos, criar rascunhos de regra e criar rascunhos de análise com as suas células

Os dados lidos incluem dados pessoais, como emails, endereços IP e identificadores de dispositivo, nos campos que não estão configurados como sensíveis.

Em cada chamada, a plataforma verifica o nível de acesso do agente na conta e o perfil de acesso do usuário. As duas verificações precisam ser aprovadas. Ler e alterar exige o perfil Editor ou Administração. Nas contas em que o seu perfil não permite edição, a opção aparece desabilitada, com o perfil exigido.

Se um usuário for removido de uma conta, o agente desse usuário perde o acesso a essa conta. O acesso às demais contas não muda.

Conectar um agente

Em Agentes > Conectar agente, a tela exibe a URL do servidor MCP. A URL é a mesma para todas as contas:

https://mcp.glassdata.io/mcp

Selecione o agente pelo logotipo. A tela exibe as instruções do agente e, quando o agente exige, o client_id. Um agente fora da lista precisa ser habilitado pelo suporte antes de conectar.

Claude

Os passos valem para o claude.ai, o Claude Desktop e o aplicativo móvel do Claude. O formulário do conector exibe alguns rótulos em inglês, citados abaixo como aparecem na tela.

1. No Claude, abra Personalizar > Conectores e clique em Adicionar conector personalizado.
2. Informe https://mcp.glassdata.io/mcp como URL do conector.
3. Em OAuth client (cliente OAuth), escolha Use your own OAuth client (usar o seu próprio cliente OAuth). A opção pré-selecionada, Use Claude’s published identity, não funciona com a Glass Data.
4. Cole o client_id exibido em Conectar agente e deixe o segredo do cliente (client secret) em branco.
5. Mantenha Authentication (autenticação) em Sign in now e Transport (transporte) em Streamable HTTP, os valores padrão.
6. Clique em Adicionar e depois em Conectar.
7. No navegador, autorize o acesso.

Nos planos Team e Enterprise, um proprietário da organização adiciona o conector em Configurações da organização > Conectores, com os passos 2 a 5. Depois, cada membro abre Personalizar > Conectores, clica em Conectar no conector da Glass Data e autoriza o próprio acesso.

Claude Code

1. No terminal, execute o comando:

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

2. Abra o Claude Code, digite /mcp, selecione o servidor glassdata e escolha Authenticate.
3. No navegador, autorize o acesso.

O Claude Code não precisa de client_id.

Antigravity CLI, VS Code e Cursor

Para esses agentes, a tela Conectar agente exibe um bloco de configuração com a URL e o client_id já preenchidos.

1. Abra o arquivo de configuração do agente indicado na tela.
2. Cole o bloco de configuração no arquivo e salve. Se o arquivo já tiver outros servidores, copie apenas o bloco da Glass Data, conforme a tela.
3. Ative o servidor no agente, conforme a tela.
4. No navegador, autorize o acesso.

No Antigravity CLI, a autorização termina com um código. Copie o código exibido no navegador e cole-o na janela do agy.

Autorizar o acesso

A tela de autorização tem o título Conectar <agente> às suas contas. Abaixo do título, a tela informa o endereço para o qual o navegador voltará depois da autorização. Confira o endereço antes de autorizar.

1. Para cada conta listada, escolha o Acesso: Sem acesso, Ler ou Ler e alterar.
2. Clique em Autorizar.

A tela lista todas as contas das quais você é usuário. A autorização exige acesso a ao menos uma conta.

Para a equipe da Glass Data, a tela exibe uma única linha em lugar da lista de contas. Ao autorizar, o agente recebe acesso a todas as contas, com todas as permissões.

Alterar os acessos

Agentes lista os agentes que você conectou, com o acesso de cada agente na conta atual, a data da conexão e a última atividade. A última atividade é registrada em intervalos de 15 minutos. A tela indica os agentes que nunca foram usados.

Para alterar o acesso de um agente:

1. Em Agentes, abra o menu da linha do agente e clique em Editar acessos….
2. Escolha o Acesso de cada conta. A tela lista todas as contas das quais você é usuário.
3. Clique em Salvar.

O novo acesso vale a partir da chamada seguinte do agente, sem nova autorização.

Para pausar um agente sem desconectá-lo, escolha Sem acesso em todas as contas. Para retomar o uso, escolha de novo o acesso de cada conta.

Desconectar de todas as contas, no menu da linha, encerra de imediato o acesso do agente a todas as contas. O agente desconectado só volta a operar depois de uma nova autorização. As conexões dos outros agentes e dos outros usuários continuam ativas.

Operações

Cada operação recebe a conta em que atua, pelo slug (o identificador da conta, como loja-br). Para descobrir as contas, o agente consulta a operação Contas. Quando falta acesso, o agente recebe uma recusa com o nome da conta e o link da tela Agentes em que o acesso pode ser habilitado.

O agente consulta configurações, eventos e métricas, cadastra campos, edita rascunhos, compara e simula versões e exporta eventos:

Operação	Conteúdo
Contas	lista das contas do usuário, com o ambiente (produção ou teste), se a conexão está habilitada em cada conta e o que o agente pode fazer nela
Conta	dados gerais de uma conta, o acesso da conexão, o perfil do usuário e as operações retidas, com o que liberaria cada uma
Tipos de evento	lista dos tipos e o detalhe de cada um, com os seus campos e as utilizações de cada campo (métricas, monitoramentos, rastreamento de permanência e versões ativas ou em observação (shadow) de regras e de análises)
Campos	valores já recebidos por um campo, inclusive por um campo de lista sem itens cadastrados
Eventos	contagem dos eventos de um período em blocos de tempo, com divisão opcional por um campo, e as linhas de evento
Regras	lista das regras e o detalhe de uma versão, com as suas condições e ações
Análises	lista das análises e o detalhe de uma, com o efeito de cada célula e as regras que a executam e a registram
Métricas	lista das métricas, o detalhe de uma (dimensões, agregações e filtros) e os valores de um período recente ou de uma janela passada, com a faixa esperada e os alertas
Monitoramentos	lista dos monitoramentos e o detalhe de um, com os seus critérios
Listas	lista das listas configuradas, o detalhe de uma, a verificação de até 100 valores e a consulta dos itens
Rascunhos de regra	criação de uma regra, edição das condições de um rascunho (inclusão, alteração, reordenação e remoção), validação do rascunho e comparação de duas versões condição a condição
Rascunhos de análise	criação de uma análise, abertura de um rascunho a partir de uma versão existente, edição das células (inclusão, alteração, reordenação e remoção) e comparação de duas versões célula a célula
Simulação	simulação de uma versão de regra ou de análise, inclusive de um rascunho, e de uma regra com um rascunho de análise
Exportação	início de uma exportação de eventos, acompanhamento e link de download
Cadastro de campos	criação de um campo, edição (nome, descrição, obrigatoriedade, herança e tamanho máximo), desativação e remoção

A consulta de eventos aceita os mesmos filtros de Explorar, inclusive a referência a uma lista e a comparação entre campos. A consulta cobre uma janela recente, não todo o histórico da conta.

A leitura de uma métrica aceita um período recente ou uma janela passada, com início e fim no formato ISO 8601 <início>/<fim>. A janela passada tem até 3 anos.

A desativação e a remoção de um campo seguem a mesma regra do painel: são recusadas enquanto algum recurso depender do campo, conforme Utilizações. Antes de desativar ou remover, o agente pode verificar, sem alterar nada, se a operação seria aceita e o que depende do campo. O agente não ativa um campo desativado. A ação Ativar é exclusiva do painel. Nos campos do sistema, o agente altera apenas o nome e a descrição.

A comparação de versões é a mesma que o painel apresenta antes da publicação. Em uma regra, a comparação indica as condições incluídas, removidas, alteradas e movidas. Em uma análise, a comparação também indica as alterações que reiniciam a janela de uma célula na publicação, conforme Versões de análise.

A simulação de uma regra com um rascunho de análise testa juntas a regra nova e a análise nova que a regra executa. Nenhuma das duas precisa estar publicada.

O agente não publica regras nem análises. A publicação continua no painel, pela comparação e publicação. Um rascunho de análise criado pelo agente é um rascunho comum no painel. Um rascunho de regra criado pelo agente conta no limite de rascunhos abertos.

A exportação iniciada pelo agente aparece no histórico de exportações da conta e consome o mesmo limite diário de registros. O link de download vale por poucos minutos. O agente obtém um novo link a cada consulta da exportação.

Cada resposta inclui o endereço do artigo correspondente nesta documentação. O agente consulta a referência em vez de deduzir o comportamento da plataforma.

Perguntas típicas

• “Quais contas eu tenho na Glass Data?”
• “Na conta loja-br, qual regra decide os pagamentos?”
• “Compare a taxa de aprovação de ontem nas contas loja-br e loja-mx.”
• “Na conta loja-br, quais métricas existem sobre o campo status?”
• “Na conta loja-br, simule a regra de pagamentos com uma condição nova sobre o BIN antes de eu revisar no painel.”

Limites de uso

As consultas de dados do agente consomem um limite por hora, por usuário e por conta. As exportações têm um limite próprio. O quadro Limites desta hora, na tela Agentes, apresenta o consumo da conta atual em Consultas e em Exportações.

As consultas feitas no painel consomem o mesmo limite de consultas, mas não são bloqueadas. Ao esgotar um limite, o agente recebe uma recusa com o tempo restante até a renovação. Cada limite é renovado uma hora depois da primeira consulta do período.

Além desses limites, as chamadas têm limite por usuário e por conta em uma janela de tempo, com um valor próprio para cada operação. Ao ultrapassar o limite, o agente recebe uma recusa e volta a operar na janela seguinte.

O agente de um usuário executa no máximo 2 operações ao mesmo tempo. Uma terceira chamada simultânea é recusada, e o agente repete a chamada em seguida.

Solução de problemas

O agente diz que a conta não está habilitada

A conexão não tem acesso à conta. Em Agentes, abra Editar acessos… no menu da linha do agente e escolha Ler ou Ler e alterar na conta. O agente passa a acessar a conta na chamada seguinte.

O agente diz que o perfil não permite a operação

O seu perfil de acesso na conta não cobre a operação. Um exemplo é alterar um campo com o perfil Analista. A recusa informa o perfil exigido. Peça esse perfil a um usuário com o perfil Administração na conta. Alterar o acesso do agente não resolve, porque a barreira é o perfil do usuário.

O agente não encontra a conta

Peça ao agente que liste as contas. Se a conta não aparecer na lista, você não é usuário dessa conta. Peça um convite a um usuário com o perfil Administração na conta.

No Claude, a autorização falha porque o cliente não é reconhecido

O conector foi criado com Use Claude’s published identity, a opção pré-selecionada do formulário. Em Personalizar > Conectores, edite o conector da Glass Data e escolha Use your own OAuth client. Depois, cole o client_id exibido em Conectar agente e deixe o segredo do cliente em branco.

A autorização falha porque o cliente não é reconhecido

O agente enviou um client_id errado. No formulário do agente, informe o client_id exibido em Conectar agente, não o nome do agente. Se o agente não aparecer em Conectar agente, fale com o suporte.

O agente recusa uma consulta por limite de uso

O agente esgotou o limite da hora. A recusa informa o tempo restante até a renovação. O consumo aparece em Limites desta hora, na tela Agentes. Veja Limites de uso.