---
title: "API và công cụ MCP"
description: "Tra một số endpoint và tool tương ứng; đây không phải toàn bộ hợp đồng API."
---

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

# API và công cụ MCP

Bả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:

```json
{
  "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](/vi/tich-hop/mcp/) trước khi gọi.

Source: https://docs.pgnext.dev/vi/tham-chieu/api/index.mdx