plori
chính thứcTạo và điều khiển các tác nhân đám mây plori (mỗi tác nhân là một AI agent trên máy tính đám mây riêng của nó)
Bạn có thể làm gì với Plori MCP?
- Liệt kê và kiểm tra Workspace — Yêu cầu trợ lý liệt kê các Workspace bạn sở hữu cùng với trạng thái, tác nhân mặc định và bản sửa đổi hiện tại.
- Đọc và tải tệp Workspace lên — Đọc một tệp hoặc danh sách thư mục từ một bản sửa đổi đã lưu, hoặc ghi tệp vào các tệp hiện tại của Workspace.
- Gửi tin nhắn và nhận kết quả chạy — Gửi tin nhắn đến cuộc trò chuyện trong Workspace, sau đó lấy trạng thái, tín dụng, token và câu trả lời của lượt chạy.
- Quản lý các worker song song — Khởi chạy worker trên các bản sao tệp Workspace riêng, kiểm tra trạng thái, điều hướng worker đang chạy hoặc dừng một nhóm tác vụ.
- Xem xét và hợp nhất changeset — Liệt kê các changeset của worker, xem những đường dẫn đã thay đổi và bị xung đột, sau đó chấp nhận hoặc từ chối các thay đổi.
- Xử lý các yêu cầu phê duyệt đang chờ — Liệt kê các lượt chạy đang tạm dừng để chờ phê duyệt hoặc câu hỏi, rồi trả lời hoặc từ chối; các yêu cầu phê duyệt sẽ được mở trong ứng dụng web.
Tài liệu
plori
Plori chạy các tác nhân AI cộng tác trên cùng một sản phẩm trên đám mây.
Plori chạy các tác nhân AI cộng tác trên cùng một sản phẩm trên đám mây. Mã, nghiên cứu, nội dung: mỗi tác nhân làm việc trên bản sao riêng, rồi Plori hợp nhất các thay đổi của họ trở lại. Các tác nhân làm việc trong một Workspace trên đám mây, nơi lưu giữ các tệp của sản phẩm cùng các bản sửa đổi đã lưu. Chỉ các tệp trong Workspace được duy trì giữa các lần chạy. Bạn trò chuyện với các tác nhân trong ứng dụng web hoặc điều khiển chúng bằng công cụ của riêng bạn qua MCP và REST.
Kho lưu trữ này là cổng tích hợp. Bản thân sản phẩm nằm tại
plori.ai; máy chủ MCP từ xa nằm tại https://api.plori.ai/mcp.
Kết nối ứng dụng MCP của bạn
plori là máy chủ MCP từ xa (HTTP có thể truyền luồng). Không cần cài đặt hay chạy cục bộ. Lần đầu ứng dụng của bạn kết nối, bạn sẽ đăng nhập trong trình duyệt qua OAuth 2.1; môi trường không có giao diện có thể dùng khóa API thay thế.
Claude Code
Dán nội dung này vào cuộc trò chuyện Claude Code:
Thiết lập https://plori.ai/SKILL.md
Claude đọc hướng dẫn thiết lập và cấu hình MCP nếu cần. Nếu máy chủ mới
chưa được tải, hãy nhập /reload-plugins khi Claude hỏi, rồi tiếp tục trong cùng
cuộc trò chuyện. Với quy trình ghép nối, hãy mở địa chỉ ngắn Claude hiển thị, nhập mã,
đăng nhập và chấp thuận. Bạn có thể dùng điện thoại trong khi Claude Code chạy trên máy từ xa.
Không cần cài đặt skill hay plugin.
Cursor
Dùng nút Thêm vào Cursor để thêm bằng một cú nhấp, hoặc tự thêm:
Settings -> MCP -> Add server với URL https://api.plori.ai/mcp.
VS Code
code --add-mcp '{"name":"plori","type":"http","url":"https://api.plori.ai/mcp"}'
Codex CLI
codex mcp add plori --url https://api.plori.ai/mcp
codex mcp login plori
Codex tự phát hiện OAuth của plori tại login. Phương án thay thế cài đặt một lần, có kèm skill:
codex plugin marketplace add plori-ai/codex-plugin rồi codex plugin add plori@plori.
Cline
Làm theo llms-install.md, tài liệu được viết cho trình cài đặt tự động của Cline.
Mọi ứng dụng khác
Các ứng dụng hỗ trợ HTTP truyền luồng gốc kết nối trực tiếp tới https://api.plori.ai/mcp. Các ứng dụng
chỉ hỗ trợ stdio có thể kết nối qua cầu nối bằng gói npm plori-mcp
(một lớp bọc mỏng quanh mcp-remote với điểm cuối được cố định; kho lưu trữ này là mã nguồn của gói):
npx plori-mcp
# headless / CI: authenticate with an API key instead of the OAuth flow
npx plori-mcp --header "Authorization: Bearer plori_sk_..."
# equivalent, without the wrapper:
npx mcp-remote https://api.plori.ai/mcp
Khóa API được tạo trong Dashboard -> Settings trên tài khoản đã đăng ký.
Hoặc bỏ qua MCP: dùng terminal của riêng bạn
plori CLI không phải là ứng dụng MCP. Đây là một cổng riêng, mở cùng phiên trực tiếp mà ứng dụng web hiển thị: lịch sử gần đây, lời nhắc, đầu ra truyền trực tiếp và hàng đợi phê duyệt ở cùng một nơi. Lượt bạn gửi trong terminal sẽ xuất hiện trong tab trình duyệt đang mở khi nội dung được truyền trực tiếp.
curl -fsSL https://plori.ai/install.sh | sh
plori login && plori attach <agent-name>
Trình cài đặt đặt một tệp nhị phân tĩnh duy nhất vào ~/.local/bin và không cần Node; nếu
thư mục đó chưa có trong PATH, tập lệnh sẽ in dòng lệnh cần thêm. npm i -g @plori/cli works too. The argument to attach là tên tác nhân, ID tác nhân hoặc
ID phiên, vì vậy ID phiên sao chép từ ứng dụng web có thể dùng độc lập. Ctrl-D
ngắt kết nối và để lượt chạy tiếp tục trên máy chủ.
Terminal không cấp cho tác nhân quyền truy cập vào các tệp cục bộ của bạn. Shell và các tệp Workspace nằm trên đám mây của Plori.
Xác minh kết nối
Hãy hỏi ứng dụng của bạn:
Liệt kê các Workspace plori của tôi và cho biết tôi còn bao nhiêu credit.
Bạn sẽ thấy các lệnh gọi công cụ list_workspaces và get_credits cùng câu trả lời thực tế.
Các công cụ làm gì
Máy chủ cung cấp 24 công cụ thuộc năm nhóm. Workspace lưu các tệp bền vững cùng
các bản sửa đổi đã lưu, một cuộc trò chuyện chính và lịch sử chạy. Tác nhân chạy trong Workspace
với shell và các tệp Workspace tại /workspace.
- Workspace và tài khoản:
list_workspaces(các Workspace bạn sở hữu, cùng trạng thái, tác nhân mặc định, bản sửa đổi hiện tại vàstorage_readinesstrong khi bộ nhớ đang khởi tạo),create_workspace(một Workspace với bản sửa đổi đầu tiên. Trừ khi bạn truyềndefault_manager_agent_id, thao tác này cũng tạo một tác nhân mặc định.idempotency_keygiúp lần thử lại trả về cùng Workspace),delete_workspace(xóa vĩnh viễn một Workspace cùng các tệp, bản sửa đổi, bản sao và cuộc trò chuyện của nó),read_workspace_file(một tệp hoặc danh sách thư mục trong bản sửa đổi đã lưu),upload_workspace_file(ghi một tệp vào các tệp hiện tại của Workspace, thay thế mọi tệp tại đường dẫn đó; truyền văn bản UTF-8 dưới dạngcontent, hoặc bỏ quacontentđể dùngupload_urlmột lần cho tệp lớn hơn hoặc tệp nhị phân),get_workspace_costs(khoản phí cho các lượt chạy của Workspace hoặc của một nhóm tác vụ trong một khoảng thời gian),get_credits(số dư trả trước, gói và giới hạn). - Lượt chạy:
send_workspace_message(gửi tin nhắn đến cuộc trò chuyện trong Workspace và chờ phản hồi, vớiwait_secondsđể đặt thời gian chờ,idempotency_keyđể lần thử lại trả về lượt chạy ban đầu, vàcallback_urlcùngcallback_secretđể gửi thông báo trạng thái có chữ ký đến điểm cuối của bạn),get_run_result(trạng thái, dấu thời gian, credit, token, tiến độ công cụ và phản hồi của một lượt chạy sau khi hoàn tất; với trình quản lý Workspace chờ các tác nhân phụ,worker_inputsliệt kê các câu hỏi đang chờ và yêu cầu phê duyệt của tác nhân phụ, cònnext_run_idnêu tên lượt chạy tiếp tục công việc đó),list_runs(lịch sử chạy của một tác nhân, mới nhất trước),cancel_run(dừng lượt chạy đang diễn ra, thao tác này báocancellingrồi đếncancelled),schedule_run(chạy một tác nhân một lần vào thời điểm sau, sau một khoảng trễ hoặc tại một mốc thời gian. Thao tác này trả vềawaiting_confirmationvà mộtconfirm_url. Plori chỉ xếp lượt chạy vào hàng đợi sau khi bạn xác nhận trong ứng dụng web Plori). - Có người tham gia trong quy trình:
list_pending_inputs(các lượt chạy đang tạm dừng để chờ phê duyệt hoặc yêu cầu nhập thông tin),answer_pending_input(từ chối một yêu cầu hoặc trả lời câu hỏi của tác nhân, thao tác này bắt đầu một lượt chạy tiếp nối). Ứng dụng MCP không thể phê duyệt hành động: mỗi yêu cầu phê duyệt đang tạm dừng đều có mộtapprove_urlmà bạn mở trong ứng dụng web Plori. - Tác nhân phụ:
create_workspace_worker(khởi chạy một tác nhân trên bản sao riêng của các tệp Workspace, để nhiều tác nhân phụ chạy đồng thời mà không thay đổi tệp của nhau),list_workspace_workersvàget_workspace_worker(trạng thái, lượt chạy và việc Plori đã lưu tệp của tác nhân phụ hay chưa),steer_workspace_worker(gửi tin nhắn vào lượt chạy của tác nhân phụ đang hoạt động),stop_workspace_task_group(dừng mọi tác nhân phụ thuộc một nhóm tác vụ). - Tập thay đổi: khi lượt chạy của tác nhân phụ hoàn tất bình thường và thay đổi ít nhất một
tệp, Plori gửi các tệp đã lưu của tác nhân đó và tự chấp nhận nếu so sánh không phát hiện xung đột.
submit_workspace_changeset(gửi các tệp đã lưu của tác nhân phụ có lượt chạy kết thúc do lỗi, bị hủy hoặc bị dừng để so sánh với các tệp hiện tại của Workspace),list_workspace_changesetsvàget_workspace_changeset(trạng thái, giai đoạn, các đường dẫn đã thay đổi và xung đột),accept_workspace_changeset(các thay đổi của tác nhân phụ trở thành các tệp hiện tại của Workspace trong một bản sửa đổi mới),reject_workspace_changeset(giữ nguyên các tệp Workspace).
Lượt chạy vẫn đang hoạt động khi hết thời gian chờ sẽ tiếp tục trên máy chủ:
send_workspace_message trả về một run_id có trạng thái running và
độ trễ poll_after_seconds; bạn đọc câu trả lời bằng get_run_result với
wait=true (hoặc wait_seconds của riêng bạn, tối đa 1800).
Chi phí: chạy tác nhân sẽ tiêu tốn credit plori trong tài khoản của bạn. Đọc (danh sách, kết quả, số dư) là miễn phí. Trang giá có thông tin chi tiết. Bạn có thể thu hồi quyền truy cập của ứng dụng bất cứ lúc nào trong phần cài đặt của ứng dụng đó, hoặc thu hồi khóa API trong Dashboard -> Settings.
Dành cho tác nhân AI đọc tài liệu này
Các điểm truy cập có thể đọc bằng máy:
- Cổng chính: plori.ai/agents.md
- Chỉ mục trang: plori.ai/llms.txt
- Skill: SKILL.md
(chỉ mục:
/.well-known/agent-skills/index.json) - Thẻ máy chủ MCP:
https://api.plori.ai/mcp/server-card - Khám phá OAuth: siêu dữ liệu tài nguyên được bảo vệ theo RFC 9728 tại
api.plori.ai, hỗ trợ đăng ký ứng dụng khách động - Mục đăng ký:
ai.plori/ploritrong MCP Registry chính thức
Mọi trang trên plori.ai cũng được cung cấp dưới dạng Markdown: thêm .md vào đường dẫn hoặc gửi
Accept: text/markdown.
Tài liệu và hỗ trợ
- Hướng dẫn kết nối (theo từng ứng dụng, luôn được cập nhật)
- Tài liệu
- Quyền riêng tư và điều khoản
- Câu hỏi: agent@plori.ai