Dùng PG Next với MCP

Kết nối trợ lý AI qua Streamable HTTP và kiểm tra quyền trước khi thao tác.

PG Next cung cấp MCP tại https://mcp.pgnext.dev/mcp qua Streamable HTTP. Domain console và endpoint MCP là hai địa chỉ khác nhau. Một endpoint khỏe không có nghĩa client đã tải được tools.

Chuẩn bị

Tạo khóa dành cho MCP với scope và quyền tối thiểu.
Thêm server HTTP trong client có hỗ trợ MCP, endpoint như trên và header Authorization: Bearer <khóa của bạn> qua cơ chế secret của client.
Không đặt khóa thật trong repository, prompt hoặc tài liệu. Nạp lại client/session nếu tools chưa xuất hiện.

Ví dụ cấu hình cho client tương thích cấu trúc JSON dưới đây; client khác có thể cần định dạng khác. Thay giá trị minh họa bằng cơ chế secret của client, không lưu literal này làm cấu hình dùng thật:

{
  "mcpServers": {
    "neon": {
      "type": "http",
      "url": "https://mcp.pgnext.dev/mcp",
      "headers": { "Authorization": "Bearer MCP_KEY_FROM_CLIENT_SECRET" }
    }
  }
}

Bắt đầu mọi phiên thao tác

Gọi neon_whoami, rồi neon_list_projects. Kiểm tra chủ khóa, scope, project và quyền hiệu lực trước khi đọc hay đổi tài nguyên. Nếu runtime không có tools neon, dừng phần thao tác; không lấy credential khác để gọi REST, SQL hoặc Kubernetes thay thế.

Thử một yêu cầu chỉ đọc như liệt kê nhánh của dự án đã xác nhận. Không cần tạo hay xóa tài nguyên chỉ để kiểm tra kết nối client.

Xác nhận thao tác có tác động

CONFIRMATION_REQUIRED chuẩn bị token dùng một lần, không phải người dùng đã cho phép. Đọc tác động, đối chiếu đúng mục tiêu và chỉ gọi lại đúng yêu cầu cũ kèm token khi người dùng đã cho phép thay đổi đó. Token hết hạn, đã dùng hoặc không khớp yêu cầu sẽ bị từ chối.

SQL ghi/DDL/nhiều câu lệnh hoặc câu không phân loại chắc chắn cần xác nhận. Xem quyền truy cập và tra cứu API/tools.