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

# monday.com

> Kết nối monday.com với CloudThinker để xem xét board, phân tích công việc đình trệ, báo cáo sprint và cập nhật item qua phê duyệt

Kết nối tài khoản monday.com của bạn để các agent CloudThinker xem xét board, tìm công việc đã ngừng tiến triển, đọc thảo luận trên item và cập nhật item sau khi bạn phê duyệt.

monday.com sử dụng **OAuth** qua MCP server do monday.com host, vì vậy bạn không cần tạo API token 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 monday.com** có thể xem các board bạn muốn CloudThinker đọc.
* Quyền ủy quyền CloudThinker qua luồng OAuth của monday.com.
* Một workspace CloudThinker chưa kết nối monday.com.

<Info>
  Agent chỉ thấy đúng những gì tài khoản ủy quyền thấy. Board mà tài khoản đó không mở được sẽ không hiển thị với CloudThinker.
</Info>

***

## Thiết lập

<Steps>
  <Step title="Mở CloudThinker">
    Điều hướng đến **Connections → monday.com** 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 monday.com.
  </Step>

  <Step title="Ủy quyền CloudThinker">
    Đăng nhập vào tài khoản monday.com có quyền truy cập các board bạn muốn 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

monday.com 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ữ token sau khi luồng ủy quyền hoàn tất.

| Trường           | Mô tả                                                            |
| ---------------- | ---------------------------------------------------------------- |
| **OAuth tokens** | Được monday.com 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 monday.com được cấp trong quá trình OAuth.

* **Thao tác đọc** bao gồm các workspace, board, item, update, doc, người dùng, nhóm, automation và sprint mà tài khoản ủy quyền đã mở được.
* **Thao tác ghi** — tạo item, thay đổi giá trị cột của item và đăng update — yêu cầu quyền monday.com tương ứng **và** [phê duyệt](/vi/guide/approval) rõ ràng trong CloudThinker.

<Tip>
  Hãy ủy quyền bằng tài khoản chỉ có quyền trên các board CloudThinker cần. MCP server của monday.com không cung cấp công cụ xóa hay lưu trữ, nên mọi thứ agent tạo ra phải được xóa trực tiếp trong monday.com.
</Tip>

***

## 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á tài khoản** | Liệt kê workspace, board, người dùng, nhóm và trả về board id mà các yêu cầu khác cần          |
| **Xem xét board**      | Tóm tắt group và cột của board, cùng cách công việc phân bổ theo trạng thái và người phụ trách |
| **Công việc đình trệ** | Tìm item không thay đổi trong một khoảng thời gian, sắp xếp cũ nhất trước                      |
| **Ngữ cảnh item**      | Đọc update của item, hoạt động của board và monday doc trước khi hành động                     |
| **Báo cáo sprint**     | Đọc board sprint của monday dev, metadata sprint và tóm tắt sprint                             |
| **Ghi lên item**       | Tạo item, thay đổi giá trị cột hoặc đăng update — mỗi thao tác sau khi được phê duyệt rõ ràng  |

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

```text theme={null}
@alex list my monday.com workspaces and boards
```

### Ví dụ prompt

```text theme={null}
@alex review the Tasks board on monday.com and #report how work splits by status and owner
@alex find monday.com items that have not moved in 14 days and #recommend what to chase first
@alex read the updates on the checkout bug item and summarize what is blocking it
```

***

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

<Accordion title="Luồng OAuth không hoàn tất">
  Trình duyệt của bạn có thể đang đăng nhập vào một tài khoản monday.com khác. Hãy đăng nhập vào đúng tài khoản và thử lại luồng kết nối trong CloudThinker.
</Accordion>

<Accordion title="Agent báo board rỗng">
  monday.com trả về bản ghi rỗng thay vì báo lỗi khi board id không tồn tại, đã bị xóa hoặc không nhìn thấy được. Hãy yêu cầu agent liệt kê workspace và board trước, rồi chọn board từ danh sách đó.
</Accordion>

<Accordion title="Agent không tìm thấy board mà bạn thấy được">
  Luồng OAuth có thể đã chạy với tài khoản không có quyền truy cập board đó. Hãy kết nối lại bằng tài khoản mở được board. Board vừa truy cập gần đây không phải là toàn bộ danh sách — board thuộc về một workspace, và agent phải đọc workspace mới liệt kê được.
</Accordion>

<Accordion title="Tóm tắt sprint không khả dụng">
  Tóm tắt sprint cần board monday dev có cột sprint summary. Board không có cột này sẽ không trả về tóm tắt, nên hãy yêu cầu metadata sprint hoặc xem xét board thay thế.
</Accordion>

<Accordion title="Agent dừng lại trước khi thay đổi item">
  Thao tác ghi lên item được kiểm soát bằng phê duyệt. Hãy phê duyệt hành động đang chờ trong CloudThinker, hoặc kiểm tra xem tài khoản monday.com ủy quyền có quyền ghi trên board đó không.
</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ữ việc tạo item, thay đổi cột và đăng update ở chế độ cần phê duyệt trong CloudThinker.
- **Không có đường hoàn tác** — monday.com không cung cấp công cụ xóa hay lưu trữ, nên hãy xóa trực tiếp trong monday.com những gì agent đã tạo.

***

## Liên quan

<CardGroup cols={2}>
  <Card title="Kết nối Atlassian" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/atlassian.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=64fcf0381646a233832602a9086a14eb" href="/vi/guide/connections/atlassian" width="24" height="24" data-path="images/icons/atlassian.svg">
    Theo dõi issue Jira và Confluence và kiến thức cơ sở
  </Card>

  <Card title="Phê duyệt" icon="shield-check" href="/vi/guide/approval">
    Cách thức hoạt động của các hành động được kiểm soát phê duyệt
  </Card>
</CardGroup>