🚀 Biến Claude thành "Chuyên gia Monitoring": Hướng dẫn cấu hình MCP Prometheus cho Claude Desktop

[Lương Đạt]

Bạn có bao giờ ước mình có thể... "chat" với hệ thống monitoring thay vì phải căng mắt soi dashboard Grafana hay gõ từng dòng PromQL dài ngoằng không? Kiểu như hỏi: "Ê Claude, server sáng nay có ổn áp không?"

Tin vui là với Model Context Protocol (MCP), bạn hoàn toàn có thể cấp "quyền lực" này cho Claude Desktop. Hôm nay, mình sẽ hướng dẫn các bạn cách kết nối Claude với Prometheus cực nhanh, cực dễ. Bắt đầu thôi! 👇

---

🛠️ Bước 1: Chuẩn bị đồ nghề
Trước khi bắt tay vào việc, hãy check xem mình đã có đủ "nguyên liệu" chưa nhé:

• ✅ Claude Desktop App: Đã cài sẵn trên Desktop
• ✅ Go (Golang): Đã cài Homebrew/Go để build tool (hoặc tải binary có sẵn nếu bạn lười build 😆).
• ✅ Prometheus: Đã có địa chỉ server (ví dụ: http://10.215.27.90:9090).
• ✅ Chìa khóa vào nhà: Username & Password (nếu Prometheus của bạn có cài Basic Auth).

---

🏗️ Bước 2: Tải và Build MCP Prometheus

Chúng ta cần một "người vận chuyển" để nối Claude với Prometheus. Mở Terminal lên và gõ vài dòng "thần thánh" này nhé:

# Cài Go nếu chưa có
brew install go

# Kéo code về máy
git clone https://github.com/giantswarm/mcp-prometheus.git
cd mcp-prometheus

# Build ra file chạy
go build -o mcp-prometheus

🎉 Xong! Lúc này bạn sẽ có một file binary tên là mcp-prometheus nằm ngay trong thư mục bạn vừa build.

💡 Lưu ý: Nhớ kỹ đường dẫn này nhé, ví dụ: /Users/you/path/mcp-prometheus/mcp-prometheus. Tí nữa chúng ta sẽ cần dùng đến nó.

---

⚙️ Bước 3: Cấu hình cho Claude "hiểu chuyện"
Giờ là lúc giới thiệu người bạn mới cho Claude. Bạn hãy mở (hoặc tạo) file cấu hình của Claude Desktop tại Settings → Developer → “Edit Config” mở file config của Claude Desktop

Paste đoạn cấu hình sau vào (nhớ thay đổi thông tin của bạn nhé):

JSON
{
     "mcpServers": {
         "mcp-prometheus": {
                  "command": "/Users/you/path/mcp-prometheus/mcp-prometheus",
                  "args": ["serve"],
                  "env": {
                        "PROMETHEUS_URL": "http://10.215.27.90:9090",
                        "PROMETHEUS_USERNAME": "your_user",
                        "PROMETHEUS_PASSWORD": "your_password"
                   }
            }
       }
}

⚠️ 3 Điều khắc cốt ghi tâm ở bước này:

1. Dùng đường dẫn tuyệt đối cho phần command (đường dẫn đầy đủ từ /Users/...).
2. Đừng quên args: Phải có dòng "args": ["serve"] để server chạy đúng chuẩn stdio.
3. Thông tin đăng nhập: Điền đúng URL, user và pass của Prometheus nhà bạn.

---

🔄 Bước 4: Khởi động lại & Kiểm tra
Tắt Claude Desktop đi và mở lại để nạp "nội công" mới.

Sau khi mở lại, bạn vào menu Settings, check tab Developer/Installed MCP Servers. Nếu thấy cái đèn xanh Running cạnh mcp-prometheus là ngon rồi đấy!

---

💬 Bước 5: Chat thử thôi!
Giờ là lúc tận hưởng thành quả. Hãy thử nhờ Claude làm vài việc của DevOps xem sao:

• 🗣️ "Chạy truy vấn PromQL up và trả kết quả cho tôi."
• 🗣️ "Cho biết số lượng series up trong 5 phút gần nhất xem nào."

Nếu mọi thứ OK, Claude sẽ kết nối thẳng vào Prometheus và trả về dữ liệu cho bạn ngay lập tức. Phê chưa! 😎

---

🚑 Bước 6: Troubleshooting (Khi đời không như mơ)
Nếu Claude "dỗi" hoặc báo lỗi đỏ lòm, đừng hoảng, check ngay mấy thứ này:

• ❌ Lỗi ENOENT / spawn ...: Chắc chắn là sai đường dẫn file binary rồi. Check lại đường dẫn tuyệt đối ở Bước 3.
• ❌ Lỗi JSON: "Unexpected token...": Đảm bảo bạn đã thêm args: ["serve"]. Đừng để chương trình in log linh tinh ra màn hình (phiên bản mới đã fix vụ này rồi, yên tâm).
• ❌ Không kết nối được: Kiểm tra VPN, mạng mẽo xem máy bạn có ping được tới Prometheus không.
• ❌ Log ở đâu? Muốn xem Claude đang "khóc" vì cái gì, mở terminal gõ:
  
  Bash
  tail -f ~/Library/Logs/Claude/mcp-server-mcp-prometheus.log

---

🔒 Bước 7: Bảo mật (An toàn là bạn)

• Đừng commit file config: File json kia chứa password đấy, đừng lỡ tay push lên Git nhé.
• Dùng Token: Nếu Prometheus hỗ trợ, hãy dùng biến môi trường PROMETHEUS_TOKEN thay vì user/pass cho an toàn hơn.

Tham khảo: https://lobehub.com/vi-VN/mcp/giantswarm-mcp-prometheus?activeTab=deployment