# ChatGPT 桌面客户端

返回 flomo MCP 总览

本页适用于电脑上带有「设置 → MCP 服务器」入口的 ChatGPT 客户端（包含 Codex）。不需要安装命令行工具或编辑器扩展。

桌面端和网页版需要分别连接。 这里配置的是当前电脑上的 MCP，不会自动出现在 ChatGPT 网页版的「插件」里。要在浏览器中使用，请看 ChatGPT 网页版连接步骤。两端连接同一个 flomo 账号后，访问的是同一批笔记。

# 准备

需要 flomo MAX 会员，并已安装或打开 ChatGPT 桌面客户端。

在 flomo 网页版或桌面端，进入 设置 → MCP 连接 → 个人 Token。
点击创建，名称填写「ChatGPT 桌面客户端」，便于以后识别。
创建后立即复制 Token，它只显示一次。把下方配置中的 粘贴你的Token 替换为这个完整 Token。

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

# 连接 flomo

按你的电脑系统，选择下面一组命令打开配置文件。
- Windows：在开始菜单搜索并打开 Windows PowerShell，完整复制下面这段命令，粘贴后按回车。它会在需要时创建文件夹和空配置文件，然后用记事本打开；已有文件的内容会保留。
```
$mcpDir = Join-Path $env:USERPROFILE ".codex"
$mcpConfig = Join-Path $mcpDir "config.toml"
New-Item -ItemType Directory -Path $mcpDir -Force | Out-Null
if (-not (Test-Path -LiteralPath $mcpConfig)) {
    New-Item -ItemType File -Path $mcpConfig | Out-Null
}
notepad.exe $mcpConfig
```
  命令执行后，切换到弹出的记事本窗口，下一步的配置内容要粘贴到记事本里。
- macOS：按 ⌘ + 空格，搜索并打开终端，完整复制下面这段命令，粘贴后按回车。它会在需要时创建文件夹和空配置文件，然后用「文本编辑」打开；已有文件的内容会保留。
```
mkdir -p ~/.codex
touch ~/.codex/config.toml
open -e ~/.codex/config.toml
```
  命令执行后，切换到弹出的「文本编辑」窗口，下一步的配置内容要粘贴到这个窗口里。
在打开的文件末尾另起一行，粘贴以下内容，把 粘贴你的Token 替换为刚才复制的完整 Token：
```
[mcp_servers.flomo]
url = "https://flomoapp.com/mcp"
http_headers = { Authorization = "Bearer 粘贴你的Token" }
```
Bearer 后面保留一个空格，英文双引号也要保留。文件中已有其他内容时，不要删除。如果已经有 [mcp_servers.flomo]，请更新原来的 flomo 配置，避免重复添加；若其中有 enabled = false，改为 enabled = true。
保存文件：Windows 按 Ctrl + S，macOS 按 ⌘ + S。保留文件名 config.toml，不要另存为 config.toml.txt 或富文本文件。
回到 ChatGPT 桌面端，进入 设置 → MCP 服务器，让新配置生效：
- 如果 flomo 已开启，先关闭它的开关，再重新开启；如果原本就是关闭状态，直接开启。更改开关后，页面会出现重启按钮，点击重启。
- 如果暂时没有 flomo，或仍然没有「重启」按钮，完全退出 ChatGPT 后重新打开。macOS 可按 ⌘ + Q 退出；Windows 若关闭窗口后仍留在系统托盘，请从托盘图标菜单退出。
- 重新打开后，确认 flomo 的开关处于开启状态。

# 确认连接成功

新建一个在本机运行的任务，输入：

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

把「复盘」换成你笔记中出现过的词。看到 flomo 工具调用并返回结果，说明连接成功；没有匹配结果时，可以换一个词再试。

# 常见问题

# 提示未授权或连接失败

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

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

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

# 如何停用连接

在 flomo 的 设置 → MCP 连接 → 个人 Token 中注销对应 Token，注销后立即失效。更多操作见创建与管理 Token。

# 看不到「重启」按钮

先关闭 flomo 开关，再重新开启。如果列表里没有 flomo，或仍没有按钮，完全退出客户端后重新打开，确认 flomo 已开启。

# 桌面端连接会带到网页版或其他电脑吗

本机配置不会自动出现在网页版插件里。两端连接同一 flomo 账号后，访问的是同一批笔记。

同一电脑、同一用户环境下，Codex CLI 和 IDE 扩展可以共用这份配置；换电脑、切到 WSL 或远程环境时，需要单独配置。

# 我设置过 CODEX_HOME

上面的命令使用默认配置路径。如果你自行设置过 CODEX_HOME，请编辑该目录中的 config.toml。

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

← WorkBuddy ChatGPT 网页版 →