Trước khi có MCP, để sử dụng trợ lý AI với dữ liệu dự án của bạn, bạn phải sao chép bối cảnh vào cửa sổ trò chuyện lặp đi lặp lại. Bất kỳ tác vụ nào phức tạp hơn đều yêu cầu tích hợp API tùy chỉnh hoặc cấu hình riêng biệt cho từng mô hình.
MCP đã thay đổi điều đó. Đây là một tiêu chuẩn mở cho phép các ứng dụng AI kết nối với các hệ thống bên ngoài, lấy dữ liệu và thực hiện hành động. Chỉ cần thiết lập tích hợp một lần, và nó sẽ hoạt động trên bất kỳ mô hình hoặc ứng dụng nào hỗ trợ giao thức này.
Máy chủ ClickUp MCP cho phép giao thức này hoạt động trong Không gian Làm việc của bạn. Kết nối một ứng dụng khách được hỗ trợ, chẳng hạn như Claude, ChatGPT, Cursor hoặc VS Code, và cấp quyền truy cập. Từ đó, ứng dụng khách có thể đọc và thực hiện các công việc, tài liệu, bình luận, mục nhập thời gian và nhiều hơn nữa, tất cả thông qua các lời nhắc bằng ngôn ngữ tự nhiên.
Hướng dẫn này bao gồm các bước thiết lập, các công cụ có sẵn, các ứng dụng khách được hỗ trợ và các ví dụ thực tế mà bạn có thể áp dụng trong công việc hàng ngày.
Tổng quan về máy chủ ClickUp MCP
| Tổng quan | Những điều cần biết |
|---|---|
| Phù hợp nhất cho | Các quy trình làm việc được hỗ trợ bởi AI giúp đọc, thực thi và kết nối công việc trên toàn bộ Không gian Làm việc ClickUp của bạn |
| Điểm cuối chính thức | https://mcp.ClickUp.com/mcp |
| Xác thực | OAuth; không hỗ trợ khóa API và token truy cập cá nhân |
| Tương thích với | Claude, ChatGPT, Cursor, VS Code và các ứng dụng khách MCP khác được hỗ trợ |
| Có thể truy cập | Công việc, Tài liệu, bình luận, Trò chuyện, theo dõi thời gian, phân cấp Không gian Làm việc, báo cáo và nhiều tính năng khác |
| Sử dụng API ClickUp khi | Bạn cần logic xác định, webhook, tác vụ được lên lịch hoặc tích hợp với khối lượng lớn hơn |
| Đừng bỏ lỡ | Quyền truy cập Không gian Làm việc, giới hạn MCP chia sẻ và giới hạn tìm kiếm AI |
| Thiết lập nâng cao | ClickUp cũng có thể hoạt động như một client MCP. Kết nối các máy chủ MCP bên ngoài để Brain và Super Agents có thể sử dụng các công cụ bên ngoài Không gian Làm việc của bạn |
Máy chủ ClickUp MCP là gì?
Máy chủ MCP của ClickUp biến Không gian Làm việc của bạn thành một bộ công cụ mà bất kỳ ứng dụng AI tương thích nào cũng có thể gọi. Thay vì phải trích xuất dữ liệu từ màn hình hoặc xử lý qua mã API tùy chỉnh, ứng dụng sẽ có quyền truy cập có cấu trúc vào các công việc, tài liệu, bình luận, mục nhập thời gian và phân cấp, đồng thời có thể đọc, tạo hoặc cập nhật chúng trong một phiên duy nhất.
Có hai điều cần biết ngay từ đầu. Máy chủ này hoạt động trên mọi gói dịch vụ ClickUp, bao gồm cả gói Miễn phí vĩnh viễn. Và bất kỳ thao tác nào mà ứng dụng AI thực hiện thông qua MCP đều tuân thủ các quyền truy cập hiện có trong tài khoản của bạn.
MCP là một tiêu chuẩn mở, không phải là dự án của một nhà cung cấp duy nhất. Anthropic đã công bố mã nguồn mở cho giao thức này vào cuối năm 2024. Hiện nay, MCP được quản lý bởi Linux Foundation, với sự hỗ trợ từ OpenAI, Google, Microsoft, AWS và Block. Điều này rất quan trọng vì bất kỳ tích hợp nào bạn xây dựng trên MCP sẽ không bị gián đoạn khi bạn chuyển sang sử dụng các khách hàng AI khác.
Bạn có thể làm gì với máy chủ ClickUp MCP?
ClickUp MCP không chỉ đơn thuần là công cụ tìm kiếm công việc. Vì một ứng dụng AI có thể kết hợp nhiều công cụ trong một yêu cầu duy nhất, nên một lời nhắc duy nhất có thể kích hoạt một quy trình làm việc gồm nhiều bước.
Trên thực tế, nội dung này bao gồm:
- Quản lý công việc: Tạo, cập nhật, di chuyển và chỉnh sửa hàng loạt công việc; cài đặt Trường Tùy chỉnh; thêm thẻ, mối quan hệ phụ thuộc, người được giao, ưu tiên và ngày đáo hạn
- Tìm kiếm và báo cáo: Tìm kiếm trên các công việc, Danh sách công việc, Thư mục và Tài liệu, sau đó chuyển đổi thông tin đó thành các bản cập nhật trạng thái, ghi chú phát hành, tóm tắt danh mục đầu tư hoặc báo cáo thời gian ở từng trạng thái
- Làm việc với tài liệu và tệp tin: Tạo tài liệu và trang, đọc và cập nhật nội dung trang, cũng như thêm tệp đính kèm vào công việc
- Theo dõi thời gian: Bắt đầu và dừng đồng hồ bấm giờ, thêm các mục nhập thời gian đã ghi lại trước đó và truy xuất thời gian đã ghi lại cho các công việc
- Cộng tác: Đọc bình luận về công việc và các phản hồi theo chủ đề, đăng bình luận kèm đề cập, tìm các kênh trò chuyện và gửi tin nhắn
- Điều hướng trong Không gian Làm việc: Truy xuất các Không gian, Thư mục, Danh sách công việc, thành viên và người được giao nhiệm vụ, cũng như tạo hoặc cập nhật các phần trong cấu trúc phân cấp của Không gian Làm việc
Mẹo chuyên nghiệp: MCP sẽ trở nên hữu ích hơn khi bạn ngừng suy nghĩ theo hướng chỉ sử dụng các lệnh riêng lẻ từ từng công cụ. Hãy thiết kế kết quả mong muốn trước, sau đó để khách hàng AI tự động kết hợp các thao tác tìm kiếm, cập nhật và hành động cần thiết để đạt được mục tiêu đó. Hướng dẫn xây dựng agent này minh họa cách áp dụng tư duy đa bước này vào thực tế.
Những điều bạn cần chuẩn bị trước khi bắt đầu
Bạn cần bốn thứ, và không có thứ nào trong số đó yêu cầu bạn phải tạo tích hợp.
- Mọi kế hoạch ClickUp đều tương thích. ClickUp MCP có sẵn trên tất cả các kế hoạch, bao gồm cả Gói Miễn phí vĩnh viễn
- Một ứng dụng khách tương thích với MCP. ClickUp duy trì danh sách các ứng dụng khách MCP đã được kiểm duyệt, bao gồm Claude Desktop, Claude Code, ChatGPT, Cursor, VS Code, Windsurf, Devin, Microsoft Copilot Studio, Antigravity, Make và Workato
- URL máy chủ: https://mcp.clickup.com/mcp
- Tài khoản ClickUp mà bạn có thể ủy quyền thông qua OAuth. Khóa API và token truy cập cá nhân không được hỗ trợ
Bạn không cần phải là quản trị viên Không gian Làm việc ClickUp để kích hoạt MCP tùy chỉnh trước khi kết nối. Quyền truy cập của bạn tuân theo các quyền truy cập của tài khoản ClickUp mà bạn đã ủy quyền.
Ứng dụng AI của bạn có thể vẫn có các quyền quản trị viên riêng. Ví dụ, trong ChatGPT Business, chỉ quản trị viên và chủ sở hữu mới có thể bật chế độ nhà phát triển và xuất bản các ứng dụng MCP tùy chỉnh. Các không gian làm việc Enterprise và Edu cũng có thể cấp quyền truy cập nhà phát triển cho người dùng được lựa chọn thông qua các quyền kiểm soát dựa trên vai trò.
Cách cài đặt máy chủ ClickUp MCP (từng bước)
Để thiết lập máy chủ MCP của ClickUp, hãy thêm nó vào khách hàng của bạn, ủy quyền qua OAuth, xác nhận các công cụ đã được tải và thử nghiệm bằng một lời nhắc. Các bước thực hiện giống nhau trên các khách hàng, nhưng vị trí lưu trữ cài đặt MCP và cách thức công việc (qua giao diện người dùng, terminal hoặc tệp JSON) sẽ khác nhau tùy theo từng khách hàng. Chi tiết như sau:
Bước 1: Mở cài đặt của ứng dụng khách MCP
Mở cài đặt MCP hoặc cài đặt kết nối trong ứng dụng khách hàng của bạn. Cài đặt MCP cụ thể phụ thuộc vào khách hàng bạn đang sử dụng và, trong trường hợp của Claude, phụ thuộc vào kế hoạch dịch vụ bạn đang sử dụng.
Trong Claude Pro, nhóm hoặc doanh nghiệp, mở Cài đặt ở thanh bên, cuộn xuống Kết nối ở phía dưới và nhấp vào Thêm. Trên Claude Miễn phí, quá trình thiết lập được thực hiện thông qua ứng dụng Claude trên máy tính để bàn: mở ứng dụng, chuyển đến Cài đặt, sau đó Nhà phát triển, rồi Chỉnh sửa cấu hình. Thao tác này sẽ mở tệp claude_desktop_config.json, nơi bạn thêm mục nhập máy chủ ClickUp và khởi động lại ứng dụng.
Trong Claude Mã, thêm máy chủ từ terminal:
claude mcp add --transport http ClickUp https://mcp.ClickUp.com/mcp
Sau khi mở phiên làm việc, hãy chạy lệnh /mcp để hoàn thành luồng xác thực.
Trong ChatGPT, quá trình thiết lập không sử dụng tệp cấu hình hay trang cài đặt. Truy cập vào mục Ứng dụng, tìm kiếm ClickUp và lựa chọn nó. Nhấp vào Kết nối, sau đó nhấp vào Kết nối ClickUp, đăng nhập vào tài khoản ClickUp của bạn và lựa chọn các Không gian Làm việc mà bạn muốn sử dụng. Nhấp vào Kết nối Không gian Làm việc, sau đó nhấp vào Bắt đầu trò chuyện. Bạn có thể kết nối lại hoặc ngắt kết nối bất cứ lúc nào từ trang cài đặt của ứng dụng.
Trong Cursor, cách nhanh nhất là sử dụng Plugin ClickUp chính thức cho Cursor, đã được Cursor xác minh và cho phép cài đặt kết nối chỉ với một cú nhấp chuột. Bạn cũng có thể cài đặt thủ công bằng cách thêm ClickUp vào tệp mcp.json của mình.
Trong VS Code, thêm máy chủ từ terminal bằng lệnh sau:
code --add-mcp '{"type":"http","name":"ClickUp","URL":"https://mcp. ClickUp.com/mcp"}'
Sau đó, mở phần mở rộng, tìm ClickUp MCP ở cuối danh sách máy chủ MCP, nhấp vào biểu tượng bánh răng cài đặt, rồi nhấp vào Khởi động máy chủ.
Trong Windsurf, nhấn "Ctrl + ," trên Windows hoặc "Cmd + ," trên Mac để mở cài đặt, cuộn xuống phần Cascade, nhấp vào MCP servers, sau đó chọn Add Server và chọn Add máy chủ tùy chỉnh. Cuối cùng, trong Antigravity, thêm mục nhập máy chủ vào tệp mcp_config.json của bạn theo hướng dẫn của Google về cách kết nối các máy chủ MCP tùy chỉnh.
Ghi chú: Bài viết này đề cập đến Claude, Claude Code, ChatGPT, Cursor, VS Code, Windsurf và Antigravity. Ngoài ra còn có các ứng dụng khách hàng khác được hỗ trợ, và quy trình thiết lập cho hầu hết các ứng dụng này đều gần như giống nhau.
Bước 2: Thêm máy chủ ClickUp MCP
Điểm cuối MCP chính thức của ClickUp là: https://mcp.clickup.com/mcp
Đây là cùng một URL cho mọi khách hàng và mọi Không gian Làm việc.
Tên trường cho URL đó thay đổi tùy theo khách hàng. Cursor sử dụng url trong tệp cấu hình mcp.json của nó. Windsurf và Antigravity đều sử dụng serverUrl. Claude Free bao bọc kết nối thông qua một gói cầu nối cục bộ có tên là mcp-remote, do đó mục nhập sẽ trông khác một chút: lệnh của bạn là npx và các đối số là -y mcp-remote https://mcp.clickup.com/mcp.
Đối với các khách hàng không được liệt kê trong Danh sách công việc, ClickUp khuyến nghị sử dụng phương án dự phòng mcp-remote tương tự và không cần thiết lập biến môi trường.
Ghi chú: ChatGPT xử lý việc này theo cách khác: kết nối được quản lý hoàn toàn thông qua giao diện Ứng dụng, do đó bạn sẽ không cần nhập URL thủ công.
Bước 3: Xác thực ClickUp bằng OAuth
Sau khi máy chủ được đăng ký, ứng dụng khách hàng của bạn sẽ mở luồng ủy quyền OAuth của ClickUp trong cửa sổ trình duyệt. Đăng nhập và lựa chọn Không gian Làm việc (Workspace) hoặc các Không gian Làm việc mà bạn muốn ứng dụng khách hàng truy cập.
ClickUp chỉ hỗ trợ OAuth cho xác thực MCP. Các khóa API cá nhân và token truy cập sẽ không hoạt động, và điều này là có chủ đích.
OAuth liên kết mọi hành động với người dùng đã ủy quyền và giới hạn quyền truy cập vào các Không gian Làm việc mà họ đã lựa chọn, giúp việc kiểm tra và thu hồi quyền truy cập trở nên dễ dàng hơn so với việc sử dụng khóa tĩnh. Nếu bạn đang phát triển một ứng dụng khách MCP tùy chỉnh, ứng dụng đó cần triển khai OAuth 2.1 với PKCE, JSON-RPC 2.0 qua HTTP và toàn bộ thông số kỹ thuật MCP.
Điều cần biết: Một nghiên cứu trên 7.973 máy chủ MCP từ xa đang hoạt động cho thấy 40,55% trong số đó hoàn toàn không có cơ chế xác thực. Phương pháp chỉ sử dụng OAuth của ClickUp đảm bảo kết nối của bạn sẽ không bao giờ rơi vào tình trạng đó: quyền truy cập được liên kết với tài khoản của bạn, giới hạn trong các Không gian Làm việc mà bạn đã chọn và có thể thu hồi bất cứ lúc nào.
Bước 4: Xác nhận kết nối
Sau khi hoàn thành quá trình ủy quyền, hãy xác minh rằng ClickUp xuất hiện dưới dạng máy chủ MCP đang hoạt động với các công cụ sẵn sàng sử dụng. Cách xác minh phụ thuộc vào từng khách hàng.
Trong Claude Code, chạy lệnh /mcp để xem trạng thái máy chủ và hoàn tất luồng xác thực.
Nếu bạn đang sử dụng VS Code, hãy tìm ClickUp trong phần "Máy chủ MCP" và xác nhận máy chủ đang hoạt động. Trong Devin, vào phần "Cài đặt", sau đó chọn "Kết nối", và trong phần "Máy chủ MCP", ClickUp sẽ xuất hiện cùng danh sách các công cụ của nó. Cuối cùng, quá trình cài đặt qua Marketplace của Cursor sẽ tự động xử lý hầu hết các bước xác minh.
Trong ChatGPT, bắt đầu một cuộc trò chuyện mới và nhập lời nhắc ClickUp. Nếu kết nối đang hoạt động, ChatGPT sẽ tự động gọi các công cụ ClickUp. Đối với Claude Desktop, bắt đầu một cuộc hội thoại mới và xác nhận rằng ClickUp xuất hiện trong danh sách công cụ hoặc trình kết nối có sẵn của bạn.
Nếu ClickUp đã kết nối nhưng không hiển thị các công cụ, nguyên nhân có thể là luồng OAuth chưa hoàn tất. Hãy quay lại, thực hiện ủy quyền lại và kiểm tra lại trước khi tiến hành khắc phục sự cố khác.
Bước 5: Kiểm tra bằng một lệnh chỉ đọc
Bắt đầu với một câu lệnh chỉ đọc để xác nhận mọi thứ đã được kết nối:
“Hãy hiển thị các Không gian trong Không gian Làm việc ClickUp của tôi.”
Điều này xác minh rằng khách hàng của bạn có thể kết nối với ClickUp và hiển thị Không gian Làm việc nào đang hoạt động trước khi bạn yêu cầu nó tạo hoặc sửa đổi bất kỳ nội dung nào.
Khi đã trở thành công việc, hãy thử một tác vụ phức tạp hơn:
“Tìm các công việc quá hạn của tôi, nhóm chúng theo Danh sách công việc và tóm tắt những công việc có bình luận chưa được giải quyết.”
Máy chủ ClickUp MCP hỗ trợ những công cụ nào?
Máy chủ MCP của ClickUp cung cấp khoảng 50 công cụ bao quát hầu hết các công việc bạn sử dụng hàng ngày (quản lý công việc, tìm kiếm trong Không gian Làm việc, tài liệu, trò chuyện, theo dõi thời gian và báo cáo). Tuy nhiên, tính năng hữu ích hơn cả là kết hợp các công cụ. Ứng dụng AI của bạn có thể kết hợp nhiều công cụ phía sau hậu trường để hoàn thành một yêu cầu. Một lời nhắc như “Tạo một công việc lỗi, giao cho Maya, đánh dấu là khẩn cấp và liên kết với tính năng cha” có thể gọi đến bốn hoặc năm công cụ, nhưng bạn chỉ cần yêu cầu trong một câu duy nhất.
| Danh mục | Nội dung bao gồm | Các công cụ ví dụ |
|---|---|---|
| Tìm kiếm | Tìm kiếm công việc và nội dung trong Không gian Làm việc | Tìm kiếm trong Không gian Làm việc, Tìm kiếm công việc theo loại công việc, Tìm kiếm công việc theo thẻ |
| Quản lý công việc | Tạo, xem, cập nhật và chỉnh sửa hàng loạt công việc | Tạo công việc, Lấy công việc, Cập nhật công việc, Đặt Trường Tùy chỉnh, Tạo công việc hàng loạt, Cập nhật công việc hàng loạt |
| Tổ chức công việc | Tệp đính kèm, thẻ, liên kết, mối quan hệ phụ thuộc và tư cách thành viên danh sách | Đính kèm tệp đính kèm vào công việc, thêm thẻ vào công việc, thêm mối quan hệ phụ thuộc, di chuyển công việc sang danh sách công việc mới, thêm công việc vào danh sách công việc khác |
| Bình luận | Đọc các cuộc hội thoại và đăng cập nhật | Lấy bình luận công việc, lấy các phản hồi theo chủ đề, tạo bình luận công việc |
| Theo dõi thời gian | Bộ đếm thời gian và các mục nhập thời gian trong lịch sử | Bắt đầu theo dõi thời gian, Dừng theo dõi thời gian, Thêm mục nhập thời gian, Xem các mục nhập thời gian của công việc |
| Cấu trúc Không gian Làm việc | Không gian, Thư mục, Danh sách công việc, thành viên và người được giao | Lấy cấu trúc phân cấp không gian làm việc, Tạo danh sách công việc, Tạo thư mục, Cập nhật thư mục, Tìm thành viên theo tên |
| Tài liệu và Trò chuyện | Làm việc với các trang tài liệu và ClickUp Chat | Tạo tài liệu, Lấy các trang tài liệu, Cập nhật trang tài liệu, Tạo trang tài liệu, Lấy các kênh trò chuyện, Gửi tin nhắn trò chuyện |
| Báo cáo | Đo lường thời gian công việc ở mỗi trạng thái | Xem thời gian ở trạng thái của một công việc, xem thời gian ở trạng thái của các công việc trong Danh sách công việc |
| Xóa* | Công cụ duy nhất có khả năng phá hủy trên máy chủ | Xóa công việc (xác nhận công việc trước khi xóa) |
Ví dụ về các lời nhắc ClickUp MCP cho thấy những gì nó thực sự có thể làm
Các lệnh MCP đơn giản nhất chỉ yêu cầu ClickUp thực hiện một việc: tìm một công việc, tạo một công việc hoặc hiển thị thời gian đã ghi lại. Những lệnh này hữu ích để kiểm tra kết nối, nhưng chúng chỉ mới chạm nhẹ vào những gì máy chủ có thể làm được.
Các lời nhắc hiệu quả thường kết hợp ba yếu tố:
- Phạm vi: Chỉ định cho trợ lý nơi cần thực hiện công việc, chẳng hạn như một Không gian, Thư mục, Danh sách công việc, công việc hoặc Tài liệu
- Tiêu chí: Xác định những thông tin cần tìm kiếm, chẳng hạn như trạng thái, người được giao nhiệm vụ, ngày đáo hạn, thẻ hoặc phạm vi thời gian
- Hành động: Hướng dẫn hệ thống về việc cần làm với thông tin mà nó tìm thấy
ClickUp MCP có thể kết hợp nhiều công cụ được hỗ trợ trong một yêu cầu duy nhất, nghĩa là một lời nhắc duy nhất có thể tìm kiếm công việc, kiểm tra bối cảnh của nó và sau đó thực hiện hành động dựa trên kết quả.
Dưới đây là một số ví dụ:
Biến một báo cáo lỗi lộn xộn thành công việc được phân công
“Tạo một công việc lỗi trong Danh sách công việc Lỗi Kỹ thuật dựa trên vấn đề chúng ta vừa thảo luận. Đặt mức độ ưu tiên là khẩn cấp, giao cho Priya, thêm thẻ ‘do khách hàng báo cáo’ và liên kết nó với công việc APP-482.”
Một lời nhắc có thể bao gồm việc tạo/lập công việc, xác định người được giao, gắn thẻ, ưu tiên và mối quan hệ giữa các công việc. Bạn chỉ cần cung cấp kết quả mong muốn cho trợ lý, và nó sẽ tự động xác định công cụ nào cần sử dụng.
Thực hiện một buổi đánh giá sprint nhẹ nhàng
“Trong Danh sách công việc Sprint 14, hãy tìm tất cả các công việc vẫn còn ở giai đoạn tiến độ hoặc đang trong quá trình xem xét. Tóm tắt những gì mỗi công việc đang chờ xử lý, đánh dấu bất kỳ công việc nào đã quá ngày đáo hạn và cho tôi biết những công việc nào có thảo luận chưa được giải quyết trong phần bình luận.”
Trợ lý có thể truy xuất các công việc liên quan, kiểm tra chi tiết và bình luận của chúng, đồng thời chuyển đổi kết quả thành bản tóm tắt để bạn có thể thực hiện các hành động tiếp theo. ClickUp MCP hỗ trợ tìm kiếm trong Không gian Làm việc ClickUp, truy xuất công việc và truy cập bình luận công việc.
Trợ lý có thể truy xuất các công việc liên quan, kiểm tra chi tiết và bình luận của chúng, đồng thời chuyển đổi kết quả thành bản tóm tắt để bạn có thể thực hiện các hành động tiếp theo. ClickUp MCP hỗ trợ tìm kiếm trong Không gian Làm việc, truy xuất công việc và truy cập bình luận công việc.
Dọn dẹp hàng đợi đánh giá chỉ trong một lần
“Tìm tất cả các công việc trong Sprint 14 có trạng thái 'Ready for Review'. Chuyển chúng sang trạng thái 'In Review' và thêm một bình luận đề cập đến người được giao hiện tại rằng quá trình xem xét đã bắt đầu.”
“Tìm tất cả các công việc trong Sprint 14 có trạng thái ‘Ready for Review’. Chuyển chúng sang trạng thái ‘In Review’ và thêm một bình luận đề cập đến người được giao hiện tại rằng quá trình xem xét đã bắt đầu.”
Yêu cầu đó bao gồm tìm kiếm công việc, cập nhật hàng loạt, bình luận và giải quyết vấn đề của thành viên. ClickUp hỗ trợ cập nhật hàng loạt công việc và bình luận kèm đề cập @mentions thông qua MCP.
Tạo bản cập nhật phát hành trực tiếp từ chính công việc
“Dựa trên các công việc đã hoàn thành trong Platform Space từ ngày 24 đến ngày 30 tháng 8, soạn thảo bản ghi chú phát hành được phân loại thành các tính năng mới, cải tiến và sửa lỗi. Bao gồm các ID Nhiệm vụ và nêu rõ bất kỳ công việc nào được hoàn thành muộn hơn so với ngày đáo hạn ban đầu.”
Bạn không cần phải chuẩn bị tài liệu nguồn trước. MCP có thể tìm kiếm trong Không gian Làm việc và lấy bối cảnh công việc, trong khi ứng dụng AI sẽ xử lý việc tổng hợp.
Bạn càng xác định rõ phạm vi và kết quả mong muốn, trợ lý càng ít phải làm công việc để hiểu chính xác ý của bạn.
Nếu bạn thường xuyên lặp lại cùng một loại lời nhắc, hãy biến nó thành một quy trình làm việc có thể tái sử dụng. Hướng dẫn của chúng tôi về tự động hóa công việc bằng AI bao gồm các mẫu hoạt động hiệu quả hơn khi quy trình cần chạy theo lịch trình.
Giải thích về giới hạn tốc độ của ClickUp MCP
Giới hạn tốc độ của ClickUp MCP phụ thuộc vào hai yếu tố: kế hoạch Không gian Làm việc của bạn và việc Không gian Làm việc của bạn có cài đặt tiện ích bổ sung Everything AI hay không.
Khi sử dụng Everything AI, các yêu cầu MCP sẽ áp dụng cùng giới hạn theo phút và theo token như API công khai của ClickUp. Nếu không sử dụng Everything AI, ClickUp sẽ áp dụng giới hạn chung cho toàn bộ Không gian Làm việc trong khoảng thời gian 24 giờ luân phiên.
| Kế hoạch dịch vụ | Không cần Everything AI | Với Everything AI |
|---|---|---|
| Miễn phí vĩnh viễn | 100 yêu cầu/24 giờ | 100 yêu cầu/phút/token |
| Không giới hạn | 300 yêu cầu/24 giờ | 100 yêu cầu/phút/token |
| Kinh doanh | 1.000 yêu cầu/24 giờ | 100 yêu cầu/phút/token |
| Business Plus | 2.500 yêu cầu/24 giờ | 1.000 yêu cầu/phút/token |
| Enterprise | 5.000 yêu cầu/24 giờ | 10.000 yêu cầu/phút/token |
Giới hạn luân phiên được chia sẻ trên toàn bộ Không gian Làm việc. Mỗi khách hàng MCP kết nối với Không gian Làm việc đó đều sử dụng chung một nguồn giới hạn. Nếu nhiều người dùng kết nối Claude, Cursor, ChatGPT hoặc bất kỳ khách hàng MCP nào khác với cùng một Không gian Làm việc, tất cả các yêu cầu của họ đều được tính vào cùng một hạn mức.
Mỗi yêu cầu MCP đều được tính vào giới hạn đó. Các thao tác đọc, tạo và cập nhật đều tiêu tốn giới hạn này như nhau. Một lời nhắc bằng ngôn ngữ tự nhiên duy nhất cũng có thể kích hoạt nhiều yêu cầu MCP diễn ra ngầm nếu khách hàng cần tìm kiếm, truy xuất bối cảnh và sau đó thực hiện một hành động.
ClickUp MCP so với API ClickUp: Nên sử dụng cái nào?
Sử dụng máy chủ ClickUp MCP khi bạn muốn trợ lý AI đọc yêu cầu của bạn, trích xuất bối cảnh phù hợp từ ClickUp và quyết định công cụ nào cần gọi. Sử dụng API ClickUp khi bạn viết mã với logic cố định, chẳng hạn như đồng bộ hóa theo lịch trình, luồng webhook hoặc ứng dụng tùy chỉnh.
| So sánh | Máy chủ ClickUp MCP | API ClickUp |
|---|---|---|
| Giao diện | Yêu cầu bằng ngôn ngữ tự nhiên thông qua một ứng dụng AI tương thích với MCP | Yêu cầu REST từ mã nguồn của bạn |
| Xác thực | Chỉ hỗ trợ OAuth; các ứng dụng khách tùy chỉnh phải hỗ trợ OAuth 2.1 với PKCE | Token API cá nhân hoặc OAuth |
| Giới hạn tốc độ | Giới hạn luân phiên trên toàn không gian làm việc mà không cần Everything AI; giới hạn theo phút phù hợp với API khi sử dụng Everything AI | Tính theo phút, theo token, dựa trên kế hoạch Không gian Làm việc |
| Phù hợp nhất cho | Phân tích theo yêu cầu, quy trình làm việc liên công cụ, báo cáo, cập nhật công việc và công việc có sự hỗ trợ của trợ lý ảo | Các tác vụ được lên lịch, quy trình làm việc dựa trên sự kiện, ứng dụng tùy chỉnh, đồng bộ hóa dữ liệu và tích hợp khối lượng lớn |
| Thiết lập | Kết nối điểm cuối MCP và ủy quyền cho ClickUp | Xây dựng các yêu cầu, xác thực, xử lý lỗi và logic tích hợp |
| Cách thức công việc được quyết định | Ứng dụng khách hàng AI sẽ giải thích yêu cầu của bạn và chọn các công cụ ClickUp để gọi | Mã của bạn sẽ xác định chính xác endpoint nào sẽ chạy và khi nào |
Chúng cũng hoạt động rất ăn ý với nhau. Hãy để API xử lý các tác vụ lặp đi lặp lại, và sử dụng MCP khi bước tiếp theo phụ thuộc vào ngữ cảnh mà trợ lý có thể hiểu rõ hơn so với kịch bản.
ClickUp có thể kết nối với các máy chủ MCP bên ngoài không?
Đúng vậy. Tất cả các nội dung trên đều coi ClickUp như một đối tượng mà AI tương tác. Tuy nhiên, ClickUp cũng có thể phản hồi lại. Nó có thể kết nối với các máy chủ MCP bên ngoài với tư cách là một khách hàng, điều này có nghĩa là ClickUp Brain và ClickUp Super Agents có thể gọi các công cụ trong hệ thống CRM, kho lưu trữ mã, hệ thống thanh toán của bạn — nói chung là bất kỳ nơi nào cung cấp máy chủ MCP.
Đây là một cách thiết lập hoàn toàn khác biệt. Không chỉ giúp Claude có cái nhìn tổng quan về các công việc của bạn, bạn còn trao cho tác nhân ClickUp khả năng tiếp cận toàn bộ hệ thống công nghệ của bạn.
Giả sử có một phiếu yêu cầu được gửi đến ClickUp. Một Super Agent sẽ đọc phiếu đó, tra cứu thông tin khách hàng trong hệ thống CRM của bạn thông qua máy chủ MCP, tạo hồ sơ hỗ trợ tại đó, cập nhật nhiệm vụ ClickUp kèm theo liên kết CRM và đăng tóm tắt lên Chat.
Bạn có thể kết nối các công cụ này trong App Center tại mục MCP Servers. Các mẫu sẵn có bao gồm GitHub, Stripe, Atlassian và các nền tảng khác. Đối với máy chủ tùy chỉnh, cần cung cấp URL công khai và phương thức xác thực (OAuth, khóa API hoặc không cần). Sau khi kết nối, các công cụ sẽ xuất hiện trong mục AI Tools. Bạn có thể gán chúng cho bất kỳ Super Agent nào, từng công cụ một hoặc toàn bộ bộ công cụ. Ngoài ra, bạn cũng có thể thêm máy chủ MCP tùy chỉnh trực tiếp trong ClickUp.
Đây có thể nói là phần quan trọng hơn. Kết nối Claude với ClickUp sẽ mang đến cho bạn một trợ lý thông minh hơn. Kết nối ClickUp với các công cụ khác sẽ mang đến cho bạn một lớp điều phối.
Lưu ý: Chỉ Chủ sở hữu Không gian Làm việc và quản trị viên Không gian Làm việc mới có thể tạo kết nối cho toàn bộ Không gian Làm việc. ClickUp ghi lại mọi thay đổi về kết nối trong nhật ký kiểm tra. Tính năng này hiện có sẵn trên tất cả các kế hoạch, giá cả có thể thay đổi.
Nếu bạn đang cân nhắc mức độ tự chủ cần giao cho các quy trình làm việc này, hướng dẫn của chúng tôi về các loại tác nhân AI khác nhau sẽ bao quát toàn bộ phạm vi.
Xem thêm: Cách xây dựng một tác nhân AI?
Khắc phục sự cố và các giới hạn đã biết của ClickUp MCP
Một số vấn đề liên quan đến ClickUp MCP thường xuất phát từ quyền truy cập, giới hạn tìm kiếm hoặc giới hạn sử dụng. Hãy kiểm tra bốn yếu tố sau trước tiên:
- Kết quả tìm kiếm Enterprise không khả dụng qua MCP. ClickUp MCP có thể tìm kiếm nội dung gốc trên ClickUp, nhưng hiện tại vẫn chưa thể lấy kết quả từ các ứng dụng bên ngoài được kết nối qua ClickUp Connected Search, như Google Drive hoặc Slack
- MCP tuân theo quyền truy cập của bạn trên ClickUp. Ứng dụng AI của bạn chỉ hiển thị những nội dung mà tài khoản ClickUp được kết nối có quyền truy cập. Nếu một Space, Danh sách công việc, công việc hoặc Tài liệu không hiển thị, hãy xác nhận rằng bạn có thể mở trực tiếp nội dung đó trong ClickUp
- Thông tin sử dụng không hiển thị trên giao diện người dùng. Hiện tại chưa có bộ đếm số lần gọi MCP đã sử dụng, vì vậy hãy coi phản hồi 429 RATE_LIMIT_EXCEEDED là tín hiệu cho biết bạn đã đạt đến giới hạn. Hạn chế phạm vi lời nhắc trong một Danh sách công việc, thư mục hoặc khoảng thời gian sẽ giúp bạn luôn nằm trong giới hạn cho phép
- Giới hạn có thể thay đổi tùy theo kế hoạch và theo thời gian. Giới hạn sử dụng và giới hạn tốc độ của ClickUp MCP có thể thay đổi khi ClickUp đánh giá mức độ sử dụng và chi phí, vì vậy hãy đảm bảo bạn kiểm tra hạn mức hiện tại cho Không gian Làm việc của mình trước khi xây dựng các quy trình làm việc lặp lại dựa trên một số cố định
Những sai lầm mà các nhóm thường mắc phải trong tuần đầu tiên
ClickUp MCP rất dễ kết nối, nhưng cách bạn nhập lời nhắc và triển khai nó rất quan trọng. Dưới đây là những sai lầm bạn cần tránh càng sớm càng tốt:
- Bắt đầu với các lời nhắc quá rộng. “Điều gì cần tôi chú ý?” có thể yêu cầu hệ thống phải tìm kiếm trên phạm vi rộng hơn trong Không gian Làm việc của bạn trước khi có thể trả lời, và mỗi yêu cầu MCP đều được tính vào giới hạn áp dụng. Hãy chỉ định một Không gian, thư mục, Danh sách công việc, dự án hoặc khoảng thời gian cụ thể mỗi khi bạn đã biết rõ phạm vi cần tìm kiếm.
- Lưu ý rằng các ứng dụng khách có thể chia sẻ cùng một hạn mức. Trên các Không gian Làm việc có giới hạn MCP hàng ngày theo chu kỳ, Claude, Cursor, ChatGPT và các ứng dụng khách khác kết nối với cùng một Không gian Làm việc sẽ sử dụng chung một hạn mức. Việc thêm một ứng dụng khách khác sẽ không cung cấp cho bạn một hạn mức mới.
- Thực hiện các thao tác ghi trước khi kiểm tra mục tiêu. Bắt đầu bằng một yêu cầu chỉ đọc để xác nhận Space, Danh sách công việc, công việc hoặc Không gian Làm việc mà bạn định sử dụng. Khi mọi thứ đã chính xác, hãy tiếp tục tạo, cập nhật, di chuyển hoặc xóa công việc
- Giả sử MCP luôn sử dụng các giới hạn giống như API. Trong cấu trúc kế hoạch hiện tại, các Không gian Làm việc không có Everything AI sử dụng hạn mức MCP luân phiên cho toàn bộ Không gian Làm việc, trong khi API công khai áp dụng giới hạn theo phút và theo token. Với Everything AI, các yêu cầu MCP sẽ tuân theo các giới hạn tương ứng với API. Các kế hoạch mới hơn sử dụng cấu trúc giới hạn MCP khác, vì vậy hãy kiểm tra các giới hạn áp dụng cho Không gian Làm việc của bạn
- Sử dụng MCP cho các công việc đã có quy tắc cố định. Nếu quy trình làm việc có thể dự đoán được, chẳng hạn như “mỗi thứ Năm lúc 8:00, cập nhật trường này” hoặc “khi PR được hợp nhất, thay đổi trạng thái của công việc”, thì Tự động hóa ClickUp được thiết kế dành riêng cho các mẫu như vậy. MCP sẽ hữu ích hơn khi trợ lý cần kiểm tra bối cảnh và quyết định bước tiếp theo. Hãy sử dụng tự động hóa quy trình làm việc cho các quy tắc lặp lại và MCP cho các công việc cần khả năng diễn giải
Máy chủ chính thức hay của bên thứ ba? Những điều cần biết
Máy chủ MCP chính thức của ClickUp không phải là lựa chọn duy nhất. Các máy chủ của bên thứ ba đã tồn tại từ rất lâu trước khi phiên bản chính thức được phát hành, và một số trong số đó còn hỗ trợ các công cụ, mô hình lưu trữ hoặc phương thức xác thực khác nữa.
Giải pháp thay thế được sử dụng rộng rãi nhất là taazkareem/clickup-mcp-server. Dự án này ban đầu là một dự án mã nguồn mở và sau đó đã chuyển sang mô hình trả phí. Nó cung cấp cả điểm cuối từ xa được lưu trữ và chế độ cục bộ kết nối thông qua khóa API ClickUp của bạn. Số lượng công cụ được hỗ trợ rộng hơn (khoảng 150 công cụ, bao gồm danh sách kiểm tra, sprint, mục tiêu và xóa Danh sách công việc, Thư mục và Tài liệu), và chế độ cục bộ cho phép bạn xác thực bằng khóa API.
Bạn cần biết điều này về giới hạn tốc độ. Một máy chủ của bên thứ ba gọi trực tiếp API ClickUp sẽ không tính vào hạn mức hàng ngày của máy chủ MCP chính thức. Máy chủ đó hoạt động dựa trên các giới hạn theo phút và theo token của API, vốn được nới lỏng hơn trên các kế hoạch trả phí. Đổi lại, bạn sẽ phải quản lý thêm một yếu tố phụ thuộc khác, dù là tự vận hành máy chủ hay tin tưởng vào một điểm cuối của bên thứ ba.
Zapier MCP áp dụng một cách tiếp cận khác. Nó có thể cung cấp các hành động ClickUp đã lựa chọn cho Claude, ChatGPT, Cursor và các khách hàng MCP khác thông qua một điểm cuối Zapier duy nhất, cùng với các hành động từ hơn 9.000 ứng dụng khác. Điểm cần cân nhắc là chi phí: mỗi lần gọi công cụ MCP thành công sẽ tiêu tốn hai công việc Zapier từ cùng hạn mức mà các Zaps của bạn sử dụng. Ở gói Miễn phí (100 công việc/tháng), con số này tương đương 50 lần gọi công cụ, và các lần gọi thất bại sẽ không được tính vào hạn mức.
Kết luận: Đối với đa số người dùng, máy chủ chính thức là lựa chọn mặc định đơn giản nhất vì nó được ClickUp duy trì, sử dụng cơ chế OAuth và không yêu cầu bất kỳ chi phí hay công sức bổ sung nào để lưu trữ hay thanh toán. Lựa chọn từ bên thứ ba sẽ hợp lý hơn khi bạn cần một công cụ hoặc phương thức xác thực mà máy chủ chính thức không cung cấp, hoặc khi bạn muốn tận dụng giới hạn theo phút của API ClickUp để tránh vượt quá giới hạn hàng ngày của MCP.
Bắt đầu sử dụng ClickUp MCP để thực hiện công việc
ClickUp MCP phát huy hiệu quả tối đa khi bước tiếp theo phụ thuộc vào ngữ cảnh, chứ không phải quy tắc định sẵn. Hãy kết nối một khách hàng, thử nghiệm với câu lệnh chỉ đọc, sau đó phát triển các quy trình làm việc kết hợp tìm kiếm, phân tích và thực thi hành động trong một cuộc hội thoại duy nhất.
Sử dụng ClickUp tự động hóa cho các quy trình lặp lại cùng một chuỗi thao tác mỗi lần. Sử dụng MCP cho các công việc cần một trợ lý để đánh giá bối cảnh, phân tích các lựa chọn và quyết định bước tiếp theo.
Và đừng chỉ dừng lại ở hướng kết nối vào. ClickUp cũng kết nối với các máy chủ MCP bên ngoài, điều này có nghĩa là Brain và Super Agents có thể truy cập vào phần còn lại của hệ thống phần mềm của bạn mà không cần ai phải rời khỏi Không gian Làm việc ClickUp.
Câu hỏi thường gặp về ClickUp MCP
Không. MCP hoạt động theo mô hình yêu cầu-phản hồi: nó chỉ thực hiện hành động khi một ứng dụng khách AI gửi lời nhắc. Không có quá trình nào chạy ngầm, theo dõi các thay đổi hoặc tự động kích hoạt theo lịch trình. Đối với các quy trình làm việc dựa trên sự kiện hoặc theo lịch trình, hãy sử dụng ClickUp tự động hóa hoặc Super Agents.
Có. Trong luồng xác thực OAuth, bạn sẽ lựa chọn Không gian Làm việc nào cần cấp quyền. Để làm việc trên nhiều Không gian Làm việc, hãy cấp quyền cho từng Không gian Làm việc riêng biệt trên ứng dụng khách của bạn. Một số ứng dụng khách hỗ trợ nhiều mục nhập máy chủ MCP, do đó bạn có thể thêm một mục nhập cho mỗi Không gian Làm việc.
Không trực tiếp. Kết nối MCP được thiết lập trong ứng dụng AI trên máy tính để bàn của bạn (Claude, Cursor, VS Code, v.v.). Nếu ứng dụng AI của bạn có ứng dụng di động hỗ trợ kết nối từ xa (như của Claude), kết nối này sẽ được chuyển sang tài khoản của bạn. Tuy nhiên, không có tùy chọn thiết lập MCP độc lập trên thiết bị di động.
Có. Vì MCP sử dụng OAuth, bạn có thể thu hồi quyền truy cập từ cài đặt tài khoản ClickUp của mình theo cách tương tự như khi thu hồi quyền truy cập của bất kỳ ứng dụng nào đã kết nối. Sau khi bị thu hồi, ứng dụng khách AI sẽ mất quyền truy cập ngay lập tức.
Có. Mọi thao tác trên MCP đều được thực hiện dưới token OAuth của người dùng đã ủy quyền kết nối. Nếu tài khoản của bạn không thể xem một không gian riêng tư hoặc Danh sách công việc bị hạn chế trong giao diện người dùng ClickUp, thì trợ lý cũng không thể xem được thông qua MCP.
ClickUp Brain là AI được tích hợp sẵn trong Không gian Làm việc ClickUp; máy chủ MCP cho phép các ứng dụng AI bên ngoài như Claude, ChatGPT và Cursor đọc và xử lý dữ liệu ClickUp từ giao diện riêng của chúng. Chúng cũng hoạt động theo hướng ngược lại: Brain và Super Agents có thể truy cập các máy chủ MCP bên ngoài (GitHub, Stripe, Atlassian, HubSpot) thông qua máy chủ MCP đến Không gian Làm việc của bạn, trong khi máy chủ MCP cho phép các công cụ khác truy cập vào ClickUp. Brain yêu cầu kế hoạch AI; máy chủ MCP hoạt động trên tất cả các kế hoạch, bao gồm cả Gói Miễn phí vĩnh viễn.