MetricFire MCP Server

공식

자연어를 사용하여 인프라를 모니터링하세요. 새로운 MetricFire Model Context Protocol (MCP) 서버를 통해 GitHub Copilot과 같은 AI 어시스턴트에 MetricFire MCP 서버를 연결하고, 간단한 프롬프트로 메트릭 검색, 데이터 시각화, 알림 생성, 모니터링 환경 관리를 API 호출 없이 수행할 수 있습니다.

MetricFire MCP(으)로 무엇을 할 수 있나요?

  • 검색 메트릭 — 패턴이나 태그로 메트릭을 찾도록 어시스턴트에게 요청하세요. 사용 중이거나 유효하지 않은 메트릭도 포함됩니다.
  • Graphite 데이터 렌더링 — 지정된 시간 범위에 대해 JSON, CSV, raw, PNG 또는 SVG 형식으로 메트릭 데이터를 요청하세요.
  • 알림 관리 — AND/OR 로직이 포함된 복합 알림을 포함해 알림을 생성, 업데이트, 검색, 음소거 또는 삭제하세요.
  • Grafana 대시보드 구축 — 자연어 프롬프트로 대시보드와 패널을 생성하거나 업데이트하도록 어시스턴트에게 요청하세요.
  • 알림 채널 처리 — Email, Slack, PagerDuty, 웹훅 같은 채널을 검색, 생성, 업데이트 또는 삭제하세요.
  • 음소거 예약 — 반복 음소거 기간(예: 주말)을 설정하고 이를 알림과 연결하세요.

문서

전체 문서 색인은 llms.txt를 참조하세요. 문서 페이지의 Markdown 버전은 페이지 URL에 .md을 추가하여 사용할 수 있습니다. 이 페이지는 Markdown으로도 제공됩니다.

MF MCP Server

AI 어시스턴트를 Hosted Graphite API와 자연어 프롬프트로 상호작용하도록 연결합니다.

목차

{% 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 등의 클라이언트는 메트릭 검색, Graphite 렌더링, 알림 관리, 알림 채널, 예약 음소거 및 기타 모니터링 워크플로우에 Hosted Graphite API를 사용할 수 있습니다.

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 렌더링

Graphite Render API는 MCP를 통해 쿼리할 수 있으며 다음을 지원합니다:

  • JSON
  • CSV
  • 원시 데이터
  • PNG
  • SVG

이를 통해 MCP 클라이언트는 메트릭을 찾고 지정된 시간 범위에 걸쳐 데이터를 검색하거나 시각화할 수 있습니다.

알림

AI 어시스턴트는 Hosted Graphite 메트릭을 사용하여 AND/OR 논리를 사용한 의미 있는 복합 알림을 구축할 수 있어, 개별 메트릭 임계값보다는 서비스 수준 문제에 대해 알림을 보내기 쉽습니다.

예: "프로덕션 서버의 관련 CPU, 메모리, 디스크 및 네트워크 메트릭을 찾아 여러 신호가 서비스 수준 문제를 나타낼 때 이메일을 보내는 복합 알림을 생성하세요."

알림 도구는 다음을 지원합니다:

  • 알림 생성 및 업데이트
  • 알림 검색 및 조회
  • 알림 삭제
  • 알림 음소거 및 음소거 해제
  • 알림 상태 및 기록
  • AND/OR 논리를 사용한 복합 알림 기준

대시보드

AI 클라이언트는 Hosted Graphite 계정에 저장된 메트릭을 참조하고 자연어 프롬프트를 사용하여 Grafana 대시보드를 구축, 업데이트 및 관리할 수 있습니다. 메트릭을 수동으로 검색하고 패널을 만들고 시각화를 하나씩 구성하는 대신, 모니터링하려는 서비스, 호스트, 애플리케이션 또는 인프라 구성 요소를 중심으로 대시보드를 구축하도록 AI 어시스턴트에게 요청할 수 있습니다.

예: "프로덕션 서버의 관련 CPU, 메모리, 디스크 및 네트워크 메트릭을 찾아 포괄적인 인프라 개요 대시보드를 구축하세요."

대시보드 도구는 다음을 지원합니다:

  • Grafana 대시보드 생성
  • 기존 대시보드 업데이트
  • 대시보드 검색 및 조회
  • 대시보드 삭제
  • 대시보드 패널 생성 및 구성
  • 자연어 프롬프트에서 Hosted Graphite 메트릭을 사용하여 대시보드 구축

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

알림 채널

MCP 클라이언트는 Hosted Graphite 알림 채널(이메일, Slack, PagerDuty, MS Teams, 웹훅 등)을 사용할 수 있으며, 채널 검색 및 알림과의 연결을 포함합니다. 토큰 권한에 따라 지원되는 채널을 생성, 업데이트 또는 삭제할 수도 있습니다.

예약 음소거

예약 음소거 도구를 통해 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에서 확인하세요.

이 문서 쿼리하기

이 페이지에서 직접 사용할 수 없는 추가 정보가 필요한 경우 질문을 통해 문서를 쿼리할 수 있습니다.

ask 및 goal 쿼리 매개변수와 함께 다음 URL에 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이 해당 사용 사례에 맞게 답변을 조정할 수 있습니다.

응답에는 질문에 대한 직접적인 답변과 문서의 관련 발췌문 및 출처가 포함됩니다.

답변이 현재 페이지에 명시적으로 없거나, 설명이나 추가 컨텍스트가 필요하거나, 관련 문서 섹션을 검색하려는 경우 이 메커니즘을 사용하세요.