AI agent (MCP)
Tranzly dành cho các tác tử AI
Trang web WordPress của bạn chính là một máy chủ MCP riêng. 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 Tranzly — không hơn.
73 tác vụ: 53 miễn phí, 20 trong bản Pro.
Tài liệu tham khảo cho nhà phát triển: mọi tác vụ, tuyến REST và các tham số tương ứng
Thiết lập trong ba bước
Kiểm tra nút gạt
Bạn cần WordPress 6.9 trở lên và Tranzly 3.19.0 trở lên. Trong phần cài đặt của plugin, tùy chọn “Cho phép tác nhân AI (MCP)” sẽ được bật trừ khi bạn đã tắt nó.
Tạo mật khẩu ứng dụng
Trong WordPress, mở mục Thành viên, sau đó vào Hồ sơ và thêm mật khẩu ứng dụng được đặt theo tên ứng dụng AI của bạn. Hãy sao chép lại: WordPress chỉ hiển thị mật khẩu này một lần.
Thêm trang web vào ứng dụng AI của bạn
Sử dụng tên người dùng WordPress, mật khẩu ứng dụng và địa chỉ kết nối của trang web:
https://example.com/wp-json/tranzly/v1/mcpCấu hình cho các ứng dụng AI phổ biến
Mỗi ứng dụng dưới đây giao tiếp 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": {
"tranzly": {
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/tranzly/v1/mcp",
"WP_API_USERNAME": "your-username",
"WP_API_PASSWORD": "your-application-password"
}
}
}
}Claude Code
claude mcp add tranzly \
-e WP_API_URL=https://example.com/wp-json/tranzly/v1/mcp \
-e WP_API_USERNAME=your-username \
-e WP_API_PASSWORD=your-application-password \
-- npx -y @automattic/mcp-wordpress-remote@latestCursor
// .cursor/mcp.json
{
"mcpServers": {
"tranzly": {
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/tranzly/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": {
"tranzly": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/tranzly/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 bộ kết nối tùy chỉnh trong Claude, hoặc dưới dạng ứng dụng trong chế độ nhà phát triển của ChatGPT. Chúng sẽ mở trang web của bạn để bạn có thể phê duyệt với tư cách 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 sử dụng đường dẫn tĩnh đẹp (pretty permalinks).
Các ứ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 (stdio) đều có thể sử dụng cùng lệnh và cài đặt này. 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 đó.
Những gì một tác tử AI có thể làm
Mọi thứ mà các giao diện của chính plugin có thể thực hiện. Các tác vụ được đánh dấu Pro yêu cầu giấy phép Tranzly Pro.
Phiên bản Miễn phí
- Hủy tác vụ (Miễn phí) — Dừng một tác vụ; các bản dịch đã hoàn thành vẫn được giữ lại.
- Kết nối với bộ phận hỗ trợ (Miễn phí) — Kết nối trang web này với bộ phận hỗ trợ của Zinn Digital® (tên, email, sự đồng ý).
- Chỉnh sửa bản dịch (Miễn phí) — Lưu các phân đoạn đã sửa của một bản dịch (segments: key sang text); văn bản đã sửa sẽ được bảo vệ không bị dịch lại.
- Bắt đầu tác vụ dịch (Miễn phí) — Khởi chạy một tác vụ nền để dịch các bài viết được liệt kê (posts) hoặc toàn bộ một loại bài viết sang các ngôn ngữ (langs).
- Tạo bản dịch trống (Miễn phí) — Tạo bản dịch nháp của một bài viết bằng một ngôn ngữ (lang) để tự viết thủ công, không dùng công cụ dịch.
- Tạo bản dịch thuật ngữ thủ công (Miễn phí) — Tạo bản dịch của một thuật ngữ bằng một ngôn ngữ với tên, đường dẫn (slug) và mô tả do bạn cung cấp.
- Ngắt kết nối khỏi bộ phận hỗ trợ (Miễn phí) — Ngắt kết nối trang web này khỏi bộ phận hỗ trợ.
- Ước tính bản dịch (Miễn phí) — Ước tính số ký tự và chi phí để dịch các bài viết (posts hoặc post_type) sang các ngôn ngữ (langs) bằng một công cụ dịch, trước khi chi tiêu bất kỳ khoản nào.
- Dịch những mục còn thiếu (Miễn phí) — Đưa vào hàng đợi việc dịch mọi mục còn thiếu (hoặc đã lỗi thời) trong một ngôn ngữ và loại bài viết.
- Xem mức sử dụng DeepL (Miễn phí) — Trả về số ký tự đã sử dụng và giới hạn của khóa DeepL đã lưu trong tháng này.
- Xem chẩn đoán trang web (Miễn phí) — Trả về thông tin chẩn đoán mà một phiếu hỗ trợ thường có: các phiên bản, plugin đang hoạt động, giới hạn và các lỗi gần đây.
- Xem tùy chọn hiển thị (Miễn phí) — Trả về các tùy chọn hiển thị bộ chuyển đổi ngôn ngữ và thông tin ghi nhận.
- Đọc cài đặt công cụ (Miễn phí) — Trả về công cụ mặc định và dự phòng, công cụ và mô hình AI theo từng ngôn ngữ, trạng thái của từng công cụ, các nhà cung cấp AI được kết nối cùng các mô hình của họ và chi tiêu trong tháng này.
- Xem các tích hợp (Miễn phí) — Liệt kê các plugin SEO, WooCommerce, trình dựng trang và biểu mẫu mà Tranzly hỗ trợ cũng như các plugin đang hoạt động tại đây.
- Xem tiến độ tác vụ (Miễn phí) — Trả về tiến độ và các số liệu đếm của một tác vụ.
- Đọc các lỗi của tác vụ (Miễn phí) — Liệt kê các mục bị lỗi của một tác vụ kèm lý do tương ứng.
- Đọc quá trình nhập từ Tranzly 2.x (Miễn phí) — Trả về trạng thái và báo cáo về việc nhập các bản dịch từ Tranzly 2.x.
- Đọc giấy phép (Miễn phí) — Trả về gói Tranzly, trạng thái giấy phép, ngày gia hạn của trang web này và những gì gói bao gồm.
- Đọc menu theo từng ngôn ngữ (Miễn phí) — Trả về menu mà mỗi ngôn ngữ hiển thị tại từng vị trí menu.
- Đọc các bản dịch của bài viết (Miễn phí) — Liệt kê nhóm bản dịch của bài viết: thành viên của từng ngôn ngữ kèm tiêu đề, trạng thái và liên kết chỉnh sửa.
- Đọc bản dịch song song (Miễn phí) — Trả về các phân đoạn của bản dịch bên cạnh bản gốc, để xem xét và chỉnh sửa.
- Đọc văn bản giao diện và plugin (Miễn phí) — Trả về văn bản giao diện và plugin (phạm vi) bằng một ngôn ngữ kèm các bản dịch của chúng.
- Đọc văn bản của trang web bằng một ngôn ngữ (Miễn phí) — Trả về tiêu đề trang web, khẩu hiệu và văn bản widget bằng một ngôn ngữ.
- Đọc kết nối hỗ trợ (Miễn phí) — Cho biết trang web này có được kết nối với bộ phận hỗ trợ của Zinn Digital® hay không, và dưới danh nghĩa ai.
- Đọc các bản dịch của thuật ngữ (Miễn phí) — Liệt kê nhóm bản dịch của một chuyên mục hoặc thẻ.
- Đọc cài đặt địa chỉ (Miễn phí) — Trả về cách các ngôn ngữ hiển thị trong địa chỉ (thư mục, tên miền phụ hoặc tên miền), các đường dẫn tĩnh (slug) và đường dẫn gốc đã dịch, cùng noindex cho các trang chưa dịch.
- Liên kết bài viết hiện có làm bản dịch (Miễn phí) — Đặt một bài viết hiện có (đích) làm bản dịch của bài viết này bằng một ngôn ngữ.
- Liên kết thuật ngữ hiện có làm bản dịch (Miễn phí) — Đặt một thuật ngữ hiện có (đích) làm bản dịch của thuật ngữ này bằng một ngôn ngữ.
- Liệt kê các công cụ dịch (Miễn phí) — Liệt kê các công cụ dịch, trạng thái thiết lập của từng công cụ, và công cụ nào được sử dụng khi không có tên cụ thể.
- Liệt kê các tác vụ dịch (Miễn phí) — Liệt kê các tác vụ dịch nền, mới nhất trước, kèm tiến trình.
- Liệt kê các ngôn ngữ (Miễn phí) — Liệt kê các ngôn ngữ của trang web. Ngôn ngữ đầu tiên là ngôn ngữ của nội dung gốc.
- Liệt kê các mục còn thiếu hoặc lỗi thời (Miễn phí) — Liệt kê các bản gốc kèm trạng thái dịch của chúng bằng một ngôn ngữ (trạng thái: thiếu, lỗi thời, hiện tại), theo từng trang.
- Mở yêu cầu hỗ trợ (Miễn phí) — Gửi yêu cầu hỗ trợ (tiêu đề, tin nhắn, loại, email), kèm chẩn đoán của trang web này khi quản trị viên đồng ý. Không bao giờ tạo thông tin đăng nhập hoặc gửi thông tin đăng nhập.
- Đồng ý gửi chẩn đoán hỗ trợ (Miễn phí) — Ghi nhận sự đồng ý của quản trị viên để gửi thông tin chẩn đoán cùng các yêu cầu hỗ trợ.
- Thử lại hoặc chuyển giao mục bị lỗi (Miễn phí) — Thử lại một mục bị lỗi (hành động: retry, tùy chọn với công cụ khác) hoặc đánh dấu để dịch thủ công (hành động: by-hand).
- Nhập các bản dịch từ Tranzly 2.x (Miễn phí) — Chạy trình nhập 2.x: chạy thử (chỉ báo cáo), chạy thực tế hoặc hoàn tác.
- Lưu khóa công cụ (Miễn phí) — Lưu khóa API (và khu vực đối với Microsoft) của DeepL, Google hoặc Microsoft; để trống sẽ xóa khóa. Các khóa được lưu trữ mã hóa và không bao giờ được trả về.
- Đặt menu theo từng ngôn ngữ (Miễn phí) — Gán một menu cho mỗi ngôn ngữ theo từng vị trí (map).
- Bảo vệ hoặc mở khóa bản dịch (Miễn phí) — Bảo vệ bản dịch không bị công cụ ghi đè (protected: true), hoặc mở khóa bản dịch.
- Sửa văn bản giao diện và plugin (Miễn phí) — Lưu các bản dịch đã sửa của văn bản giao diện và plugin (chuỗi); chúng sẽ được bảo vệ.
- Dịch một văn bản của trang web (Miễn phí) — Lưu một văn bản của trang web (khóa) bằng một ngôn ngữ, ví dụ: tiêu đề hoặc khẩu hiệu của trang web.
- Thay đổi cài đặt địa chỉ (Miễn phí) — Đặt chế độ địa chỉ (mode), tên miền theo ngôn ngữ, các đường dẫn gốc và phân đoạn đã dịch, noindex_untranslated và gợi ý đường dẫn tĩnh (slug).
- Bắt đầu dùng thử Pro miễn phí (Miễn phí) — Bắt đầu dùng thử Tranzly Pro trong 14 ngày cho trang web này (không cần thanh toán).
- Dịch văn bản của hình ảnh (Miễn phí) — Lưu văn bản thay thế (alt), tiêu đề hoặc chú thích (trường) của hình ảnh bằng một ngôn ngữ (lang).
- Dịch một bài viết hoặc trang (Miễn phí) — Dịch một bài viết hoặc trang sang một hoặc nhiều ngôn ngữ của trang web bằng công cụ dịch, tạo mới hoặc cập nhật từng bản dịch. Các bản dịch mới là bản nháp trừ khi publish là true. Bản dịch do con người chỉnh sửa sẽ bị bỏ qua trừ khi force là true.
- Dịch các văn bản giao diện và plugin còn thiếu (Miễn phí) — Dịch trang tiếp theo của các văn bản giao diện và plugin chưa được dịch bằng một ngôn ngữ với công cụ mặc định (lặp lại với after cho đến khi hoàn tất).
- Dịch một chuyên mục hoặc thẻ (Miễn phí) — Dịch một thuật ngữ (chuyên mục, thẻ hoặc thuộc tính sản phẩm) sang một ngôn ngữ (lang) bằng một công cụ, tạo mới hoặc cập nhật bản dịch của nó.
- Trạng thái dịch (Miễn phí) — Khi có ID bài viết: bản dịch của từng ngôn ngữ cho bài viết đó, liệu nó có bị lỗi thời hay không và ai là người viết. Khi không có: mức độ trang web đã được dịch, theo từng ngôn ngữ.
- Hủy liên kết bài viết khỏi các bản dịch của nó (Miễn phí) — Đưa một bài viết ra khỏi nhóm bản dịch của nó; bài viết vẫn giữ nguyên ngôn ngữ của mình.
- Hủy liên kết thuật ngữ khỏi các bản dịch của nó (Miễn phí) — Đưa một thuật ngữ ra khỏi nhóm bản dịch của nó.
- Thay đổi tùy chọn hiển thị (Miễn phí) — Thay đổi bộ chuyển đổi (kiểu dáng, cờ, tên, vị trí) và dòng ghi công.
- Thay đổi cài đặt công cụ (Miễn phí) — Thiết lập công cụ mặc định, công cụ dự phòng, công cụ theo từng ngôn ngữ và mô hình AI theo từng ngôn ngữ (default, fallback, per_lang, models, caps). Mọi thứ ngoại trừ công cụ mặc định đều thuộc bản Pro.
- Thay đổi ngôn ngữ và cài đặt (Miễn phí) — Thiết lập các ngôn ngữ của trang web (languages: danh sách mã và tên; ngôn ngữ đầu tiên là ngôn ngữ gốc), tiền tố lớp (class prefix) giao diện người dùng và việc có cho phép tác nhân AI (MCP) hay không.
Phiên bản Pro
- Dịch toàn bộ trang web (Pro) — Bắt đầu các tác vụ dịch chạy ngầm cho mọi bản gốc của các loại nội dung đã cho (tất cả các loại được dịch khi không chỉ định): các bản dịch còn thiếu, các bản dịch lỗi thời hoặc tất cả chúng. Trả về các tác vụ đã bắt đầu, mỗi tác vụ cho một ngôn ngữ.
- Kiểm tra bản dịch bằng AI (Pro) — Để AI so sánh một bản dịch với bản gốc của nó và chấm điểm, sau đó lưu báo cáo vào bản dịch. Sử dụng mô hình AI kiểm tra chất lượng được đặt trong cài đặt quy trình làm việc của Tranzly.
- Ước tính dịch toàn trang web (Pro) (Pro) — Ước tính chi phí dịch toàn bộ trang web sang một ngôn ngữ (post_types, scope, engine) trước khi bắt đầu.
- Xuất tệp cho biên dịch viên con người (Pro) — Trả về tệp XLIFF hoặc CSV (dưới dạng văn bản) gồm các bản gốc và bản dịch của chúng trong một ngôn ngữ, dành cho biên dịch viên hoặc công ty dịch thuật: các bài viết đã chỉ định, hoặc một trang tối đa 100 bản gốc của một loại nội dung ở một trạng thái (thiếu, cũ, đã dịch hoặc tất cả; lặp lại với after). Có thể nhập lại chính tệp đó sau khi đã dịch.
- Đọc cách xử lý bình luận (Pro) (Pro) — Trả về trạng thái bình luận được chia sẻ giữa các ngôn ngữ hay được giữ riêng cho từng ngôn ngữ.
- Đọc bảng thuật ngữ (Pro) — Trả về các từ không bao giờ dịch, bản dịch thuật ngữ cố định và văn phong cho từng ngôn ngữ.
- Đọc báo cáo chất lượng (Pro) (Pro) — Trả về báo cáo chất lượng AI của bản dịch: điểm số và các phân đoạn được gắn cờ.
- Đọc cài đặt quy trình làm việc (Pro) (Pro) — Trả về tùy chọn tự động dịch khi xuất bản và khi cập nhật, xem xét trước khi xuất bản, cùng với ngưỡng, nhà cung cấp và mô hình kiểm tra chất lượng bằng AI.
- Di chuyển từ WPML, Polylang hoặc TranslatePress (Pro) (Pro) — Nhập trang bản dịch tiếp theo từ một plugin đa ngôn ngữ khác (mode: dry-run hoặc run; cursor).
- Ghi tệp đã nhập (Pro) (Pro) — Ghi trang bài viết tiếp theo từ một tệp dịch đã tải lên (lặp lại với after cho đến khi hoàn tất).
- Liệt kê các plugin để di chuyển dữ liệu (Pro) (Pro) — Liệt kê dữ liệu WPML, Polylang và TranslatePress được tìm thấy trên trang web này có thể nhập được.
- Liệt kê nguồn văn bản của giao diện và plugin (Pro) (Pro) — Liệt kê các giao diện và plugin có văn bản có thể quét để dịch, cùng số lượng chuỗi của mỗi mục.
- Phê duyệt hoặc từ chối bản dịch (Pro) (Pro) — Phê duyệt bản dịch (và xuất bản khi bản gốc được xuất bản) hoặc gửi trả lại (decision, note).
- Quét giao diện hoặc plugin để tìm văn bản (Pro) (Pro) — Quét trang tệp PHP tiếp theo của một thành phần để tìm các văn bản có thể dịch (lặp lại với after cho đến khi hoàn tất).
- Kiểm tra các bản dịch bằng AI (Pro) (Pro) — Lên lịch kiểm tra chất lượng bằng AI cho trang bản dịch tiếp theo của một ngôn ngữ (hoặc các bài viết đã cho).
- Kiểm toán SEO đa ngôn ngữ (Pro) (Pro) — Kiểm tra từng trang của các bản dịch để phát hiện tiêu đề SEO, phần mô tả, đường dẫn (slug) và hreflang bị thiếu trong một ngôn ngữ.
- Thay đổi cách xử lý bình luận (Pro) (Pro) — Chia sẻ bình luận giữa các bản dịch của bài viết hoặc giữ riêng theo từng ngôn ngữ (mode).
- Cập nhật bảng thuật ngữ (Pro) — Thay thế các phần của bảng thuật ngữ mà bạn gửi (các từ không bao giờ dịch, bản dịch thuật ngữ, văn phong); các phần bạn bỏ qua sẽ được giữ nguyên. Được sử dụng bởi mọi công cụ dịch kể từ bản dịch tiếp theo trở đi.
- Thay đổi cài đặt quy trình làm việc (Pro) (Pro) — Thiết lập on_update (off, stale, translate), on_publish, review, quality_threshold, quality_provider và quality_model.
- Nhập tệp đã dịch (Pro) (Pro) — Tải lên tệp XLIFF hoặc CSV của Tranzly (content, filename) đã được dịch ở nơi khác; trả về một token xác định lượt tải lên cho việc nhập.
Quy trình làm việc có hướng dẫn
Máy chủ cũng cung cấp các quy trình làm việc tạo sẵn mà ứng dụng AI của bạn liệt kê dưới dạng câu lệnh nhắc (prompt):
- Dịch trang web của tôi (Miễn phí) — Một quy trình làm việc có hướng dẫn: tác nhân kiểm tra ngôn ngữ và công cụ dịch, ước tính chi phí và dịch những nội dung còn thiếu, có hỏi trước khi trừ phí hoặc xuất bản.
An toàn theo thiết kế
Mỗi hành động đều kiểm tra quyền WordPress tương tự như màn hình riêng của plugin, đối với chính xác trang hoặc bài viết mà nó can thiệp. Người đăng ký hoàn toàn không thể kết nối.
Mật khẩu ứng dụng có thể bị thu hồi bất kỳ lúc nào trong mục Thành viên, Hồ sơ mà không cần thay đổi mật khẩu thông thường của bạn.
Tắt “Cho phép tác nhân AI (MCP)”, các hành động và địa chỉ kết nối sẽ biến mất khỏi trang web.
Các trang được tác nhân thay đổi vẫn lưu giữ các bản sửa đổi WordPress, vì vậy mọi thay đổi đều có thể được hoàn tác.
Được lưu trữ với 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 hành động 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 và wordpress_ability_run.