> ## 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/zh-Hant/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/zh-Hant/cloud/integrations/connectors.md)
* [工作區設定](https://docs.aihubmix.com/zh-Hant/cloud/settings/workspace.md)
* [雲主機概覽](https://docs.aihubmix.com/zh-Hant/cloud/cloud-host/overview.md)


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