---
title: "Giao việc cho Cloud Agent từ Claude, ChatGPT hoặc Claude Code qua MCP"
description: "Kết nối MCP của TOSE với Claude, ChatGPT, Claude Code, Cursor hoặc VS Code, rồi giao và theo dõi tác vụ cho Cloud Agent bằng các tool cloud_agent_*."
url: https://tose.sh/blog/giao-viec-cho-cloud-agent-qua-mcp
lang: vi
category: "Hướng dẫn"
tags: ["cloud-agents", "mcp", "claude", "chatgpt", "huong-dan"]
author: "TOSE"
published: 2026-11-13T12:49:21.201774Z
updated: 2026-11-13T12:49:21.201826Z
---

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

**TL;DR:** 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ủ.

> **info**
> **Loạt bài Cloud Agents trên TOSE** · Phần 3/5
> 1. [Giới thiệu](/blog/gioi-thieu-cloud-agents-tren-tose) · 2. [Tạo Cloud Agent đầu tiên](/blog/huong-dan-tao-cloud-agent-dau-tien) · 3. **Giao việc qua MCP** (bài này) · 4. [GitHub và Pull Request](/blog/cloud-agent-github-pull-request) · 5. [Chi phí và tự động ngủ](/blog/chi-phi-cloud-agent-va-tu-dong-ngu)

[Video: Giao việc cho Cloud Agent qua MCP](https://cdn.tose.sh/blog/d5a941a6d8cdb5d4ccf830ae16f6027a.mp4)

![Một cuộc trò chuyện giao việc cho Cloud Agent qua MCP](https://cdn.tose.sh/blog/4ee1ddfb9f55caec0d5db17df8d00aa1.webp)

*Ả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](/blog/huong-dan-tao-cloud-agent-dau-tien).

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

| Ứng dụng | Cách thêm |
| --- | --- |
| Claude | Settings → Connectors → Add custom connector → dán URL |
| ChatGPT | Settings → Apps & Connectors → Create (chế độ developer) → dán URL, chọn OAuth |
| Claude Code | `claude mcp add --transport http tose <MCP server URL>` |
| Cursor | Thêm vào `~/.cursor/mcp.json`: `{"mcpServers":{"tose":{"url":"<MCP server URL>"}}}` |
| VS Code | Chạy *MCP: Add Server*, chọn HTTP, dán URL |

*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*

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

| Tool | Chứ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 |

*Bốn tool MCP*

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ụ](https://cdn.tose.sh/blog/750ca300c9c733a3087634f494eb53fe.webp)

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](https://cdn.tose.sh/blog/5522c0cc23ecc11d05f54b4a4939225f.webp)

*Ả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

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

**Phần trước:** [← Tạo Cloud Agent đầu tiên](/blog/huong-dan-tao-cloud-agent-dau-tien) **Phần tiếp theo:** [Gắn GitHub repo và nhận Pull Request →](/blog/cloud-agent-github-pull-request)

## FAQ

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