Pulsetic MCP Server

Pulsetic MCP Server

Kết nối trợ lý AI với nền tảng giám sát Pulsetic của bạn bằng Model Context Protocol (MCP).

---

MCP là gì?

Model Context Protocol là một tiêu chuẩn mở cho phép trợ lý AI tương tác với các công cụ và dịch vụ bên ngoài. Với máy chủ MCP của Pulsetic, bạn có thể yêu cầu trợ lý AI kiểm tra trạng thái giám sát, tạo sự cố, lên lịch bảo trì và hơn thế nữa — tất cả thông qua hội thoại tự nhiên.

Các ứng dụng khách được hỗ trợ:

• Claude Desktop — Ứng dụng máy tính để bàn của Anthropic
• Claude Code — CLI dành cho nhà phát triển của Anthropic
• ChatGPT — Trợ lý AI của OpenAI (qua OAuth)
• Cursor — Trình soạn thảo mã nguồn hỗ trợ AI
• Windsurf — IDE hỗ trợ AI
• Bất kỳ ứng dụng khách nào triển khai đặc tả MCP

---

Điều kiện tiên quyết

• Tài khoản Pulsetic thuộc gói có quyền truy cập API (Business hoặc Enterprise).
• Khóa API Pulsetic — tạo từ Cài đặt → API trong bảng điều khiển của bạn.
• Một ứng dụng khách AI tương thích MCP.

---

Thiết lập

Claude Desktop

Claude Desktop sử dụng máy chủ MCP dựa trên stdio. Sử dụng mcp-remote để kết nối đến điểm cuối HTTP từ xa. Mở Cài đặt → Nhà phát triển → Chỉnh sửa cấu hình và thêm:

{
  "mcpServers": {
    "pulsetic": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://api.pulsetic.com/mcp",
        "--header", "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Thay thế YOUR_API_KEY bằng khóa API thực tế của bạn. Khởi động lại Claude Desktop để áp dụng.

Claude Code

Thêm máy chủ vào tệp .mcp.json của dự án:

{
  "mcpServers": {
    "pulsetic": {
      "type": "streamableHttp",
      "url": "https://api.pulsetic.com/mcp",
      "headers": {
        "Authorization": "YOUR_API_KEY"
      }
    }
  }
}

Cursor

Mở Cài đặt → Máy chủ MCP → Thêm máy chủ và cấu hình:

• Loại: streamableHttp
• URL: https://api.pulsetic.com/mcp
• Tiêu đề: Authorization: YOUR_API_KEY

ChatGPT

ChatGPT có hỗ trợ MCP gốc thông qua Chế độ nhà phát triển. Nó sử dụng OAuth để xác thực với Pulsetic.

Bước 1. Bật Chế độ nhà phát triển trong ChatGPT: vào Ứng dụng đã bật → Cài đặt nâng cao → Chế độ nhà phát triển và bật nó lên. Tính năng này khả dụng cho người dùng ChatGPT Pro, Plus, Team, Business, Enterprise và Edu.

Bước 2. Tạo ứng dụng mới: vào Ứng dụng đã bật → Tạo ứng dụng.

Bước 3. Điền thông tin chi tiết ứng dụng:

Trường	Giá trị
Tên	Pulsetic MCP (hoặc bất kỳ tên nào bạn thích)
Mô tả	Uptime monitoring (tùy chọn)
URL máy chủ MCP	https://api.pulsetic.com/mcp
Xác thực	OAuth

Bước 4. Các điểm cuối OAuth sẽ được tự động phát hiện từ máy chủ. Bạn có thể xác minh chúng trong Cài đặt nâng cao:

Trường	Giá trị
URL xác thực	https://api.pulsetic.com/mcp/oauth/authorize
URL mã thông báo	https://api.pulsetic.com/mcp/oauth/token
URL đăng ký	https://api.pulsetic.com/mcp/oauth/register

Bước 5. Chọn "Tôi hiểu và muốn tiếp tục" và nhấp Tạo.

Bước 6. Hoàn tất quy trình đăng nhập OAuth. Bạn sẽ được chuyển hướng đến trang ủy quyền Pulsetic, nơi bạn nhập email tài khoản và mã thông báo API.

Email phải khớp với mã thông báo API của bạn. Trên trang ủy quyền, email bạn nhập phải khớp với chủ sở hữu của mã thông báo API bạn cung cấp.

Giữ khóa API của bạn ở chế độ riêng tư. Khóa API của bạn có toàn quyền truy cập vào tài khoản Pulsetic. Không bao giờ commit nó vào hệ thống kiểm soát phiên bản hoặc chia sẻ công khai.

---

Công cụ khả dụng

Máy chủ MCP cung cấp 17 công cụ được tổ chức thành bốn danh mục.

Trình giám sát

Công cụ	Mô tả
list_monitors	Liệt kê tất cả trình giám sát với trạng thái, thời gian hoạt động và thời gian phản hồi.
get_monitor	Nhận thông tin chi tiết về một trình giám sát cụ thể.
get_monitor_stats	% thời gian hoạt động, thời gian ngừng hoạt động và thời gian phản hồi trong 1 ngày/7 ngày/30 ngày/90 ngày.
get_monitor_events	Sự kiện trực tuyến/ngoại tuyến trong một khoảng thời gian.
get_monitor_downtime	Tổng thời gian ngừng hoạt động tính bằng giây trong một khoảng thời gian nhất định.
create_monitor	Tạo trình giám sát HTTP, TCP hoặc ICMP mới.
update_monitor	Cập nhật tên, URL, tần suất hoặc cài đặt của trình giám sát.
delete_monitor	Xóa vĩnh viễn một trình giám sát.
pause_monitor	Tạm dừng giám sát (dừng kiểm tra).
resume_monitor	Tiếp tục một trình giám sát đã tạm dừng.

Trang trạng thái

Công cụ	Mô tả
list_status_pages	Liệt kê tất cả các trang trạng thái với tiêu đề, slug và tên miền.

Sự cố

Công cụ	Mô tả
list_incidents	Liệt kê các sự cố cho một trang trạng thái.
create_incident	Tạo sự cố mới với cập nhật trạng thái ban đầu.
update_incident	Đăng cập nhật trạng thái cho một sự cố hiện có.
resolve_incident	Đánh dấu sự cố đã được giải quyết.

Bảo trì

Công cụ	Mô tả
create_maintenance	Lên lịch một cửa sổ bảo trì trên trang trạng thái.
delete_maintenance	Xóa một cửa sổ bảo trì đã lên lịch.

---

Ví dụ sử dụng

Sau khi được cấu hình, bạn có thể tương tác với Pulsetic thông qua ngôn ngữ tự nhiên.

Kiểm tra trình giám sát của bạn

"Show me all my monitors and their current status."

"What's the uptime for my production API monitor over the last 30 days?"

"Are any of my monitors currently down?"

"Show me the downtime events for monitor 42 in the past week."

Quản lý trình giám sát

"Create a new monitor for https://api.example.com that checks every 30 seconds."

"Pause the staging monitor while we do the migration."

"Resume all paused monitors."

"Change the check frequency of monitor 15 to 60 seconds."

"Delete the old marketing-site monitor."

Xử lý sự cố

"Create an incident on our main status page: 'Elevated API latency'
 with status investigating and message 'We're looking into slow response times.'"

"Update the API latency incident to identified: 'Root cause is a database
 connection pool issue. Working on a fix.'"

"Resolve incident 8 with message 'Connection pool limits increased.
 Response times back to normal.'"

Lên lịch bảo trì

"Schedule a maintenance window on status page 1 called 'Database upgrade'
 starting 2025-03-20 at 2am UTC and ending at 4am UTC."

"Delete the maintenance window we scheduled for next week."

---

Kiểm thử với cURL

Bạn có thể kiểm tra trực tiếp điểm cuối MCP bằng cURL để xác minh khóa API của bạn hoạt động.

Khởi tạo

curl -X POST https://api.pulsetic.com/mcp \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": {"name": "curl", "version": "1.0"}
    }
  }'

Liệt kê công cụ

curl -X POST https://api.pulsetic.com/mcp \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

Gọi một công cụ

curl -X POST https://api.pulsetic.com/mcp \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "list_monitors",
      "arguments": {}
    }
  }'

---

Tham khảo công cụ

list_monitors

Trả về tất cả trình giám sát cho tài khoản của bạn.

Không có tham số.

---

get_monitor

Trả về chi tiết đầy đủ cho một trình giám sát, bao gồm thông tin chứng chỉ SSL.

Tham số	Loại	Bắt buộc	Mô tả
monitor_id	số nguyên	Có	ID của trình giám sát.

---

get_monitor_stats

Trả về % thời gian hoạt động, thời gian ngừng hoạt động, số lượng sự cố và thời gian phản hồi trung bình trong các khoảng thời gian 1 ngày, 7 ngày, 30 ngày và 90 ngày.

Tham số	Loại	Bắt buộc	Mô tả
monitor_id	số nguyên	Có	ID của trình giám sát.

---

get_monitor_events

Trả về các sự kiện trực tuyến/ngoại tuyến trong một khoảng thời gian (tối đa 100, mới nhất trước).

Tham số	Loại	Bắt buộc	Mô tả
monitor_id	số nguyên	Có	ID của trình giám sát.
from	chuỗi	Không	Ngày bắt đầu (YYYY-MM-DD). Mặc định: 7 ngày trước.
to	chuỗi	Không	Ngày kết thúc (YYYY-MM-DD). Mặc định: hôm nay.

---

get_monitor_downtime

Trả về tổng thời gian ngừng hoạt động tính bằng giây và số lượng sự cố trong một khoảng thời gian.

Tham số	Loại	Bắt buộc	Mô tả
monitor_id	số nguyên	Có	ID của trình giám sát.
days	số nguyên	Không	Số ngày để tra cứu ngược. Mặc định: 30.

---

create_monitor

Tạo một trình giám sát thời gian hoạt động mới.

Tham số	Loại	Bắt buộc	Mô tả
url	chuỗi	Có	URL hoặc tên máy chủ để giám sát.
name	chuỗi	Không	Tên hiển thị.
request_type	chuỗi	Không	http, tcp, hoặc icmp. Mặc định: http.
uptime_check_frequency	số nguyên	Không	Khoảng thời gian kiểm tra tính bằng giây. Mặc định: 60.
request_method	chuỗi	Không	Phương thức HTTP. Mặc định: GET.
request_timeout	số nguyên	Không	Thời gian chờ tính bằng giây. Mặc định: 30.
ssl_check	boolean	Không	Bật giám sát SSL.

---

update_monitor

Cập nhật cài đặt của một trình giám sát hiện có. Chỉ bao gồm các trường bạn muốn thay đổi.

Tham số	Loại	Bắt buộc	Mô tả
monitor_id	số nguyên	Có	ID của trình giám sát.
name	chuỗi	Không	Tên hiển thị mới.
url	chuỗi	Không	URL hoặc tên máy chủ mới.
uptime_check_frequency	số nguyên	Không	Khoảng thời gian kiểm tra mới tính bằng giây.
request_method	chuỗi	Không	Phương thức HTTP.
request_timeout	số nguyên	Không	Thời gian chờ tính bằng giây.
ssl_check	boolean	Không	Bật/tắt giám sát SSL.

---

delete_monitor

Xóa vĩnh viễn một trình giám sát và tất cả dữ liệu liên quan.

Tham số	Loại	Bắt buộc	Mô tả
monitor_id	số nguyên	Có	ID của trình giám sát.

---

pause_monitor

Tạm dừng một trình giám sát. Nó sẽ ngừng được kiểm tra cho đến khi được tiếp tục.

Tham số	Loại	Bắt buộc	Mô tả
monitor_id	số nguyên	Có	ID của trình giám sát.

---

resume_monitor

Tiếp tục một trình giám sát đã tạm dừng.

Tham số	Loại	Bắt buộc	Mô tả
monitor_id	số nguyên	Có	ID của trình giám sát.

---

list_status_pages

Trả về tất cả các trang trạng thái cho tài khoản của bạn.

Không có tham số.

---

list_incidents

Trả về các sự cố cho một trang trạng thái, bao gồm cập nhật mới nhất cho mỗi sự cố.

Tham số	Loại	Bắt buộc	Mô tả
status_page_id	số nguyên	Có	ID của trang trạng thái.

---

create_incident

Tạo một sự cố mới với cập nhật trạng thái ban đầu xuất hiện trên trang trạng thái.

Tham số	Loại	Bắt buộc	Mô tả
status_page_id	số nguyên	Có	ID của trang trạng thái.
title	chuỗi	Có	Tiêu đề sự cố.
status	chuỗi	Có	investigating, identified, monitoring, hoặc resolved.
message	chuỗi	Có	Thông điệp cập nhật ban đầu.

---

update_incident

Đăng cập nhật trạng thái mới cho một sự cố hiện có.

Tham số	Loại	Bắt buộc	Mô tả
incident_id	số nguyên	Có	ID của sự cố.
status	chuỗi	Có	investigating, identified, monitoring, hoặc resolved.
message	chuỗi	Có	Thông điệp cập nhật.
title	chuỗi	Không	Cập nhật tiêu đề sự cố.

---

resolve_incident

Đánh dấu sự cố đã được giải quyết với thông điệp giải quyết.

Tham số	Loại	Bắt buộc	Mô tả
incident_id	số nguyên	Có	ID của sự cố.
message	chuỗi	Có	Thông điệp giải quyết.

---

create_maintenance

Lên lịch một cửa sổ bảo trì trên trang trạng thái.

Tham số	Loại	Bắt buộc	Mô tả
status_page_id	số nguyên	Có	ID của trang trạng thái.
name	chuỗi	Có	Tiêu đề bảo trì.
description	chuỗi	Không	Mô tả về bảo trì.
start	chuỗi	Có	Thời gian bắt đầu theo định dạng ISO 8601.
end	chuỗi	Có	Thời gian kết thúc theo định dạng ISO 8601.
timezone	chuỗi	Không	Múi giờ (ví dụ: UTC, America/New_York). Mặc định: UTC.

---

delete_maintenance

Xóa một cửa sổ bảo trì đã lên lịch.

Tham số	Loại	Bắt buộc	Mô tả
maintenance_id	số nguyên	Có	ID của cửa sổ bảo trì.

---

Khắc phục sự cố

401 Unauthorized

• Xác minh khóa API của bạn chính xác và chưa hết hạn.
• Đảm bảo bạn đang truyền khóa trong tiêu đề Authorization (dưới dạng mã thông báo thô hoặc với tiền tố Bearer).
• Xác nhận tài khoản của bạn thuộc gói có quyền truy cập API được bật.

Ủy quyền OAuth thất bại (ChatGPT)

• Trên trang ủy quyền, email bạn nhập phải khớp với chủ sở hữu của mã thông báo API.
• Đảm bảo Chế độ nhà phát triển được bật trong cài đặt ChatGPT của bạn.
• Đảm bảo bạn có gói ChatGPT hỗ trợ Chế độ nhà phát triển (Pro, Plus, Team, Business, Enterprise hoặc Edu).

"Không tìm thấy trình giám sát hoặc truy cập bị từ chối"

• ID trình giám sát không tồn tại hoặc thuộc về một tài khoản khác.
• Sử dụng list_monitors để xem các ID trình giám sát khả dụng của bạn.

Công cụ không hiển thị trong ứng dụng khách AI của bạn

• Khởi động lại ứng dụng khách AI sau khi chỉnh sửa cấu hình MCP.
• Kiểm tra xem URL có chính xác là https://api.pulsetic.com/mcp không.
• Kiểm tra điểm cuối bằng cURL để xác minh kết nối.

Gặp lỗi giao thức

• Đảm bảo các yêu cầu sử dụng Content-Type: application/json.
• Trường jsonrpc phải chính xác là "2.0".
• Bao gồm trường id (số nguyên hoặc chuỗi) cho tất cả các yêu cầu ngoại trừ thông báo.

---

Tham khảo API

Máy chủ MCP triển khai đặc tả MCP (2025-03-26) sử dụng truyền tải HTTP có thể truyền phát qua một điểm cuối POST /mcp duy nhất với JSON-RPC 2.0.