用途

Plopino MCP 是一个面向 Plopino 的 MCP 服务器，目标是让 AI 智能体把它刚构建出来的内容直接发布出去，并交回一个公开链接，用户全程不必接触浏览器。可发布的对象包括单个页面、单个文件，或整个文件夹（按原有目录结构上传）。

主要能力

一键发布：通过命令行或 MCP 工具把内容发布到公开 URL。
文档优先渲染：Word（doc/docx）、Excel（xls/xlsx）和 Markdown 会渲染为可读页面；代码和数据文件获得语法高亮预览；图片和视频内嵌显示。接收方打开链接即可查看，无需下载文件。
文件夹上传：目录上传会递归遍历，并跳过 .git、.env*、node_modules、.ssh、.aws 和符号链接；其他文件会被包含。明确单独选中的单个文件按请求上传，符号链接输入会被拒绝。
原地更新：发布工具接受可选的 update_url，传入先前发布返回的链接后，该页面内容被替换而链接保持不变（需要令牌）。
匿名发布：默认匿名，无需账号、配置或 API 密钥。返回的链接是公开的；不带令牌时页面保留一个月，带令牌则永久保存并可原地更新。
认领链接：匿名创建会返回 claimUrl，这是给发布者的私密浏览器链接，自行打开并登录后确认认领，即可把该页面保留在账户中。不要把它附加到公开 URL 或分享给页面查看者。JSON 输出中以 claimUrl 字段给出；人类可读输出在 CLI 发布时打印到 stderr，在智能体发布时包含在 MCP 工具结果内。

使用方式

认证（可选）

设置 PLOPINO_TOKEN 后，发布会归入你的账户，而不是匿名发布。可获得私密看板、保持同一链接的更新，并且不受匿名频率限制。可在 plopino.com/b 创建令牌，面板会给出已带令牌的现成命令（服务器保留加密副本，可随时回来取）。不设置令牌是受支持的配置，并非降级状态；大多数用户从不需要令牌。

CLI 发布

CLI 用一条命令发布。login 会提示输入邮箱和隐藏的密码；如无账号需先在网站创建。登录会认领使用该 CLI 已保存身份完成的匿名上传，报告认领数量，并保存会话供后续上传使用。已存在的 PLOPINO_TOKEN 会覆盖已保存会话用于发布。仅使用 Google/GitHub 登录的账号，后续上传需使用 API 令牌；CLI 密码登录要求账号具有密码。

Cookie 按服务器源存放在 ~/.config/plopino/ 下，文件权限仅所有者可读。可用 PLOPINO_CONFIG_DIR 覆盖目录。保留该目录可保留认领匿名上传的能力。密码从不存储。登出会撤销会话，但保留匿名身份。浏览器会话与 MCP 会话相互独立：仅在网站登录不会认领 CLI 上传。

非交互式登录使用 login --email you@example.com --password-stdin，通过标准输入从密钥管理器提供密码；不要把密码作为命令行参数传入。--json 给出结构化结果和错误；错误以状态 1 退出。默认发布只把 URL 写到 stdout，状态写到 stderr。

CLI 同一服务器的命令不能并发运行；强制终止进程后，下一条命令会在没有命令运行时识别并移除任何过期锁。

npm 发布前的开发阶段，把示例中的 npx -y plopino 替换为 node /path/to/boards/mcp/index.js。

MCP 客户端接入

任何支持 stdio MCP 的客户端都可使用——服务器是一个普通 stdio 进程，客户端之间唯一的差别是注册方式。以下均为各客户端自身文档中的形式（2026-09 验证）。出现 plp_xxx 处粘贴来自 plopino.com/b 的令牌；该面板会代为填入并允许选择客户端。如果客户端不想运行本地进程，可改用远程端点——工具相同，只需一个 URL。

Codex（CLI 与 IDE 扩展共用 ~/.codex/config.toml）
WorkBuddy：~/.workbuddy/mcp.json（Windows 为 %USERPROFILE%\.workbuddy\mcp.json；需要 WorkBuddy 5.3+），然后重启 WorkBuddy
Cursor：同样的 JSON 放在 .cursor/mcp.json（项目）或 ~/.cursor/mcp.json（全局）
Windsurf：同样的 JSON 放在 ~/.codeium/windsurf/mcp_config.json
Claude Desktop：同样的 JSON 放在 claude_desktop_config.json
VS Code：同样的思路放在 .vscode/mcp.json，但键是 servers，不是 mcpServers

没有 npm？服务器也在网站上以单个自包含文件提供，两行代替一行，无需安装。"$HOME/…" 会在粘贴时由你的 shell 展开，因此注册的是绝对路径——这一点很重要：MCP 客户端会从任意工作目录启动服务器，相对路径会失效。

之后只需请求：“publish this to Plopino”或“give me a link for that page”。

远程端点（无需安装）

以上都在你的机器上运行。另外还有一个托管的 Streamable HTTP 端点提供相同工具，供支持远程 MCP 服务器、不愿运行本地进程的客户端使用。任何接受远程服务器 URL 的客户端都用同一地址。认证方式相同：有令牌则发送 Authorization: Bearer plp_xxx，没有则匿名发布。

与 stdio 版本有两处刻意差异：

远程不提供 publish_path。它取的是服务器运行所在机器上的路径，而远程时那不是你的机器。请改用 publish_files 发送内容。
端点是 stateless 的：每个请求独立处理，没有需要保持的会话。

自托管/本地

服务器默认发布到 https://plopino.com。设置 PLOPINO_BASE_URL 可指向另一个实例——暂存主机或你自己的部署。

适用场景

让 AI 智能体构建完页面或文档后立即发布并给出可分享链接。
把包含代码、数据、图片、视频或 Word/Excel/Markdown 的文件夹原样发布为可浏览页面。
需要长期保留链接并原地更新内容的场景（使用令牌）。
不想安装本地进程时，通过远程端点接入。

限制与注意事项

匿名上传按 IP 由服务端限流。
publish_path 会递归遍历目录并跳过符号链接——跟随符号链接可能逃逸目录树并上传机器上其他位置的文件。
在调用工具之前不会上传任何内容；服务器启动时不做网络 I/O。
Node 20 或更新版本（MCP TypeScript SDK v2 要求）。唯一运行时依赖是 MCP SDK。
远程端点不支持 publish_path。
stdout 是 MCP 协议通道，写入任何非 JSON-RPC 消息都会破坏客户端；所有日志必须写到 stderr。
已验证的客户端配置形式为 2026-09，且官方 MCP 注册表中列为 io.github.plopino/plopino-mcp，Smithery 上也可作为可安装包。
要完整测试发布路径，可运行一个 Plopino 实例并通过 stdio 驱动服务器对接它。

隐私与保留

完整政策见 https://plopino.com/privacy。

收集内容：仅为发布所需——传给工具的文件内容和文件名、目标 URL，以及匿名发布时的请求 IP 地址（用于每日限流）。MCP 服务器本身不收集任何内容、不发送遥测；它本地运行且只写 stderr。
使用与存储：上传内容存储在 Plopino 服务器上，并从返回的公开链接提供。PLOPINO_TOKEN 存储在本地 MCP 客户端配置中；服务器只保留其 SHA-256 哈希。
第三方：不向第三方出售、共享或发送内容与使用数据用于广告。Plopino 使用 Cloudflare 作为 CDN/反向代理，使用自托管 Umami 做聚合、无 Cookie 的访问计数。
保留期限：匿名上传在 30 天后删除；也可更早从账户页面移除链接。使用令牌的上传会保留，直到你删除或账户关闭。请求删除或举报滥用请联系 abuse@plopino.com。
联系：abuse@plopino.com（滥用与隐私请求），或 https://plopino.com/abuse。

plopino-mcp

工具介绍

用途