Conecte logs de aplicativos JSON ao Claude com o MCP.

MCP · Logs de aplicativos para Claude

Perguntar Claude sobre o seu arquivo de logs do aplicativo, em inglês simples

Conecte o Claude, o Claude Code, o Cursor ou qualquer cliente MCP ao Query Streams uma única vez. O Claude lê a estrutura do seu arquivo de logs de aplicativos, escreve o SQL, executa-o em modo somente leitura por meio do agente que já está conectado aos seus dados e retorna as linhas. Nenhuma senha do banco de dados chega à IA. Leva cerca de dez minutos e o plano gratuito cobre esse processo.

Cerca de 10 minutos Claude, ChatGPT, Cursor + 11 outros clientes O arquivo permanece onde está. Somente leitura, sempre

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

Um Claude capaz de responder a perguntas sobre os arquivos de log da sua aplicação 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 o caminho do 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 a tela de configurações. Assim:

Claude · conectado a Fluxos de Consulta Somente leitura

Quais foram os erros mais comuns na última hora e qual registrador os causou?

qs_get_table_schema qs_executar_consulta inteligência_de_esquema

Claude verifica as colunas de conjunto de arquivos.eventosEm seguida, executa uma consulta que registra erros e falhas fatais. nível valores da última hora de hora do evento e os agrupa por lenhador e mensagemOs três melhores:

nível	lenhador	mensagem
erro	Pagamentos.Cliente Stripe	Cobrança recusada: cartão recusado para o pedido 88213
erro	Serviço de Pedidos	Tempo limite excedido após 30000 ms ao chamar o serviço de inventário.
fatal	db.pool	Conjunto de conexões esgotado (máximo de 20 conexões)

O esgotamento do pool explicaria os timeouts no OrderService. Peça ao Claude a mensagem completa e o stack trace do evento fatal. A linha exibida é a mesma, pois o rastreamento permaneceu associado ao evento. A resposta abrange o que o Agente havia lido em sua última varredura.

Analise os problemas de pagamento desta semana por motivo. A culpa é dos clientes ou nossa?

qs_executar_consulta qs_executar_consulta

Analisei o motivo da recusa. mensagem para Pagamentos.Cliente Stripe erros em conjunto de arquivos.eventos e em comparação com a semana passada:

Motivo da recusa	Contar	Compartilhar	em comparação com a semana passada
cartão_recusado	1,204	62%	+2%
fundos insuficientes	402	21%	-1%
tempo limite da API	331	17%	+310%

Os dois primeiros são clientes e são planos. tempo limite da API somos nós: não existia há duas semanas, todos vêm de host = web-03E o servidor web-03 apresenta intervalos de 30 segundos em seus próprios registros nos mesmos momentos. Um host com problemas, não o provedor de pagamentos.

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 possui todas as ferramentas que o Claude tem aqui, além de outras que o Claude não tem: 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, no Google Sheets ou na API REST — sem chave, sem conector, nada para instalar. Use o MCP quando sua equipe já utiliza o Claude, o Cursor ou o ChatGPT; use o Nova quando você quiser as respostas dentro do Portal.

O Application Logs lê os arquivos de log JSON e de texto que seus aplicativos gravam, desde logs JSON do ECS, Serilog, pino ou Bunyan até texto simples. Ele transforma cada evento em uma linha SQL com seu nível, logger e mensagem, e um stack trace permanece associado ao evento que o gerou. O Agent monitora cada arquivo à medida que ele cresce, reconhece arquivos rotacionados para que nada seja lido duas vezes e lê cada .gz Arquiva uma única vez e preenche os últimos 30 dias na primeira leitura.

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. Novo 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 aplicativos 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.

   • Adicione a pasta onde seus aplicativos armazenam os logs em Pastas raiz.
   • Escolha um Tipo de registroO cartão envia linhas JSON (ECS, Serilog, pino e Bunyan), texto simples com nível, logger e mensagem, além do histórico do dpkg e do apt, que utilizam hospedar como a coluna de identidade.
   • Nome da tabela é opcional e o valor padrão é eventos. Mantenha os eventos por N dias Mantém tudo configurado, a menos que você defina outra configuração.
   • Sobre VerificarO Agente lê uma amostra e exibe a contagem de arquivos, o tamanho, uma estimativa de linhas e as tabelas que serão criadas. Nada foi criado ainda. Se os arquivos não forem do tipo escolhido, o cabeçalho exibirá a mensagem: Esses arquivos não são seguido desse tipo, com a razão.

2. Veja quais tabelas você consegue.

   Os eventos analisados chegam em conjunto de arquivos.eventos, ou no Nome da tabela Você escolheu. O Agente mantém as linhas em um cache local no computador do Agente e as serve como SQL. Cada linha indica de qual arquivo ela veio. _arquivo_fonteAs colunas abaixo são provenientes do tipo de log de linhas JSON padrão.

   Mesa	O que contém
   eventos	Uma linha por evento: hora do evento, aplicativo, nível, lenhador e mensagem, mais hospedar, serviço, fluxo e dadosUm rastreamento de pilha de várias linhas permanece em seu evento.
   eventos_linhas_brutas	Linhas que não foram analisadas, mantidas em linha com um razãoUm bloco mais longo que o limite cai aqui como record-max-linhasNada cai no chão.
   arquivos	Todos os arquivos de log na pasta neste momento, com caminho_relativo, tamanho_bytes e UTC modificado.
   arquivos_eventos	O histórico de cada arquivo: apareceu, modificado, girado, truncado e deriva fileiras, cronometradas por evento_em.
   cursores de log	Posição de leitura e estado de cada arquivo. Um arquivo reservado mostra o estado. estacionado com a razão 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

   Em Claude, Query Streams está no Diretório de Conectores AntrópicosNavegue pelos conectores e clique. ConectarEm outros lugares, você cola um endereço no aplicativo, https://mcp.querystreams.com/mcpe conecte-se por meio de um chat. Uma página de Fluxos de Consulta será aberta, você seleciona a organização e as permissões e clica em Aprovar conexãoNada para copiar, nada para manter em segredo. A conexão aparece em Aplicativos Conectados e pode ser revogada lá.

   Ferramentas de desenvolvedor · uma chave

   Claude Code, Cursor, VS Code e amigos

   Sobre Minhas chaves clique Gerar chaveDê uma olhada. Nome da chave como “Código Claude no meu laptop”, mantenha Ler e Executar Com a opção marcada, escolha uma Validade (Nunca, 30 dias, 90 dias ou 1 ano) e clique Gerar chaveCopie-o e então Continue a instalação: o Conectar A aba mostra o trecho de código exato para sua ferramenta com a chave já preenchida.

   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

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

   Analisar

   Tabelas de perfil, descoberta de relacionamentos e agendamento de uma execução de Inteligência Semântica. Isso consome créditos de IA e dados do Nova, portanto, a tela de consentimento nunca é marcada previamente.

   Perdeu a chave? Aberto Minhas chavesO ícone do olho 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. Aberto Configurações → Conectores e clique em Navegue pelos conectores. O Query Streams está listado no Diretório de Conectores Antrópicos: encontrar Fluxos de consulta e clique em Conectar(Ou abra a lista de diretórios diretamente e clique) Conectar lá.)
   2. Se sua organização oculta conectores de diretório, clique Adicionar conector personalizado Em vez disso, dê um nome a ele. Fluxos de consulta, colar https://mcp.querystreams.com/mcpDeixe os campos OAuth vazios e clique em AdicionarEm seguida, em qualquer bate-papo, clique + → Navegue pelos conectores → 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, 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 de "Minhas Chaves":

   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 Conectar 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 certa. Três opções que funcionam bem com seus arquivos de log de aplicativos:

   “Quais arquivos de log de aplicativos você está lendo e qual o tamanho de cada um?”

   Claude faz perguntas conjunto de arquivos.arquivos para caminho_relativo, tamanho_bytes e UTC modificado.

   “Quantos erros cada aplicativo registrou na última hora, por nível?”

   Grupos Claude conjunto de arquivos.eventos por aplicativo e nível, filtrado em hora do evento.

   “Quais linhas não puderam ser analisadas e por quê?”

   Claude lê fileset.events_raw_lines e agrupa as linhas por razão, com alguns exemplos de cada um.

   Para confirmar a fiação, pergunte “Quais conectores de fluxos de consulta eu tenho?”Claude liga qs_list_connectorse em Minhas chaves a chave Último uso A hora é atualizada em poucos segundos.

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

O que Claude pode fazer quando estiver conectado

Claude vê dezenove pequenas ferramentas. Você nunca as nomeia; Claude escolhe a certa para a sua pergunta. Em outras palavras:

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 Minhas chaves 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 plano gratuito, sem custo adicional. O que cada plano define é a quantidade de chaves ou aplicativos conectados que você pode armazenar e quantas chamadas Claude pode fazer por minuto:

Um aplicativo conectado conta como uma chave. Além do valor por minuto, cada chave pode executar no máximo 10 consultas por minuto. Uma consulta retorna até 1.000 linhas e leva até 60 segundos para ser executada, a menos que Claude solicite mais, com um limite máximo de 50.000 linhas e cinco minutos. As linhas que Claude recebe são contabilizadas no seu limite do Data Realm, o mesmo pool usado pelas suas consultas do Excel e do Planilhas Google, e o MCP (Maximum Charge Point - Ponto Máximo de Compressão) é medido antes da compressão, portanto, um resultado amplo custa mais aqui do que as mesmas linhas em uma planilha. As execuções de Inteligência Semântica iniciadas por Claude consomem créditos Nova AI, exatamente como acontece no Portal. Consulte a página de preços. pelas verbas.

Mantendo-o seguro

Boas próximas jogadas

• Ative a opção "Monitorar pasta" para receber notificações de alterações (quase em tempo real). Para detectar novas linhas em segundos em um disco local. A verificação agendada continua sendo a garantia.
• Defina os eventos "Manter" para N dias. Para controlar a quantidade de histórico que permanece no cache. Os Logs de Aplicativos mantêm tudo, a menos que você defina um limite.
• Usar pasta de registro personalizada se o seu formato não estiver no Tipo de registro lista. Você pode descrever o formato você mesmo ou abrir uma solicitação de suporte e nós o adicionaremos em alguns dias.

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