API 与 Token
在「我的账号」里签发访问令牌,用脚本、第三方应用或外部 AI 智能体读写 cflow。
入口
设置 → 我的账号 → 访问 Token(Access Token)
可按类型筛选:全部、API Token、Agent Token,以及各平台的前端登录会话。

Token 类型
前端登录 Token
登录网页产生的会话。列表会标出平台描述;当前正在使用的会话会标「当前会话」。
API Token
给脚本或第三方应用调用 cflow API。创建时可配置:
| 项 | 选项 |
|---|---|
| 名称 / 描述 | 方便辨认用途 |
| 有效期 | 1 天 / 1 周 / 1 月 / 永久 |
| 权限 | 读写(所有权限)/ 只读 / 只写 |
| 允许访问的空间 | 全部,或指定若干空间 |
Agent 专用 Token AI
给外部 AI 智能体用,需配合 cflow Skill 或 MCP。同样可配置名称、有效期、读写权限与空间范围。
额外限制:
- 只走 Agent 专用能力,不替代普通网页登录。
- 不能访问私密笔记。
接入 AI 客户端(Skill / MCP) AI
通过 Skill 或 MCP 两种方式之一,把 cflow 接入你的 AI 客户端。MCP 方式支持浏览器授权登录,通常无需手动创建 Token。
入口:访问 Token 区域的 Skill/MCP 指引。

指引对话框顶部可切换 Skill 与 MCP 两个标签页。
方式一:Skill(安装到本地智能体)
把 Skill 装进你的 AI 智能体(如 OpenClaw、Cursor、Claude Code 等),适合本地 CLI 类智能体。
一句话安装
复制安装指引里的提示词,发给你的 AI 智能体,让它按仓库说明完成安装;装好后再把本页的 Agent Token 发给它。
命令行安装
在本机终端执行指引中的 npx 命令(需已安装 Node.js),按提示选择平台;装好后同样把 Agent Token 告诉智能体即可。
方式二:MCP(远程直连,免安装) AI
客户端通过 MCP 协议直连 cflow 服务端,无需在本地安装任何文件。支持 Claude Code、Codex、Cursor、豆包工作、WorkBuddy、Kimi Claw、Hermes、GrokBot、Muse 等。
服务地址:https://api.cflow.cc/mcp。在指引的 MCP 标签页选择你的客户端,即可查看对应的分步操作指引,也可参考下面两种接入方式。
浏览器授权登录(推荐)
大部分客户端支持标准 OAuth 登录:只需填写服务地址,无需创建或粘贴 Token。首次连接时客户端会自动弹出浏览器,登录 cflow 并点击「允许访问」即可完成接入。
授权后系统会自动创建一个 Agent Token(描述为客户端名称,如 Claude Code),与手动创建的 Token 一样受权限与空间范围约束,可在访问 Token 页面随时查看与撤销。
各客户端接入要点:
- Claude Code:终端执行
claude mcp add --transport http cflow https://api.cflow.cc/mcp,打开会话输入/mcp并选择 cflow,在弹出的页面中登录授权。 - Codex:设置 → 插件 → 添加 MCP 服务器,名称填
cflow、类型选「流式 HTTP」、URL 填服务地址,保存后点击「授权登录」。 - Cursor:在指引中点击「快速安装」一键添加;若未生效,可手动在
~/.cursor/mcp.json写入仅含服务地址的配置(无需 headers)。 - 豆包工作:插件 · 技能 · 伙伴 → 添加 → 创建自定义连接器,名称填
cflow、类型选 HTTP、URL 填服务地址,保存后点击「去授权」。 - WorkBuddy:自定义连接器 → 添加 MCP,粘贴仅含服务地址的配置并点击「连接」,在弹出的页面中登录授权。
- GrokBot:向任意一个 Bot 发送「帮我连接 cflow,MCP 地址是 https://api.cflow.cc/mcp」,点击对话中弹出卡片上的「连接」按钮。
- Muse:在对话中发送「帮我用 OAuth 连接 cflow MCP:https://api.cflow.cc/mcp」,点击卡片上的「连接」按钮。
手动 Token(客户端不支持浏览器授权时)
部分客户端(如 Hermes、Kimi Claw)不支持浏览器授权,需先在本页创建 Agent Token,替换下方配置中的 <token> 后填入。
Hermes:
hermes mcp add cflow --url https://api.cflow.cc/mcp
命令行会提示输入 API key,粘贴 Agent Token 即可;已有会话里执行 /reload-mcp 生效。
Kimi Claw(在 MCP 设置里粘贴并启用,Maxclaw 同样适用):
{
"mcpServers": {
"cflow": {
"transport": "streamable-http",
"url": "https://api.cflow.cc/mcp",
"headers": { "Authorization": "Bearer <token>" }
}
}
}
其他自定义客户端(通用配置):
{
"mcpServers": {
"cflow": {
"type": "streamable-http",
"url": "https://api.cflow.cc/mcp",
"headers": { "Authorization": "Bearer <token>" }
}
}
}
Skill 与 MCP 怎么选
| Skill | MCP | |
|---|---|---|
| 接入方式 | 本地安装脚本文件 | 远程直连,免安装 |
| 适合场景 | 本地 CLI 智能体 | 任意支持远程 MCP 的客户端 |
| 附件上传 | 直接传本地文件路径 | 传 base64(限 20MB) |
| 附件下载 | 保存到本地目录 | 返回带签名的下载链接 |
两种方式背后调用同一套接口,功能一致,可按客户端支持情况任选。
能做什么(用户向)
接入并授权后,智能体可在你授权的空间与权限内协助:
| 类别 | 能力 |
|---|---|
| 笔记 | 创建、修改、查看、搜索(支持搜索语法宏)、AI 搜索 |
| 附件 | 给笔记添加附件 |
| 空间 / 标签 | 罗列空间、罗列标签 |
| 看板 | 创建看板;查看详细/基础信息;创建分组;把笔记加入分组;更新或移除分组内笔记 |
实际能否写入,仍受该 Token 的权限与空间范围约束;私密笔记对 Agent 一律不可见。