Guía de configuración del servidor Honeybadger MCP
Este servidor MCP integra el seguimiento de errores de Honeybadger con Cursor IDE, lo que le permite obtener y analizar errores directamente desde su entorno de desarrollo.
Prerrequisitos
- Node.js 18+ instalado
- Cuenta Honeybadger con acceso a la API
- IDE de cursor con soporte MCP
Instalación
1. Clonar el servidor MCP
2. Construir el proyecto
3. Uso como paquete NPM (recomendado)
Instalación global:
Luego configúrelo en Cursor:
Instalación basada en proyectos (alternativa):
Si prefiere administrar el servidor MCP como una dependencia del proyecto:
En este caso, el comando en su Cursor mcp_servers.json
apuntaría a la instalación local dentro de node_modules
de su proyecto:
4. Configurar variables de entorno
Crea un archivo .env
en la raíz de tu proyecto:
4. Obtén tus credenciales de Honeybadger
- Clave API :
- Vaya a https://app.honeybadger.io/users/auth\_tokens
- Crear un nuevo token de autenticación personal
- Copia el token para tu archivo
.env
- ID del proyecto :
- Vaya a su proyecto en Honeybadger
- El ID del proyecto está en la URL:
https://app.honeybadger.io/projects/{PROJECT_ID}
- O encuéntrelo en la configuración del proyecto
Configuración del cursor
1. Configurar MCP en Cursor
Añade el servidor MCP a la configuración de Cursor. Edita tu ~/.cursor/mcp_servers.json
(o equivalente):
2. Alternativa: Instalación global
Esta sección se actualizará o eliminará, ya que ya se ha explicado anteriormente. Si prefiere el método anterior de clonar e instalar globalmente desde una ruta local, aún puede hacerlo, pero se recomienda usar el paquete npm publicado para facilitar las actualizaciones y la administración.
Si se instala desde un clon local:
Uso
Una vez configurado, puedes utilizar estas herramientas en Cursor:
1. Enumere las fallas recientes
2. Obtenga detalles específicos de la falla
3. Analizar un problema
4. Obtener ocurrencias de errores
Herramientas disponibles
list_honeybadger_faults
Enumera fallas recientes con filtrado opcional por entorno y estado resuelto.
Parámetros:
project_id
(opcional): ID del proyectolimit
(opcional): Número de fallos (predeterminado: 20, máximo: 100)environment
(opcional): Filtrar por entornoresolved
(opcional): Filtrar por estado resuelto
get_honeybadger_fault
Obtiene información detallada sobre una falla específica.
Parámetros:
fault_id
(obligatorio): El ID de fallaproject_id
(opcional): ID del proyecto
get_honeybadger_notices
Obtiene avisos (ocurrencias de errores) para una falla específica.
Parámetros:
fault_id
(obligatorio): El ID de la fallaproject_id
(opcional): ID del proyectolimit
(opcional): Número de avisos (predeterminado: 10, máximo: 100)
analyze_honeybadger_issue
Proporciona un análisis completo con sugerencias de soluciones.
Parámetros:
fault_id
(obligatorio): El ID de la fallaproject_id
(opcional): ID del proyectoinclude_context
(opcional): incluye el contexto de la solicitud (valor predeterminado: verdadero)
Ejemplo de flujo de trabajo
- Lista de errores recientes : "Muéstrame los últimos errores sin resolver de producción"
- Analizar el error específico : "Analizar la falla 12345 de Honeybadger y sugerir soluciones".
- Obtener contexto de error : "Obtener las últimas incidencias del error 12345 con contexto completo"
- Revisar y corregir : utilice el análisis para comprender y solucionar el problema en su código.
Solución de problemas
Problemas comunes
- Error de autenticación : Verifique que su clave API sea correcta y tenga los permisos adecuados
- Proyecto no encontrado : Verifique que el ID de su proyecto sea correcto
- Problemas de conexión : verificar el acceso de red a la API de Honeybadger
Modo de depuración
Ejecute el servidor directamente para ver los mensajes de error:
Registros
Consulte los registros del cursor para detectar problemas relacionados con MCP:
- macOS:
~/Library/Logs/Cursor/
- Windows:
%APPDATA%\Cursor\logs\
- Linux:
~/.config/Cursor/logs/
Notas de seguridad
- Almacene las claves API de forma segura y nunca las envíe al control de versiones
- Utilice claves API específicas del entorno cuando sea posible
- Considere usar tokens API de solo lectura para esta integración
- Rote regularmente sus claves API
Contribuyendo
Para ampliar este servidor MCP:
- Agregar nuevas herramientas en el método
setupToolHandlers()
- Implementar métodos de controlador correspondientes
- Actualizar la lista de herramientas y la documentación
- Pruebe exhaustivamente su configuración de Honeybadger
Apoyo
Para problemas con:
- Este servidor MCP : Verifique el código y la configuración
- API de Honeybadger : consulte la documentación de la API de Honeybadger
- Integración de Cursor MCP : consulte la documentación de Cursor
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Integra el seguimiento de errores de Honeybadger con Cursor IDE, lo que permite a los desarrolladores obtener, analizar y solucionar errores de aplicaciones directamente desde su entorno de desarrollo.
Related MCP Servers
- -securityAlicense-qualityFacilitates integration with the Cursor code editor by enabling real-time code indexing, analysis, and bi-directional communication with Claude, supporting concurrent sessions and automatic reconnection.Last updated -22131TypeScriptMIT License
- -securityAlicense-qualityAn AI-powered development toolkit for Cursor providing intelligent coding assistance through advanced reasoning, UI screenshot analysis, and code review tools.Last updated -839240TypeScriptMIT License
- -securityAlicense-qualityA Cursor-compatible toolkit that provides intelligent coding assistance through custom AI tools for code architecture planning, screenshot analysis, code review, and file reading capabilities.Last updated -8392TypeScriptMIT License
- -securityAlicense-qualityA collection of Laravel helper tools for integration with Cursor IDE, providing features like log viewing, error searching, artisan command execution, and model information display directly within the editor.Last updated -1PythonMIT License