> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 插件、MCP 与 Skills：管理、导入与从设备同步

> 在「设置 › 集成 › 插件」统一管理插件、MCP 服务器和 Skills：云端共享与仅此设备、导入 MCP JSON、手动添加 MCP、从设备同步。

**插件**、**MCP** 和 **Skills** 是 Agent 的能力扩展：插件可以带命令和 hooks；MCP 服务器给 Agent 接入外部工具；Skill 是一份写给 Agent 的操作说明。它们都在「设置 › 集成 › 插件」统一管理，云端会话开始时加载已启用的项目。

需要登录第三方账号的服务（GitHub、Gmail、Notion 等）不在这里，而在[连接器](https://docs.aihubmix.com/cn/cloud/integrations/connectors.md)里授权。

## 适用范围

| 形态 | 支持情况 | 说明 |
| - | - | - |
| 桌面客户端 | 支持 | 可以扫描「这台设备」并同步到工作区 |
| 网页版 / 手机网页 | 支持 | 可以查看各设备的清单，但扫描和同步要在那台设备的客户端里做 |

## 入口

* 「设置 › 集成 › 插件」。
* 「设置 › 机器」里机器详情的插件入口会打开同一个页面，并预选那台设备。

## 基本概念

| 概念 | 说明 |
| - | - |
| 云端共享 | 已上传到工作区的项目。启用后，这个工作区的云端会话都能使用 |
| 仅此设备 | 只安装在某台设备上、没有上传到工作区的项目，只在该设备执行的会话中可用 |
| 查看位置 | 工具栏左侧的下拉，切换查看「云端共享」或某台设备的清单；云主机也作为一台设备列出 |

插件库按工作区隔离。云端开关和每台设备上的开关互相独立：在设备上停用一项，不影响云端共享里的同名项，反之亦然。

## 列表

页面工具栏有「查看位置」、搜索、「添加」和「从设备同步」，下面按「全部」「插件」「Skills」「MCP」分页签列出项目。每项显示名称、范围（「云端共享」或「仅此设备」）、版本、来源，以及启用开关；插件带 hooks 时标「含 hooks」。

* 开关只影响之后开始的会话，云端会话在下一轮加载新设置。
* 设备上的开关只能在那台设备自己的客户端里修改，其他地方只读。

## 详情

点名称打开详情，可以看到说明、可用位置和来源。

* 云端共享的项目可以「停止共享」：新的云端会话不再加载它，设备上的安装和本机开关保持不变。MCP 另有「编辑配置」。
* 设备上的项目可以「同步到工作区」，打开「从设备同步」并预先勾选这一项。

## 添加与导入

点工具栏「添加」，打开「添加到插件库」。目前只支持**向云端共享添加 MCP**（导入 JSON 或手动配置）；插件和 Skill 的文件导入、添加到设备即将开放。

### 导入 MCP JSON

1. 在「添加到插件库」选「MCP」，查看位置为云端共享。
2. 选择或拖入 JSON 文件（支持 `mcpServers` 格式，或单个服务器的 `url` / `command` 配置）。
3. 确认预览里的服务器名称和地址或启动命令。
4. 点「导入 N 项」。导入后默认停用，需要在列表里按需启用。

| 限制 | 值 |
| - | - |
| 单个文件 | 不超过 10 MB |
| 一次选择 | 最多 20 个文件 |
| 一次导入 | 最多 64 个服务器 |
| 名称 | 只能用字母、数字、点、横线和下划线，不超过 64 个字符；同名已存在时不会覆盖 |
| 密钥 | 配置里不能有密钥明文：先在「密钥与环境变量」保存密钥，再把配置里的值改为 `${变量名}` |
| 本地配置 | 依赖本机路径、localhost 等本地环境的配置不能导入云端共享 |

导入失败时，弹窗会写明原因（例如 JSON 格式无效、URL 不完整），按提示修改文件后重新导入。

## 添加或编辑 MCP 服务器

在「添加到插件库」选「MCP」，点左下角「手动配置 MCP」。编辑已有服务器：在云端共享里打开 MCP 详情，点「编辑配置」，编辑时左下角「删除」可移除该服务器。

先填「名称」（编辑时不能改），再选「类型」：

| 类型 | 需要填写 |
| - | - |
| STDIO（在项目的云端环境里启动的进程） | 「启动命令」（例如 `npx`）、「参数」（每行一个）、「环境变量」 |
| 可流式 HTTP（直接连接远程服务器） | 「URL」（以 http\:// 或 https\:// 开头）；按需填「Bearer token 变量」「请求头」 |

环境变量、token 和请求头的值都不能填明文，只能填「密钥与环境变量」里的变量名；输入时会提示工作区里已有的密钥名。手动添加的 MCP 默认启用。

## 从设备同步

把某台设备上已经安装的插件、Skills、MCP 上传到工作区，让云端会话也能用。**扫描和上传只能在那台设备自己的桌面客户端里进行。**

1. 在桌面客户端点工具栏「从设备同步」。
2. 「来源设备」默认是这台设备，点「扫描此设备」。
3. 扫描完成后勾选要同步的项目（默认都不勾选，未选中的只留在这台设备上）。
4. 按需处理版本冲突、hooks 和密钥（见下文）。
5. 点「同步所选」。完成后云端会话在下一轮加载，设备上的安装与开关保持不变。

部分项目没同步成功时，结果里会逐项写明原因，点「重试未完成项」只重试失败的部分。

### 不能勾选的项目

| 标注 | 怎么办 |
| - | - |
| 已共享 | 云端已有相同版本，无需同步 |
| 依赖本地路径 | 改为可远程访问的配置后再同步 |
| 需替换密钥明文 | 点「改用密钥引用」选一个工作区密钥（没有就点「添加工作区密钥」），并在这台设备上把配置里的明文改成变量引用后再同步。密钥明文不会上传 |

### 版本冲突与 hooks

* 勾选的项目在云端已有不同版本时，二选一：「保留云端版本」（默认，这一项不上传）或「使用此设备版本」（替换云端旧版本）。
* 所选插件含 hooks（可在工具调用前后自动执行命令）时，需要勾选「允许在云端任务中运行所选插件的 hooks」才能同步。

## 注意与限制

* 首期只有个人工作区级别的插件库，没有插件市场。
* 目前能直接添加的只有云端共享的 MCP；插件和 Skills 可以通过「从设备同步」上传。
* MCP 配置里不能写明文密钥，只能引用「密钥与环境变量」里的变量。

## 常见问题

### 「云端共享」和「仅此设备」有什么区别？

云端共享的项目上传到了工作区，所有云端会话都能用；仅此设备的项目只在那台设备上，只有在该设备执行的会话才能用。

### 为什么导入后没有生效？

导入的 MCP 默认停用，需要在列表里打开开关。云端开关在下一轮会话时加载。

### 为什么某个 MCP 不能同步到云端？

它依赖设备本地路径（或 localhost），或者配置里有密钥明文。前者需要改成远程可访问的配置；后者用「改用密钥引用」并在设备上改成变量引用后再同步。

### 在网页上为什么不能扫描设备？

扫描要读取设备本机的文件，只能在那台设备的桌面客户端里进行。

## 相关

* [连接器](https://docs.aihubmix.com/cn/cloud/integrations/connectors.md)
* [工作区设置](https://docs.aihubmix.com/cn/cloud/settings/workspace.md)
* [云主机概览](https://docs.aihubmix.com/cn/cloud/cloud-host/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.