跳到主要内容

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 怎么选​

SkillMCP
接入方式本地安装脚本文件远程直连,免安装
适合场景本地 CLI 智能体任意支持远程 MCP 的客户端
附件上传直接传本地文件路径传 base64(限 20MB)
附件下载保存到本地目录返回带签名的下载链接

两种方式背后调用同一套接口,功能一致,可按客户端支持情况任选。

能做什么(用户向)​

接入并授权后,智能体可在你授权的空间与权限内协助:

类别能力
笔记创建、修改、查看、搜索(支持搜索语法宏)、AI 搜索
附件给笔记添加附件
空间 / 标签罗列空间、罗列标签
看板创建看板;查看详细/基础信息;创建分组;把笔记加入分组;更新或移除分组内笔记

实际能否写入,仍受该 Token 的权限与空间范围约束;私密笔记对 Agent 一律不可见。