MCP（AI 插件）

什么是 MCP（AI 插件）？

Owlfiles 内置了使用模型上下文协议（Model Context Protocol）的 MCP 服务器。Claude Desktop、Claude Code 或 Codex 等 AI 智能体可以通过 Owlfiles 访问文件。

连接后，你可以使用自然语言要求智能体列出 Google Drive 中的文件、将报告从 NAS 复制到 Dropbox，或在 SMB 服务器上查找发票。智能体会通过 Owlfiles 在本地磁盘、SMB、FTP、SFTP、WebDAV、NFS 和受支持的云服务中执行请求。

智能体可以执行的操作

Owlfiles MCP 服务器提供以下工具：

list_connections — 列出已配置的 Owlfiles 连接。
list_dir — 列出文件夹内容。
get_item_metadata — 获取文件或文件夹的大小、类型和修改日期。
search_files — 按名称搜索文件和文件夹。
read_file — 读取文件内容，包括分块读取大文件。
write_file — 创建或覆盖文件，包括分块上传大文件。
create_folder — 创建文件夹。
copy_item — 复制文件或文件夹，包括在两个连接之间复制。
move_item — 移动或重命名文件或文件夹，包括跨连接操作。
delete_item — 删除文件或文件夹。

由于复制和移动可以跨连接执行，智能体能够直接在 NAS 和云盘之间传输文件。

设置连接

在 Owlfiles 中打开设置 → MCP（AI 插件）。Claude Desktop、Claude Code 和 Codex 提供引导式安装；其他兼容 MCP 的工具可以手动配置。

Claude Desktop

点击安装到 Claude Desktop。
Owlfiles 会生成 owlfiles.mcpb 扩展包，并在 Claude Desktop 中打开它。
在 Claude Desktop 显示的对话框中点击安装。
开始新的对话即可使用 Owlfiles 工具。

Claude Code

点击安装到 Claude Code。
复制 Owlfiles 显示的 claude mcp add 命令。
打开终端，粘贴命令并按下 Return 键。
启动或重新启动 Claude Code。

Codex

确保已经安装 Codex。
点击安装到 Codex。
如果系统提示，请允许访问 ~/.codex/config.toml。Owlfiles 会添加 [mcp_servers.owlfiles] 条目。
重新启动 Codex 以应用更改。

其他 AI 智能体

任何兼容 MCP 的工具都可以使用 Owlfiles MCP 服务器。服务器类型为 stdio。将以下内容添加到工具的 MCP 配置中，然后重新启动智能体：

{
  "mcpServers": {
    "owlfiles": {
      "command": "/Applications/Owlfiles.app/Contents/MacOS/Owlfiles",
      "args": ["--mcp"]
    }
  }
}

隐私与安全

MCP 服务器在 Mac 本地运行，仅在需要时由 AI 智能体启动，不会打开网络端口。
它会复用已存储在 Owlfiles 中的连接、帐户和凭据。密码和令牌不会发送给智能体。
Owlfiles 在 macOS App Sandbox 中运行。只有在你向 Owlfiles 授予本地文件夹访问权限后，智能体才能访问这些文件夹。
智能体可以删除、覆盖和移动文件。批准破坏性操作前，请仔细检查。

故障排除

连接要求我登录

在 Owlfiles 中打开一次该连接并登录。MCP 服务器会复用保存的登录信息。

智能体无法访问本地文件夹

在 Owlfiles 中打开一次该文件夹以授予访问权限，然后重试。此沙盒限制只影响本地文件，不影响远程或云端连接。

插件停止响应

重新启动 AI 智能体。智能体会管理 MCP 服务器进程，并自动再次启动它。