MagicFrog 市场是一份目录、两个入口:桌面应用内建的市场,和一个无需客户端即可使用的独立 web 站点。两者看到的是同一份目录,对「存在什么」的回答保持一致。
web 站点
市场 web 站点是 MagicFrog 官网上的一个独立页面。浏览、搜索、分类过滤、精选推荐与最近更新流,全部无需账号、无需桌面客户端即可使用。每个列出的 server 都有详情页,展示其元数据、来源与安装动作。
该站点浏览的是 MCP server 目录:agent 可用的工具,来自官方 registry 加上已配置的自定义源,合并为一份列表;只想要官方目录时,有 official-only 过滤面。MCP server、插件与技能三类内容,网页端与桌面端看到的是同一份。
官方 registry 恒在,且不可移除。除此之外你可以配置自定义源——兼容官方 registry 格式的自有目录地址。
登录并发起安装
从 web 站点安装使用你的 MagicFrog 账号:
- 登录:输入账号标识与密码(与 MagicFrog 其余部分相同的账号门)。
- 发送安装。一次点击即在你的账号上排队一个安装项。
- 桌面来取。登录了同一账号的桌面客户端认领该项、执行安装,并落定结果。
从网页端可以安装两类内容:MCP server 与插件。
这就是如实的边界:技能可以在桌面市场里浏览,但 web 发起的安装目前只覆盖 MCP server 与插件。
队列如何运转
安装项只记「装什么」,不含具体配置;桌面端执行时按你本机已安装的版本核对,不会装重,也不会装错版本。
队列项在一张显式状态机中流转:
pending → claimed → executed | failed
↘ cancelled
- 只有
pending项可被认领;只有claimed项可被执行或标记失败;pending与claimed项可被取消。终态不可变。 failed项总带有显式原因。- 桌面端幂等执行:重试绝不重复安装;结果未知的安装不会被标成已完成。
你的凭据在哪里
访问 token 只在 web 页面内存中保存,tab 开着就在,tab 关了就没——绝不写入浏览器存储。refresh token 则根本不会到达 web 客户端。离开页面会话即消失;下一次安装会要求你重新登录。桌面侧走的是账号的设备凭据通道,相互独立且可独立吊销。
桌面市场
桌面应用内嵌的市场展示同样的内容,外加一个用于授权外部服务的 OAuth connectors 标签页。网页端浏览到的与桌面上安装的保持一致。