Chuyển đến nội dung chính

Tất cả bài viếtHướng dẫn

Giao việc cho Cloud Agent từ Claude, ChatGPT hoặc Claude Code qua MCP

Tác giả TOSEĐăng ngày Cập nhật 5 phút đọc

Mockup cuộc trò chuyện giao việc cho Cloud Agent qua MCP

Tóm tắt

Lấy MCP server URL ở Cài đặt workspace, mục Agent access, rồi thêm vào Claude, ChatGPT, Claude Code, Cursor hoặc VS Code. Bốn tool: cloud_agent_list, cloud_agent_run_task, cloud_agent_get_task, cloud_agent_cancel_task. Mỗi agent một tác vụ tại một thời điểm, thời gian chạy 1 đến 120 phút (mặc định 30); tác vụ không đánh thức agent đang ngủ.

Một cuộc trò chuyện giao việc cho Cloud Agent qua MCP
Ảnh mockup giao diện trò chuyện trung tính, dữ liệu minh họa.

Điều kiện để agent nhận tác vụ

• Agent cài từ bản có hỗ trợ tác vụ: Claude Code 1.1.0, Codex 1.1.0 hoặc Pi 1.2.0. Bản cũ hơn trả về TASKS_UNSUPPORTED.

• Trong tab Cài đặt của agent, tùy chọn "Nhận tác vụ từ ứng dụng đã kết nối và khóa API" đang bật. Tùy chọn này bật sẵn với agent mới cài; khi tắt, tác vụ bị từ chối với TASKS_DISABLED.

• Agent đang thức. Tác vụ không đánh thức agent đang ngủ (AGENT_SLEEPING).

• Agent đã đăng nhập nhà cung cấp; nếu chưa, tác vụ trả về PROVIDER_SIGN_IN_REQUIRED.

Nếu chưa có agent, hãy làm theo phần 2.

Kết nối MCP của TOSE

Mở Cài đặt của workspace, mục Agent access, và sao chép MCP server URL (thường là https://app.tose.sh/mcp). Sau đó thêm URL này vào ứng dụng:

Mở Cài đặt của workspace, mục Agent access, và sao chép MCP server URL (thường là `https//app.tose.sh/mcp`). Sau đó thêm URL này vào ứng dụng
Ứng dụngCách thêm
ClaudeSettings → Connectors → Add custom connector → dán URL
ChatGPTSettings → Apps & Connectors → Create (chế độ developer) → dán URL, chọn OAuth
Claude Code`claude mcp add --transport http tose <MCP server URL>`
CursorThêm vào `~/.cursor/mcp.json`: `{"mcpServers":{"tose":{"url":"<MCP server URL>"}}}`
VS CodeChạy *MCP: Add Server*, chọn HTTP, dán URL

Khi ứng dụng yêu cầu, đăng nhập TOSE, chọn workspace và chọn quyền cho phép:

• agents:read: liệt kê agent và đọc tác vụ;

• agents:execute: giao việc;

• agents:control: hủy tác vụ.

Người cấp quyền phải là chủ sở hữu hoặc quản trị viên workspace. Lưu ý cảnh báo của agents:execute: một tác vụ có thể đọc và gửi về mọi thứ agent truy cập được, kể cả thông tin đăng nhập. Chỉ cấp quyền này cho ứng dụng bạn tin cậy.

Bốn tool MCP

Bốn tool MCP
ToolChức năng
`cloud_agent_list`Liệt kê agent cùng trạng thái, bản phát hành, khả năng nhận tác vụ và tác vụ đang chạy
`cloud_agent_run_task`Giao một tác vụ cho một agent
`cloud_agent_get_task`Đọc trạng thái và sự kiện của tác vụ; mỗi lần gọi có thể chờ tới 25 giây
`cloud_agent_cancel_task`Dừng tác vụ đang chạy

Thông thường bạn không cần gọi tool trực tiếp: chỉ cần mô tả việc bằng ngôn ngữ tự nhiên, AI sẽ chọn tool phù hợp.

Vòng đời của một tác vụ

Vòng đời một tác vụ

Tác vụ bắt đầu ở starting, chuyển sang running, và kết thúc ở một trong các trạng thái succeeded, failed, cancelled, timed_out hoặc lost. Kết quả gồm:

• final_message: tóm tắt cuối cùng của agent;

• changed_files: các tệp đã thay đổi theo repo và trạng thái;

• problem_code và ended_by khi có sự cố hoặc tác vụ bị dừng.

Giới hạn cần lưu ý

• Mỗi agent một tác vụ tại một thời điểm, không có hàng đợi. Giao thêm khi agent đang bận sẽ nhận AGENT_BUSY. Để chạy song song, hãy dùng nhiều agent.

• Thời gian chạy đặt bằng timeout_minutes, từ 1 đến 120 phút, mặc định 30.

• Đề bài tối đa 100.000 byte.

• Tiếp tục việc cũ: truyền continue_task_id của một tác vụ đã kết thúc để agent làm tiếp trong cùng ngữ cảnh.

• Ví hết số dư: tác vụ bị từ chối với INSUFFICIENT_BALANCE.

Theo dõi trên trang agent

Mọi tác vụ, dù được giao từ đâu, đều hiển thị trong tab Tác vụ với ba cột: Đang chạy, Hoàn thành, Lỗi hoặc đã dừng.

Bảng tác vụ của agent
Ảnh mockup tab Tác vụ, dữ liệu minh họa.

Mẫu đề bài cho agent làm việc độc lập

text
Bối cảnh: repo web-app, lỗi refresh token khiến người dùng bị đăng xuất sau 15 phút.​Phạm vi được sửa: src/auth/ và tests/auth/.Không sửa: cấu hình triển khai, migration, package.json.​Hoàn thành khi:- có test tái hiện lỗi, thất bại trước khi sửa và thành công sau khi sửa;- toàn bộ test hiện có vẫn thành công;- báo cáo ngắn: nguyên nhân, tệp đã sửa, cách kiểm tra.

Một đề bài tốt có ba phần: bối cảnh, phạm vi và điều kiện hoàn thành. Thiếu phần nào, agent sẽ phải tự suy đoán phần đó.

Sau khi có kết quả

Trạng thái "Hoàn thành" chưa có nghĩa là kết quả đúng. Hãy xem changed_files, đọc diff và chạy lại test. Nếu agent được phép push, kết quả sẽ nằm trên một nhánh hoặc Pull Request để review, như hướng dẫn ở phần tiếp theo.

Câu hỏi thường gặp

Agent nào nhận được tác vụ qua MCP?

Agent cài từ Claude Code 1.1.0, Codex 1.1.0 hoặc Pi 1.2.0, đang thức, đã bật nhận tác vụ và đã đăng nhập nhà cung cấp.

Có thể giao nhiều tác vụ cho một agent cùng lúc không?

Không. Mỗi agent chạy một tác vụ, không có hàng đợi; giao thêm khi agent đang bận sẽ nhận lỗi AGENT_BUSY.

Cần quyền gì để giao việc qua MCP?

Scope agents:execute để giao việc, agents:read để liệt kê và đọc tác vụ, agents:control để hủy. Người cấp quyền phải là chủ sở hữu hoặc quản trị viên.