Flexnote MCP 服务

Flexnote MCP 服务简介

Flexnote 桌面端于 2026 年 9 月 18 日正式推出 MCP（Model Context Protocol）服务，将本地知识库以标准化协议开放给外部 AI 客户端。开发者可在 Cursor、Claude Desktop、Codex 等支持 MCP 协议的开发环境中，直接检索、读取并写入本地笔记库，无需切换窗口或复制粘贴内容。

核心能力

• 本地 MCP 服务：Flexnote 桌面端内置 MCP 服务，仅监听本机 127.0.0.1，不对外暴露网络接口，数据始终保留在用户设备
• 多端读写：支持在笔记库中创建日记、编辑笔记卡片、管理白板和待办，所有操作实时同步
• 外部 AI 客户端集成：客户端自行选择模型并承担 API 计费，Flexnote 不介入模型选择或供应商绑定
• 知识库统一：同一批卡片同时出现在画布视图、卡片库和收藏夹，三处编辑互相联动
• 与应用内 AI 互补：应用内 Flexnote AI 适用于文献精读、视频标注等深度阅读场景；MCP 则面向开发工具中的读写操作场景

安装配置

环境要求

• Flexnote 桌面端（Windows / macOS）
• 支持 MCP 协议的 AI 客户端（Cursor、Claude Desktop、Codex 等）
• 本地网络环境正常

配置步骤

1. 在 Flexnote 桌面端开启 MCP 服务（设置 → MCP → 启动服务）
2. 获取本机服务地址（默认为 127.0.0.1 及对应端口）
3. 在目标 AI 客户端中添加 Flexnote MCP 服务器地址
4. 完成身份验证并确认连接

连接参数示例

• 服务地址：http://127.0.0.1:PORT
• 协议：MCP（Model Context Protocol）
• 传输层：本地 HTTP

使用流程

1. 启动 Flexnote：打开 Flexnote 桌面端，确保 MCP 服务处于运行状态
2. 打开 AI 客户端：在 Cursor、Claude Desktop 或 Codex 中打开对话窗口
3. 发起查询：通过 MCP 协议向 Flexnote 知识库发起检索请求，获取笔记、卡片或白板内容
4. 写入内容：使用写入类工具在当前笔记库中新建日记、创建卡片或布置白板结构
5. 同步查看：返回 Flexnote 画布，确认新增内容已出现在相应视图

适用场景

• 程序员在编码界面直接查阅本地笔记中的接口文档、架构设计或文献摘录
• 写作过程中将Claude的输出结果直接写入知识库，无需复制粘贴
• 产品经理在规划功能时通过AI工具批量创建待办事项
• 研究人员利用外部模型处理笔记内容并将结论沉淀至知识图谱

适用人群

• 习惯在笔记中记录技术文档、接口设计和开发思路的软件工程师
• 需要将 AI 输出结果直接沉淀至本地知识库的写作者与研究者
• 对数据隐私有较高要求、不希望笔记内容上传至第三方云服务的用户

工作原理

Flexnote MCP 基于 Model Context Protocol 实现。服务启动后，本地运行一个 MCP 服务器，通过标准化的工具列表（tools/list）和工具调用（tools/call）接口供外部客户端使用。客户端通过 JSON-RPC 协议与服务器通信，查询或写入本地 SQLite 数据库中的笔记、卡片、白板和待办数据。整个通信链路完全封闭在本机 loopback 接口，任何数据均不经过外网。模型推理由 AI 客户端自行调用，用户自行配置 API Key 并承担相应费用。

官方链接

• 官网：https://myflexnote.com
• MCP 官方介绍：https://myflexnote.com/zh/blog/flexnote-mcp