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 thao tác miễn phí được liệt kê

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"
      }
    }
  }
}

Ứ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ácChức năngPhiên bản
Trả lời ticketTrả 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 chatKế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ệnTrả 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ệnTrả 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ếpLiệ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ế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 đó, 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ệnGử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ệnGá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ệ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í
Đổ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.

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