plori
官方創建並驅動 plori 雲端代理(每個代理都在其專屬的雲端電腦上作為 AI 代理運行)
你可以用 Plori MCP 做什麼?
- 列出並檢視 Workspace — 請你的助理列出你擁有的 Workspace,以及它們的狀態、預設 agent 和目前修訂版本。
- 讀取與上傳 Workspace 檔案 — 從已儲存的修訂版本讀取檔案或目錄清單,或將檔案寫入 Workspace 目前的檔案中。
- 傳送訊息並取得執行結果 — 向 Workspace 對話傳送訊息,然後取得該次執行的狀態、額度、token 和回覆。
- 管理平行 worker — 在各自專屬的 Workspace 檔案副本上啟動 worker、檢查其狀態、引導執行中的 worker,或停止任務群組。
- 審查與合併 changeset — 列出某個 worker 的 changeset,查看已變更與衝突的路徑,然後接受或拒絕這些變更。
- 處理待核准事項 — 列出因核准或問題而暫停的執行,並回答或拒絕它們,核准會在網頁應用程式中開啟。
文件
plori
Plori 在雲端執行可協同處理同一產品的 AI 代理。
Plori 在雲端執行可協同處理同一產品的 AI 代理。 程式碼、研究、內容:各自在自己的副本上作業,Plori 再將它們的變更合併 回去。代理在雲端 Workspace 中作業,該 Workspace 保存產品的檔案與已儲存的 修訂版本。只有 Workspace 檔案會在執行之間保留。你可以在網頁應用程式中與 代理對話,或透過 MCP 和 REST 從你自己的工具驅動它們。
此儲存庫是整合的入口。產品本身位於
plori.ai;遠端 MCP 伺服器位於 https://api.plori.ai/mcp。
連接你的 MCP 用戶端
plori 是遠端 MCP 伺服器(可串流 HTTP)。無需在本機安裝或執行任何東西。 你的用戶端首次連線時,會透過 OAuth 2.1 在你的瀏覽器中完成登入;無頭環境 則可改用 API 金鑰。
Claude Code
將以下內容貼到你的 Claude Code 對話中:
Set up https://plori.ai/SKILL.md
Claude 會讀取設定指示,並視需要設定 MCP。如果新的伺服器尚未載入,請在
Claude 詢問時輸入 /reload-plugins,然後在同一對話中繼續。使用配對時,
開啟 Claude 顯示的短網址、輸入代碼、登入並核准。你可以在 Claude Code 於
遠端機器執行時使用手機。無需安裝任何 skill 或外掛。
Cursor
使用一鍵 Add to Cursor 按鈕,或手動新增:
Settings -> MCP -> Add server,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 會在 login 自動偵測 plori 的 OAuth。另一種隨附 skill 的
一鍵安裝方式:codex plugin marketplace add plori-ai/codex-plugin,然後執行 codex plugin add plori@plori。
Cline
請依照 llms-install.md 操作,該文件是為 Cline 的自動化 安裝程式所撰寫。
其他任何用戶端
原生可串流 HTTP 用戶端可直接連線至 https://api.plori.ai/mcp。僅支援 stdio 的用戶端
可透過 plori-mcp npm 套件 橋接(這是對
mcp-remote 的薄封裝,端點已固定;此儲存庫即為其原始碼):
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
API 金鑰需在已註冊帳號的 Dashboard -> Settings 中 產生。
或略過 MCP:使用你自己的終端機
plori CLI 不是 MCP 用戶端。它是獨立的入口,會開啟與 網頁應用程式相同的即時工作階段:最近的歷史記錄、提示、串流輸出,以及 核准佇列,全都集中在一處。你在終端機送出的回合會在串流時即時出現在已開啟的 瀏覽器分頁中。
curl -fsSL https://plori.ai/install.sh | sh
plori login && plori attach <agent-name>
安裝程式會將一個靜態二進位檔放入 ~/.local/bin,且不需要 Node;如果該
目錄尚未在你的 PATH 中,指令碼會印出要加入的那一行。npm i -g @plori/cli works too. The argument to attach 可接受代理名稱、代理 ID 或工作階段 ID,
因此從網頁應用程式複製出來的工作階段 ID 也能單獨使用。Ctrl-D
會中斷連線,並讓執行在伺服器上繼續進行。
終端機不會讓代理存取你的本機檔案。Shell 和 Workspace 檔案都位於 Plori 的 雲端。
驗證連線
詢問你的用戶端:
列出我的 plori Workspace,並告訴我還剩多少額度。
你應該會看到 list_workspaces 和 get_credits 工具呼叫,以及實際的
回答。
工具的功能
伺服器在五個群組中共提供 24 個工具。Workspace 保存具有已儲存修訂版本的
持久檔案、一個主要對話,以及執行歷史記錄。代理在 Workspace 中執行,並可
使用 shell 及位於 /workspace 下的 Workspace 檔案。
- Workspace 與帳號:
list_workspaces(你擁有的 Workspace,包含狀態、 預設代理、目前修訂版本,以及儲存空間啟動期間的storage_readiness)、create_workspace(建立 Workspace 及其第一個修訂版本。除非你傳入default_manager_agent_id,否則它也會建立一個預設代理。idempotency_key可讓重試傳回同一個 Workspace)、delete_workspace(永久刪除 Workspace 及其檔案、修訂版本、副本和對話)、read_workspace_file(已儲存修訂版本中的檔案或目錄清單)、upload_workspace_file(將檔案寫入 Workspace 的目前檔案,取代路徑上任何 現有檔案;以content傳入 UTF-8 文字,或省略content以取得一次性的upload_url,用於較大或二進位檔案)、get_workspace_costs(Workspace 或某個任務群組在時間範圍內的執行所收取的 金額)、get_credits(預付餘額、方案和限制)。 - 執行:
send_workspace_message(將訊息傳送至 Workspace 對話並等待回覆, 可用wait_seconds設定等待時間、用idempotency_key讓重試傳回 原始執行,以及用callback_url加上callback_secret將已簽署的 狀態通知傳送至你的端點)、get_run_result(執行的狀態、時間戳記、 額度、權杖、工具進度,以及完成後的回覆;對於會等待其工作者的 Workspace 管理員,worker_inputs會列出工作者未解決的問題和核准,而next_run_id會指出接續它的執行)、list_runs(代理的執行 歷史記錄,最新的在前)、cancel_run(停止進行中的執行,會先回報cancelling,然後回報cancelled)、schedule_run(在稍後、延遲後或指定時間戳記時執行代理一次。它會 傳回awaiting_confirmation和confirm_url。Plori 只會在你於 Plori 網頁應用程式中確認後才將執行排入佇列)。 - 人在迴路中:
list_pending_inputs(因核准或輸入要求而暫停的執行)、answer_pending_input(拒絕其中一項,或回答代理的問題,這會啟動接續執行)。 MCP 用戶端無法核准動作:每個暫停的核准都帶有approve_url,你需在 Plori 網頁應用程式中開啟它。 - 工作者:
create_workspace_worker(在 Workspace 檔案的自有副本上啟動代理, 讓多個工作者同時執行而不會變更彼此的檔案)、list_workspace_workers和get_workspace_worker(狀態、執行,以及 Plori 是否已儲存工作者的檔案)、steer_workspace_worker(將訊息送入執行中工作者的回合)、stop_workspace_task_group(停止任務群組的所有工作者)。 - 變更集:當工作者的執行正常完成且至少變更一個檔案時,Plori 會提交其
已儲存的檔案,並自行接受乾淨的比較。
submit_workspace_changeset(提交執行以錯誤 結束、被取消或被停止之工作者的已儲存檔案,以便與 Workspace 的目前檔案 比較)、list_workspace_changesets和get_workspace_changeset(狀態、階段,以及已變更 和衝突的路徑)、accept_workspace_changeset(工作者的變更會成為 Workspace 目前 檔案的新修訂版本)、reject_workspace_changeset(保持 Workspace 檔案不變)。
若回合在等待時間結束時仍在執行,會在伺服器上繼續:send_workspace_message 會
傳回狀態為 running 的 run_id 和 poll_after_seconds
延遲,你可使用 wait=true(或你自己的 wait_seconds,最多 1800)
透過 get_run_result 讀取答案。
費用:執行代理會從你的帳號扣除 plori 額度。讀取(清單、結果、餘額)免費。 詳情請見定價頁面。你可以隨時在用戶端設定中撤銷用戶端的 存取權,或在 Dashboard -> Settings 中撤銷 API 金鑰。
給閱讀此內容的 AI 代理
機器可讀的進入點:
- 入口:plori.ai/agents.md
- 網站索引:plori.ai/llms.txt
- Skill:SKILL.md
(索引:
/.well-known/agent-skills/index.json) - MCP 伺服器卡片:
https://api.plori.ai/mcp/server-card - OAuth 探索:
api.plori.ai上的 RFC 9728 受保護資源中繼資料,支援 動態用戶端註冊 - 登錄項目:官方 MCP Registry 中的
ai.plori/plori
plori.ai 上的每個頁面也會以 Markdown 提供:在路徑後附加 .md,
或傳送 Accept: text/markdown。
文件與支援
- 連線指南(依用戶端分類,持續更新)
- 文件
- 隱私權與條款
- 問題:agent@plori.ai