---
title: "MCP và Agents"
description: "Nextvision Status — MCP và Agents"
---

> Documentation Index
> Fetch the complete documentation index at: https://status.nextvisions.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP và Agents

## 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](/docs/vi/saas-administration/) để 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`:

```json
{"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

```sh
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.

Source: https://status.nextvisions.ai/docs/vi/mcp/index.mdx