与黎 · 工坊 返回控制台

让 ChatGPT 网页读取你电脑上的文件

这篇教程教你在自己的 Windows 电脑上跑一个很小的程序,让 ChatGPT 网页版在你的授权下,读取你电脑里指定的一个文件夹,帮你整理笔记、总结资料、检查文档。全程不用写代码,大约 15 分钟。

先把边界说清楚,再动手:

开始之前要准备的

  1. 一台 Windows 电脑,能正常上网。
  2. 一个能创建自定义 MCP 插件的 ChatGPT 账号(Plus 账号实测可用)。OpenAI 按账号类型和工作区设置来开放这个功能,不同版本的说明不完全一致;如果你在设置里找不到开发者模式,或者开关是灰的,说明账号或工作区暂时不支持,本教程帮不上忙,换个账号再试。
  3. 一个专用文件夹,里面放你愿意让 ChatGPT 看的文件。建议新建一个,比如 D:\给ChatGPT看。不能选整个磁盘、用户主目录、系统目录,也不能选工具包所在的文件夹,程序会直接拒绝。

第一步:安装 Python

  1. 打开 Python 官网下载页,下载 Python 3.11 或更新的版本。
  2. 运行安装程序,第一个界面最下面一定要勾选 “Add python.exe to PATH”,再点 Install Now。
  3. 装完后按 Win + R,输入 cmd 回车,在黑色窗口里输入下面这行,能看到版本号(3.11 或更高)就对了:
python --version

第二步:下载并解压工具包

  1. 下载工具包:huiliu-local-files.zip
  2. 解压到一个固定位置,比如 C:\huiliu-files。不要解压到你要共享的那个文件夹里。
  3. 解压后能看到 start.bat、approve.bat、start-tunnel.bat 等文件。

第三步:启动本地服务

  1. 双击 start.bat。
  2. 弹出“选择文件夹”窗口,选你准备好的专用文件夹,点确定。
  3. 黑色窗口里会出现一串信息,其中有一行“本机地址”,形如:

    http://127.0.0.1:38765/mcp/一长串字母数字

  4. 记住两件事:最后那一长串就是你的口令;这个窗口要一直开着,关掉就断开了。

第四步:开一条 HTTPS 隧道

ChatGPT 在网上,你的程序在自己电脑里,中间需要一条隧道把它们接起来。这里用 Cloudflare 的免费快速隧道,不用注册账号。

  1. 打开 cloudflared 下载页,下载 cloudflared-windows-amd64.exe。
  2. 改名为 cloudflared.exe,放进第二步解压的文件夹里(和 start-tunnel.bat 放在一起)。
  3. 双击 start-tunnel.bat。
  4. 等几秒,窗口里会出现一行 https://xxxx-xxxx-xxxx.trycloudflare.com,这就是你的隧道地址。这个窗口也要一直开着。
  5. 验证隧道通了:在浏览器地址栏打开 隧道地址/health,应该看到 {"ok":true}。

隧道地址每次重新启动都会变,所以每次使用前要重新填一次。

第五步:在 ChatGPT 里添加这个本地工具

下面的步骤是按 2026 年 10 月的 ChatGPT 网页版实际操作验证过的(Plus 账号)。OpenAI 经常调整界面,如果名字和这里略有不同,找意思相近的入口就行。

  1. 打开 ChatGPT 网页版,点左侧栏的“插件”。
  2. 点页面右上角的“添加”,在下拉菜单里选“创建自定义 MCP 服务器”。老版本里这一步叫“开发者模式 → 创建连接器”,位置在“设置”里。
  3. 在弹出的窗口里按下面填:
    • 名称:随便取,比如“我的本地文件”。
    • 说明:可以不填。
    • 服务器 URL:隧道地址/mcp/你的口令,注意中间的 /mcp/ 不能少。例如 https://xxxx.trycloudflare.com/mcp/一长串口令。
    • 身份验证:把默认的 OAuth 改成“无需身份验证”(口令已经在地址里了)。
    • 勾选“我已了解,并希望继续”。这是 ChatGPT 对所有自定义 MCP 服务器的风险提示:请只连接你自己搭的、信任的服务器。
  4. 点“以插件形式创建”。创建后它会出现在“已安装”里。

第六步:开始使用

  1. 新开一个对话,在输入框里打 @,选你刚建的插件。不选的话 ChatGPT 不会去调用它。
  2. 第一次使用时,ChatGPT 会在对话里弹出“连接”按钮,点它,再在弹窗里确认一次“连接”。这是 ChatGPT 自己的授权步骤,每个插件只需要做一次。
  3. 试着这样问:
    • “列一下文件夹里有哪些文件。”
    • “读一下 notes.txt,帮我总结成三条要点。”
    • “在所有文件里搜一下‘预算’出现在哪。”
  4. 想让它改文件,可以说:“把 notes.txt 里的日期统一改成 2026-10-08 格式。”此时 ChatGPT 只会给出一份“写入建议”和差异,文件并没有改。
  5. 要让改动生效:双击 approve.bat,在黑色窗口里选编号,看清差异,确认没问题再输入屏幕上显示的批准码。直接回车就是取消。批准后原文件会备份到 C:\Users\你的用户名\.huiliu-files\state\ 下,不在共享文件夹里。建议 15 分钟内处理,超时的建议会自动失效。

它一共提供 4 个工具:list_files(列目录)、read_file(读文件)、search_text(搜内容)、propose_write(提出写入建议)。ChatGPT 的回复里会显示它调用了哪一个。

我们在真实账号里用一个只有两个文件的测试文件夹验证过:ChatGPT 能列出文件、读出内容,读取 .env 时会被拒绝并提示“protected path”。

用完以后怎么断开

  1. 关掉 start.bat 和 start-tunnel.bat 两个黑色窗口。ChatGPT 立刻读不到你的文件。
  2. 想让旧口令彻底作废:删除 C:\Users\你的用户名\.huiliu-files\token.txt,下次启动会生成新口令。
  3. 在 ChatGPT 设置里把这个应用删掉。

常见问题

找不到“创建自定义 MCP 服务器”,或者是灰的
这是账号类型或工作区设置的限制,不是你操作错了。如果是工作区账号,可能需要管理员开启。个人账号请对照 OpenAI 当前的说明,确认你的套餐是否支持。
ChatGPT 创建应用时提示连不上
依次检查:两个黑色窗口是不是都还开着;地址是不是 隧道地址/mcp/口令 的完整写法;在浏览器里打开 隧道地址/health 能不能看到 {"ok":true};隧道重启过的话地址已经变了,要重新填。
隧道地址一直是 404 或打不开
如果你以前配置过 cloudflared(电脑上有 C:\Users\你的用户名\.cloudflared\config.yml),快速隧道会读到旧配置,请求在 Cloudflare 那一端就被拒了。本工具包的 start-tunnel.bat 已经自动绕开这个问题;如果你手动运行 cloudflared,需要加上 --config 指向一个空文件。
ChatGPT 说读不到某个文件
常见原因有四个:文件在隐藏目录里或名字以点开头;是 .pem、.key、.env 这类密钥文件,默认保护;文件超过 1 MiB;不是 UTF-8 文本。Word、PDF、Excel 需要先另存成文本或 Markdown 再放进文件夹。
start.bat 提示“共享文件夹不合适”
你选的是整个磁盘、用户主目录、系统目录,或者包含了工具包本身。请在别处新建一个专用文件夹,只把想让 ChatGPT 看的文件放进去。
ChatGPT 想写脚本文件,被拒绝了
这是故意的。如果让 ChatGPT 改写 .py、.bat 这类文件,批准一次就等于以后双击它时在你电脑上运行这段内容,风险很大,所以默认禁止。确实需要的话,可以用 start.bat --allow-code-write 启动,并且每次批准前一定逐行看清差异。
想换一个新口令
双击 start.bat 之前先在命令窗口里运行 start.bat --rotate-token。旧口令立刻作废,ChatGPT 里的应用地址也要换成新口令。
窗口里的输出突然停了
在黑色窗口里点一下鼠标,Windows 会暂停程序输出。按一下回车就会继续。
start.bat 提示端口被占用
程序会自动尝试后面的 9 个端口,一般不用管。start-tunnel.bat 会自动读取实际用的端口。
国内网络下隧道连不上
Cloudflare 的连接可能被网络环境阻断。可以在 start-tunnel.bat 里的 cloudflared 命令后面加上 --protocol http2 再试,仍不行就需要换一个网络环境,或改用你自己熟悉的隧道工具。
我想让 ChatGPT 能运行命令、写代码
本工具故意不提供。如果你确实需要,可以看开源项目 Waishnav/devspace、hoangcoderr/chatgpt-local-coder,它们功能更强,也意味着一旦授权,对方能在你的电脑上做更多事,请先读完它们的安全说明,并且只在你完全信任的环境里用。
还有没有更稳定的连接方式
有。OpenAI 官方提供 Secure MCP Tunnel,地址固定,不依赖第三方隧道,但需要 OpenAI Platform 的相应权限,并且和开发者模式是分开授权的。需要的话可以按 OpenAI 官方文档把本地地址 http://127.0.0.1:38765/mcp/你的口令 配成隧道的目标。这条路我们没有逐步验证过,请以官方文档为准。
这个工具会收集我的数据吗
不会。它只在你的电脑上运行,不连接我们的服务器,也没有统计和上报。数据流向只有你选的共享文件夹,ChatGPT,以及你选的隧道服务商。
源码在哪里,能不能自己检查
工具包里的 huiliu_files_mcp.py 和 workspace.py 就是全部源码,用记事本就能打开,总共几百行,没有任何需要联网下载的依赖。