연결
원격 서버를 지원하는 MCP 클라이언트에 https://neboai.com/mcp를 추가하세요. 클라이언트가 인증 서버를 찾아 스스로 등록하고, OAuth와 PKCE로 로그인시켜 줍니다. 모든 NeboAI 계정으로 연결할 수 있습니다. 액세스 토큰은 1시간 동안 유효하며 30일 동안 갱신됩니다.
개발자 계정
NeboAI 계정이 있으면 누구나 게시할 수 있습니다. 버전을 제출하거나 파일을 업로드할 때는 개발자 계정을 사용하며, 처음 제출하거나 업로드 토큰을 요청할 때 무료로 자동 설정됩니다. 수수료도 승인 절차도 없습니다.
내가 아닌 팀 이름으로 게시하려면, 세션에서 팀 계정을 선택하세요. 해당 팀의 구성원이어야 합니다.
developer(resource: "account", action: "list") developer(resource: "account", action: "select", slug: "example-team")
developer로 계정을 미리 설정할 수도 있고(action: "create", 선택 사항), 네임스페이스를 나열하고 선택할 수도 있습니다(resource: "namespace"). 선택한 네임스페이스는 게시하는 모든 정규 이름의 일부가 됩니다.
도구
skill, agent, plugin 도구는 같은 작업 세트를 공유합니다. 앱은 agent 도구로 게시합니다.
| 작업 | 개발자 계정 | 하는 일 |
|---|---|---|
create | 필요 없음 | 아티팩트와 설치 코드를 만듭니다. |
update | 필요 없음 | 필드, 내용, 버전 또는 공개 범위를 변경합니다. |
get, list, delete | 필요 없음 | 내 아티팩트를 읽거나 제거합니다. |
install | 필요 없음 | 내 봇 중 하나에 설치합니다: id, botId, 그리고 종속성을 포함하려면 cascade. |
bundle-token | 자동 설정 | 텍스트 파일 zip을 업로드하기 위한 토큰. |
binary-token | 자동 설정 | 바이너리, plugin.json, agent.json, 앱 UI를 업로드하기 위한 토큰. |
list-binaries, delete-binary | 자동 설정 | 업로드된 바이너리를 관리합니다. |
submit | 자동 설정 | 버전을 검토에 제출합니다. |
| 필드 | 의미 |
|---|---|
name | 표시 이름. 슬러그는 이 이름으로 만들어집니다. |
description | 한 줄, 제출하려면 10~500자. |
manifestContent | 아티팩트의 주 파일: SKILL.md, AGENT.md 또는 PLUGIN.md. |
version | 시맨틱 버전. 기본값 0.1.0. |
visibility | private(기본값), loop(내 채널과 공유) 또는 public. |
category | 마켓플레이스 카테고리. |
longDescription | 마켓플레이스의 “하는 일” 텍스트(update에서만). |
sourceUrl, manifestUrl | 선택적 링크. |
dependencies | 직원 전용. 종속성을 참조하세요. |
marketplace 도구는 마켓플레이스를 검색하고 카테고리를 나열합니다. pricing 도구는 아티팩트에 가격을 설정합니다. 유료 아티팩트는 정산 온보딩을 완료해야 합니다.
스킬 게시하기
SKILL.md를 내용으로 넣어 스킬을 만드세요.
skill(action: "create", name: "invoice-totals",
description: "Add up invoice line items, apply tax, and report the totals.",
category: "finance", version: "1.0.0", manifestContent: "<contents of SKILL.md>") 스킬 이름은 프런트매터의 name으로 정하세요. 정규 이름은 @<namespace>/skills/<slug>이며 슬러그는 표시 이름으로 만들어집니다. 봇은 정규 이름을 프런트매터의 name과 대조하므로 둘이 일치해야 합니다.
스킬에 다른 파일이 있으면 폴더를 zip으로 업로드하세요. zip 안에 최상위 폴더가 하나만 있으면 자동으로 제거되며, 빌드 폴더와 버전 관리 폴더는 건너뜁니다.
skill(action: "bundle-token", id: "<skill id>") cd invoice-totals && zip -r ../invoice-totals.zip . && cd .. curl -X POST "https://neboai.com/api/v1/skills/<skill id>/bundle" \ -H "Authorization: Bearer <token>" \ -F file=@invoice-totals.zip
| 번들 규칙 | 한도 |
|---|---|
| zip 크기 | 50 MB |
| 파일당 | 10 MB |
| 전체 파일 | 50 MB |
| 파일 유형 | 텍스트, 코드, 데이터, 이미지, PDF, 글꼴. 예: .md, .py, .js, .ts, .json, .yaml, .csv, .html. scripts/, bin/, dist/ 아래의 파일은 모두 허용됩니다. |
| 경로 | .. 금지, 절대 경로 금지. |
스킬을 공개로 설정하고 버전을 제출하세요.
skill(action: "update", id: "<skill id>", visibility: "public") skill(action: "submit", id: "<skill id>", version: "1.0.0")
직원 게시하기
AGENT.md를 내용으로, 마켓플레이스 종속성과 함께 직원을 만드세요.
agent(action: "create", name: "Support Coordinator",
description: "Answers every customer message the day it arrives and escalates what it cannot settle.",
version: "1.0.0", manifestContent: "<contents of AGENT.md>",
dependencies: { skills: [ { qualifiedName: "@example-studio/skills/reply-drafting", id: "<skill id>", name: "reply-drafting" } ] }) 바이너리 토큰으로 agent.json을 업로드하세요. 직원에게는 바이너리가 필요 없으며 config면 충분합니다. 직원 자체의 skills/ 폴더를 포함하려면 대신 패키지를 번들로 업로드하세요: AGENT.md, agent.json, skills/를 zip 하나에 담습니다.
agent(action: "binary-token", id: "<agent id>") curl -X POST "https://neboai.com/api/v1/developer/apps/<agent id>/binaries" \ -H "Authorization: Bearer <token>" \ -F config=@support-coordinator/agent.json
종속성은 agent.json에 두세요. 업로드한 agent.json은 create나 update로 설정한 종속성을 포함해 저장된 구성을 대체하며, dependencies를 넣은 update는 저장된 agent.json을 대체합니다. 둘 다 사용할 때는 같은 dependencies 객체를 agent.json 안에 넣으세요.
종속성
dependencies에는 skills, agents, connectors 목록이 있습니다. 각 항목은 {qualifiedName, id, name}이며, NeboAI는 정규화된 이름을 먼저 확인한 다음 ID를 확인합니다. 플러그인은 skills 아래에 나열합니다. agent.json에 지정된 스킬이 필요로 하는 플러그인은 자동으로 추가됩니다. 소유자가 마켓플레이스에서 또는 코드로 직원을 설치하면, 봇은 해당 직원의 스킬, 플러그인, 직원 종속 항목을 함께 설치합니다.
플러그인 또는 앱 게시하기
플러그인은 플랫폼마다 바이너리 하나를 플러그인의 plugin.json 및 스킬과 함께 업로드합니다. 플러그인 출시하기를 참조하세요. 페이지만 있는 앱은 바이너리가 필요 없습니다. bundle-token으로 AGENT.md(artifact_type: app 포함), agent.json, manifest.json, ui/, 그리고 있다면 skills/를 담은 번들 하나를 업로드하세요. 사이드카가 있는 앱은 agent 도구로 같은 바이너리 업로드를 사용합니다. 사이드카 바이너리는 platform과 함께 file로, 페이지는 ui/ 폴더의 .tar.gz인 ui로 업로드합니다. 앱을 참조하세요.
검토
submit에는 주 파일의 내용과 10~500자의 설명이 필요합니다. 모든 제출물은 검사를 거칩니다. 문제가 없으면 자동으로 승인될 수 있고, 표시된 항목은 수동 검토로 넘어갑니다. 승인되면 바이너리가 서명되고 해당 버전이 활성화됩니다. 거부된 버전은 초안으로 돌아갑니다.
| 아티팩트 상태 | 의미 |
|---|---|
draft | 제출되지 않았거나 거부됨. |
pending_review, review | 검토 대기 중. |
active | 승인됨. 공개 범위가 public이면 마켓플레이스에 등록됩니다. |
revoked | 철회됨. |
설치 코드
모든 아티팩트는 만들어질 때 설치 코드를 받습니다. SKIL-, AGNT-, PLUG-, APPS-, CONN- 또는 COLL- 뒤에 여덟 문자가 붙습니다. Nebo 채팅에 코드를 메시지로 입력하면 아티팩트가 설치됩니다. 핵심 개념을 참조하세요.