plori

官方

创建并驱动 plori 云代理(每个都是运行在自有云计算机上的 AI 代理)

你可以用 Plori MCP 做什么?

  • 列出并检查 Workspace — 让助手列出你拥有的 Workspace,以及它们的状态、默认 agent 和当前修订版本。
  • 读取和上传 Workspace 文件 — 从已保存的修订版本中读取文件或目录列表,或将文件写入 Workspace 的当前文件。
  • 发送消息并获取运行结果 — 向 Workspace 会话发送消息,然后获取该次运行的状态、credits、tokens 和回复。
  • 管理并行 worker — 在各自独立的 Workspace 文件副本上启动 worker,检查其状态,引导正在运行的 worker,或停止任务组。
  • 审查并合并 changeset — 列出某个 worker 的 changeset,查看已更改和存在冲突的路径,然后接受或拒绝这些更改。
  • 处理待审批项 — 列出因审批或问题而暂停的运行,并对其进行回答或拒绝,审批将在 Web 应用中打开。

文档

plori

Plori 在云端运行协作开发同一款产品的 AI 智能体。

Plori 在云端运行协作开发同一款产品的 AI 智能体。 代码、研究、内容:每个智能体都在自己的副本上工作,Plori 再将它们的改动合并 回去。智能体在云端 Workspace 中工作,该 Workspace 保存产品的文件及已保存的 修订版本。只有 Workspace 文件会在多次运行之间持久保留。你可以在 Web 应用中 与智能体对话,也可以通过 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 客户端。它是 一个独立的入口,打开的是与 Web 应用相同的实时会话:最近 历史、提示符、流式输出和审批队列都在一处。你在终端中发送的一轮对话 会在流式传输时出现在打开的浏览器标签页中。

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,因此从 Web 应用中复制的会话 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 的当前文件,替换 该路径上的任何文件;将 UTF-8 文本作为 content 传入,或对于较大或二进制文件 省略 content 以获取一次性 upload_url)、 get_workspace_costs(在时间窗口内,某个 Workspace 或某个 任务组的运行所收取的金额)、get_credits(预付余额、套餐和限制)。
  • 运行:send_workspace_message(向 Workspace 对话发送消息并 等待回复,使用 wait_seconds 设置保持时长,使用 idempotency_key 使重试返回原始运行,并使用 callback_url 加 callback_secret 向你的端点发送签名状态通知)、get_run_result(一次运行的状态、 时间戳、额度、token、工具进度,以及完成后的回复;对于等待其 worker 的 Workspace 管理器,worker_inputs 列出 worker 的未决问题和审批,next_run_id 指明 继续它的运行)、list_runs(智能体的运行历史,最新在前)、cancel_run (停止进行中的运行,它会报告 cancelling,然后报告 cancelled)、 schedule_run(在延迟之后或某个时间戳稍后运行一次智能体。它 返回 awaiting_confirmation 和一个 confirm_url。Plori 仅在你于 Plori Web 应用中 确认后才会将运行加入队列)。
  • 人在回路:list_pending_inputs(因审批或 输入请求而暂停的运行)、answer_pending_input(拒绝某个请求,或回答智能体的问题, 这会启动一次继续运行)。MCP 客户端无法批准操作:每个 暂停的审批都带有一个 approve_url,你在 Plori Web 应用中打开它。
  • Worker:create_workspace_worker(在 Workspace 文件的独立副本上启动智能体, 因此多个 worker 可以同时运行而不会更改彼此的 文件)、list_workspace_workers 和 get_workspace_worker(状态、运行, 以及 Plori 是否保存了 worker 的文件)、steer_workspace_worker(向 正在运行的 worker 的回合发送消息)、stop_workspace_task_group(停止某个任务组的 所有 worker)。
  • 变更集:当 worker 的运行正常完成并至少更改一个 文件时,Plori 会提交其已保存的文件并自行接受一次干净的比较。 submit_workspace_changeset(提交运行以错误结束、被取消或被停止的 worker 的已保存文件, 以便与 Workspace 的当前文件进行比较)、list_workspace_changesets 和 get_workspace_changeset(状态、阶段,以及已更改和冲突的路径)、 accept_workspace_changeset(worker 的更改作为新修订版本成为 Workspace 的当前 文件)、reject_workspace_changeset(保持 Workspace 文件 原样)。

保持时间结束时仍在运行的一轮对话会在服务器上继续: send_workspace_message 返回一个状态为 running 的 run_id 以及一个 poll_after_seconds 延迟,你使用 get_run_result 和 wait=true(或你自己的 wait_seconds,最多 1800)读取答案。

费用:运行智能体会从你的账户中消耗 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。

文档与支持