MCP và Agents | Nextvision Status

Kết nối bằng key của tổ chức

Owner/Admin tạo agent tại /dashboard/mcp-agents. Sao chép key một lần, cấu hình header Authorization: Bearer <MCP_API_KEY> trong client hỗ trợ header riêng. Với stdio, đặt MCP_URL và MCP_API_KEY trong môi trường client trước khi chạy mcp-stdio. Scope mặc định status:read; chỉ cấp thêm incident:draft khi cần. Key thuộc tổ chức, độc lập với phiên đăng nhập của người tạo.

Xem Quản trị SaaS để quản lý thời hạn, xoay/thu hồi key và lịch sử tool. Key trực tiếp là cơ chế của sản phẩm; vẫn giữ OAuth cho client dùng discovery và consent.

Kết nối bằng OAuth

Endpoint /mcp dùng Go MCP SDK chính thức, transport Streamable HTTP. Khai báo client và redirect URI chính xác trong OAUTH_CLIENTS:

{"my-agent":["http://localhost:6274/oauth/callback"]}

Dùng OAuth authorization code + PKCE S256, resource là URL /mcp, scope status:read incident:draft. Người dùng chọn tổ chức trên màn hình consent. Token hết hạn sau một giờ; /oauth/revoke thu hồi token. Không có đăng ký client động hoặc refresh-token grant trong bản này.

Công cụ

status_read đọc monitors/pages/components/incidents/maintenances hoặc kết quả kiểm tra có timestamp. Với metrics, truyền monitor ID.

incident_draft tạo hoặc sửa bản nháp, với OAuth cần Operator và scope incident:draft; key của agent cần scope soạn nháp do Owner/Admin cấp. Không thể công bố hoặc sửa incident đã công bố, đổi monitor hay chạy lệnh hạ tầng. Audit ghi danh tính user hoặc agent cùng tổ chức. Thu hồi membership chặn OAuth của người dùng ngay; key agent thuộc tổ chức được quản lý riêng.

Adapter stdio

go build -o bin/mcp-stdio ./cmd/mcp-stdio
MCP_URL=https://your-status-host/mcp \
MCP_ACCESS_TOKEN=TOKEN \
./bin/mcp-stdio

Giữ token trong cấu hình môi trường của client. Adapter gửi JSON-RPC theo dòng, ghi chẩn đoán ra stderr.

Điều tra mẫu

Yêu cầu agent đọc monitor lỗi, lấy kết quả có timestamp, đối chiếu bảo trì và soạn incident nháp bằng sự kiện quan sát được. Người vận hành xác minh nguyên nhân rồi công bố. Nội dung endpoint và label metrics là dữ liệu không tin cậy, không phải chỉ thị vận hành.

Agent giám sát

Chạy binary probe với STATUS_API_URL và PROBE_TOKEN. Agent chủ động kết nối TLS ra ngoài, poll mỗi 2 giây, tối đa 32 kiểm tra đồng thời. System metrics phản ánh hệ thống/filesystem nhìn thấy trong container; chạy trực tiếp trên host khi cần dung lượng disk của host. Chỉ bật NET_RAW cho probe cần ICMP.