flomo 101

# Codex CLI

返回 flomo MCP 总览

本页适用于在终端中使用 codex 的用户。连接后，可以让 Codex 搜索 flomo 笔记或保存结论。

# 准备

如果已经在同一台电脑、同一用户环境下连接了 ChatGPT 桌面客户端或其他 Codex 客户端，可以直接跳到 确认连接成功。

需要 flomo MAX 会员，并已安装或打开 Codex CLI。

  1. 打开 flomo 网页版 (opens new window)，点击左上角昵称，进入 设置 → MCP / API，保持 MCP 标签选中。
  2. 向下滚动到 Token 授权模式，点击 Token 列表 右侧的 创建，名称填写「Codex CLI」，便于以后识别。
  3. 填写名称后点击 创建，立即复制生成的 Token，它只显示一次。把下方配置中的 粘贴你的Token 替换为这个完整 Token。

在 flomo 网页版设置的 MCP / API 中，向下滚动到 Token 授权模式，点击 Token 列表右侧的创建

Token 是访问你 flomo 的凭证，请勿分享。建议为不同工具分别创建，方便单独停用。

# 连接 flomo

打开当前环境中的配置文件：macOS / Linux 使用 ~/.codex/config.toml，Windows 使用 %USERPROFILE%\.codex\config.toml。如果设置过 CODEX_HOME，使用该目录里的 config.toml。

加入下面的配置，并替换 Token。已有 [mcp_servers.flomo] 时，更新原来的配置，避免重复添加：

[mcp_servers.flomo]
url = "https://flomoapp.com/mcp"
http_headers = { Authorization = "Bearer 粘贴你的Token" }

# 确认连接成功

在终端中执行下面的命令，确认 Codex 已经识别 flomo：

codex mcp get flomo

正常情况下会看到类似下面的结果：

enabled: true
transport: streamable_http
url: https://flomoapp.com/mcp
http_headers: Authorization=*****

其中 ***** 表示 Codex 已隐藏 Token，不是配置丢失。

启动 Codex，在对话中输入 /mcp，确认 flomo 显示为已连接。 输入下面这句话进行只读测试：

请使用 flomo 搜索最近包含「复盘」的笔记，只列出日期和内容，不要创建或修改笔记。

# 常见问题

# 提示未授权或连接失败

检查 Token 是否完整、是否已注销，以及 Bearer 后是否保留了一个空格。修改配置后，重新加载连接，再新建对话验证。

# 配置文件里已经有其他服务

保留原有内容，把 flomo 加入对应的服务器列表；已有同名配置时直接更新，避免重复添加。配置含有 Token，请勿上传到代码仓库或分享给他人。

# 如何停用连接

打开 flomo 网页版 (opens new window) 的 设置 → MCP / API → MCP，在 Token 授权模式 的 Token 列表 中注销对应 Token，注销后立即失效。更多操作见 创建与管理 Token。

# 已经连接了同一电脑上的 ChatGPT 桌面客户端

同一用户环境下可以共用本机配置，无需再次创建 Token 或添加 flomo，直接验证即可。网页版、WSL 和远程环境需要分别配置。

配置方式也可参考 OpenAI 官方 MCP 文档 (opens new window)。

← Codex IDE 扩展 →