---
title: "Dùng PG Next với MCP"
description: "Kết nối trợ lý AI qua Streamable HTTP và kiểm tra quyền trước khi thao tác."
---

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

# Dùng PG Next với MCP

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ị

1. Tạo [khóa dành cho MCP](/vi/tich-hop/khoa-mcp/) với scope và quyền tối thiểu.
2. 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.
3. 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:

```json
{
  "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](/vi/tich-hop/quyen-truy-cap/) và [tra cứu API/tools](/vi/tham-chieu/api/).

Source: https://docs.pgnext.dev/vi/tich-hop/mcp/index.mdx