MetricFire MCP Server

Para el índice completo de la documentación, consulta llms.txt. Las versiones en Markdown de las páginas de documentación están disponibles añadiendo .md a las URLs de las páginas; esta página está disponible como Markdown.

MF MCP Server

Conecta asistentes de IA para interactuar con la API de Hosted Graphite mediante indicaciones en lenguaje natural.

Contenido

• Crear un token MCP
• Conectar un cliente MCP
  • GitHub Copilot (VS Code)
  • Cursor, Claude Code, Cline, Windsurf
  • Claude
• Herramientas disponibles
  • Métricas
  • Renderizado de Graphite
  • Alertas
  • Paneles
  • Canales de notificación
  • Silencios programados
• Cómo funciona

{% embed url="https://www.youtube.com/watch?t=15s&v=7dIbd2rxARs" %}

El MetricFire MCP Server permite a los clientes de IA compatibles interactuar directamente con tu cuenta de Hosted Graphite mediante el Protocolo de Contexto de Modelo (MCP).

Una vez conectados, clientes como GitHub Copilot, Cursor, Claude/Claude Code, etc. pueden usar las APIs de Hosted Graphite para descubrimiento de métricas, renderizado de Graphite, gestión de alertas, canales de notificación, silencios programados y otros flujos de monitoreo.

El servidor MCP opera sobre los datos y recursos de tu cuenta de Hosted Graphite. Las métricas deben enviarse y almacenarse previamente en Hosted Graphite antes de poder buscarse, renderizarse o usarse para alertas.

Crear un token MCP

En tu cuenta de Hosted Graphite, navega a Add-Ons ⇒ MetricFire MCP Server

Crea un token y selecciona los permisos requeridos por tu cliente MCP:

• Lectura – accede a métricas, renderizados, alertas, canales de notificación, silencios programados y otros recursos compatibles.
• Escritura – crea o modifica recursos compatibles.
• Eliminación – elimina recursos compatibles.

Recomendamos usar los permisos mínimos necesarios para tu flujo de trabajo.

El token MCP completo solo se muestra una vez cuando se crea. Guárdalo de forma segura antes de salir de la página.

Conectar un cliente MCP

El endpoint MCP de Hosted Graphite es:

https://mcp.hostedgraphite.com/

La configuración varía ligeramente según el cliente MCP.

GitHub Copilot (VS Code)

Abre la Paleta de Comandos de VS Code y selecciona: MCP: Open User Configuration

Añade el objeto del MetricFire MCP Server:

{
  "servers": {
    "mf-mcp-server": {
      "url": "https://mcp.hostedgraphite.com/",
      "headers": {
        "X-HostedGraphite-MCP-Token": "YOUR-MCP-TOKEN"
      }
    }
  }
}

Guarda la configuración, inicia el servidor MCP desde VS Code e interactúa con el agente usando Copilot Chat.

Cursor, Claude Code, Cline, Windsurf

Estos clientes admiten encabezados HTTP personalizados. Configura el endpoint:

https://mcp.hostedgraphite.com/

y pasa tu token:

X-HostedGraphite-MCP-Token: <MF-MCP-TOKEN>

Consulta la documentación MCP de tu cliente para conocer la ubicación y el formato de su configuración de servidor.

Claude

La configuración de navegador/interfaz de Claude puede conectarse usando el token MCP en la URL del servidor:

https://<MF-MCP-TOKEN>@mcp.hostedgraphite.com

NOTA: Al usar autenticación basada en URL, recomendamos encarecidamente un token de solo lectura a menos que se requiera específicamente acceso de escritura o eliminación.

Herramientas disponibles

Después de conectarte, tu cliente MCP puede descubrir las herramientas que Hosted Graphite expone actualmente.

Métricas

Hay herramientas disponibles para:

• Búsqueda estándar de métricas (por patrón*)
• Búsqueda de métricas etiquetadas
• Métricas ocupadas
• Métricas inválidas
• Eliminación de métricas

Renderizado de Graphite

La API de Renderizado de Graphite se puede consultar a través de MCP, con soporte para:

• JSON
• CSV
• Datos sin procesar
• PNG
• SVG

Esto permite a los clientes MCP localizar métricas y recuperar o visualizar sus datos en un rango de tiempo especificado.

Alertas

Los asistentes de IA pueden trabajar con tus métricas de Hosted Graphite para crear alertas compuestas significativas usando lógica AND/OR, lo que facilita alertar sobre problemas a nivel de servicio en lugar de umbrales de métricas individuales.

Por ejemplo: "Encuentra las métricas relevantes de CPU, memoria, disco y red para mis servidores de producción y crea una alerta compuesta que me envíe un correo cuando múltiples señales indiquen un problema a nivel de servicio."

Las herramientas de alertas admiten:

• Crear y actualizar alertas
• Buscar y recuperar alertas
• Eliminar alertas
• Silenciar y reactivar alertas
• Estado e historial de alertas
• Criterios de alertas compuestas usando lógica AND/OR

Paneles

Los clientes de IA pueden hacer referencia a métricas almacenadas en tu cuenta de Hosted Graphite y usarlas para crear, actualizar y gestionar paneles de Grafana mediante indicaciones en lenguaje natural. En lugar de buscar métricas manualmente, crear paneles y configurar visualizaciones uno a la vez, puedes pedirle a tu asistente de IA que construya un panel en torno a un servicio, host, aplicación o componente de infraestructura que quieras monitorear.

Por ejemplo: "Encuentra las métricas relevantes de CPU, memoria, disco y red para mis servidores de producción y crea un panel completo de visión general de infraestructura."

Las herramientas de paneles admiten:

• Crear paneles de Grafana
• Actualizar paneles existentes
• Buscar y recuperar paneles
• Eliminar paneles
• Crear y configurar paneles de visualización
• Usar métricas de Hosted Graphite para construir paneles a partir de indicaciones en lenguaje natural

{% embed url="https://www.youtube.com/watch?v=jzkK_87fi0Q" %}

Canales de notificación

Los clientes MCP pueden trabajar con los canales de notificación de Hosted Graphite (Email, Slack, PagerDuty, MS Teams, webhooks, etc.), incluyendo la recuperación de canales y su asociación con alertas. Según los permisos del token, los canales compatibles también se pueden crear, actualizar o eliminar.

Silencios programados

Las herramientas de silencios programados permiten a los clientes MCP crear y gestionar ventanas de silencio recurrentes (por ejemplo, fines de semana). Los silencios programados son recursos separados que se pueden asociar con alertas a través de la API de Alertas.

Cómo funciona

El MetricFire MCP Server proporciona una interfaz MCP para las APIs compatibles de Hosted Graphite. El cliente de IA conectado selecciona la herramienta MCP adecuada según la solicitud y la ejecuta usando los permisos asociados con tu token MCP.

La integración MCP no reemplaza tu recopilación de métricas existente. Continúa enviando datos a Hosted Graphite usando tus agentes, integraciones o protocolos compatibles actuales.

Para más detalles sobre las APIs subyacentes, consulta la documentación de la API de Hosted Graphite y si necesitas ayuda para conectar un cliente MCP, contáctanos en: support@metricfire.com

MCP no está disponible actualmente para usuarios que hayan habilitado el Add-on de Hosted Graphite desde Heroku Marketplace. Contáctanos para aprender cómo migrar tu(s) cuenta(s) HG de Heroku a una cuenta HG dedicada y aprovechar todas las funciones disponibles como MCP y Logging.

---

Instrucciones para agentes

Esta documentación se publica con GitBook. GitBook es la plataforma de documentación diseñada para que tanto humanos como agentes de IA puedan leer, navegar y razonar sobre contenido técnico de manera efectiva. Obtén más información en gitbook.com.

Consultar esta documentación

Si necesitas información adicional que no está disponible directamente en esta página, puedes consultar la documentación haciendo una pregunta.

Realiza una solicitud HTTP GET en la siguiente URL con los parámetros de consulta ask y goal:

GET https://docs.hostedgraphite.com/add-ons-and-integrations-guide/mf-mcp-server.md?ask=<question>&goal=<user_goal>

ask es la pregunta inmediata: debe ser específica, autónoma y escrita en lenguaje natural. goal es lo que el usuario intenta lograr en última instancia, la razón por la que necesita la respuesta. Compartirla ayuda a GitBook a darte una respuesta mejor y más relevante. Una meta es más útil cuando describe el resultado que el usuario quiere en lugar de reformular la pregunta. Por ejemplo, con ask=how do I create an API token, una meta como automate deployments from our CI pipeline permite a GitBook adaptar la respuesta a ese caso de uso.

La respuesta contendrá una respuesta directa a la pregunta y extractos y fuentes relevantes de la documentación.

Usa este mecanismo cuando la respuesta no esté explícitamente presente en la página actual, necesites aclaraciones o contexto adicional, o quieras recuperar secciones relacionadas de la documentación.