Tác nhân AI (MCP)
Zinn® Chat cho các tác nhân AI
Trang web WordPress của bạn đóng vai trò là máy chủ MCP của riêng nó. Một trợ lý AI đăng nhập với tư cách là người dùng WordPress bằng mật khẩu ứng dụng và có thể thực hiện những gì người dùng đó được phép làm với Zinn® Chat — không hơn không kém.
36 hành động: 21 miễn phí, 15 trong Pro.
Hướng dẫn tương tự trong cơ sở kiến thức của chúng tôi, với mọi thao tác miễn phí được liệt kê
Thiết lập trong ba bước
Kiểm tra công tắc
Bạn cần WordPress 6.9 trở lên và Zinn® Chat 2.9.0 trở lên. Trong phần cài đặt của plugin, "Allow AI agents (MCP)" được bật trừ khi bạn đã tắt nó.
Tạo mật khẩu ứng dụng
Trong WordPress, hãy mở Người dùng, sau đó chọn Hồ sơ và thêm một mật khẩu ứng dụng được đặt tên theo ứng dụng AI của bạn. Hãy sao chép mật khẩu đó: WordPress chỉ hiển thị một lần duy nhất.
Thêm trang web vào ứng dụng AI của bạn
Sử dụng tên người dùng WordPress của bạn, mật khẩu ứng dụng và địa chỉ kết nối trang web của bạn:
https://example.com/wp-json/zinn-chat/v1/mcp
Cấu hình cho các ứng dụng AI phổ biến
Mọi ứng dụng dưới đây đều kết nối với trang web của bạn thông qua proxy chính thức của WordPress, @automattic/mcp-wordpress-remote. Hãy thay thế địa chỉ, tên người dùng và mật khẩu bằng thông tin của bạn.
Claude Desktop
// claude_desktop_config.json
{
"mcpServers": {
"zinn-chat": {
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/zinn-chat/v1/mcp",
"WP_API_USERNAME": "your-username",
"WP_API_PASSWORD": "your-application-password"
}
}
}
}Claude Code
claude mcp add zinn-chat \
-e WP_API_URL=https://example.com/wp-json/zinn-chat/v1/mcp \
-e WP_API_USERNAME=your-username \
-e WP_API_PASSWORD=your-application-password \
-- npx -y @automattic/mcp-wordpress-remote@latestCon trỏ
// .cursor/mcp.json
{
"mcpServers": {
"zinn-chat": {
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/zinn-chat/v1/mcp",
"WP_API_USERNAME": "your-username",
"WP_API_PASSWORD": "your-application-password"
}
}
}
}VS Code
// .vscode/mcp.json — VS Code's key is "servers"
{
"servers": {
"zinn-chat": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/zinn-chat/v1/mcp",
"WP_API_USERNAME": "your-username",
"WP_API_PASSWORD": "your-application-password"
}
}
}
}Ứng dụng khác
Bất kỳ ứng dụng nào hỗ trợ các máy chủ MCP qua đầu vào và đầu ra tiêu chuẩn đều có thể sử dụng cùng một lệnh và cài đặt. Các ứng dụng chỉ kết nối với máy chủ HTTP từ xa có thể truy cập trực tiếp vào địa chỉ kết nối bằng cùng tên người dùng và mật khẩu ứng dụng. ChatGPT là ngoại lệ hiện tại: nó chỉ kết nối với các máy chủ MCP bằng cách đăng nhập OAuth, do đó không thể sử dụng mật khẩu ứng dụng.
Tác nhân AI có thể làm gì
Mọi tính năng mà các màn hình riêng của plugin có thể thực hiện. Các thao tác được đánh dấu Pro cần có giấy phép Zinn® Chat Pro.
| Thao tác | Chức năng | Phiên bản |
|---|---|---|
| Trả lời ticket | Trả lời khách hàng qua email (text) hoặc thêm ghi chú nội bộ (note: true); trạng thái tùy chọn thay đổi trạng thái của yêu cầu hỗ trợ. | Bản miễn phí |
| Hỏi trợ lý | Đặt câu hỏi cho trợ lý AI của trang web và trả về câu trả lời cùng với mọi nguồn mà nó tìm thấy. | Bản miễn phí |
| Thay đổi nhiều phiếu hỗ trợ cùng lúc (Pro) | Thay đổi trạng thái, mức độ ưu tiên hoặc người được giao của tối đa 100 ticket (id). Mỗi ticket đều trải qua các bước kiểm tra giống như khi thay đổi riêng lẻ; kết quả sẽ liệt kê từng ticket một. | Bản Pro |
| Biến cuộc trò chuyện thành một phiếu hỗ trợ | Mở một yêu cầu hỗ trợ từ cuộc trò chuyện để có thể trả lời qua email (cần có địa chỉ email của khách truy cập). | Bản miễn phí |
| Đóng một đoạn chat | Kết thúc một cuộc trò chuyện; khách truy cập vẫn có thể yêu cầu bản ghi. | Bản miễn phí |
| Gửi yêu cầu hỗ trợ | Mở một phiếu hỗ trợ thay mặt cho khách hàng (email, tiêu đề và tin nhắn đầu tiên của họ). | Bản miễn phí |
| Xóa câu trả lời đã lưu (Pro) | Xóa một phản hồi đã lưu. | Bản Pro |
| Xóa vé hỗ trợ | Xóa vĩnh viễn một phiếu hỗ trợ và cuộc trò chuyện của phiếu đó (chỉ dành cho quản lý). | Bản miễn phí |
| Soạn một bài viết trợ giúp từ một phiếu hỗ trợ (Pro) | Viết một bài viết nháp trên cơ sở kiến thức từ một phiếu hỗ trợ đã được giải quyết; bài viết sẽ giữ nguyên trạng thái nháp cho đến khi được con người xuất bản. | Bản Pro |
| Soạn thảo bài viết trợ giúp cho các câu hỏi chưa có câu trả lời (Pro) | Viết các bài viết nháp trong cơ sở tri thức để trả lời các câu hỏi đã chọn (ids); các bài viết này vẫn giữ nguyên trạng thái nháp. | Bản Pro |
| Điền câu trả lời đã lưu (Pro) | Trả về nội dung của một câu trả lời đã lưu với các chỗ giữ chỗ đã được điền cho một cuộc trò chuyện hoặc phiếu hỗ trợ. | Bản Pro |
| Đọc cuộc trò chuyện | Trả về tin nhắn và thông tin chi tiết của khách truy cập cho một đoạn chat (after: chỉ lấy các tin nhắn mới hơn ID này). | Bản miễn phí |
| Đọc tổng quan hỗ trợ | Trả về số lượng vé trong mỗi trạng thái, số lượng đoạn chat đang chờ nhân viên (cùng với tin nhắn chưa đọc của họ), và trạng thái bật/tắt của đoạn chat, trợ lý ảo và vé hỗ trợ. | Bản miễn phí |
| Đọc cài đặt trò chuyện | Trả về mọi cài đặt trò chuyện: tiện ích, trợ lý, con người và giờ mở cửa, phiếu hỗ trợ và email, chỉ mục trang web, quyền riêng tư và thư rác. | Bản miễn phí |
| Xem thống kê hỗ trợ (Pro) | Trả về số lượng cuộc trò chuyện và phiếu hỗ trợ, thời gian phản hồi và đánh giá cho N ngày qua (ngày). | Bản Pro |
| Đọc phiếu hỗ trợ | Trả về một phiếu hỗ trợ kèm theo toàn bộ cuộc trò chuyện, trạng thái, mức độ ưu tiên và người được phân công. | Bản miễn phí |
| Chuyển lại đoạn chat cho trợ lý | Trả lại một cuộc trò chuyện cho trợ lý AI, trả lời khách truy cập từ nội dung của trang web. | Bản miễn phí |
| Danh sách câu trả lời đã lưu (Pro) | Liệt kê các câu trả lời đã lưu mà nhân viên hỗ trợ có thể chèn vào, kèm theo phím tắt của chúng. | Bản Pro |
| Liệt kê trò chuyện trực tiếp | Liệt kê các cuộc trò chuyện đang chờ, đang diễn ra và mới đóng, kèm theo người xử lý từng cuộc. | Bản miễn phí |
| Liệt kê những gì trợ lý biết | Liệt kê nội dung mà trợ lý dùng để trả lời, cùng với trạng thái chỉ mục của nội dung đó, theo từng trang một. | Bản miễn phí |
| Liệt kê các câu hỏi chưa được trả lời (Pro) | Liệt kê các câu hỏi mà khách truy cập đã đặt ra nhưng cơ sở kiến thức không thể trả lời. | Bản Pro |
| Danh sách phiếu hỗ trợ | Liệt kê các ticket hỗ trợ, được lọc theo trạng thái hoặc tìm kiếm, từng trang một. | Bản miễn phí |
| Xây dựng lại chỉ mục tìm kiếm của trợ lý | Xây dựng lại các vectơ tìm kiếm cho một mục (item_id) hoặc toàn bộ (all: true) (chỉ dành cho người quản lý). | Bản miễn phí |
| Đọc lại nội dung cho trợ lý | Đọc lại một mục (item_id) hoặc toàn bộ (all: true) vào chỉ mục của trợ lý (chỉ dành cho người quản lý). | Bản miễn phí |
| Trả lời trong một cuộc trò chuyện | Gửi tin nhắn tới khách truy cập (text) hoặc chỉ thêm một ghi chú nội bộ mà các nhân viên mới thấy (note: true). | Bản miễn phí |
| Lưu câu trả lời đã lưu (Pro) | Tạo hoặc thay đổi một câu trả lời đã lưu (tiêu đề, phím tắt, nội dung, phòng ban; id để thay đổi một câu). | Bản Pro |
| Viết bài viết trợ giúp (Pro) | Tạo một bài viết cơ sở kiến thức hoặc sửa đổi một bài viết (id): tiêu đề, nội dung, đoạn trích, danh mục và trạng thái (bản nháp, hoặc xuất bản khi bạn có thể xuất bản). | Bản Pro |
| Tìm kiếm cơ sở kiến thức (Pro) | Tìm các bài viết trợ giúp để liên kết trong câu trả lời (q: nội dung tìm kiếm). | Bản Pro |
| Đặt bộ phận và thẻ cho cuộc trò chuyện (Pro) | Thiết lập phòng ban và các thẻ của cuộc trò chuyện hoặc phiếu hỗ trợ (loại: cuộc trò chuyện hoặc phiếu hỗ trợ; id). | Bản Pro |
| Đánh dấu các câu hỏi chưa trả lời (Pro) | Đánh dấu các câu hỏi chưa được trả lời là đang mở, đã lên kế hoạch hoặc đã bỏ qua (id, trạng thái). | Bản Pro |
| Đặt trạng thái sẵn sàng của bạn | Đánh dấu tác viên đã đăng nhập là có sẵn hoặc vắng mặt cho các đoạn chat mới (vắng mặt: true hoặc false). | Bản miễn phí |
| Soạn thảo câu trả lời bằng AI (Pro) | Soạn thảo bản nháp trả lời cho đoạn chat hoặc phiếu hỗ trợ từ nội dung của trang web; không có nội dung nào được gửi đi. | Bản Pro |
| Tóm tắt cuộc trò chuyện với AI (Pro) | Tóm tắt cuộc trò chuyện hoặc phiếu hỗ trợ trong vài dòng. | Bản Pro |
| Mở cuộc trò chuyện | Gán một đoạn chat đang chờ cho nhân viên đã đăng nhập, để khách truy cập có thể trò chuyện với một người thật. | Bản miễn phí |
| Thay đổi cài đặt trò chuyện | Thay đổi các cài đặt bạn gửi (cài đặt: khóa tương ứng với giá trị) và giữ nguyên các cài đặt còn lại. Mỗi giá trị được kiểm tra chính xác như trên màn hình cài đặt; get-settings liệt kê các khóa. | Bản miễn phí |
| Đổi một yêu cầu hỗ trợ | Thay đổi trạng thái, mức độ ưu tiên hoặc người được giao của một phiếu hỗ trợ. | Bản miễn phí |
An toàn theo thiết kế
Mỗi hành động kiểm tra quyền WordPress giống như màn hình của chính plugin đối với trang hoặc bài viết chính xác mà nó tác động. Một người đăng ký (subscriber) hoàn toàn không thể kết nối.
Bạn có thể thu hồi mật khẩu ứng dụng bất cứ lúc nào trong mục Người dùng, Hồ sơ mà không cần thay đổi mật khẩu thông thường của mình.
Tắt "Cho phép các tác tử AI (MCP)" và các hành động cũng như địa chỉ kết nối sẽ biến mất khỏi trang web.
Các trang do một tác nhân thay đổi vẫn giữ lại các bản chỉnh sửa WordPress của chúng, vì vậy mọi thay đổi đều có thể được hoàn tác.
Được lưu trữ cùng Zinn Digital®?
Nếu Zinn Digital® lưu trữ trang web, máy chủ MCP của chúng tôi có thể sử dụng các thao tác này cho bạn mà không cần mật khẩu ứng dụng: kết nối ứng dụng AI của bạn với máy chủ MCP của Zinn Digital® và sử dụng wordpress_abilities_list cùng wordpress_ability_run.