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.

Tài liệu tham khảo dành cho nhà phát triển: mọi hành động, tuyến REST và các tham số của hành động đó

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ê

Zinn®, người Viking của chúng tôi, đang reo hò khi trợ lý AI kết nối với các công cụ của nền tảng.

Thiết lập trong ba bước

  1. 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ó.

  2. 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.

  3. 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@latest

Con 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 độngChức năngPhiê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ệnKế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ệnTrả 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ệnTrả 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ếpLiệ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ếtLiệ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ệnGử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ệnGá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ệnThay đổ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.

Máy chủ MCP của Zinn Digital®