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 hành động 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"
}
}
}
}Claude và ChatGPT (đăng nhập)
Thêm địa chỉ kết nối dưới dạng trình kết nối tùy chỉnh trong Claude hoặc dưới dạng máy chủ MCP tùy chỉnh trong ChatGPT. Chúng sẽ mở trang web của bạn để bạn có thể phê duyệt với tư cách là người dùng WordPress mà không cần sao chép mật khẩu ứng dụng. Trang web của bạn cần có liên kết tĩnh đẹp mắt.
Ứng dụng khác
Bất kỳ ứng dụng nào hỗ trợ 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 một tên người dùng và mật khẩu ứng dụng.
Những gì một tác tử AI có thể làm
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.
| Hành động | Chức năng | Phiên bản |
|---|---|---|
| Trả lời yêu cầu hỗ trợ | 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 yêu cầ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 vé (id). Mỗi vé đề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 vé một. | Bản Pro |
| Biến đoạn chat thành một phiếu hỗ trợ | Mở một yêu cầu hỗ trợ từ đoạn chat để 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 cuộc trò chuyện | Kết thúc một đoạn chat; 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 câu trả lời đã lưu. | Bản Pro |
| Xóa một phiếu hỗ trợ | Xóa vĩnh viễn một phiếu hỗ trợ và toàn bộ cuộc trò chuyện của phiếu đó (chỉ dành cho quản lý). | Bản miễn phí |
| Soạn thảo 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 ticket đã được giải quyết; bài viết sẽ giữ ở trạng thái nháp cho đến khi có 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 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); chúng vẫn ở trạng thái nháp. | Bản Pro |
| Điền câu trả lời đã lưu (Pro) | Trả về văn bản của một câu trả lời đã lưu với các trình giữ chỗ của nó được điền cho một đoạn chat 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 phiên trò chuyện (after: chỉ bao gồm 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 từng trạng thái và số lượng cuộc trò chuyện đang chờ nhân viên (cùng với tin nhắn chưa đọc của họ), cũng như trạng thái bật/tắt của cuộc trò chuyện, trợ lý ảo và vé. | Bản miễn phí |
| Đọc cài đặt trò chuyện | Trả về tất cả các cài đặt trò chuyện: tiện ích, trợ lý, mọi 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í |
| Đọc 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 một 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 cuộc trò chuyện lại cho trợ lý | Trả lại một cuộc trò chuyện cho trợ lý AI, phản hồi khách truy cập bằng nội dung của trang web. | Bản miễn phí |
| Hiển thị 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 |
| Danh sách trò chuyện trực tiếp | Liệt kê các cuộc trò chuyện đang chờ, đang diễn ra và vừa đóng, cùng với người đang xử lý từng cuộc trò chuyện đó. | 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 đó, 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 yêu cầu hỗ trợ | Liệt kê các yêu cầu 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 vào 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í |
| Phản hồi trong cuộc trò chuyện | Gửi tin nhắn cho khách truy cập (text) hoặc thêm ghi chú nội bộ mà chỉ điện tín viên mới nhìn 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 trả lời). | Bản Pro |
| Viết một bài viết trợ giúp (Pro) | Tạo bài viết cơ sở kiến thức hoặc thay đổi 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ẻ của 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ợ (kiểu: chat hoặc ticket; 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 cuộc trò chuyện 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 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 đoạn chat hoặc yêu cầu hỗ trợ trong vài dòng. | Bản Pro |
| Bắt đầu trò chuyện | Gán cuộc trò chuyện đ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í |
| Thay đổi vé 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.