플러그인

확장은 git에서, 설치 전에 검토하고

플러그인, MCP 서버, 스킬, 에이전트, 테마, 글꼴, 언어, 모델 제공자, 메시징 연결이 모두 같은 방식으로 들어옵니다. git 저장소나 폴더에서 받아 출처와 해시를 검토한 뒤 설치합니다.

Nord 테마 패키지의 설치 검토 창. 출처 폴더, 내용 해시, 호환 버전과 설치 버튼
마켓플레이스 탭의 추가 메뉴. 마켓플레이스 추가, Git URL이나 폴더에서 설치, MCP 서버 추가, 플러그인 만들기, 파일에서 설치

추가하는 길

마켓플레이스, git 주소, 폴더, 파일

마켓플레이스 탭의 추가 메뉴에서 마켓플레이스 저장소를 더하거나, git 주소나 폴더에서 패키지 하나를 바로 설치합니다.

  • 공식. Ave에 들어 있는 출처이며, 호스트 비밀 값을 받을 수 있는 유일한 출처입니다.
  • 관리. 조직이 시스템 정책 파일의 marketplaces.additional로 더합니다.
  • 사용자 지정과 직접. 설정 → 마켓플레이스 → 추가로 저장소를 더하거나, git 폴더 하나를 패키지 하나로 설치합니다.
  • 링크로 설치. ave://install 링크는 확인 화면만 엽니다. 확인하기 전에는 아무것도 설치되지 않습니다.

설치 과정

검토한 그대로 설치됩니다

설치 계획은 검토한 내용의 해시에 묶입니다. 그 사이 폴더가 바뀌어도 설치되는 것은 검토한 내용이고, 계획은 몇 분 뒤 만료됩니다.

Git 주소나 폴더에서 설치 창의 검토 단계. 테마 패키지이며 코드를 실행하지 않는다는 표시

주소를 확인

어떤 종류의 패키지인지, 코드를 실행하는지, 어디서 오는지를 먼저 보여 줍니다.

Nord 1.0.1 설치 계획. 폴더 내용 해시에 묶여 있고 계획이 만료되기까지 남은 시간

설치 계획

‘검토한 것이 설치됩니다’와 함께 내용 해시와 만료 시간을 보여 줍니다.

테마 설정의 색 테마 목록에 Moonstone, Gallery와 마켓플레이스에서 설치한 Tokyo Night 테마가 있는 화면. 어두운 버전은 Tokyo Night을 켠 상태

바로 적용되는 테마

설치한 테마는 테마 설정에 마켓플레이스 표시와 함께 나타납니다. 어두운 화면의 사진은 Tokyo Night 테마를 켠 모습입니다.

모델 설정 화면 오른쪽 위의 ‘마켓플레이스에서 제공자 더 보기’ 버튼

제공자도 패키지로

기본으로 없는 모델 제공자는 마켓플레이스 패키지로 더합니다.

공식 마켓플레이스

공식 카탈로그에 있는 것

공식 마켓플레이스는 git 저장소 ken-jo/agent-marketplace이고, 그 안의 marketplace.json이 모든 패키지를 나열합니다. 아래 숫자와 이름은 그 파일을 기록한 커밋에서 그대로 읽었습니다.

패키지 399개 · 카탈로그 커밋 1f21a1839dcb

  • 3

    플러그인

    Hello World · Ave Local Indexer · Ave Meeting

  • 1

    에이전트 플러그인

    Meeting Notes Kit

  • 23

    MCP 서버

    AWS KB Retrieval MCP · Brave Search MCP · Browserbase MCP · Context Mode MCP 외 19개

  • 153

    스킬

    Angular Architect · Api Designer · Architecture Designer · Atlassian Mcp 외 149개

  • 169

    에이전트

    Anthropologist · Geographer · Historian · Narratologist 외 165개

  • 35

    모델 제공자

    AI Hub Mix Provider · AskSage Provider · Azure AI Foundry Provider · Baseten Provider 외 31개

  • 14

    테마

    Catppuccin Latte · Catppuccin Mocha · Cherry Blossom · Executive Graphite 외 10개

  • 1

    언어

    한국어 (Korean)

  • 커밋에 고정. 카탈로그의 버전마다 설치할 git 커밋이 적혀 있고, 설치는 그 커밋에 묶입니다.
  • 코드는 릴리스 압축 파일로. 플러그인 버전은 릴리스 압축 파일과 그 SHA-256을 적어 둬서, 카탈로그가 설치할 바이트를 정확히 고정합니다.
  • 필요한 버전을 선언. 버전마다 필요한 가장 낮은 Ave 버전을 적고, 더 새 Ave가 필요한 버전은 설치하지 않습니다.
  • 네트워크도 선언. 플러그인은 접속할 수 있는 주소를 적어 두고(최대 16개), 카탈로그가 그 목록을 함께 싣습니다.

만드는 사람에게

두 가지 실행 방식

entry는 JavaScript 모듈, process는 표준 입출력의 JSON-RPC로 호스트와 대화하는 아무 언어의 프로그램입니다. process는 OS 샌드박스가 켜져 있어야 돌고 Windows에서는 지원하지 않습니다.

나눠서 내보내기

게시자는 특정 버전을 회수하거나 설치본의 일부에 먼저 내보낼 수 있고, 사용자는 canaryOptIn 설정으로 카나리 버전을 받을 수 있습니다.

알림은 종류별로

플러그인이 선언한 알림 종류는 설치할 때 플러그인이 정한 기본값으로 켜지거나 꺼지고, 종류마다 따로 끌 수 있습니다. 쿨다운과 빈도 제한을 지켜 카드나 OS 알림으로 옵니다. 플러그인이 제안한 대화는 수락해야 시작합니다.

자주 묻는 질문

플러그인이 앱 안에서 그대로 실행되나요?

아니요. 설치 경로와 관계없이 모든 플러그인은 앱 밖의 자기 프로세스에서 돌고, 샌드박스를 켜면 그 안에서 돕니다. 하나가 시작에 실패해도 나머지는 계속 동작합니다.

플러그인이 아무 사이트에나 접속할 수 있나요?

networkAccess.allowedDomains에 선언한 도메인에만, 많아야 16개까지 접속합니다. 호스트가 한 번에 한 홉씩 보내고 리다이렉트마다 다시 확인합니다.

설치한 파일이 바뀌면 어떻게 되나요?

설치할 때 파일마다 SHA-256을 영수증에 기록하고 실행할 때 다시 확인합니다. 맞지 않는 플러그인은 올라오지 않습니다.

업데이트는 자동인가요?

실행할 때와 정해진 주기로 새 버전을 확인하고, 대화가 쉬는 동안 하나씩 적용합니다. 권한이나 MCP 서버, 훅이 승인한 것과 달라지면 자동으로 적용하지 않고 검토를 기다립니다.

조직에서 설치를 관리할 수 있나요?

정책 파일로 허용·차단 목록, 기본 설치, 필수 설치를 정합니다. 필수 패키지는 지우거나 끌 수 없습니다.

마켓플레이스 주소에는 제한이 있나요?

일반 http와 내부망 주소는 한 번 묻고, 클라우드 메타데이터 주소처럼 안전하지 않은 주소는 항상 거부합니다.

직접 만든 플러그인은 어떻게 시험하나요?

패키징하지 않은 빌드를 AVE_DEV=1로 실행하고 설정 → 확장 설정 → 개발자 도구 → 로컬 폴더에서 설치를 고릅니다.

이어서 읽기