Flare

Seguimiento de errores, monitoreo de rendimiento y registros para aplicaciones Laravel y PHP, por Spatie.

Ver en flareapp.io

Servidor MCP alojado

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

Se instala en Claude Code, Codex, Cursor y más

Documentación

Ver como Markdown

El servidor MCP de Flare te permite integrar las capacidades de seguimiento de errores, monitoreo de rendimiento y registro de logs de Flare directamente en tus flujos de trabajo de desarrollo impulsados por IA. Úsalo con asistentes de IA como Claude para monitorear, analizar y resolver errores de aplicaciones automáticamente, investigar problemas de rendimiento y buscar en tus logs.

Consulta lo que puedes hacer con Flare e IA.

¿Qué es MCP?

MCP (Protocolo de Contexto de Modelo) es un protocolo abierto que permite a los asistentes de IA conectarse de forma segura con fuentes de datos y herramientas externas. Al usar el servidor MCP de Flare, tu asistente de IA obtiene acceso directo a tus datos de seguimiento de errores, monitoreo de rendimiento y logs, y puede realizar acciones en Flare en tu nombre.

Características clave

Con el servidor MCP de Flare, puedes pedirle a tu asistente de IA que:

  • "Muéstrame los errores más recientes de mi proyecto"
  • "Corrige el error relacionado con el error de sintaxis de PHP en myfile.php"
  • "Marca el error como resuelto en Flare"
  • "Corrige el error ERROR-ID-HERE y márcalo como resuelto"
  • "Muéstrame todas las rutas lentas en mi aplicación"
  • "¿Qué usuarios están afectados por este error?"
  • "Lista las consultas de base de datos más lentas de los últimos 7 días"
  • "Muéstrame los traces más lentos para esta ruta"
  • "Lista las llamadas HTTP externas más lentas de los últimos 7 días"
  • "Posponer este error hasta la próxima semana"
  • "Asigna este error a Alex"
  • "Crea una nota en Flare con los resultados de tu investigación sobre este error"
  • "Muéstrame los logs más recientes de mi proyecto"
  • "Busca en los logs cualquier error de conexión a la base de datos"
  • "Crea un proyecto en Flare y usa la documentación para instalar Flare en mi aplicación"

Autenticación

El servidor MCP de Flare está en https://flareapp.io/mcp y se autentica con OAuth 2.1. Cada cliente compatible abre un navegador, te envía a Flare para otorgar acceso y almacena un token renovable. No se pegan tokens manualmente y el cliente nunca ve tu contraseña.

Cuando autorizas, eliges qué equipos y proyectos puede acceder la conexión: el mismo selector de alcance utilizado para los tokens de acceso personal. Otorga el alcance admin si quieres que tu asistente cree proyectos.

Si tu cliente aún no admite MCP OAuth, puedes recurrir a un token de acceso personal enviado como encabezado Bearer.

Instalación

Elige tu cliente y sigue los pasos. Después de la instalación, salta a Sugerencia de proyecto para que tu asistente sepa qué proyecto de Flare usar.

Amp

Agrega el servidor con la CLI de Amp:

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

También puedes agregar el servidor a la configuración de usuario de Amp en ~/.config/amp/settings.json:

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

Cuando inicies Amp nuevamente, abrirá tu navegador para que autorices Flare. Amp almacena el token y lo renueva cuando sea necesario. Si debes autorizar de nuevo, ejecuta amp mcp oauth logout flare y reinicia Amp.

Los orbes de Amp no pueden abrir un navegador para OAuth. Para usar Flare en un orbe, sigue la documentación de MCP de Amp y envía un token de acceso personal en el headers del servidor.

Claude Code

Agrega el servidor con la CLI de Claude Code:

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

Luego, en una sesión de Claude Code, ejecuta /mcp y sigue el mensaje del navegador para autorizar. Claude Code almacena el token. Si te pide autorizar de nuevo, ejecuta /mcp y aprueba en el navegador.

Verifica con:

claude mcp get flare

Claude Desktop y claude.ai

Los conectores personalizados se encuentran en el mismo lugar en Claude Desktop y claude.ai:

  1. Abre Personalizar → Conectores.
  2. Haz clic en + Agregar, luego en Agregar conector personalizado.
  3. Nombra el conector Flare y establece la URL del servidor MCP remoto en https://flareapp.io/mcp.
  4. Haz clic en Agregar y completa el flujo de OAuth en tu navegador.

En los planes Team y Enterprise, un propietario agrega el conector una vez en Configuración de la organización → Conectores. Luego, los miembros encuentran Flare en Personalizar → Conectores y hacen clic en Conectar para autorizar.

Codex (CLI, aplicación de escritorio y extensión de IDE)

La CLI de Codex, la aplicación de escritorio y la extensión de IDE comparten un único archivo de configuración en ~/.codex/config.toml. Agrega:

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

Luego inicia el flujo de OAuth:

codex mcp login flare

Si configuras el servidor a través del panel Configuración → MCP de la aplicación de escritorio, la misma entrada aparece en config.toml y el flujo de OAuth se ejecuta en tu navegador cuando usas el servidor por primera vez.

Cursor

Agrega Flare en Configuración de Cursor → MCP → Agregar servidor personalizado, o colócalo en .cursor/mcp.json (proyecto) o ~/.cursor/mcp.json (global):

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

Cursor abre un navegador para autorizar la primera vez que se usa el servidor y almacena el token resultante por ti.

OpenCode

Agrega Flare a opencode.json (raíz del proyecto) o ~/.config/opencode/opencode.json:

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

Luego autoriza:

opencode mcp auth flare

OpenCode descubre los endpoints de OAuth automáticamente mediante el registro dinámico de clientes (RFC 7591) y almacena los tokens en ~/.local/share/opencode/mcp-auth.json.

VS Code

Agrega Flare a .vscode/mcp.json (proyecto). Para una configuración global, ejecuta MCP: Abrir configuración de usuario desde la Paleta de comandos y agrega la misma entrada allí:

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

Luego ejecuta MCP: Listar servidores, selecciona flare y elige Iniciar servidor. VS Code abre un navegador para autorizar y almacena el token resultante por ti.

Alternativa: token de acceso fijo

Si tu cliente aún no admite MCP OAuth, crea un token de acceso personal con los alcances read y write y envíalo como encabezado Bearer. Agrega el alcance admin si quieres que tu asistente cree proyectos.

Si tu cliente puede enviar encabezados personalizados, establece Authorization: Bearer <YOUR-PERSONAL-ACCESS-TOKEN> en la entrada del servidor. Si solo ejecuta servidores locales, usa mcp-remote como puente:

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

Sugerencia de proyecto

Para ayudar a tu asistente de IA a elegir el proyecto correcto cuando hay más de uno, agrega una sugerencia de una línea al archivo de instrucciones de tu proyecto (por ejemplo, CLAUDE.md, AGENTS.md o el equivalente de tu 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: habilidad de agente

Si tu agente trabaja a través de comandos de terminal, puedes usar la CLI de Flare con la habilidad de agente de Flare. La habilidad agrega instrucciones a tu proyecto que enseñan a los agentes de codificación compatibles cómo investigar con la CLI. Elige MCP o la CLI según cómo quieras que tu agente se conecte a Flare.

Herramientas disponibles

Una vez configurado, tu asistente de IA puede:

  • Listar proyectos: Ver todos los proyectos asociados con tu cuenta de Flare, o encontrar un proyecto por nombre
  • Mostrar errores: Mostrar errores recientes de un proyecto específico
  • Ver detalles del error: Obtener información completa sobre un error específico, incluidos stack traces y contexto
  • Resolver errores: Marcar errores como resueltos directamente desde tu conversación de IA, o como no resueltos nuevamente
  • Posponer errores: Posponer errores para suprimir notificaciones temporalmente (hasta una fecha, para siempre, por un número de ocurrencias o hasta la próxima versión de la aplicación)
  • Reanudar errores: Reanudar notificaciones para errores previamente pospuestos
  • Asignar errores: Asignar errores a miembros del equipo para seguimiento
  • Listar miembros del equipo: Ver los miembros del equipo de un proyecto para encontrar asignados
  • Buscar errores: Encontrar errores que coincidan con criterios específicos
  • Ver información de errores: Ver con qué frecuencia ocurrió un error, agrupado por usuario, URL, trabajo, versión, tipo o comando
  • Crear notas: Agregar notas de investigación a errores para colaboración en equipo
  • Explorar logs: Buscar, filtrar y paginar los logs del proyecto por severidad, nombre de host, tipo de punto de entrada o búsqueda de texto libre
  • Monitorear rendimiento: Listar las rutas, consultas, trabajos, comandos, llamadas HTTP externas, vistas, componentes de Livewire y páginas y componentes de navegador más lentos, luego inspeccionar métricas detalladas, tendencias y los traces más lentos para cualquiera de ellos
  • Crear proyectos: Crear un nuevo proyecto de Flare en uno de tus equipos y obtener las claves de API para instalar Flare
  • Leer documentación: Buscar y leer la documentación de Flare, para que tu asistente pueda instalar y configurar Flare por ti

Seguridad

Cada conexión OAuth de un cliente al servidor MCP de Flare tiene su propio nombre y está limitada a los permisos, equipos y proyectos que seleccionas durante el flujo de consentimiento. Múltiples conexiones de Claude, Codex, Cursor u otros clientes pueden funcionar al mismo tiempo. Renombra, ajusta o revoca una conexión sin afectar a las demás desde Cuenta → Conexiones. Los tokens de acceso personal utilizados como respaldo Bearer se gestionan en Cuenta → Tokens de acceso personal.

Comentarios

Si tienes comentarios o preguntas, contáctanos en [email protected].

Primeros pasos Habilidad de agente