MetricFire MCP Server

完全なドキュメント索引については、llms.txt を参照してください。ドキュメントページのMarkdown版は、ページURLに .md を追加することで利用できます。このページは Markdown としても利用可能です。

MF MCP Server

AIアシスタントを自然言語プロンプトでHosted Graphite APIと連携させます。

目次

• MCPトークンの作成
• MCPクライアントの接続
  • GitHub Copilot (VS Code)
  • Cursor、Claude Code、Cline、Windsurf
  • Claude
• 利用可能なツール
  • メトリクス
  • Graphite Render
  • アラート
  • ダッシュボード
  • 通知チャンネル
  • スケジュール済みミュート
• 仕組み

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

MetricFire MCP Serverを使用すると、サポートされているAIクライアントがModel Context Protocol (MCP)を使用してHosted Graphiteアカウントと直接対話できます。

接続後、GitHub Copilot、Cursor、Claude/Claude Codeなどのクライアントは、Hosted Graphite APIを使用して、メトリクスの検出、Graphiteレンダリング、アラート管理、通知チャンネル、スケジュール済みミュート、その他の監視ワークフローを実行できます。

MCPサーバーは、Hosted Graphiteアカウント内のデータとリソースに対して動作します。メトリクスは、検索、レンダリング、またはアラートに使用される前に、事前にHosted Graphiteに転送および保存されている必要があります。

MCPトークンの作成

Hosted Graphiteアカウントで、Add-Ons ⇒ MetricFire MCP Server に移動します。

トークンを作成し、MCPクライアントに必要な権限を選択します:

• 読み取り – メトリクス、レンダリング、アラート、通知チャンネル、スケジュール済みミュート、その他のサポートされているリソースにアクセスします。
• 書き込み – サポートされているリソースを作成または変更します。
• 削除 – サポートされているリソースを削除します。

ワークフローに必要な最小限の権限を使用することをお勧めします。

完全なMCPトークンは作成時に一度だけ表示されます。ページを離れる前に安全に保管してください。

MCPクライアントの接続

Hosted Graphite MCPエンドポイントは次のとおりです:

https://mcp.hostedgraphite.com/

設定はMCPクライアントによって多少異なります。

GitHub Copilot (VS Code)

VS Codeのコマンドパレットを開き、MCP: Open User Configuration を選択します。

MetricFire MCP Serverオブジェクトを追加します:

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

設定を保存し、VS Code内からMCPサーバーを起動して、Copilot Chatでエージェントと対話します。

Cursor、Claude Code、Cline、Windsurf

これらのクライアントはカスタムHTTPヘッダーをサポートしています。エンドポイントを設定します:

https://mcp.hostedgraphite.com/

トークンを渡します:

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

サーバー設定の場所と形式については、クライアントのMCPドキュメントを参照してください。

Claude

Claudeのブラウザ/UI設定は、サーバーURL内のMCPトークンを使用して接続できます:

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

注: URLベースの認証を使用する場合、書き込みまたは削除アクセスが特に必要な場合を除き、読み取り専用トークンを強くお勧めします。

利用可能なツール

接続後、MCPクライアントはHosted Graphiteが現在公開しているツールを検出できます。

メトリクス

次のツールが利用可能です:

• 標準メトリクス検索（パターン*による）
• タグ付きメトリクス検索
• ビジーメトリクス
• 無効なメトリクス
• メトリクスの削除

Graphite Render

Graphite Render APIはMCPを通じてクエリでき、以下をサポートしています:

• JSON
• CSV
• 生データ
• PNG
• SVG

これにより、MCPクライアントはメトリクスを特定し、指定した時間範囲でデータを取得または視覚化できます。

アラート

AIアシスタントはHosted Graphiteメトリクスを使用して、AND/ORロジックを使用した意味のある複合アラートを構築でき、個々のメトリクスしきい値ではなく、サービスレベルの問題に対してアラートを発報しやすくなります。

例: 「本番サーバーの関連するCPU、メモリ、ディスク、ネットワークメトリクスを特定し、複数のシグナルがサービスレベルの問題を示したときにメールで通知する複合アラートを作成してください。」

アラートツールは以下をサポートしています:

• アラートの作成と更新
• アラートの検索と取得
• アラートの削除
• アラートのミュートとミュート解除
• アラートのステータスと履歴
• AND/ORロジックを使用した複合アラート条件

ダッシュボード

AIクライアントはHosted Graphiteアカウントに保存されているメトリクスを参照し、自然言語プロンプトを使用してGrafanaダッシュボードを構築、更新、管理できます。メトリクスを手動で検索したり、パネルを作成したり、視覚化を1つずつ設定したりする代わりに、監視したいサービス、ホスト、アプリケーション、またはインフラストラクチャコンポーネントを中心にダッシュボードを構築するようAIアシスタントに依頼できます。

例: 「本番サーバーの関連するCPU、メモリ、ディスク、ネットワークメトリクスを特定し、包括的なインフラストラクチャ概要ダッシュボードを構築してください。」

ダッシュボードツールは以下をサポートしています:

• Grafanaダッシュボードの作成
• 既存ダッシュボードの更新
• ダッシュボードの検索と取得
• ダッシュボードの削除
• ダッシュボードパネルの作成と設定
• Hosted Graphiteメトリクスを使用した自然言語プロンプトからのダッシュボード構築

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

通知チャンネル

MCPクライアントはHosted Graphite通知チャンネル（Email、Slack、PagerDuty、MS Teams、webhooksなど）を操作でき、チャンネルの取得やアラートへの関連付けが含まれます。トークンの権限に応じて、サポートされているチャンネルの作成、更新、削除も可能です。

スケジュール済みミュート

スケジュール済みミュートツールを使用すると、MCPクライアントは定期的なミュート期間（例: 週末）を作成および管理できます。スケジュール済みミュートは独立したリソースであり、Alert APIを通じてアラートに関連付けることができます。

仕組み

MetricFire MCP Serverは、サポートされているHosted Graphite APIへのMCPインターフェースを提供します。接続されたAIクライアントは、リクエストに基づいて適切なMCPツールを選択し、MCPトークンに関連付けられた権限を使用して実行します。

MCP統合は既存のメトリクス収集を置き換えるものではありません。既存のエージェント、統合、またはサポートされているプロトコルを使用して、引き続きHosted Graphiteにデータを送信してください。

基盤となるAPIの詳細については、Hosted Graphite APIドキュメント を参照してください。MCPクライアントの接続についてサポートが必要な場合は、support@metricfire.com までお問い合わせください。

MCPは現在、Heroku MarketplaceからHosted Graphite Add-onを有効にしたユーザーには利用できません。Heroku HGアカウントを専用HGアカウントに移行し、MCPやロギングなどの利用可能なすべての機能を活用する方法については、お問い合わせください。

---

エージェント向け手順

このドキュメントはGitBookで公開されています。GitBookは、人間とAIエージェントの両方が技術コンテンツを効果的に読み、ナビゲートし、推論できるように設計されたドキュメントプラットフォームです。詳細はgitbook.comをご覧ください。

このドキュメントのクエリ

このページで直接利用できない追加情報が必要な場合は、質問をすることでドキュメントをクエリできます。

次のURLに対して、ask および goal クエリパラメータを使用してHTTP GETリクエストを実行します:

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

ask は直接の質問です。具体的で、自己完結型で、自然言語で記述する必要があります。 goal はユーザーが最終的に達成しようとしていること、つまり回答が必要な理由です。これを共有することで、GitBookはより適切で関連性の高い回答を提供できます。ゴールは、質問を言い換えるのではなく、ユーザーが望む結果を説明する場合に最も役立ちます。たとえば、ask=how do I create an API token の場合、automate deployments from our CI pipeline のようなゴールを設定すると、GitBookはそのユースケースに合わせて回答を調整できます。

応答には、質問への直接的な回答と、ドキュメントからの関連する抜粋およびソースが含まれます。

回答が現在のページに明示的に存在しない場合、明確化や追加のコンテキストが必要な場合、または関連するドキュメントセクションを取得したい場合は、このメカニズムを使用してください。