FrelyMCP

Frely CLI

网站 · 文档 · Frely · English · 简体中文

Frely CLI（frely-cli）将你选择的计算机连接到 FrelyMCP，让 ChatGPT、Claude、Codex 和其他 MCP 客户端能够从任何地点在这台计算机上工作。它们可以使用你允许访问的文件、Shell 命令和进程。计算机会主动连接到 Frely，因此无需开放端口。

它也是 Frely 账户的命令行工具：

• 设备 MCP：让远程 AI 客户端在这台计算机上工作。
• 本地 MCP 服务：将仅在这台计算机上运行的 MCP 服务（例如在 127.0.0.1 上运行的服务）转发给远程客户端。
• Agent、提示词和技能：将已发布的 Frely Agent 安装为本地技能，或安装你购买的提示词和技能。
• 本地模型共享：将本地 Ollama 或兼容 OpenAI 的运行时发布为你自己的 Frely Provider。

安装

服务器，使用 Frely 账户（无需浏览器）

在 Frely 网站上获取一次性安装命令（我的设备 → 添加计算机 → 创建安装命令），或让已连接到 FrelyMCP 的 ChatGPT 或 Claude 添加计算机。在服务器上粘贴该命令：

curl -fsSL https://frely.cloud/start.sh | FRELY_INSTALL_TOKEN=fit_... sh

此命令会安装 frely、登录你的账户、启用设备 MCP 并启动后台服务。令牌只能使用一次，并会在 15 分钟后过期。在 Linux 上，运行 sudo loginctl enable-linger $USER，这样你退出 SSH 后服务仍会保持在线。更多信息

有浏览器的计算机

# macOS / Linux
curl -fsSL https://frely.cloud/start.sh | sh

# Windows (PowerShell)
curl.exe -fsSLo "$env:TEMP\frely-start.ps1" https://frely.cloud/start.ps1; powershell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\frely-start.ps1"

脚本会安装最新版本的 frely，打开浏览器以登录（新账户可在此注册），提示你批准此设备，并输出 MCP URL。之后可随时再次运行脚本进行更新。工作区默认为你的主目录；设置 FRELY_WORKSPACE=/path 可共享其他文件夹。更多信息

让你的 Agent 完成设置

让可使用 Shell 的 Agent（Claude Code、Codex、pi）安装 CLI，使用 frely login --email 登录，并运行 frely skill install --host <host>。frely 技能会教 Agent 如何使用你的账户，并且只在请求需要时才提供 FrelyMCP。此方式不会向远程客户端开放这台计算机；frely mcp start 才会开放。

仅安装

https://frely.cloud/install.sh 和 install.ps1 只安装程序，适用于需要 CLI 的脚本和 Agent。也可以使用 npm（Node.js 22 或更高版本）：

npm install --global --ignore-scripts frely-cli@latest

安装程序会校验 SHA-256，并优先从 GitHub Releases 下载，然后再从 npmmirror 和 npmjs 下载。更多信息

常用命令

命令	功能
frely mcp start	如有需要则登录，启用 Device MCP，启动服务并显示 MCP URL。可安全地重复运行。
frely mcp status	显示 MCP URL、工作区、授权到期时间和服务状态。
frely mcp workspace add <path>	共享另一个文件夹。frely mcp workspace list 会显示所有文件夹。
frely mcp stop / frely mcp start	暂停或恢复后台服务。
frely mcp auto-update [on|off]	允许后台服务在空闲时自行更新（macOS/Linux，默认关闭）。
frely mcp remove	撤销所有客户端的访问权限并卸载服务。
frely doctor	检查登录状态、安装情况、服务和连接。使用 -v 查看详情。
frely update	就地更新到最新版本。
frely login / frely logout	登录或退出 Frely 账户。
frely sandbox proxy <url>	将命令沙箱的网络流量转发到你自己的 HTTP(S) 代理。未设置时，CLI 会使用 HTTPS_PROXY / HTTP_PROXY / ALL_PROXY，并在 macOS 上使用系统代理。--clear 可移除代理；重启服务以应用更改。
frely tunnel <host>:<port>	在沙箱命令中：监听 127.0.0.1，并通过沙箱将 TCP 连接转发到 host:port，供数据库和 redis 客户端使用。--local-port N 可指定本地端口。
frely uninstall	从这台计算机上移除 Frely（会先列出所有内容）。

所有命令和选项：命令参考。frely help --agent --json 会输出完整的机器可读契约。

与 FrelyMCP 搭配使用

FrelyMCP 是整个账户共用的一个 MCP 地址：https://mcp.frely.cloud/mcp。你运行过 frely mcp start 的每台计算机都会出现在此地址下。

1. 在要控制的计算机上运行 frely mcp start（上面的安装脚本已执行此操作）。
2. 将该 URL 添加到客户端，作为使用 OAuth 的远程 MCP 服务：
   • ChatGPT 或 Claude：使用该 URL 添加自定义连接器。
   • 在另一台计算机上使用 Claude Code：运行 claude mcp add --transport http frely "https://mcp.frely.cloud/mcp"，然后打开 /mcp 进行授权。
3. 登录 Frely 并批准客户端。

要检查连接，请让客户端列出工作区顶层的名称。

• AI 可以执行的操作：运行 list_devices，然后在你选择的计算机上执行 read、edit_file、process 和 web_fetch；还可以通过 frely_list 和 frely_call 访问你的账户。更多信息
• 本地 MCP 服务：会自动发现环回服务（frely mcp local list）；每个服务在 Frely 中启用之前都会保持隐藏。更多信息
• 授权：默认访问权限有效期为 90 天；frely mcp start --days 1..365 可提前续期。URL 始终不变。更多信息

更多功能

• Frely 托管的 Agent：frely item install <username/name> --host claude-code 会将 Agent 安装为本地 Skill；frely agent run <username/name> 可调用该 Agent。更多信息
• 市场提示词和 Skill：frely item install <username/name> --host claude-code（同一命令也可安装 Agent；添加 @3 可指定版本 3）。只有账户持有通行证时，才会安装付费部分。frely item update 会列出已安装且有更新版本的条目；运行 frely item update <folder> 前不会进行任何更改。更多信息
• 共享本地模型：frely provider share ollama 会将回环模型服务发布为你的个人 Frely Provider。更多信息
• 共享本地网页：frely share 3000 会先征求确认，然后通过 Frely 中继为 http://127.0.0.1:3000 生成私密链接；按 Ctrl+C 或链接过期后即停止（最长 24 小时）。中继流量计入每个 UTC 周的套餐额度；直接连接不计入。此功能不同于 frely provider share（本地模型）或 frely tunnel（命令沙盒内）。
• 在终端中管理账户：frely api list|describe|call。更多信息

安全

文件工具仅在共享工作区内运行，并会保护凭据文件和 Shell 启动文件。命令以你的 OS 用户身份在 OS 沙盒中运行；如果计算机无法对其进行沙盒隔离，则会拒绝运行。客户端持有 OAuth 令牌；CLI 会将自己的密钥保存在系统凭据存储中。安全吗？ · 沙盒和权限 · 凭据存储

文档

• 帮助：cli.frely.cloud/docs（update、doctor、uninstall）
• 面向贡献者的契约：Device MCP · Device Relay transport · MCP OAuth contract · frely api · Frely Network（预览版） · 自更新 · 服务维护

许可和商标

frely-cli 根据 Apache License 2.0 授权；请参阅 LICENSE。Frely 名称、徽标和产品名称不作为商标许可；请参阅 TRADEMARKS.md。开发相关信息请参阅 CONTRIBUTING.md，报告漏洞请参阅 SECURITY.md。