Quickstart
Từ cài đặt đến tool call đầu tiên. Làm đúng trình tự, không cần đọc tài liệu nào khác trước.
Điều kiện tiên quyết
- Coworker đã cài và mở; workspace đã trỏ vào thư mục dự án
- Tài khoản ChatGPT có quyền dùng Plugin và cấu hình MCP theo chính sách tổ chức
- MCP đã bật trong Coworker — kiểm tra trạng thái ở mục Kết nối
1 · Tạo tunnel trên OpenAI Platform
Tunnel là kết nối giữa ChatGPT và MCP của Coworker. Cấu hình có thể khác theo tài khoản hoặc tổ chức; xem Multi-tunnel nếu cần chạy nhiều kết nối.
- Đăng nhập đúng tài khoản
Tunnel thuộc về tài khoản tạo nó. Dùng tài khoản chính cho tunnel đầu tiên.
- Tạo tunnel
Mở trang quản trị tunnel theo tổ chức của bạn → Create tunnel. Đặt tên dễ nhận biết và ghi lại Tunnel ID.
- Tạo Runtime API key
Mở mục Runtime API Keys, tạo key theo quyền tối thiểu cần thiết và lưu ở nơi an toàn.
- Nhập vào Coworker
Vào Kết nối → thêm Secure MCP Tunnel → điền nhãn, Tunnel ID và Runtime API key → Lưu. Kiểm tra dòng trạng thái chuyển sang sẵn sàng.
Mất key thì tạo key mới trên Platform và nhập đè — tunnel và các cấu hình khác không bị ảnh hưởng.
2 · Tạo app "Coworker" trong ChatGPT
App là cầu nối phía ChatGPT: nó bảo ChatGPT "có một MCP server ở đầu kia tunnel này". Tạo một lần cho mỗi tài khoản.
- Mở giao diện tạo app
Trong ChatGPT, vào Cài đặt → Plugin, mở trang quản lý plugin, bấm dấu + rồi chọn Ứng dụng mới.
- Điền thông tin
Đặt tên
Coworker, chọn Connection = Tunnel, rồi chọn tunnel vừa tạo theo hướng dẫn của ChatGPT. - Lưu kết nối
Chọn Create hoặc Save. Không chia sẻ Runtime API key trong chat hoặc mã nguồn.
- Xác nhận hai đầu
Ở Coworker, dòng tunnel chuyển Đang chạy. Trong ChatGPT, app Coworker xuất hiện trong danh sách app của chat mới.
3 · Chạy tool đầu tiên
- Mở ChatGPT trong app
Chọn ChatGPT trên thanh điều hướng. Tạo chat mới và chọn app Coworker nếu ChatGPT yêu cầu.
- Gửi lệnh kiểm tra
Dùng Coworker gọi workbench_status, liệt kê workspace và task, sau đó bind vào task đang mở. - Duyệt thao tác
Nếu đang ở chế độ Hỏi trước, thanh duyệt xuất hiện trong app. Xem phạm vi rồi bấm Cho phép hoặc từ chối.
- Kiểm tra phía app
Mục Hoạt động ghi lại tool call với thời gian. Workspace đã bind vào chat.
Khi gặp lỗi
| Triệu chứng | Nguyên nhân thường gặp | Xử lý |
|---|---|---|
| ChatGPT không thấy app Coworker | Tunnel chưa chạy / app chưa install | Kiểm tra trạng thái tunnel ở Kết nối; install lại app trong ChatGPT |
| Tunnel báo "Lỗi" | Sai Runtime API key, tunnel đã xóa trên Platform, hoặc mạng chặn | Tạo key mới, nhập đè; kiểm tra tunnel còn tồn tại trên Platform |
| Tool call treo không trả | MCP server chưa bật, hoặc app Coworker đang tắt | Bật lại MCP ở mục Kết nối rồi gửi lại lệnh |
Bước tiếp theo
- Multi-account — thêm tài khoản và chọn profile sử dụng
- Multi-tunnel — mỗi tài khoản một tunnel, chạy song song
- Bảo mật & kiến trúc — credential mã hóa thế nào, dữ liệu đi đường nào
Coworker