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

# ClickUp

> Kết nối ClickUp với CloudThinker qua OAuth để khám phá workspace, phân loại task, xem xét workload và thay đổi task có phê duyệt

Kết nối ClickUp để [Anna](/vi/guide/agents/anna) khám phá cấu trúc workspace, phân loại công việc, xem xét workload và điều tra task, comment, document cùng chat. ClickUp sử dụng **OAuth** qua MCP server do ClickUp host, vì vậy bạn không cần dán API token vào CloudThinker.

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

* Một **tài khoản ClickUp** có quyền truy cập workspace bạn muốn CloudThinker sử dụng.
* Quyền ủy quyền CloudThinker qua luồng OAuth của ClickUp.
* Một workspace CloudThinker chưa kết nối ClickUp.

<Info>
  Chỉ ủy quyền đúng một ClickUp workspace. Các công cụ ClickUp không thể chuyển workspace sau khi ủy quyền, và kết nối được cấp quyền cho nhiều workspace không thể hoàn tất yêu cầu.
</Info>

## Thiết lập

<Steps>
  <Step title="Mở danh mục kết nối">
    Trong workspace CloudThinker, vào **Settings → Connections**, chọn **Builtin Connections**, rồi chọn **ClickUp**.
  </Step>

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

  <Step title="Ủy quyền một workspace">
    Đăng nhập bằng tài khoản ClickUp có quyền truy cập công việc của bạn, chọn đúng một ClickUp workspace, rồi phê duyệt quyền truy cập.
  </Step>

  <Step title="Quay lại CloudThinker">
    CloudThinker lưu quyền OAuth và kết nối hiển thị trạng thái **Connected**.
  </Step>
</Steps>

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

ClickUp sử dụng OAuth, vì vậy không có trường thông tin xác thực nào cần nhập thủ công.

| Trường                | Mô tả                                                                           |
| --------------------- | ------------------------------------------------------------------------------- |
| **Quyền OAuth**       | Do ClickUp cấp và được lưu tự động sau khi bạn phê duyệt quyền truy cập         |
| **ClickUp workspace** | Workspace duy nhất được chọn trong quá trình ủy quyền                           |
| **MCP endpoint**      | Server do ClickUp host tại `mcp.clickup.com/mcp`; cố định và không thể cấu hình |

## Quyền bắt buộc

CloudThinker kế thừa quyền truy cập ClickUp của người dùng thực hiện ủy quyền.

* **Thao tác đọc** bao gồm cấu trúc workspace, task, comment, custom field, workload, time entry, document và chat channel mà người dùng có thể xem.
* **Thao tác ghi** bao gồm task, comment, tag và document page. Các thao tác này cần quyền ClickUp tương ứng **và** [phê duyệt](/vi/guide/approval) rõ ràng trong CloudThinker.

<Tip>
  Ủy quyền bằng người dùng ClickUp chỉ có quyền truy cập các space và list CloudThinker cần. CloudThinker không thể đọc hoặc thay đổi tài nguyên người dùng đó không thể truy cập.
</Tip>

## Khả năng của agent

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

| Khả năng                     | Mô tả                                                                                                               |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Khám phá workspace**       | Liệt kê space, folder, list và công việc gần đây                                                                    |
| **Phân loại task**           | Tìm task quá hạn, chưa được giao và chưa được lên lịch trong một list                                               |
| **Xem xét workload**         | So sánh công việc đang mở theo người được giao và status, sau đó đo thời gian ở status khi ClickUp cung cấp dữ liệu |
| **Điều tra task**            | Đọc chi tiết task, custom field, comment và thảo luận theo thread                                                   |
| **Document và chat**         | Đọc document page và chat message mà người dùng đã kết nối có thể truy cập                                          |
| **Thay đổi task**            | Tạo, cập nhật, di chuyển hoặc xóa task sau khi được phê duyệt                                                       |
| **Comment, tag và document** | Thêm comment, thay đổi tag hoặc cập nhật document page sau khi được phê duyệt                                       |

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

```text theme={null}
@anna #report show the ClickUp workspace structure and summarize what needs attention in Project 1
```

### Ví dụ prompt

```text theme={null}
@anna #report list overdue, unassigned, and unscheduled ClickUp tasks in Project 1
@anna #report compare open ClickUp work by assignee and status age in Team Space
@anna #recommend review the comments on the oldest overdue ClickUp task and suggest the next action
```

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

<Accordion title="Luồng OAuth không hoàn tất">
  Trình duyệt có thể đang đăng nhập sai tài khoản ClickUp. Đăng nhập bằng tài khoản có quyền truy cập workspace cần dùng, rồi bắt đầu lại **Connect**.
</Accordion>

<Accordion title="Agent báo có nhiều workspace">
  Kết nối đã được ủy quyền cho nhiều ClickUp workspace. Ngắt kết nối ClickUp, kết nối lại và chọn đúng một workspace trong quá trình ủy quyền.
</Accordion>

<Accordion title="Kết nối trả về 401 Unauthorized">
  ClickUp access token không hợp lệ hoặc đã hết hạn. ClickUp có thể không cấp refresh token cho kết nối này, vì vậy hãy ngắt kết nối và ủy quyền ClickUp lại.
</Accordion>

<Accordion title="Agent không tìm thấy space, list hoặc task">
  Người dùng thực hiện ủy quyền có thể không có quyền truy cập, hoặc tài nguyên đã được di chuyển. Xác nhận quyền ClickUp của người dùng, rồi yêu cầu agent khám phá lại workspace.
</Accordion>

<Accordion title="Không có dữ liệu thời gian ở status">
  Bật ClickApp **Total time in Status** trong cài đặt ClickUp workspace. Việc đọc task và workload vẫn hoạt động khi phép đo này bị tắt.
</Accordion>

<Accordion title="Yêu cầu trả về lỗi rate limit">
  Tài khoản ClickUp đã đạt giới hạn của nhà cung cấp. Chờ cửa sổ rate limit của ClickUp đặt lại, rồi thử lại với cùng phạm vi.
</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.

- **Dùng một workspace giới hạn**: chỉ ủy quyền ClickUp workspace mà CloudThinker cần truy cập.
- **Dùng quyền tối thiểu**: kết nối người dùng ClickUp có space và list khớp với công việc CloudThinker cần xem và thay đổi.

## Liên quan

<CardGroup cols={2}>
  <Card title="Phê duyệt" icon="shield-check" href="/vi/guide/approval">
    Xem cách CloudThinker kiểm soát thay đổi trong ClickUp
  </Card>

  <Card title="Anna Agent" icon="users" href="/vi/guide/agents/anna">
    Điều phối công việc dự án và vận hành trên nhiều dịch vụ
  </Card>
</CardGroup>