메인 콘텐츠로 건너뛰기
플러그인, MCP, Skills 는 에이전트가 할 수 있는 작업을 확장합니다. 플러그인에는 명령과 hooks가 포함될 수 있습니다. MCP 서버는 에이전트를 외부 도구에 연결합니다. Skill은 에이전트를 위해 작성된 지시 모음입니다. 세 가지 모두 Settings › Integrations › Plugins 에서 관리하며, 클라우드 세션은 시작할 때 켜져 있는 항목을 불러옵니다. 서드파티 계정 로그인이 필요한 서비스(GitHub, Gmail, Notion 등)는 여기서 관리하지 않습니다. 커넥터에서 인증합니다.

사용 가능 여부

찾는 위치

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

주요 개념

플러그인 라이브러리는 워크스페이스마다 별도입니다. 클라우드 스위치와 각 기기의 스위치는 서로 독립적입니다. 기기에서 항목을 꺼도 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 를 클릭합니다. 가져온 항목은 기본적으로 꺼져 있습니다. 필요할 때 목록에서 켭니다.
가져오기에 실패하면 대화 상자에 이유(예: 잘못된 JSON 또는 불완전한 URL)가 표시됩니다. 안내에 따라 파일을 수정한 다음 다시 가져옵니다.

MCP 서버 추가 또는 편집

Add to library 에서 MCP 를 선택하고 왼쪽 아래의 Configure MCP manually 를 클릭합니다. 기존 서버를 편집하려면 Cloud shared에서 MCP 상세를 열고 Edit configuration 을 클릭합니다. 편집 중에 왼쪽 아래의 Delete 를 클릭하면 서버가 삭제됩니다. 먼저 Name 을 입력한 다음(편집 시에는 변경 불가) Type 을 선택합니다. 환경 변수, 토큰, 헤더의 값은 평문일 수 없습니다. Secrets & variables 의 변수 이름만 입력할 수 있으며, 필드에 워크스페이스에 이미 있는 시크릿 이름이 제안됩니다. 직접 추가한 MCP 서버는 기본적으로 켜져 있습니다.

기기에서 동기화

기기에 이미 설치된 플러그인, Skills, MCP 서버를 워크스페이스에 업로드해 클라우드 세션에서도 사용할 수 있게 합니다. 스캔과 업로드는 해당 기기의 데스크톱 앱에서만 할 수 있습니다.
  1. 데스크톱 앱의 도구 모음에서 Sync from device 를 클릭합니다.
  2. Source device 의 기본값은 이 기기입니다. Scan device 를 클릭합니다.
  3. 스캔이 끝나면 동기화할 항목을 선택합니다(기본적으로 아무것도 선택되지 않으며, 선택하지 않은 항목은 이 기기에만 남습니다).
  4. 필요에 따라 버전 충돌, hooks, 시크릿을 처리합니다(아래 참고).
  5. Sync selected 를 클릭합니다. 완료되면 클라우드 세션이 다음 턴에 항목을 불러오며, 기기의 설치와 스위치는 변경되지 않습니다.
일부 항목의 동기화에 실패하면 결과에 항목별 이유가 나열됩니다. Retry incomplete 를 클릭하면 실패한 항목만 다시 시도합니다.

선택할 수 없는 항목

버전 충돌과 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 를 사용하고 기기에서 구성을 변수 참조로 변경한 다음 동기화하세요.

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

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

관련 문서