Flare

Rastreamento de erros, monitoramento de desempenho e logs para aplicativos Laravel e PHP, pela Spatie.

Servidor MCP hospedado

npx add-mcp 'https://flareapp.io/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

View as Markdown

O servidor MCP do Flare permite que você integre os recursos de rastreamento de erros, monitoramento de desempenho e registro de logs do Flare diretamente aos seus fluxos de trabalho de desenvolvimento com IA. Use-o com assistentes de IA como o Claude para monitorar, analisar e resolver erros de aplicativos automaticamente, investigar problemas de desempenho e pesquisar seus logs.

Veja o que você pode fazer com o Flare e IA.

O que é MCP?

MCP (Model Context Protocol) é um protocolo aberto que permite que assistentes de IA se conectem com segurança a fontes de dados e ferramentas externas. Ao usar o servidor MCP do Flare, seu assistente de IA ganha acesso direto aos seus dados de rastreamento de erros, monitoramento de desempenho e logs, e pode executar ações no Flare em seu nome.

Principais recursos

Com o servidor MCP do Flare, você pode pedir ao seu assistente de IA para:

"Mostre-me os erros mais recentes do meu projeto"
"Corrija o erro relacionado ao erro de sintaxe PHP em myfile.php"
"Marque o erro como resolvido no Flare"
"Corrija o erro ERROR-ID-HERE e marque-o como resolvido"
"Mostre-me todas as rotas lentas do meu aplicativo"
"Quais usuários são afetados por este erro?"
"Liste as consultas de banco de dados mais lentas dos últimos 7 dias"
"Mostre-me os traces mais lentos para esta rota"
"Liste as chamadas HTTP externas mais lentas dos últimos 7 dias"
"Adie este erro até a próxima semana"
"Atribua este erro ao Alex"
"Crie uma nota no Flare com os resultados da sua investigação sobre este erro"
"Mostre-me os logs mais recentes do meu projeto"
"Pesquise nos logs por erros de conexão com o banco de dados"
"Crie um projeto no Flare e use a documentação para instalar o Flare no meu aplicativo"

Autenticação

O servidor MCP do Flare está em https://flareapp.io/mcp e autentica com OAuth 2.1. Cada cliente compatível abre um navegador, envia você ao Flare para conceder acesso e armazena um token renovável. Nenhum token é colado manualmente e o cliente nunca vê sua senha.

Ao autorizar, você escolhe quais equipes e projetos a conexão pode acessar — o mesmo seletor de escopo usado para tokens de acesso pessoal. Conceda o escopo admin se quiser que seu assistente crie projetos.

Se o seu cliente ainda não suporta MCP OAuth, você pode usar um token de acesso pessoal enviado como cabeçalho Bearer.

Instalação

Escolha seu cliente e siga os passos. Após a instalação, vá para Dica de projeto para que seu assistente saiba qual projeto do Flare usar.

Amp

Adicione o servidor com a CLI do Amp:

amp mcp add flare https://flareapp.io/mcp

Você também pode adicionar o servidor às configurações de usuário do Amp em ~/.config/amp/settings.json:

{
  "amp.mcpServers": {
    "flare": {
      "url": "https://flareapp.io/mcp"
    }
  }
}

Ao iniciar o Amp novamente, ele abre seu navegador para que você autorize o Flare. O Amp armazena o token e o renova quando necessário. Se precisar autorizar novamente, execute amp mcp oauth logout flare e reinicie o Amp.

Os orbs do Amp não podem abrir um navegador para OAuth. Para usar o Flare em um orb, siga a documentação MCP do Amp e envie um token de acesso pessoal no headers do servidor.

Claude Code

Adicione o servidor com a CLI do Claude Code:

claude mcp add --transport http flare https://flareapp.io/mcp

Em seguida, em uma sessão do Claude Code, execute /mcp e siga o prompt do navegador para autorizar. O Claude Code armazena o token. Se ele pedir para autorizar novamente, execute /mcp e aprove no navegador.

Verifique com:

claude mcp get flare

Claude Desktop e claude.ai

Os conectores personalizados ficam no mesmo lugar no Claude Desktop e no claude.ai:

Abra Customize → Connectors.
Clique em + Add e depois em Add custom connector.
Nomeie o conector como Flare e defina a Remote MCP server URL como https://flareapp.io/mcp.
Clique em Add e conclua o fluxo OAuth no seu navegador.

Nos planos Team e Enterprise, um proprietário adiciona o conector uma vez em Organization settings → Connectors. Os membros então encontram o Flare em Customize → Connectors e clicam em Connect para autorizar.

Codex (CLI, aplicativo de desktop e extensão IDE)

A CLI do Codex, o aplicativo de desktop e a extensão IDE compartilham um único arquivo de configuração em ~/.codex/config.toml. Adicione:

[mcp_servers.flare]
url = "https://flareapp.io/mcp"
oauth_resource = "https://flareapp.io/mcp"

Em seguida, inicie o fluxo OAuth:

codex mcp login flare

Se você configurar o servidor pelo painel Settings → MCP do aplicativo de desktop, a mesma entrada aparecerá em config.toml e o fluxo OAuth será executado no seu navegador quando você usar o servidor pela primeira vez.

Cursor

Adicione o Flare em Cursor Settings → MCP → Add custom server, ou cole isto em .cursor/mcp.json (projeto) ou ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "flare": {
      "url": "https://flareapp.io/mcp"
    }
  }
}

O Cursor abre um navegador para autorizar na primeira vez que o servidor for usado e armazena o token resultante para você.

OpenCode

Adicione o Flare em opencode.json (raiz do projeto) ou ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "flare": {
      "type": "remote",
      "url": "https://flareapp.io/mcp"
    }
  }
}

Em seguida, autorize:

opencode mcp auth flare

O OpenCode descobre os endpoints OAuth automaticamente via registro dinâmico de cliente (RFC 7591) e armazena os tokens em ~/.local/share/opencode/mcp-auth.json.

VS Code

Adicione o Flare em .vscode/mcp.json (projeto). Para uma configuração global, execute MCP: Open User Configuration na Paleta de Comandos e adicione a mesma entrada lá:

{
  "servers": {
    "flare": {
      "type": "http",
      "url": "https://flareapp.io/mcp"
    }
  }
}

Em seguida, execute MCP: List Servers, selecione flare e escolha Start Server. O VS Code abre um navegador para autorizar e armazena o token resultante para você.

Alternativa: token de acesso fixo

Se o seu cliente ainda não suporta MCP OAuth, crie um token de acesso pessoal com escopo read e write e envie-o como cabeçalho Bearer. Adicione o escopo admin se quiser que seu assistente crie projetos.

Se o seu cliente pode enviar cabeçalhos personalizados, defina Authorization: Bearer <YOUR-PERSONAL-ACCESS-TOKEN> na entrada do servidor. Se ele só executa servidores locais, use mcp-remote como ponte:

{
  "mcpServers": {
    "flare": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://flareapp.io/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <YOUR-PERSONAL-ACCESS-TOKEN>"
      }
    }
  }
}

Dica de projeto

Para ajudar seu assistente de IA a escolher o projeto certo quando houver mais de um, adicione uma dica de uma linha ao arquivo de instruções do seu projeto (por exemplo, CLAUDE.md, AGENTS.md ou o equivalente da sua IDE):

When the user asks to show or investigate errors, performance issues,
or logs, use the Flare MCP server. The project name in Flare is
INSERT-YOUR-PROJECT-NAME-HERE.

Alternativa: habilidade de agente

Se o seu agente trabalha por comandos de terminal, você pode usar a CLI do Flare com a habilidade de agente do Flare. A habilidade adiciona instruções ao seu projeto que ensinam agentes de codificação compatíveis a investigar com a CLI. Escolha MCP ou CLI com base em como você quer que seu agente se conecte ao Flare.

Ferramentas disponíveis

Uma vez configurado, seu assistente de IA pode:

Listar projetos: Ver todos os projetos associados à sua conta do Flare, ou encontrar um projeto pelo nome
Mostrar erros: Exibir erros recentes de um projeto específico
Ver detalhes do erro: Obter informações completas sobre um erro específico, incluindo stack traces e contexto
Resolver erros: Marcar erros como resolvidos diretamente da sua conversa com IA, ou como não resolvidos novamente
Adiar erros: Adiar erros para suprimir notificações temporariamente (até uma data, para sempre, por um número de ocorrências, ou até a próxima versão do aplicativo)
Reativar erros: Retomar notificações para erros adiados anteriormente
Atribuir erros: Atribuir erros a membros da equipe para acompanhamento
Listar membros da equipe: Ver membros da equipe de um projeto para encontrar responsáveis
Pesquisar erros: Encontrar erros que correspondam a critérios específicos
Ver insights de erros: Ver com que frequência um erro ocorreu, agrupado por usuário, URL, job, versão, tipo ou comando
Criar notas: Adicionar notas de investigação a erros para colaboração da equipe
Navegar pelos logs: Pesquisar, filtrar e paginar pelos logs do projeto por severidade, hostname, tipo de ponto de entrada ou pesquisa de texto livre
Monitorar desempenho: Listar as rotas, consultas, jobs, comandos, chamadas HTTP externas, visualizações, componentes Livewire e páginas e componentes de navegador mais lentos, e depois inspecionar métricas detalhadas, tendências e os traces mais lentos para qualquer um deles
Criar projetos: Criar um novo projeto no Flare em uma das suas equipes e obter as chaves de API para instalar o Flare
Ler documentação: Pesquisar e ler a documentação do Flare, para que seu assistente possa instalar e configurar o Flare para você

Segurança

Cada conexão OAuth de um cliente ao servidor MCP do Flare tem seu próprio nome e é limitada às permissões, equipes e projetos que você seleciona durante o fluxo de consentimento. Várias conexões do Claude, Codex, Cursor ou outros clientes podem funcionar ao mesmo tempo. Renomeie, ajuste ou revogue uma conexão sem afetar as outras em Account → Connections. Tokens de acesso pessoal usados como fallback Bearer são gerenciados em Account → Personal access tokens.

Feedback

Se você tiver algum feedback ou perguntas, entre em contato conosco em [email protected].

Getting started Agent skill