AI Access——给你的助手接入 MCP 文件工具
通过本地服务器把 MCP 文件工具暴露给 Claude Code、Gemini 等 AI 助手——助手只把指令发送到 127.0.0.1，压缩、转换、重命名、遮盖等实际工作全部由应用自带的工具在你自己的机器上完成，文件内容从不上传，破坏性操作还需显式确认。
AI Access 把 1FileTool 变成一个本地 MCP 服务器，让 AI 助手可以用大白话运行它的 MCP 文件工具——压缩、转换、重命名、遮盖等等——全程不上传任何文件。助手把指令发给 127.0.0.1；每个任务都在你机器上的应用内部运行。
开启它
Settings › AI Access 里装著全部设置：
- 打开 Allow AI assistant access。状态徽章变为 Listening——服务器只绑定
127.0.0.1，所以从网络侧够不到任何东西。 - 在 Your AI tools 下点 Connect。1FileTool 把自己作为
onefiletoolMCP 服务器写进检测到的客户端配置——Claude Code（~/.claude.json）和 Gemini CLI（~/.gemini/settings.json）一键搞定。 - 重启 CLI，让它识别到新服务器。
Codex CLI 的配置文件在目前的 Codex 版本里不会以同样方式被读取，所以对于 Codex——以及任何其他支持 MCP 的客户端——打开 Set up another client manually，点 Copy，自己把 JSON 片段粘进那个客户端的 MCP 配置。
然后直接问就行——应用自带的例子：use 1filetool mcp to compress these images。
助手能拿到什么
十个工具，都带 filetool_ 前缀：
| 工具 | 用途 |
|---|---|
filetool_status | 应用状态和套餐限制 |
filetool_list_operations | 发现全部 64 个操作及其参数 |
filetool_run | 按 id 运行任意操作——通用工具 |
filetool_inspect | 读取文件元数据而不改动它 |
filetool_extract_text | 从 PDF 和文档里提取文本 |
filetool_compress_images / filetool_convert_images | 图片任务 |
filetool_compress_pdf / filetool_pdf_convert | PDF 任务 |
filetool_compress_video | 视频任务 |
便捷工具一口气覆盖常见调用；filetool_run 触达其余一切——包括通过 workflow_run_recipe 调工作流配方。
护栏
- 破坏性操作先询问。 像按模式重命名或粉碎文件这类操作带 Asks first 徽章——助手必须传
confirm: true，所以 agent 不会因为误解的 prompt 就粉碎或批量改名。 - 应用的限制仍然生效。 MCP 运行与点按钮共用同一份额度：免费档每天 8 个文件，少数操作仅限 Pro（文件夹监控就是一例），设备端 AI 以预览形态运行。触限时助手会被告知。
- 应用必须在运行。 服务器住在 1FileTool 内部——退出应用，连接随之断开。
与 AI Chat 的定位差异
AI Chat 是应用内的聊天窗口，用来聊关于文件的事。AI Access 是反方向：你留在自己的终端或编辑器里，助手伸手进应用运行它的工具。指令过网；文件从不离开。