Conecte os registros de CNC e de máquina ao Claude com o MCP.

Registros de máquinasPlano gratuitoFluxos de consultaClaude

Logs de máquina → Claude · com Query Streams

Com Query Streams, pergunte ao Claude sobre seu arquivo de logs de máquina em linguagem natural: o Agent, que já está dentro da sua rede, executa o SQL em modo somente leitura, e nenhuma senha do banco de dados chega à IA. Leva cerca de dez minutos, e o plano Free dá conta.

Comece gratuitamente

O resultado final será o que você obterá.

Um Claude capaz de responder a perguntas sobre os logs do seu CNC, PLC e controlador de robô com consultas em tempo real, somente leitura, nas tabelas que o Agente cria a partir dos seus arquivos, e informar de qual arquivo cada resposta veio — sem nunca ver um login ou caminho de arquivo, e sem alterar o firewall: o Agente, já dentro da sua rede, lê a pasta e envia apenas as linhas. Uma vez que o Agente esteja instalado, conectar o Claude leva cerca de 90 segundos, caso você esteja familiarizado com uma tela de configurações. Assim:

Claude · conectado a Fluxos de Consulta Somente leitura

Quais alarmes mantiveram as máquinas inoperantes por mais tempo esta semana?

qs_get_table_schema qs_executar_consulta inteligência_de_esquema

Claude lê a estrutura de conjunto de arquivos.alarms Primeiro. Em seguida, executa uma consulta SELECT em seu agente, filtrada para esta semana e classificada por duração_s, do mais longo para o mais antigo.

código	gravidade	duração_s
SV0401	FALTA	2710
OT0500	FALTA	1325
EX1015	AVISO	640

Claude responde com base nas linhas armazenadas em cache na última verificação do Agente. A tabela de alarmes só existe quando o seu tipo de log a cria, portanto, verifique o perfil antes de perguntar sobre ciclos ou OEE.

Qual máquina perde mais tempo com alarmes, e essa situação está piorando semana após semana?

qs_executar_consulta qs_executar_consulta

Eu somei duração_s em conjunto de arquivos.alarms por máquina Para esta semana e a anterior, extraí o código de alarme mais frequente de cada máquina:

máquina	Em baixa esta semana	Semana passada	Alarme superior
cnc-07	4 h 12 m	1 h 50 m	SV0401 sobrecarga do servo
nc-03	1 h 05 min	1 h 10 m	Troca de ferramenta EX1010
cnc-12	0 h 40 m	0 h 35 m	Porta PS0100 aberta

cnc-07 mais que dobrou, e 80% do seu tempo de inatividade é SV0401 sempre no mesmo eixo Z, em episódios mais longos todos os dias. Isso indica que um servo está com defeito, não é erro do operador. Os outros dois estão estáveis.

Somente SELECIONAR, verificado pelo Agente Acessei a guia Atividade do MCP. 6 linhas retornadas em 3 consultas

Prefere não instalar um cliente de IA? No plano de negócios, Nova é o assistente integrado ao próprio Query Streams. Ele usa o mesmo conjunto de ferramentas do Agent que seu cliente de IA obtém aqui, além de recursos que um cliente externo não oferece: ele elabora e valida o SQL com base no seu modelo de Inteligência Semântica, transforma a resposta em um gráfico e salva o resultado como uma consulta que sua equipe pode executar no Excel, Planilhas Google ou na API REST — sem chave, sem conector, sem necessidade de instalação. Use o MCP quando sua equipe já utiliza o Claude, o Cursor ou o ChatGPT; use o Nova quando desejar as respostas dentro do Portal.

O cartão de Registros de Máquina lê os arquivos de registro que seus controladores CNC, PLCs e robôs gravam e transforma cada evento em uma linha que o Claude pode consultar. Em vez de um servidor, você direciona o Agente para uma pasta de registro em um computador que possa abri-la. Os arquivos são monitorados à medida que crescem e um arquivo rotacionado é reconhecido para que não seja lido duas vezes. Alguns perfis de máquina também criam tabelas de alarmes, ciclos e tempo de inatividade.

O que você vai precisar

Uma conta do Query Streams

O MCP está disponível em todos os planos, inclusive no plano gratuito. O plano gratuito permite uma chave ou um aplicativo conectado, que é tudo o que este guia precisa. Cadastre-se em my.querystreams.com.

O agente em um computador que pode abrir a pasta

Versão 2.6.0 ou posterior. A pasta pode estar nesse computador ou em um compartilhamento de arquivos acessível a ele. O Agente é executado como um serviço, portanto, digite "compartilhamentos" como \\servidor\compartilhamento\pasta, não como uma letra de unidade mapeada. No Windows, ele pode fazer login em um compartilhamento com um login que você armazena; no Linux ou Mac, monte o compartilhamento primeiro (no Linux, em /mnt ou /mídia, um Mac sob /VolumesNovo no Agente? Instale-o no Windows., macOS ou Linux.

MCP ativado para você

Criadores, proprietários e administradores têm acesso desde o início. Todos os outros precisam de um administrador para ativar o recurso. MCP alterne ao lado do nome deles abaixo Conta → Controle de acessoAté então, a página do MCP exibe a mensagem "O MCP está desativado para sua conta".

Um cliente de IA

O Claude na web, o Claude Desktop ou os aplicativos móveis do Claude se conectam sem necessidade de chave. O Claude Code, o Cursor, o ChatGPT e cerca de outras dez ferramentas também funcionam; o Portal possui uma configuração pronta para cada uma delas.

Configure em quatro etapas

1. Aponte o Agente para a pasta.

   No portal aberto Dados → Agentes de DadosEncontre o agente que pode abrir a pasta e clique nele. Adicionar conector botão. Abaixo do Arquivos e pastas clique na pílula Registros de máquinas cartão. O mago então te guia através de Pastas, Verificar, Configurações, Reino e Análise:

   Pastas

   Digite o Pastas raiz, um por linha, como caminhos no computador do Agente. Analisar subpastas está ligado, Profundidade máxima é 8. Incluir padrões começa com o padrão glob correto para este tipo de arquivo; adicione Excluir padrões Se a pasta contiver arquivos indesejados, uma letra de unidade mapeada exibirá um aviso em amarelo: o Agente não consegue vê-la, portanto, use a \\servidor\compartilhamento caminho em vez disso.

   Verificar

   O agente lê uma amostra de até 64 arquivos e mostra o que irá construir. Nada foi criado ainda. Pronto para criar significa que todos os arquivos amostrados se encaixam. Uma faixa âmbar, “{n} de {m} arquivo(s) serão separados”, lista os arquivos que não se encaixam. Mostre quais arquivos e por quê.Você pode criar o conector de qualquer maneira e corrigi-lo mais tarde. Se a pasta contiver layouts mistos, um painel azul oferece opções. Mude para uma tabela por layout..

   Configurações

   Intervalo de varredura (por padrão, a cada hora, podendo variar de 5 minutos a diariamente) é a frequência com que o Agente procura por arquivos novos, alterados ou que desapareceram. Acompanhe as alterações na pasta. Reage em segundos nos discos locais. Quando um arquivo desaparece é Solte suas fileiras Por padrão.

   Realm, Review

   Selecione o domínio de dados correspondente à contagem de linhas, verifique o resumo e clique. Criar conectorA primeira varredura começa imediatamente; o conector Manifesto A aba mostra o que foi compilado e quaisquer arquivos que foram separados.

   Escolha o seu Tipo de registro da lista. Os perfis de máquina são fixos. Apenas o Pasta de registro personalizada O cartão permite que você defina seu próprio formato. Abaixo da lista, está escrito: “Precisa de um tipo de log que não está listado? Abra uma solicitação de suporte e nós o adicionaremos em alguns dias.” Nome da tabela é opcional e o valor padrão é eventos. Aterro (dias) é 30, então a primeira leitura retrocede 30 dias. Em VerificarO Agente lê uma amostra com o tipo de log escolhido e exibe os arquivos, o tamanho e as tabelas que serão criadas. Se os arquivos não corresponderem, o título exibirá "Estes arquivos não são" seguido do tipo de log. Selecione outro tipo e clique em Teste novamente.

2. Veja quais tabelas você consegue.

   As linhas analisadas chegam em eventosou o nome da tabela que você definiu. Cada linha tem hora do evento, a coluna de identidade máquina (robô para perfis de robôs) e as colunas do tipo de log que você escolher. As tabelas derivadas existem apenas para perfis que as declaram.

   Mesa	O que contém
   eventos	Uma linha por evento de log analisado, com hora do evento, evento_tempo_bruto, máquina, as colunas do perfil, _arquivo_fonte e _linha_no.
   eventos_linhas_brutas	Linhas que não foram analisadas, mantidas com o linha e um razão tais como "sem correspondência gramatical" ou "indecodificável".
   alarmes, ciclos, turnos	Reconstruído a partir de eventos após cada sincronização, para perfis que os declaram.
   intervalos_ociosos, oee_entradas	Os períodos de inatividade e as entradas de OEE também são reconstruídos após cada sincronização para os perfis que os declaram.
   arquivos, arquivos_eventos	Os arquivos de registro e seu histórico, incluindo eventos rotacionados, reescritos e truncados.
   cursores de log	Posição de leitura e estado de cada arquivo. Um arquivo reservado mostra o estado "estacionado" com o motivo em último_erro.

   Cada conector de pastas também fornece a Claude as mesmas tabelas de contabilidade, todas no mesmo formato. conjunto de arquivos esquema:

   Mesa	O que contém
   arquivos	Todos os arquivos presentes na pasta: caminho, nome, extensão, tamanho, data de criação e data de modificação. Pergunte "o que há nesta pasta?" e Claude lerá a resposta.
   arquivos_eventos	O histórico de alterações: uma linha por arquivo que apareceu, foi modificado, desapareceu ou foi arquivado (deriva), com o tempo em evento_em e a razão em detalhe.
   diretórios, volumes	Tamanhos e quantidades de pastas, e os discos ou compartilhamentos onde as pastas raiz estão localizadas.
   _arquivo_fonte, _row_id	Duas colunas em cada linha de dados: o arquivo de origem da linha e um ID de linha fixo dentro desse arquivo. Agrupar por _arquivo_fonte para comparar arquivos.

3. Conecte-se com Claude

   Aberto Transmissões → Ao vivo → MCPExistem duas entradas, e ambas levam ao mesmo lugar:

   Aplicativos de bate-papo · sem chave

   claude.ai, Claude Desktop, ChatGPT

   No claude.ai e no Claude Desktop, abra o Listagem de fluxos de consulta No Diretório de Conectores da Anthropic, clique em Conectar e aprovar. Adicionando por URL, https://mcp.querystreams.com/mcp, é a alternativa. No ChatGPT, você adiciona Fluxos de Consulta a partir do aplicativo (modo desenvolvedor por enquanto) e faz login com Fluxos de Consulta. De qualquer forma, uma página de Fluxos de Consulta será aberta: selecione a organização e as permissões e clique em Aprovar conexãoNada para copiar. A conexão aparece no Conexões aba e pode ser revogada lá.

   Ferramentas de desenvolvedor · uma chave

   Claude Code, Cursor, VS Code e amigos

   Na página MCP, clique Conecte um cliente de IAO guia pergunta Como seu cliente de IA se conectará?: escolher Use uma chave em um arquivo de configuração, escolha sua ferramenta, então Gere uma chave para isso: um Nome da chave, Ler e Executar consultas marcado, um Validade (Nunca, 30 dias, 90 dias ou 1 ano). Configure-o Mostra o trecho com a chave preenchida, e Verifique a conexão Aguarda a primeira chamada.

   Ambas as formas utilizam as mesmas três permissões, que você escolhe na tela de consentimento ou na chave:

   Ler

   Liste conectores, navegue por tabelas e colunas, leia suas consultas salvas e regras de alerta. Nunca retorna dados de linha.

   Executar consultas

   Execute consultas SQL somente leitura e consultas salvas por meio do seu Agente e retorne as linhas. Sem isso, seu cliente de IA pode descrever seus dados, mas não responder com base neles.

   Analisar

   Crie perfis das tabelas, descubra relações e coloque uma execução do Semantic Intelligence na fila. A criação de perfis e a descoberta são gratuitas; uma execução do Semantic Intelligence consome créditos do Nova AI e a franquia de dados, por isso a tela de consentimento nunca a marca previamente.

   Perdeu a chave? Está listado no Conexões guia: Revelar a chave completa mostra isso novamente e Copiar chave completa copia-o. Revogue-o lá se um laptop desaparecer; todos os clientes que o utilizam falham na próxima chamada, em cerca de cinco minutos.

   Em seguida, selecione a receita do Claude que você utiliza. O endereço do servidor é o mesmo em todos os lugares: https://mcp.querystreams.com/mcp.

   Claude na web, Claude para desktop e dispositivos móveis. sem chave

   1. Abra o Listagem de fluxos de consulta No Diretório de Conectores da Anthropic, clique em ConectarNa área de trabalho, ele fica localizado em + → Conectores.
   2. Alternativa, caso sua organização oculte conectores de diretório: Configurações → Conectores → Adicionar conector personalizado, nome Fluxos de consulta, URL https://mcp.querystreams.com/mcp, Campos OAuth vazios, Adicionar; então em um bate-papo + → Fluxos de consulta → Conectar.
   3. Uma aba "Fluxos de Consulta" será aberta. Faça login, se solicitado, selecione a organização e revise. Ler e Executar consultas, opcionalmente Limitar a conectores específicose clique Aprovar conexão.
   4. De volta ao Claude, você vê “Conectado aos Fluxos de Consulta”. Na primeira vez que o Claude usa uma ferramenta, ele pergunta: escolha Permitir sempre.

   Se você adicionar manualmente no Claude Desktop, use Configurações → Conectores → Adicionar, não o chat interno Adicionar ao mercado opção, que espera um repositório git. Os conectores sincronizam com sua conta Claude, então os aplicativos móveis e o Desktop os reconhecem automaticamente. Os nomes dos menus são da Anthropic e podem ser alterados.

   Código Claude chave

   Um único comando, com a sua chave da aba Conexões:

   terminal

   claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp \ --header "X-MCP-Key: qsmcp_COLE_SUA_CHAVE_AQUI"

   Isso descreve o projeto atual. .mcp.json. Adicionar --escopo usuário Para ter fluxos de consulta em todos os projetos. Execute /mcp dentro do Código Claude para ver se está conectado.

   Cursor chave

   Aberto Configurações do cursor → MCP → Adicionar novo servidor MCPou editar .cursor/mcp.json na raiz do seu espaço de trabalho:

   .cursor/mcp.json

   { "mcpServers": { "querystreams": { "url": "https://mcp.querystreams.com/mcp", "headers": { "X-MCP-Key": "qsmcp_COLE_SUA_CHAVE_AQUI" } } } }

   Reinicie o Cursor ou execute MCP: Reiniciar servidores; um fluxos de consulta O ícone aparece na barra de status do MCP.

   Usar outra coisa? O Portal Conecte um cliente de IA guia Possui receitas prontas para colar para ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev e JetBrains AI, além de um Colar e mesclar ferramenta que solta o fluxos de consulta entrada em um arquivo de configuração que você já possui. Qualquer cliente que se comunique via MCP sobre HTTP funciona: servidor https://mcp.querystreams.com/mcp, cabeçalho Chave X-MCP (um Autorização: Portador O cabeçalho com a mesma chave também funciona).

4. Faça sua primeira pergunta

   Comece com algo que você possa verificar abrindo a pasta, para ver Claude alcançar a mesa correta. Três opções que funcionam bem com os registros do seu CNC, PLC e controlador de robô:

   “Quais arquivos de log da máquina o Agente está lendo e quando cada um deles foi atualizado pela última vez?”

   Claude consulta o arquivo fileset.files em busca de relative_path, size_bytes e modified_utc, do mais recente para o mais antigo.

   “Quantos eventos cada máquina registrou por hora ontem?”

   Claude agrupa os arquivos do conjunto de eventos (fileset.events) por máquina e hora (event_time) e retorna uma pequena tabela.

   “Mostre-me as linhas que não foram analisadas, agrupadas por motivo.”

   Claude conta as linhas em events_raw_lines por motivo e mostra alguns exemplos de linhas para cada um.

   Para confirmar a fiação, pergunte “Quais conectores de fluxos de consulta eu tenho?”Claude liga qs_list_connectors, o guia do Portal Verifique a conexão passo diz Conectadoe a chave ou aplicativo no Conexões A aba mostra o seu Último uso tempo em questão de segundos.

Acessando um arquivo em um compartilhamento de rede

O Agente abre arquivos como um serviço em segundo plano, não como você, portanto, um arquivo em outro computador requer uma etapa adicional. Qual etapa depende do computador em que o Agente está sendo executado.

Se o teste não conseguir acessar a pasta compartilhada, procure por estas palavras no resultado: inalcançável Significa que o computador do agente não recebeu resposta do servidor. No Linux ou no Mac, não montado Significa que o compartilhamento ainda precisa ser montado, e essa mensagem inclui o comando de montagem exato para o seu servidor.

Como os arquivos novos, alterados e excluídos são exibidos

O que Claude pode fazer quando estiver conectado

Seu cliente de IA visualiza as ferramentas de Fluxos de Consulta e seleciona a mais adequada para sua pergunta. O Portal Ferramentas guia lista todas as ferramentas e modos incluídos no seu plano. Query Streams solicita que seu cliente de IA leia as colunas de cada tabela antes de consultá-la, para que use os nomes reais em vez de adivinhar. Em todos os planos, incluindo o Free:

O conjunto de ferramentas analíticas. Nos planos pagos, o Agente realiza o trabalho preparatório no arquivo de Logs da sua Máquina, permitindo que seu cliente de IA concentre sua atenção no processamento. A versão gratuita funciona como sempre funcionou.

Os valores padrão estão em Contexto guia: limite de células de texto, visualização do esquema, tamanho do resultado, padrões de análise e resultados retidos.

Por que a Inteligência Semântica é importante aqui?

Cada resposta que Claude recebe é etiquetada com a origem da estrutura, e Claude ajusta o grau de confiança que deposita no que vê.

Se um banco de dados for importante, execute a Inteligência Semântica nele uma vez a partir de Nova → Inteligência. O Conexões A aba mostra um painel de cobertura para cada conector. Como funciona a Inteligência Semântica.

O que os planos permitem

O MCP está incluído em todos os planos, inclusive no gratuito, sem custo adicional. O que cada plano define é a quantidade de chaves ou aplicativos conectados que você pode armazenar e quantas chamadas por minuto seu cliente de IA pode fazer:

Um aplicativo conectado conta como uma chave. Além do limite por minuto, cada chave pode executar no máximo 10 consultas por minuto. Uma consulta é executada por até 60 segundos, a menos que seu cliente de IA solicite mais tempo, que pode chegar a cinco minutos. Seu plano também define quantas linhas uma consulta retorna e, com o conjunto de ferramentas Analíticas, por quanto tempo e qual o tamanho máximo que um resultado pode ser armazenado. o guia completo do MCP lista todos os planos. O que seu cliente de IA recebe é contabilizado na sua franquia do Data Realm, o mesmo limite usado pelas consultas do Excel e do Sheets: o uso do AI-agent (MCP) contabiliza cada byte entregue ao seu cliente de IA, incluindo resultados, leituras de esquema e páginas de resultados mantidos, antes de qualquer compactação de transporte negociada pelo seu cliente; já as consultas de planilhas contabilizam o resultado compactado entregue pelo seu Network Agent. As execuções do Semantic Intelligence iniciadas pelo seu cliente de IA consomem créditos Nova AI, exatamente como as iniciadas pelo Portal. Consulte a página de preços. pelas verbas.

Mantendo-o seguro

Boas próximas jogadas

• Executar Inteligência Semântica no conector para que Claude receba descrições em linguagem simples das suas colunas. As tabelas de arquivos já contêm descrições integradas.
• Defina os eventos "Manter" para N dias. Se você deseja remover eventos antigos, o Machine Logs mantém tudo por padrão.
• Abra a caixa de diálogo Arquivos do conector. Para visualizar cada arquivo de log e o motivo pelo qual algum deles foi separado. Na lista de conectores, este conector aparece como "Arquivos de Log".

Quando algo não funciona

Perguntas que as pessoas fazem

Guias relacionados

• Conecte uma pasta de arquivos CSV ao Claude com o MCP.
• Conecte uma pasta de arquivos do Excel ao Claude com o MCP.
• Conecte uma pasta de bancos de dados SQLite ao Claude com o MCP.
• Conecte uma pasta de arquivos Parquet ao Claude com o MCP.
• Conectar fluxos de consulta ao Claude via MCP: configuração, permissões e solução de problemas
• Todos os guias MCP