Plori

plori

Plori 在云端运行 AI Agent，让它们协作打造同一款产品。

Plori 在云端运行 AI Agent，让它们协作打造同一款产品。 代码、研究、内容：每个 Agent 都在自己的副本上工作，Plori 会将它们的更改 合并回来。Agent 在云端工作区中运行，产品文件及其保存的修订版本都保存在其中。只有工作区文件会在多次运行之间保留。你可以在 Web 应用中与 Agent 对话，也可以通过 MCP 和 REST 使用自己的工具来驱动它们。

此代码仓库是集成入口。产品本身位于 plori.ai；远程 MCP 服务位于 https://api.plori.ai/mcp。

连接 MCP 客户端

plori 是一个远程 MCP 服务（可流式传输的 HTTP）。无需在本地安装或运行任何内容。客户端首次连接时，会通过 OAuth 2.1 在浏览器中完成登录；无头环境则可以使用 API 密钥。

Claude Code

将以下内容粘贴到 Claude Code 对话中：

设置 https://plori.ai/SKILL.md

Claude 会读取设置说明，并在需要时配置 MCP。如果新服务尚未加载，请在 Claude 提示时输入 /reload-plugins，然后继续在同一对话中操作。使用配对登录时，打开 Claude 显示的短地址，输入代码，登录并批准。Claude Code 在远程机器上运行时，你也可以使用手机。无需安装技能或插件。

Cursor

使用一键式 添加到 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。另一种只需安装一次的方式是使用捆绑技能：先运行 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 package 桥接（这是一个固定了端点的轻量级 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

注册账户后，可在 Dashboard -> Settings 中生成 API 密钥。

或跳过 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 也可以使用。attach 的参数可以是 Agent 名称、Agent ID 或会话 ID，因此从 Web 应用复制的会话 ID 可以直接使用。按 Ctrl-D 会断开连接，但服务器上的运行会继续。

终端不会让 Agent 访问你的本地文件。Shell 和工作区文件都位于 Plori 云端。

验证连接

向客户端提问：

列出我的 plori 工作区，并告诉我还剩多少积分。

你应该会看到 list_workspaces 和 get_credits 工具调用，以及真实的回答。

工具的作用

服务提供 24 个工具，分为五组。工作区包含可持久保存的文件及其已保存的修订版本、一个主对话和运行历史记录。Agent 在工作区中运行，并可使用 Shell 以及 /workspace 下的工作区文件。

• 工作区和账户：list_workspaces（列出你拥有的工作区，以及其状态、默认 Agent、当前修订版和存储启动期间的 storage_readiness），create_workspace（创建一个包含首个修订版的工作区。除非传入 default_manager_agent_id，否则还会创建一个默认 Agent。idempotency_key 可确保重试时返回同一个工作区），delete_workspace（永久删除工作区及其文件、修订版、副本和对话），read_workspace_file（读取已保存修订版中的文件或目录列表），upload_workspace_file（将文件写入工作区当前文件，在指定路径替换已有文件；通过 content 传入 UTF-8 文本，或省略 content，以获取用于较大文件或二进制文件的一次性 upload_url），get_workspace_costs（查询某个时间范围内工作区或某个任务组运行所产生的费用），get_credits（查询预付余额、套餐和限额）。
• 运行：send_workspace_message（向工作区对话发送消息并等待回复；使用 wait_seconds 设置等待时长，使用 idempotency_key 确保重试时返回原始运行，使用 callback_url 和 callback_secret 向你的端点发送带签名的状态通知），get_run_result（查询运行的状态、时间戳、积分、令牌、工具进度，以及运行完成后的回复；对于等待其工作线程的工作区管理 Agent，worker_inputs 会列出工作线程待解答的问题和待审批事项，next_run_id 会标明后续运行的 ID），list_runs（列出 Agent 的运行历史，按时间从近到远排列），cancel_run（停止正在进行的运行；状态会先显示为 cancelling，然后变为 cancelled），schedule_run（在延迟一段时间后或指定时间运行一次 Agent。返回 awaiting_confirmation 和 confirm_url。只有在 Plori Web 应用中确认后，Plori 才会将运行加入队列）。
• 人在回路中：list_pending_inputs（列出因等待审批或输入请求而暂停的运行），answer_pending_input（拒绝一项请求，或回答 Agent 的问题；回答后会启动后续运行）。MCP 客户端无法批准操作：每项暂停的审批都会附带一个 approve_url，你需要在 Plori Web 应用中打开该链接。
• 工作线程：create_workspace_worker（在工作区文件的独立副本上启动 Agent，使多个工作线程可同时运行，且不会更改彼此的文件），list_workspace_workers 和 get_workspace_worker（查询状态、运行情况，以及 Plori 是否已保存工作线程的文件），steer_workspace_worker（向正在运行的工作线程发送消息），stop_workspace_task_group（停止某个任务组的所有工作线程）。
• 变更集：工作线程的运行正常完成且至少更改一个文件时，Plori 会提交其已保存的文件，并自动接受无冲突的比较结果。submit_workspace_changeset（提交运行因错误结束、被取消或被停止的工作线程已保存文件，以便与工作区当前文件进行比较），list_workspace_changesets 和 get_workspace_changeset（查询状态、阶段，以及已更改和冲突的路径），accept_workspace_changeset（将工作线程的更改设为工作区当前文件，并创建一个新修订版），reject_workspace_changeset（保留工作区文件现状）。

等待时长结束时仍在运行的轮次会继续在服务端运行：send_workspace_message 会返回状态为 running 的 run_id 和 poll_after_seconds 延迟时间；你可以使用 get_run_result 并设置 wait=true（或自行设置最长为 1800 秒的 wait_seconds）来读取答案。

费用：运行 Agent 会消耗你账户中的 plori 积分。读取信息（列表、结果、余额）免费。详情请参阅定价页面。你可以随时在客户端设置中撤销客户端的访问权限，也可以在 Dashboard -> Settings 中撤销 API 密钥。

写给 AI Agent

机器可读的入口：

• 入口页：plori.ai/agents.md
• 站点索引：plori.ai/llms.txt
• 技能：SKILL.md （索引：/.well-known/agent-skills/index.json）
• MCP 服务卡片：https://api.plori.ai/mcp/server-card
• OAuth 发现：api.plori.ai 上符合 RFC 9728 的受保护资源元数据，支持动态 客户端注册
• 注册表条目：官方 MCP 注册表中的 ai.plori/plori

plori.ai 上的每个页面也都以 Markdown 格式提供：在路径后附加 .md，或发送 Accept: text/markdown。

文档与支持

• 连接指南（针对各客户端，持续更新）
• 文档
• 隐私和条款
• 问题咨询：[email protected]