让常用 Agent 安全操作你的文档

它如何工作

常规文档工具由你的 Agent 提供模型能力，Koinote 只负责令牌鉴权、文档工具、并发冲突检测和审计记录。若调用 GEO 摘要生成工具，Koinote 会按你的设置调用内置模型或 BYOK 渠道。绑定飞书账号后，读写令牌还可以调用 sync_document_to_feishu 一键创建或更新飞书文档。

开始之前

• 开通终生会员 — MCP 是终生会员权益。
• 创建个人令牌 — 在控制台创建只读、读写或仅发布令牌，并选择期限或永久有效。
• 配置客户端 — 使用下方对应方式连接 https://koinote.app/mcp。

各 Agent 的接入方式

令牌属于账号凭据。请放在环境变量或客户端的安全存储中，不要提交到代码仓库。

• 在 ~/.codex/config.toml 中注册远程 MCP，并从环境变量读取令牌。重启 Codex 后即可使用。
• 使用 Claude Code CLI 添加 HTTP MCP 服务；命令会同时写入 Bearer 鉴权头。
• 在全局或项目级 opencode.json 中声明 remote MCP，并从环境变量注入请求头。
• 使用 OpenClaw CLI 注册 Streamable HTTP 服务，再运行 doctor 探测工具列表。
• WorkBuddy 或其他客户端只需支持 Streamable HTTP，并允许设置 Authorization 请求头。

如何让 Agent 使用

配置完成后不需要特殊语法，直接在对话里说明要操作 Koinote。Agent 会自行选择合适的 MCP 工具；涉及覆盖或移入回收站时，建议明确文档标题和期望结果。绑定飞书后，可以要求 Agent 调用 sync_document_to_feishu 将文档单向同步到飞书；同步会以 Koinote 内容为准。使用仅发布令牌时，可以要求 Agent 将指定文章推送到已绑定的微信公众号草稿箱，也可以让它生成或维护 GEO 摘要；推送时需明确要求携带 GEO。

配置后可用这些提示词验证

• 列出我在 Koinote 最近修改的 5 篇文档。
• 写一篇关于远程工作的文章，并保存到 Koinote。
• 找到《产品发布清单》，在末尾追加一节上线后复盘。
• 把《旧草稿》移入回收站，不要永久删除。

权限与删除边界

• 只读令牌可列出、搜索、读取文档与历史版本，不能改动内容。
• 读写令牌可以创建、追加、更新、恢复版本，以及移入或移出回收站；绑定飞书后还可以调用 sync_document_to_feishu 创建或更新飞书文档。
• 仅发布令牌可以读取文档并调用 push_wechat_draft 创建公众号草稿，但不能修改或删除 Koinote 文档。
• 读写和仅发布令牌可以生成或维护微信公众号 GEO 摘要；内置模型会消耗 credits，推送草稿默认不携带摘要。
• Agent 不能永久删除文档；永久删除只能在网页回收站中二次确认。
• 令牌可以单独撤销，过期或会员失效后会立即停止访问。