MetricFire MCP Server

Để xem chỉ mục tài liệu đầy đủ, hãy xem llms.txt. Các phiên bản Markdown của các trang tài liệu có sẵn bằng cách thêm .md vào URL của trang; trang này có sẵn dưới dạng Markdown.

MF MCP Server

Kết nối các trợ lý AI để tương tác với API Hosted Graphite bằng các lời nhắc ngôn ngữ tự nhiên.

Mục lục

• Tạo MCP Token
• Kết nối MCP Client
  • GitHub Copilot (VS Code)
  • Cursor, Claude Code, Cline, Windsurf
  • Claude
• Các công cụ có sẵn
  • Metrics
  • Graphite Render
  • Alerts
  • Dashboards
  • Kênh thông báo
  • Tạm ẩn theo lịch
• Cách hoạt động

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

MetricFire MCP Server cho phép các MCP client được hỗ trợ tương tác trực tiếp với tài khoản Hosted Graphite của bạn bằng Model Context Protocol (MCP).

Sau khi kết nối, các client như GitHub Copilot, Cursor, Claude/Claude Code, v.v. có thể sử dụng API Hosted Graphite để khám phá metrics, kết xuất Graphite, quản lý cảnh báo, kênh thông báo, tạm ẩn theo lịch và các quy trình giám sát khác.

MCP server hoạt động trên dữ liệu và tài nguyên trong tài khoản Hosted Graphite của bạn. Metrics phải được chuyển tiếp và lưu trữ trong Hosted Graphite trước khi chúng có thể được tìm kiếm, kết xuất hoặc sử dụng để tạo cảnh báo.

Tạo MCP Token

Trong tài khoản Hosted Graphite của bạn, điều hướng đến Add-Ons ⇒ MetricFire MCP Server

Tạo một token và chọn các quyền cần thiết cho MCP client của bạn:

• Read – truy cập metrics, kết xuất, cảnh báo, kênh thông báo, tạm ẩn theo lịch và các tài nguyên được hỗ trợ khác.
• Write – tạo hoặc sửa đổi các tài nguyên được hỗ trợ.
• Delete – xóa các tài nguyên được hỗ trợ.

Chúng tôi khuyên bạn nên sử dụng quyền tối thiểu cần thiết cho quy trình làm việc của mình.

MCP token đầy đủ chỉ được hiển thị một lần khi được tạo. Hãy lưu trữ nó một cách an toàn trước khi rời khỏi trang.

Kết nối MCP Client

Điểm cuối MCP của Hosted Graphite là:

https://mcp.hostedgraphite.com/

Cấu hình thay đổi đôi chút tùy thuộc vào MCP client.

GitHub Copilot (VS Code)

Mở Command Palette của VS Code và chọn: MCP: Open User Configuration

Thêm đối tượng MetricFire MCP Server:

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

Lưu cấu hình, khởi động MCP server từ trong VS Code và tương tác với agent bằng Copilot Chat.

Cursor, Claude Code, Cline, Windsurf

Các client này hỗ trợ các tiêu đề HTTP tùy chỉnh. Cấu hình điểm cuối:

https://mcp.hostedgraphite.com/

và truyền token của bạn:

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

Tham khảo tài liệu MCP của client để biết vị trí và định dạng cấu hình server của nó.

Claude

Cấu hình trình duyệt/giao diện người dùng của Claude có thể kết nối bằng MCP token trong URL server:

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

LƯU Ý: Khi sử dụng xác thực dựa trên URL, chúng tôi khuyên bạn nên dùng token chỉ đọc trừ khi quyền ghi hoặc xóa thực sự được yêu cầu.

Các công cụ có sẵn

Sau khi kết nối, MCP client của bạn có thể khám phá các công cụ hiện được Hosted Graphite cung cấp.

Metrics

Các công cụ có sẵn cho:

• Tìm kiếm metrics tiêu chuẩn (theo mẫu*)
• Tìm kiếm metrics có gắn thẻ
• Metrics bận
• Metrics không hợp lệ
• Xóa metrics

Graphite Render

API Graphite Render có thể được truy vấn thông qua MCP, với hỗ trợ cho:

• JSON
• CSV
• Dữ liệu thô
• PNG
• SVG

Điều này cho phép MCP client định vị metrics và truy xuất hoặc trực quan hóa dữ liệu của chúng trong một khoảng thời gian cụ thể.

Alerts

Các trợ lý AI có thể làm việc với metrics Hosted Graphite của bạn để xây dựng cảnh báo tổng hợp có ý nghĩa bằng logic AND/OR, giúp dễ dàng cảnh báo về các vấn đề ở cấp dịch vụ thay vì các ngưỡng metric riêng lẻ.

Ví dụ: “Tìm các metrics CPU, bộ nhớ, đĩa và mạng liên quan cho các máy chủ production của tôi và tạo một cảnh báo tổng hợp gửi email cho tôi khi nhiều tín hiệu chỉ ra một vấn đề ở cấp dịch vụ.”

Các công cụ cảnh báo hỗ trợ:

• Tạo và cập nhật cảnh báo
• Tìm kiếm và truy xuất cảnh báo
• Xóa cảnh báo
• Tạm ẩn và bỏ tạm ẩn cảnh báo
• Trạng thái và lịch sử cảnh báo
• Tiêu chí cảnh báo tổng hợp bằng logic AND/OR

Dashboards

Các AI client có thể tham chiếu các metrics được lưu trữ trong tài khoản Hosted Graphite của bạn và sử dụng chúng để xây dựng, cập nhật và quản lý các dashboard Grafana bằng lời nhắc ngôn ngữ tự nhiên. Thay vì tìm kiếm metrics, tạo panel và cấu hình trực quan hóa từng cái một theo cách thủ công, bạn có thể yêu cầu trợ lý AI xây dựng một dashboard xoay quanh dịch vụ, máy chủ, ứng dụng hoặc thành phần hạ tầng mà bạn muốn giám sát.

Ví dụ: “Tìm các metrics CPU, bộ nhớ, đĩa và mạng liên quan cho các máy chủ production của tôi và xây dựng một dashboard tổng quan hạ tầng toàn diện.”

Các công cụ dashboard hỗ trợ:

• Tạo dashboard Grafana
• Cập nhật dashboard hiện có
• Tìm kiếm và truy xuất dashboard
• Xóa dashboard
• Tạo và cấu hình panel dashboard
• Sử dụng metrics Hosted Graphite để xây dựng dashboard từ lời nhắc ngôn ngữ tự nhiên

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

Kênh thông báo

Các MCP client có thể làm việc với các kênh thông báo Hosted Graphite (Email, Slack, PagerDuty, MS Teams, webhooks, v.v.), bao gồm truy xuất kênh và liên kết chúng với cảnh báo. Tùy thuộc vào quyền của token, các kênh được hỗ trợ cũng có thể được tạo, cập nhật hoặc xóa.

Tạm ẩn theo lịch

Các công cụ tạm ẩn theo lịch cho phép MCP client tạo và quản lý các khoảng thời gian tạm ẩn định kỳ (ví dụ: cuối tuần). Tạm ẩn theo lịch là các tài nguyên riêng biệt có thể được liên kết với cảnh báo thông qua Alert API.

Cách hoạt động

MetricFire MCP Server cung cấp giao diện MCP cho các API Hosted Graphite được hỗ trợ. AI client được kết nối sẽ chọn công cụ MCP phù hợp dựa trên yêu cầu và thực thi nó bằng các quyền liên kết với MCP token của bạn.

Tích hợp MCP không thay thế việc thu thập metrics hiện tại của bạn. Tiếp tục gửi dữ liệu đến Hosted Graphite bằng các agent, tích hợp hoặc giao thức được hỗ trợ hiện có của bạn.

Để biết thêm chi tiết về các API cơ bản, hãy xem tài liệu API Hosted Graphite và nếu bạn cần trợ giúp kết nối MCP client, hãy liên hệ với chúng tôi tại: support@metricfire.com

MCP hiện không khả dụng cho người dùng đã kích hoạt Add-on Hosted Graphite từ Heroku Marketplace. Liên hệ với chúng tôi để tìm hiểu cách di chuyển (các) tài khoản Heroku HG của bạn sang tài khoản HG chuyên dụng và tận dụng tất cả các tính năng có sẵn như MCP và Logging.

---

Hướng dẫn Agent

Tài liệu này được xuất bản bằng GitBook. GitBook là nền tảng tài liệu được thiết kế để cả con người và AI agent có thể đọc, điều hướng và suy luận về nội dung kỹ thuật một cách hiệu quả. Tìm hiểu thêm tại gitbook.com.

Truy vấn tài liệu này

Nếu bạn cần thông tin bổ sung không có trực tiếp trong trang này, bạn có thể truy vấn tài liệu bằng cách đặt câu hỏi.

Thực hiện yêu cầu HTTP GET trên URL sau với các tham số truy vấn ask và goal:

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

ask là câu hỏi trực tiếp: nó phải cụ thể, tự chứa và được viết bằng ngôn ngữ tự nhiên. goal là điều người dùng cuối cùng đang cố gắng đạt được, lý do họ cần câu trả lời. Chia sẻ mục tiêu giúp GitBook đưa ra câu trả lời tốt hơn và phù hợp hơn. Mục tiêu hữu ích nhất khi nó mô tả kết quả người dùng muốn đạt được thay vì diễn đạt lại câu hỏi. Ví dụ: với ask=how do I create an API token, một mục tiêu như automate deployments from our CI pipeline cho phép GitBook điều chỉnh câu trả lời cho trường hợp sử dụng đó.

Phản hồi sẽ chứa câu trả lời trực tiếp cho câu hỏi cùng các đoạn trích và nguồn liên quan từ tài liệu.

Sử dụng cơ chế này khi câu trả lời không có sẵn rõ ràng trong trang hiện tại, bạn cần làm rõ hoặc thêm ngữ cảnh, hoặc bạn muốn truy xuất các phần tài liệu liên quan.