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。

文件與支援