MetricFire MCP Server

Pour l'index complet de la documentation, voir llms.txt. Les versions Markdown des pages de documentation sont disponibles en ajoutant .md aux URL des pages ; cette page est disponible en Markdown.

MF MCP Server

Connectez des assistants IA pour interagir avec l'API Hosted Graphite à l'aide de requêtes en langage naturel.

Sommaire

• Créer un jeton MCP
• Connecter un client MCP
  • GitHub Copilot (VS Code)
  • Cursor, Claude Code, Cline, Windsurf
  • Claude
• Outils disponibles
  • Métriques
  • Rendu Graphite
  • Alertes
  • Tableaux de bord
  • Canaux de notification
  • Mises en sourdine planifiées
• Comment ça fonctionne

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

Le MetricFire MCP Server permet aux clients IA pris en charge d'interagir directement avec votre compte Hosted Graphite en utilisant le Model Context Protocol (MCP).

Une fois connectés, des clients tels que GitHub Copilot, Cursor, Claude/Claude Code, etc. peuvent utiliser les API Hosted Graphite pour la découverte de métriques, le rendu Graphite, la gestion des alertes, les canaux de notification, les mises en sourdine planifiées et d'autres flux de travail de surveillance.

Le serveur MCP opère sur les données et les ressources de votre compte Hosted Graphite. Les métriques doivent déjà être transférées et stockées dans Hosted Graphite avant de pouvoir être recherchées, rendues ou utilisées pour les alertes.

Créer un jeton MCP

Dans votre compte Hosted Graphite, accédez à Add-Ons ⇒ MetricFire MCP Server

Créez un jeton et sélectionnez les autorisations requises par votre client MCP :

• Lecture – accéder aux métriques, rendus, alertes, canaux de notification, mises en sourdine planifiées et autres ressources prises en charge.
• Écriture – créer ou modifier des ressources prises en charge.
• Suppression – supprimer des ressources prises en charge.

Nous recommandons d'utiliser les autorisations minimales requises pour votre flux de travail.

Le jeton MCP complet n'est affiché qu'une seule fois lors de sa création. Stockez-le en toute sécurité avant de quitter la page.

Connecter un client MCP

Le point de terminaison MCP Hosted Graphite est :

https://mcp.hostedgraphite.com/

La configuration varie légèrement selon le client MCP.

GitHub Copilot (VS Code)

Ouvrez la palette de commandes VS Code et sélectionnez : MCP: Open User Configuration

Ajoutez l'objet MetricFire MCP Server :

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

Enregistrez la configuration, démarrez le serveur MCP depuis VS Code et interagissez avec l'agent à l'aide de Copilot Chat.

Cursor, Claude Code, Cline, Windsurf

Ces clients prennent en charge les en-têtes HTTP personnalisés. Configurez le point de terminaison :

https://mcp.hostedgraphite.com/

et transmettez votre jeton :

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

Consultez la documentation MCP de votre client pour connaître l'emplacement et le format de sa configuration serveur.

Claude

La configuration navigateur/interface de Claude peut se connecter en utilisant le jeton MCP dans l'URL du serveur :

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

REMARQUE : Lorsque vous utilisez l'authentification par URL, nous recommandons fortement un jeton en lecture seule sauf si un accès en écriture ou en suppression est spécifiquement requis.

Outils disponibles

Après la connexion, votre client MCP peut découvrir les outils actuellement exposés par Hosted Graphite.

Métriques

Des outils sont disponibles pour :

• Recherche de métriques standard (par modèle*)
• Recherche de métriques étiquetées
• Métriques actives
• Métriques invalides
• Suppression de métriques

Rendu Graphite

L'API Graphite Render peut être interrogée via MCP, avec prise en charge de :

• JSON
• CSV
• Données brutes
• PNG
• SVG

Cela permet aux clients MCP de localiser les métriques et de récupérer ou visualiser leurs données sur une plage de temps spécifiée.

Alertes

Les assistants IA peuvent travailler avec vos métriques Hosted Graphite pour créer des alertes composites significatives utilisant la logique ET/OU, ce qui facilite l'alerte sur des problèmes au niveau du service plutôt que sur des seuils de métriques individuels.

Par exemple : « Trouvez les métriques CPU, mémoire, disque et réseau pertinentes pour mes serveurs de production et créez une alerte composite qui m'envoie un e-mail lorsque plusieurs signaux indiquent un problème au niveau du service. »

Les outils d'alerte prennent en charge :

• Création et mise à jour d'alertes
• Recherche et récupération d'alertes
• Suppression d'alertes
• Mise en sourdine et réactivation d'alertes
• Statut et historique des alertes
• Critères d'alerte composite utilisant la logique ET/OU

Tableaux de bord

Les clients IA peuvent référencer les métriques stockées dans votre compte Hosted Graphite et les utiliser pour créer, mettre à jour et gérer des tableaux de bord Grafana à l'aide de requêtes en langage naturel. Au lieu de rechercher manuellement les métriques, de créer des panneaux et de configurer les visualisations un par un, vous pouvez demander à votre assistant IA de créer un tableau de bord autour d'un service, d'un hôte, d'une application ou d'un composant d'infrastructure que vous souhaitez surveiller.

Par exemple : « Trouvez les métriques CPU, mémoire, disque et réseau pertinentes pour mes serveurs de production et créez un tableau de bord complet de vue d'ensemble de l'infrastructure. »

Les outils de tableau de bord prennent en charge :

• Création de tableaux de bord Grafana
• Mise à jour de tableaux de bord existants
• Recherche et récupération de tableaux de bord
• Suppression de tableaux de bord
• Création et configuration de panneaux de tableau de bord
• Utilisation des métriques Hosted Graphite pour créer des tableaux de bord à partir de requêtes en langage naturel

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

Canaux de notification

Les clients MCP peuvent travailler avec les canaux de notification Hosted Graphite (Email, Slack, PagerDuty, MS Teams, webhooks, etc.), y compris la récupération des canaux et leur association avec des alertes. Selon les autorisations du jeton, les canaux pris en charge peuvent également être créés, mis à jour ou supprimés.

Mises en sourdine planifiées

Les outils de mise en sourdine planifiée permettent aux clients MCP de créer et de gérer des fenêtres de mise en sourdine récurrentes (par exemple, les week-ends). Les mises en sourdine planifiées sont des ressources distinctes qui peuvent être associées à des alertes via l'API Alert.

Comment ça fonctionne

Le MetricFire MCP Server fournit une interface MCP aux API Hosted Graphite prises en charge. Le client IA connecté sélectionne l'outil MCP approprié en fonction de la demande et l'exécute en utilisant les autorisations associées à votre jeton MCP.

L'intégration MCP ne remplace pas votre collecte de métriques existante. Continuez à envoyer des données à Hosted Graphite en utilisant vos agents, intégrations ou protocoles pris en charge existants.

Pour plus de détails sur les API sous-jacentes, consultez la documentation de l'API Hosted Graphite et si vous avez besoin d'aide pour connecter un client MCP, contactez-nous à : support@metricfire.com

MCP n'est actuellement pas disponible pour les utilisateurs qui ont activé l'Add-on Hosted Graphite depuis le Heroku Marketplace. Contactez-nous pour savoir comment migrer votre(vos) compte(s) Heroku HG vers un compte HG dédié et profiter de toutes les fonctionnalités disponibles comme MCP et la journalisation.

---

Instructions pour l'agent

Cette documentation est publiée avec GitBook. GitBook est la plateforme de documentation conçue pour que les humains et les agents IA puissent lire, naviguer et raisonner efficacement sur le contenu technique. En savoir plus sur gitbook.com.

Interroger cette documentation

Si vous avez besoin d'informations supplémentaires qui ne sont pas directement disponibles sur cette page, vous pouvez interroger la documentation en posant une question.

Effectuez une requête HTTP GET sur l'URL suivante avec les paramètres de requête ask et goal :

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

ask est la question immédiate : elle doit être spécifique, autonome et rédigée en langage naturel. goal est ce que l'utilisateur essaie finalement d'atteindre, la raison pour laquelle il a besoin de la réponse. Le partager aide GitBook à vous donner une meilleure réponse, plus pertinente. Un objectif est plus utile lorsqu'il décrit le résultat souhaité par l'utilisateur plutôt que de reformuler la question. Par exemple, avec ask=how do I create an API token, un objectif comme automate deployments from our CI pipeline permet à GitBook d'adapter la réponse à ce cas d'utilisation.

La réponse contiendra une réponse directe à la question ainsi que des extraits et sources pertinents de la documentation.

Utilisez ce mécanisme lorsque la réponse n'est pas explicitement présente sur la page actuelle, que vous avez besoin de clarifications ou de contexte supplémentaire, ou que vous souhaitez récupérer des sections de documentation connexes.