Plain 是一款面向专注写作与团队协作的协作文档编辑器，供写作者、编辑和内容团队实时创建与打磨文档。
用途 本技能用于与 Plain 集成，管理 Persons、Organizations、Deals、Leads、Activities、Notes 等数据。当用户希望与 Plain 数据进行交互时使用。官方文档：https://www.plain.com/docs/
主要能力 Plain 的相关对象包括：Note、Attachment、Notebook。使用时可按照需要调用相应的操作名称与参数。集成通过 Membrane CLI 完成，Membrane 自动处理认证与凭证刷新，可专注于集成逻辑而非认证管道。
使用方式
-
安装 CLI： npm install -g @membranehq/cli@latest
-
认证： membrane login --tenant --clientName=<agentType> 该命令会打开浏览器进行认证，或在控制台打印授权 URL（取决于是否可用交互模式）。无头环境会打印授权 URL，需用户自行在浏览器中打开，完成登录后使用： membrane login complete <code> 可在任意命令后加 --json 获得机器可读的 JSON 输出。Agent 类型包括 claude、openclaw、codex、warp、windsurf 等，用于针对不同环境调整工具配置。
-
连接 Plain： membrane connection ensure "https://plain.com/" --json 用户在浏览器中完成认证，输出包含新的 connection id。若返回的 connection 状态为 READY，可直接进入下一步。若状态为 BUILDING，则轮询等待： npx @membranehq/cli connection get <id> --wait --json --wait 标志会长时间轮询（最多 --timeout 秒，默认 30）直到状态改变。状态含义：READY 表示连接完全就绪；CLIENT_ACTION_REQUIRED 表示用户或 agent 需要执行操作，clientAction.type 可为 "connect"（需要认证）或 "provide-input"（需要更多信息），clientAction.description 为说明，clientAction.uiUrl 为可选预构建 UI 地址，clientAction.agentInstructions 为可选程序化指引；CONFIGURATION_ERROR 或 SETUP_FAILED 表示出错，需检查 error 字段。
-
搜索操作： membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json 应始终在特定连接的上下文中搜索操作。每条结果包含 id、name、description、inputSchema（接受的参数）与 outputSchema（返回内容）。也可用 npx @membranehq/cli@latest action list --intent=QUERY --connectionId=CONNECTION_ID --json 发现可用操作。
-
运行操作： membrane action run <actionId> --connectionId=CONNECTION_ID --json 传入 JSON 参数： membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json 结果位于响应的 output 字段。
-
代理请求： 当可用操作无法覆盖需求时，可通过 Membrane 代理直接向 Plain API 发送请求。Membrane 会自动为你提供的路径附加基础 URL 并注入正确的认证头，包括凭证过期时的透明刷新： membrane request CONNECTION_ID /path/to/endpoint 常用选项：-X/--method 指定 HTTP 方法（GET、POST、PUT、PATCH、DELETE，默认 GET）；-H/--header 添加请求头（可重复）；-d/--data 请求体字符串；--json 发送 JSON 体并设置 Content-Type: application/json；--rawData 原样发送请求体；--query 查询字符串参数（可重复）；--pathParam 路径参数（可重复）。
适用场景 适合通过 AI agent 与 Plain 数据交互，例如管理 Persons、Organizations、Deals、Leads、Activities、Notes 等，以及使用 Plain 的 Note、Attachment、Notebook 相关能力。
限制 文档未提供具体的操作列表细节、字段定义、收费与价格信息，这些内容暂未提供。使用前需完成 Membrane 登录与连接认证，部分环境需手动在浏览器完成授权。