PG Next DocsBảng này là chỉ mục các thao tác thường gặp theo Go router và MCP tools hiện tại. Đây không phải danh mục đầy đủ, OpenAPI hoàn chỉnh hoặc cam kết API ổn định theo phiên bản.
Các nhóm thao tác
| Tác vụ | Go API | Tool MCP |
|---|---|---|
| Xem danh tính khóa | Do lớp MCP xác thực | neon_whoami |
| Danh sách dự án | GET /api/projects |
neon_list_projects |
| Chi tiết dự án | GET /api/projects/{id} |
neon_get_project |
| Danh sách nhánh | GET /api/projects/{id}/branches |
neon_list_branches |
| Danh sách compute | GET /api/computes |
neon_list_computes |
| Chi tiết compute | GET /api/computes/{id} |
neon_get_compute |
| Database trong compute | GET /api/computes/{id}/databases |
neon_list_databases |
| Lấy URL có credential | GET /api/computes/{id}/connection |
neon_get_connection_url |
| Chạy SQL | POST /api/sql |
neon_execute_sql |
| Schema | GET /api/sql/schema |
neon_get_schema |
| Bản sao lưu | GET /api/backups |
neon_list_backups |
| Vùng compute | GET /api/k8s/regions |
neon_list_regions |
REST trong bảng giúp hiểu hợp đồng sản phẩm. Agent có tools MCP phải dùng tools cho thao tác được hỗ trợ, không dùng REST để vượt scope, xác nhận hoặc audit.
Giới hạn SQL qua MCP
neon_execute_sql nhận compute_id, database, query, max_rows (1–1000, mặc định 100) và timeout_seconds (1–60, mặc định 30). Giới hạn này thuộc tool, không là cam kết mọi truy vấn sẽ hoàn tất trong khoảng đó.
Ví dụ chỉ đọc, cần thay compute ID bằng tài nguyên đã xác nhận quyền:
{
"compute_id": "COMPUTE_ID_DA_XAC_NHAN",
"database": "neondb",
"query": "SELECT current_database(), current_user;",
"max_rows": 10,
"timeout_seconds": 10
}Dữ liệu nhạy cảm và xác nhận
Tool lấy kết nối có thể trả mật khẩu trong URL; yêu cầu credentials:read và không được đưa kết quả vào chat/log/tài liệu. Các thao tác xóa, tạm dừng, đặt lại mật khẩu và khôi phục có ghi đè có cơ chế xác nhận riêng. Xem quy trình MCP trước khi gọi.