# Kết nối Agent AI với Tự Động Sale

Source: https://wiki.tudongsale.com/agent-ai/ket-noi

Cập nhật: 2026-10-04

> Dán địa chỉ MCP `https://api.tudongsale.com/mcp` vào ứng dụng Agent AI rồi đăng nhập Tự Động Sale để cho phép, hoặc tạo API key cho công cụ dòng lệnh và luồng tự động. Hai cách cùng một bộ lệnh, cùng một chỗ thu hồi.

## Cần chuẩn bị gì trước khi kết nối?

Để kết nối Agent AI, bạn cần:

- tài khoản Tự Động Sale đăng nhập được ở [app.tudongsale.com](https://app.tudongsale.com);
- địa chỉ MCP của Tự Động Sale, chép đúng từng ký tự, không thêm dấu `/` ở cuối:

```text
https://api.tudongsale.com/mcp
```

Địa chỉ này cũng hiện trong trang [Kết nối Agent AI](https://app.tudongsale.com/settings/ket-noi-agent) (menu Tài khoản & Thanh toán), kèm nút sao chép.

## Kết nối claude.ai thế nào?

1. Trong claude.ai, mở **Settings → Connectors** và chọn **Add custom connector**.
2. Đặt tên (ví dụ Tự Động Sale) và dán `https://api.tudongsale.com/mcp` vào ô URL, rồi bấm **Add**.
3. Bấm **Connect**: claude.ai mở trang đồng ý của Tự Động Sale. Đăng nhập nếu được hỏi, xem lại quyền rồi bấm **Cho phép**.
4. Trình duyệt quay về claude.ai; connector hiện đã kết nối và Agent AI thấy danh sách lệnh của Tự Động Sale.

## Kết nối ChatGPT thế nào?

1. Trong ChatGPT, mở **Settings → Apps & Connectors**. Nếu chưa thấy nút tạo connector, bật **Developer mode** trong mục **Advanced settings**.
2. Chọn **Create**, đặt tên, dán `https://api.tudongsale.com/mcp` vào ô MCP server URL và chọn xác thực **OAuth**.
3. ChatGPT mở trang đồng ý của Tự Động Sale: đăng nhập nếu được hỏi, xem lại quyền rồi bấm **Cho phép**.
4. Mở một cuộc trò chuyện mới và bật connector Tự Động Sale để Agent AI dùng các lệnh.

## Kết nối Claude Code thế nào?

Thêm Tự Động Sale làm MCP server qua HTTP:

```bash
claude mcp add --transport http tudongsale https://api.tudongsale.com/mcp
```

Trong phiên Claude Code, gõ `/mcp`, chọn `tudongsale` rồi chọn đăng nhập: trình duyệt mở trang đồng ý của Tự Động Sale, bạn bấm **Cho phép** là xong.

Muốn dùng API key thay cho đăng nhập (ví dụ trên máy chủ không có trình duyệt), tạo key theo mục dưới rồi thêm server kèm header:

```bash
claude mcp add --transport http tudongsale https://api.tudongsale.com/mcp --header "Authorization: Bearer <API_KEY>"
```

## Dùng API key cho công cụ tự động thế nào?

1. Mở trang [Kết nối Agent AI](https://app.tudongsale.com/settings/ket-noi-agent), bấm **Tạo API key**, đặt tên để nhận ra key và chọn quyền.
2. Chép key ngay: key chỉ hiện đúng một lần. Mất key thì thu hồi và tạo key mới.
3. Gửi mọi request MCP (JSON-RPC qua HTTP POST, không cần phiên) tới `https://api.tudongsale.com/mcp` kèm header `Authorization: Bearer <API_KEY>`.

Key chưa có, sai hay đã thu hồi thì Tự Động Sale trả `401` kèm header `WWW-Authenticate` trỏ tới thông tin đăng nhập OAuth của địa chỉ MCP.

## Màn đồng ý hỏi những gì?

Màn đồng ý hiện tên ứng dụng xin kết nối, nhãn **Đã xác minh** hoặc **Ứng dụng chưa xác minh**, địa chỉ bạn sẽ được chuyển về sau khi đồng ý, và các quyền ứng dụng xin:

- **Đọc** — luôn đi kèm;
- **Sửa dữ liệu** — cập nhật CRM, sửa chủ đề, tạo bản nháp chiến dịch chờ bạn duyệt;
- **Ra lệnh máy** — bật hoặc tạm dừng thu thập trên chủ đề.

Ứng dụng chưa xác minh chỉ được tích sẵn quyền Đọc; muốn cấp thêm, bạn tự tích. Chỉ bấm **Cho phép** khi chính bạn vừa bấm kết nối trong ứng dụng Agent AI của mình. Ý nghĩa từng quyền theo mức hậu quả: [Bậc hậu quả](/agent-ai/bac-hau-qua).

## Làm mới danh sách lệnh trong ứng dụng thế nào?

Ứng dụng Agent AI giữ danh sách lệnh từ lần kết nối trước. Khi Tự Động Sale thêm lệnh mới hoặc ngừng một lệnh cũ, làm mới kết nối để Agent AI thấy đúng danh sách hiện tại:

- ChatGPT: mở connector Tự Động Sale và bấm **Refresh**.
- claude.ai: ngắt connector Tự Động Sale rồi kết nối lại.
- Claude Code: mở một phiên mới.

## Thu hồi một kết nối thế nào?

Trang [Kết nối Agent AI](https://app.tudongsale.com/settings/ket-noi-agent) liệt kê mọi API key và ứng dụng đã kết nối, quyền, lần dùng cuối và các lệnh gần nhất. Bấm thu hồi ở một kết nối (hoặc ở cả một ứng dụng) là lần gọi kế tiếp của nó bị từ chối ngay.

Thu hồi chỉ xảy ra khi bạn bấm: đổi mật khẩu hay đăng xuất mọi thiết bị không tự thu hồi kết nối Agent AI. Khi đã có quá nhiều kết nối, thu hồi một kết nối không còn dùng rồi kết nối lại.