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

# Neon

> Kết nối Neon Postgres với CloudThinker qua MCP hỗ trợ OAuth để khám phá dự án, kiểm tra schema và thực hiện các thao tác cơ sở dữ liệu

Kết nối tài khoản Neon của bạn để các agent CloudThinker có thể kiểm tra dự án Neon, xem xét schema cơ sở dữ liệu, phân tích slow query và hỗ trợ các thao tác cơ sở dữ liệu được phê duyệt qua MCP server do Neon host.

Neon sử dụng **OAuth**, vì vậy bạn không cần tạo Neon API key hay dán thông tin xác thực vào CloudThinker.

***

## Điều kiện tiên quyết

* Một **tài khoản Neon** có quyền truy cập vào các dự án bạn muốn CloudThinker kiểm tra.
* Quyền ủy quyền CloudThinker qua luồng OAuth của Neon.
* Một workspace CloudThinker chưa kết nối Neon.

<Info>
  CloudThinker hỗ trợ một kết nối Neon mỗi workspace. Để chuyển tài khoản, hãy xóa kết nối Neon hiện tại và kết nối lại.
</Info>

***

## Thiết lập

<Steps>
  <Step title="Mở CloudThinker">
    Điều hướng đến **Connections → Neon** trong workspace CloudThinker của bạn.
  </Step>

  <Step title="Bắt đầu luồng OAuth">
    Nhấn **Connect** để mở trang ủy quyền của Neon.
  </Step>

  <Step title="Ủy quyền CloudThinker">
    Đăng nhập vào tài khoản Neon sở hữu hoặc có quyền truy cập các dự án bạn muốn CloudThinker sử dụng, sau đó phê duyệt quyền truy cập.
  </Step>

  <Step title="Quay lại CloudThinker">
    Sau khi ủy quyền, CloudThinker lưu trữ OAuth token và hiển thị trạng thái **Connected**.
  </Step>
</Steps>

***

## Chi tiết kết nối

Neon sử dụng OAuth — không có trường kết nối nào cần nhập thủ công. CloudThinker tự động lưu trữ OAuth access token và refresh token sau khi luồng ủy quyền hoàn tất.

| Trường           | Mô tả                                                      |
| ---------------- | ---------------------------------------------------------- |
| **OAuth tokens** | Được Neon cấp phát và lưu tự động; không cần nhập thủ công |

***

## Quyền bắt buộc

CloudThinker kế thừa quyền truy cập Neon được cấp trong quá trình OAuth.

* **Thao tác đọc** bao gồm liệt kê dự án, kiểm tra schema, xem xét metadata và phân tích slow query.
* **Thao tác ghi** như thực thi SQL, thay đổi branch, migration, thay đổi Neon Auth và cấp phát Data API yêu cầu quyền truy cập Neon tương ứng **và** [phê duyệt](/vi/guide/approval) rõ ràng trong CloudThinker.

***

## Khả năng của agent

Sau khi kết nối, các agent có thể:

| Khả năng               | Mô tả                                                                   |
| ---------------------- | ----------------------------------------------------------------------- |
| **Khám phá dự án**     | Khám phá dự án Neon, dự án được chia sẻ, tổ chức, compute và bảng       |
| **Kiểm tra schema**    | Kiểm tra schema và metadata bảng                                        |
| **Phân tích truy vấn** | Xem xét slow query và đề xuất tối ưu                                    |
| **Thực thi SQL**       | Chạy SQL hoặc transaction chỉ sau khi được người dùng phê duyệt rõ ràng |
| **Quản lý branch**     | Quản lý branch, migration và Neon Auth — mỗi thao tác cần phê duyệt     |

### Xác minh kết nối

```text theme={null}
@tony list my Neon projects and summarize their schemas
```

### Ví dụ prompt

```text theme={null}
@tony review slow queries on the production-db project and #recommend optimizations
@tony inspect the schema for the users table in the main branch
@tony list all available tables and branches on the analytics project
```

***

## Khắc phục sự cố

<Accordion title="Luồng OAuth không hoàn tất">
  Bạn có thể đang đăng nhập vào sai tài khoản Neon, hoặc phiên trình duyệt chưa đăng nhập Neon. Hãy đăng nhập vào đúng tài khoản Neon và thử lại luồng kết nối Neon trong CloudThinker.
</Accordion>

<Accordion title="CloudThinker thông báo Neon đã được kết nối">
  Mỗi workspace chỉ cho phép một kết nối OAuth Neon. Hãy dùng kết nối Neon hiện có hoặc xóa nó trước khi kết nối lại.
</Accordion>

<Accordion title="Agent không tìm thấy dự án Neon dự kiến">
  Luồng OAuth có thể đã hoàn tất với tài khoản Neon không có quyền truy cập các dự án đó. Kết nối lại bằng tài khoản Neon sở hữu hoặc có quyền truy cập các dự án.
</Accordion>

***

## Bảo mật

* **Quyền tối thiểu** — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
* **Chỉ đọc theo mặc định** — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
* **Xoay vòng thông tin xác thực** — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
* **Thu hồi khi bàn giao** — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.

- **Phê duyệt cho thao tác ghi** — giữ SQL, branch, migration, Auth và thay đổi Data API yêu cầu phê duyệt trong CloudThinker
- **Kết nối lại cẩn thận** — xóa kết nối workspace hiện tại trước khi chuyển tài khoản Neon

***

## Liên quan

<CardGroup cols={2}>
  <Card title="Kết nối MCP" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/mcp.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=c89b6087a9d233901dea5e354452eff6" href="/vi/guide/connections/mcp" width="24" height="24" data-path="images/icons/mcp.svg">
    Kết nối công cụ và dịch vụ tùy chỉnh qua MCP
  </Card>

  <Card title="Tony Agent" icon="database" href="/vi/guide/agents/tony">
    Phân tích và tối ưu cơ sở dữ liệu
  </Card>
</CardGroup>