> For the complete documentation index, see [llms.txt](https://docs.incogniton.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incogniton.com/documentation/vietnamese-documentation/api-tu-dong-va-sdks/connect-ai-clients-mcp.md).

# Kết nối khách hàng AI với MCP

Tạo mã thông báo MCP trong Cài đặt → Tự động hóa và kết nối Claude Desktop, Claude Code, Cursor, Windsurf, VS Code hoặc Codex CLI với tài khoản Incogniton của bạn.

Mở **Cài đặt** trong menu bên trái, nhấp vào tab **Tự động hóa** và nhấp vào **Tạo mã thông báo MCP**. Sau đó chọn khách hàng AI của bạn dưới **Cài đặt trong khách hàng AI của bạn** và nhấp vào **Sao chép cấu hình**.

MCP (Giao thức Ngữ cảnh Mô hình) cho phép một khách hàng AI như Claude, Cursor hoặc VS Code làm việc với tài khoản Incogniton của bạn. Bạn có thể yêu cầu nó tìm, tạo hoặc chỉnh sửa hồ sơ, quản lý proxy, nhóm và thẻ, và khởi chạy hoặc dừng hồ sơ.

Kết nối chạy thông qua gói npm `@incogniton/mcp`. Khách hàng AI của bạn khởi động nó với `npx`, vì vậy bạn cần [Node.js](https://nodejs.org/) 18 hoặc mới hơn trên máy tính nơi khách hàng AI chạy.

### Tạo mã thông báo MCP của bạn

{% stepper %}
{% step %}

#### Mở tab Tự động hóa

Nhấp vào **Cài đặt** trong menu bên trái, sau đó nhấp vào tab **Tự động hóa**. Cuộn đến phần **mã thông báo MCP**.
{% endstep %}

{% step %}

#### Tạo mã thông báo

Nhấp vào **Tạo mã thông báo MCP**. Mã thông báo mới xuất hiện trong một trường bên dưới nút.
{% endstep %}

{% step %}

#### Sao chép và lưu trữ

Nhấp vào **Sao chép** bên cạnh mã thông báo và lưu trữ nó ở nơi an toàn, ví dụ như trong trình quản lý mật khẩu. Incogniton chỉ hiển thị mã thông báo một lần: **Cảnh báo: Bạn không thể lấy lại mã thông báo này sau — sao chép và lưu trữ nó ngay bây giờ.**
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Xử lý mã thông báo MCP như một mật khẩu. Bất kỳ ai có nó đều có thể quản lý hồ sơ của tài khoản của bạn. Không bao giờ chia sẻ nó hoặc dán nó vào một tệp công khai.
{% endhint %}

### Thay thế hoặc thu hồi mã thông báo của bạn

Bạn có một mã thông báo MCP hoạt động tại một thời điểm. Nhấp vào **Tạo mã thông báo MCP** lần nữa sẽ tạo ra một mã thông báo mới và làm cho mã cũ ngừng hoạt động. Cập nhật mã thông báo trong mọi khách hàng AI bạn đã kết nối.

Để dừng tất cả truy cập, nhấp vào **Thu hồi** dưới **Mã thông báo hoạt động**. Khi không có mã thông báo nào hoạt động, phần này sẽ hiển thị **Không có mã thông báo hoạt động**.

### Thêm Incogniton vào khách hàng AI của bạn

Dưới **Cài đặt trong khách hàng AI của bạn**, mở danh sách thả xuống **Khách hàng AI** và chọn khách hàng của bạn: Claude Desktop, Claude Code, Cursor, Windsurf, VS Code hoặc Codex CLI. Incogniton hiển thị một cấu hình sẵn sàng để dán với mã thông báo mới của bạn đã được điền sẵn, và cho bạn biết nơi để dán nó. Nhấp vào **Sao chép cấu hình**, dán nó vào nơi ứng dụng chỉ định, và khởi động lại khách hàng AI.

Tạo mã thông báo trước. Nếu bạn mở danh sách này sau, cấu hình sẽ chứa `YOUR_MCP_TOKEN` thay vì mã thông báo: thay thế nó bằng mã thông báo bạn đã lưu trữ.

Để cài đặt thủ công trong các khách hàng MCP khác, xem [tài liệu máy chủ MCP](https://api-docs.incogniton.com/mcp).

### Khách hàng AI có thể làm gì thông qua MCP

Sau khi bạn kết nối, khách hàng AI của bạn có thể:

* **Hồ sơ:** tìm kiếm, tạo, chỉnh sửa và sao chép hồ sơ, và tra cứu các nhóm, thẻ, proxy và ngôn ngữ trình duyệt bạn có thể sử dụng cho một hồ sơ mới.
* **Nhóm và thẻ:** tìm kiếm và tạo nhóm hồ sơ và thẻ.
* **Proxy:** tìm kiếm và thêm proxy, và tìm kiếm và tạo nhóm proxy.
* **Đội ngũ:** tra cứu thành viên đội ngũ.
* **Khởi chạy và dừng:** xem máy tính nào có thể khởi chạy một hồ sơ, khởi chạy một hồ sơ, kiểm tra xem một lần khởi chạy hoặc dừng có thành công không, và dừng một hồ sơ.
* **Điện thoại đám mây:** liệt kê điện thoại đám mây của bạn, tạo một điện thoại đám mây với một proxy từ Thư viện Proxy của bạn, và bắt đầu hoặc dừng điện thoại đám mây. Điện thoại bắt đầu thông qua MCP bắt đầu mà không có màn hình.

Danh sách công cụ đầy đủ có trong [tài liệu máy chủ MCP](https://api-docs.incogniton.com/mcp).

### Cách khởi chạy hoạt động thông qua MCP

Một hồ sơ luôn mở trong ứng dụng Incogniton trên một trong các máy tính của bạn. Máy tính đó phải mở ứng dụng và đăng nhập vào tài khoản của bạn.

* Nếu một máy tính có sẵn, hồ sơ sẽ khởi chạy ở đó. Nếu có nhiều máy tính, khách hàng AI sẽ nhận danh sách máy tính và bạn chọn một cái.
* Yêu cầu khởi chạy mà không có máy tính nào nhận trong vòng 5 phút sẽ hết hạn.
* MCP chỉ có thể dừng các hồ sơ đã được khởi chạy thông qua MCP. Đóng một hồ sơ bạn đã mở từ ứng dụng Incogniton.

### Kiểm soát trình duyệt sau khi khởi chạy MCP

Bản thân MCP chỉ mở và đóng hồ sơ. Nó không thể nhấp, gõ hoặc đọc các trang bên trong trình duyệt.

Sau khi khởi chạy, khách hàng AI có thể nhận một địa chỉ DevTools cục bộ (`cdp_url`) của trình duyệt đang chạy. Một khách hàng AI có thể chạy mã có thể kết nối Puppeteer, Playwright hoặc một trình duyệt MCP đến địa chỉ đó.

{% hint style="info" %}
`cdp_url` chỉ hoạt động khi khách hàng AI chạy trên **cùng một máy tính** với ứng dụng Incogniton đã khởi chạy hồ sơ. Nó không hoạt động từ một máy tính khác, hoặc từ một khách hàng không thể chạy mã, như Claude Desktop. Nó cũng cần **Cho phép điều khiển từ xa trình duyệt** được bật trong tab Tự động hóa. Xem [Điều khiển từ xa trình duyệt](https://docs.incogniton.com/documentation/vietnamese-documentation/api-tu-dong-va-sdks/browser-remote-control.md).
{% endhint %}

### Những gì MCP không thể làm

Những hành động này không có sẵn thông qua MCP:

* Mở một URL, quản lý tab hoặc đọc các trang trong một hồ sơ đang chạy.
* Kiểm tra xem một proxy có hoạt động không.
* Xóa hồ sơ.
* Khôi phục một hồ sơ từ bản sao lưu.

Cas, trợ lý AI bên trong ứng dụng Incogniton, có thể làm những điều này. Mở Cas trong ứng dụng để sử dụng chúng.

### Khắc phục sự cố

* **Khách hàng không hiển thị công cụ Incogniton:** khởi động lại khách hàng AI sau khi bạn dán cấu hình, và kiểm tra rằng Node.js 18 hoặc mới hơn đã được cài đặt.
* **Nhật ký MCP của khách hàng hiển thị "thiếu mã thông báo bearer":** mã thông báo bị thiếu trong cấu hình. Dán mã thông báo của bạn vào vị trí của `YOUR_MCP_TOKEN`.
* **Lỗi xác thực:** mã thông báo đã được thay thế hoặc thu hồi. Tạo một mã mới và cập nhật cấu hình.

Đối với các kịch bản chạy trên máy tính của bạn, bạn cũng có thể sử dụng [API REST cục bộ](https://docs.incogniton.com/documentation/vietnamese-documentation/api-tu-dong-va-sdks/local-rest-api.md) hoặc [SDK JavaScript và Python](https://docs.incogniton.com/documentation/vietnamese-documentation/api-tu-dong-va-sdks/javascript-and-python-sdk.md).
