> ## 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: 관리, 가져오기, 기기에서 동기화

> Settings › Integrations › Plugins에서 플러그인, MCP 서버, Skills를 한곳에서 관리합니다: Cloud shared와 Device only, MCP JSON 가져오기, MCP 서버 직접 추가, 기기에서 동기화.

**플러그인**, **MCP**, **Skills** 는 에이전트가 할 수 있는 작업을 확장합니다. 플러그인에는 명령과 hooks가 포함될 수 있습니다. MCP 서버는 에이전트를 외부 도구에 연결합니다. Skill은 에이전트를 위해 작성된 지시 모음입니다. 세 가지 모두 **Settings › Integrations › Plugins** 에서 관리하며, 클라우드 세션은 시작할 때 켜져 있는 항목을 불러옵니다.

서드파티 계정 로그인이 필요한 서비스(GitHub, Gmail, Notion 등)는 여기서 관리하지 않습니다. [커넥터](https://docs.aihubmix.com/ko/cloud/integrations/connectors.md)에서 인증합니다.

## 사용 가능 여부

| 플랫폼 | 지원 | 비고 |
| - | - | - |
| 데스크톱 앱 | 지원 | **This device** 를 스캔하고 워크스페이스로 동기화할 수 있습니다 |
| 웹 앱 / 모바일 웹 | 지원 | 각 기기의 인벤토리를 볼 수 있지만, 스캔과 동기화는 해당 기기의 앱에서 해야 합니다 |

## 찾는 위치

* **Settings › Integrations › Plugins**.
* **Settings › Machines** 의 머신 상세에 있는 플러그인 항목을 클릭하면 해당 기기가 미리 선택된 상태로 같은 페이지가 열립니다.

## 주요 개념

| 개념 | 설명 |
| - | - |
| Cloud shared | 워크스페이스에 업로드된 항목입니다. 켜면 이 워크스페이스의 모든 클라우드 세션에서 사용할 수 있습니다 |
| Device only | 한 기기에 설치되어 있고 워크스페이스에 업로드되지 않은 항목입니다. 해당 기기에서 실행되는 세션에서만 사용할 수 있습니다 |
| Location | 도구 모음 왼쪽의 드롭다운입니다. **Cloud shared** 인벤토리와 기기의 인벤토리 사이를 전환합니다. 클라우드 서버도 기기로 표시됩니다 |

플러그인 라이브러리는 워크스페이스마다 별도입니다. 클라우드 스위치와 각 기기의 스위치는 서로 독립적입니다. 기기에서 항목을 꺼도 Cloud shared의 같은 이름 항목에는 영향을 주지 않으며, 그 반대도 마찬가지입니다.

## 목록

페이지 도구 모음에는 **Location**, 검색, **Add**, **Sync from device** 가 있습니다. 그 아래에 **All**, **Plugins**, **Skills**, **MCP** 탭별로 항목이 나열됩니다. 각 항목에는 이름, 범위(**Cloud shared** 또는 **Device only**), 버전, 출처, 켜기 스위치가 표시됩니다. hooks가 포함된 플러그인에는 **Includes hooks** 가 표시됩니다.

* 스위치는 이후에 시작되는 세션에만 영향을 줍니다. 클라우드 세션은 다음 턴에 새 설정을 불러옵니다.
* 기기의 스위치는 해당 기기의 앱에서만 변경할 수 있습니다. 다른 곳에서는 읽기 전용입니다.

## 상세

이름을 클릭하면 상세가 열리며, 설명, 사용 가능한 위치, 출처를 확인할 수 있습니다.

* Cloud shared 항목은 **Stop sharing** 을 클릭하면 새 클라우드 세션이 더 이상 불러오지 않으며, 기기의 설치와 로컬 스위치는 그대로 유지됩니다. MCP 항목에는 **Edit configuration** 도 있습니다.
* 기기 항목은 **Sync to workspace** 를 클릭하면 이 항목이 미리 선택된 상태로 **Sync from device** 가 열립니다.

## 추가와 가져오기

도구 모음에서 **Add** 를 클릭하면 **Add to library** 가 열립니다. 현재는 **Cloud shared에 MCP 서버 추가하기** 만 지원합니다(JSON 가져오기 또는 직접 구성). 플러그인과 Skills의 파일 가져오기, 기기에 추가하기는 준비 중입니다.

### MCP JSON 가져오기

1. **Add to library** 에서 **MCP** 를 선택하고 위치를 Cloud shared로 설정합니다.
2. JSON 파일을 선택하거나 끌어다 놓습니다(`mcpServers` 형식과 단일 서버의 `url` / `command` 구성을 지원합니다).
3. 미리보기에서 서버 이름과 URL 또는 시작 명령을 확인합니다.
4. **Import N items** 를 클릭합니다. 가져온 항목은 기본적으로 꺼져 있습니다. 필요할 때 목록에서 켭니다.

| 제한 | 값 |
| - | - |
| 단일 파일 | 최대 10 MB |
| 한 번에 선택하는 파일 수 | 최대 20개 |
| 한 번에 가져오는 서버 수 | 최대 64개 |
| 이름 | 영문자, 숫자, 마침표, 하이픈, 밑줄만 사용 가능, 최대 64자. 같은 이름의 기존 항목은 덮어쓰지 않습니다 |
| 시크릿 | 구성에 평문 시크릿을 넣을 수 없습니다. 먼저 **Secrets & variables** 에 시크릿을 저장한 다음 구성의 값을 `${VARIABLE_NAME}` 으로 변경합니다 |
| 로컬 구성 | 로컬 환경(사용자 기기의 경로, localhost 등)에 의존하는 구성은 Cloud shared로 가져올 수 없습니다 |

가져오기에 실패하면 대화 상자에 이유(예: 잘못된 JSON 또는 불완전한 URL)가 표시됩니다. 안내에 따라 파일을 수정한 다음 다시 가져옵니다.

## MCP 서버 추가 또는 편집

**Add to library** 에서 **MCP** 를 선택하고 왼쪽 아래의 **Configure MCP manually** 를 클릭합니다. 기존 서버를 편집하려면 Cloud shared에서 MCP 상세를 열고 **Edit configuration** 을 클릭합니다. 편집 중에 왼쪽 아래의 **Delete** 를 클릭하면 서버가 삭제됩니다.

먼저 **Name** 을 입력한 다음(편집 시에는 변경 불가) **Type** 을 선택합니다.

| 유형 | 입력 항목 |
| - | - |
| STDIO(프로젝트의 클라우드 환경에서 시작되는 프로세스) | **Start command**(예: `npx`), **Arguments**(한 줄에 하나씩), **Environment variables** |
| Streamable HTTP(원격 서버에 직접 연결) | **URL**(http\:// 또는 [https://로](https://로) 시작). 선택 사항으로 **Bearer token variable** 과 **Headers** |

환경 변수, 토큰, 헤더의 값은 평문일 수 없습니다. **Secrets & variables** 의 변수 이름만 입력할 수 있으며, 필드에 워크스페이스에 이미 있는 시크릿 이름이 제안됩니다. 직접 추가한 MCP 서버는 기본적으로 켜져 있습니다.

## 기기에서 동기화

기기에 이미 설치된 플러그인, Skills, MCP 서버를 워크스페이스에 업로드해 클라우드 세션에서도 사용할 수 있게 합니다. **스캔과 업로드는 해당 기기의 데스크톱 앱에서만 할 수 있습니다.**

1. 데스크톱 앱의 도구 모음에서 **Sync from device** 를 클릭합니다.
2. **Source device** 의 기본값은 이 기기입니다. **Scan device** 를 클릭합니다.
3. 스캔이 끝나면 동기화할 항목을 선택합니다(기본적으로 아무것도 선택되지 않으며, 선택하지 않은 항목은 이 기기에만 남습니다).
4. 필요에 따라 버전 충돌, hooks, 시크릿을 처리합니다(아래 참고).
5. **Sync selected** 를 클릭합니다. 완료되면 클라우드 세션이 다음 턴에 항목을 불러오며, 기기의 설치와 스위치는 변경되지 않습니다.

일부 항목의 동기화에 실패하면 결과에 항목별 이유가 나열됩니다. **Retry incomplete** 를 클릭하면 실패한 항목만 다시 시도합니다.

### 선택할 수 없는 항목

| 라벨 | 해결 방법 |
| - | - |
| Already shared | 클라우드에 같은 버전이 이미 있습니다. 동기화할 필요가 없습니다 |
| Uses a local path | 원격으로 접근할 수 있는 구성으로 변경한 다음 동기화합니다 |
| Secret reference required | **Use secret reference** 를 클릭하고 워크스페이스 시크릿을 선택합니다(사용할 수 있는 시크릿이 없으면 **Add workspace secret** 을 클릭합니다). 그런 다음 이 기기에서 구성의 평문을 변수 참조로 변경하고 동기화합니다. 평문 시크릿은 업로드되지 않습니다 |

### 버전 충돌과 hooks

* 선택한 항목의 다른 버전이 클라우드에 이미 있으면 **Keep cloud version**(기본값, 이 항목은 업로드되지 않음) 또는 **Use device version**(기존 클라우드 버전을 대체) 중 하나를 선택합니다.
* 선택한 플러그인에 hooks(도구 호출 전후에 명령을 자동으로 실행할 수 있음)가 포함되어 있으면 **Allow selected plugin hooks to run in cloud tasks** 를 체크해야 동기화할 수 있습니다.

## 참고 및 제한 사항

* 첫 릴리스에서는 개인 워크스페이스 수준의 플러그인 라이브러리만 제공합니다. 플러그인 마켓은 없습니다.
* 현재는 Cloud shared MCP 서버만 직접 추가할 수 있습니다. 플러그인과 Skills는 **Sync from device** 로 업로드할 수 있습니다.
* MCP 구성에는 평문 시크릿을 넣을 수 없습니다. **Secrets & variables** 의 변수만 참조할 수 있습니다.

## 자주 묻는 질문

### "Cloud shared"와 "Device only"의 차이는 무엇인가요?

Cloud shared 항목은 워크스페이스에 업로드되어 모든 클라우드 세션에서 사용할 수 있습니다. Device only 항목은 해당 기기에 남아 있으며, 그 기기에서 실행되는 세션에서만 사용할 수 있습니다.

### 가져온 항목이 왜 적용되지 않나요?

가져온 MCP 서버는 기본적으로 꺼져 있습니다. 목록에서 스위치를 켜세요. 클라우드 스위치는 세션의 다음 턴에 불러옵니다.

### MCP 서버를 왜 클라우드로 동기화할 수 없나요?

기기의 로컬 경로(또는 localhost)에 의존하거나, 구성에 평문 시크릿이 포함되어 있기 때문입니다. 전자는 원격으로 접근할 수 있는 구성으로 변경하세요. 후자는 **Use secret reference** 를 사용하고 기기에서 구성을 변수 참조로 변경한 다음 동기화하세요.

### 웹에서 기기를 스캔할 수 없는 이유는 무엇인가요?

스캔은 기기 자체의 파일을 읽으므로 해당 기기의 데스크톱 앱에서만 할 수 있습니다.

## 관련 문서

* [커넥터](https://docs.aihubmix.com/ko/cloud/integrations/connectors.md)
* [워크스페이스 설정](https://docs.aihubmix.com/ko/cloud/settings/workspace.md)
* [클라우드 서버 개요](https://docs.aihubmix.com/ko/cloud/cloud-host/overview.md)


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