Підключення
Додайте https://neboai.com/mcp до будь-якого MCP-клієнта, що підтримує віддалені сервери. Клієнт знаходить сервер авторизації, реєструється й виконує ваш вхід через OAuth і PKCE. Підключитися може будь-який акаунт NeboAI. Токени доступу діють одну годину й оновлюються протягом 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 та інтерфейсів застосунків. |
list-binaries, delete-binary | налаштовується автоматично | Керує завантаженими виконуваними файлами. |
submit | налаштовується автоматично | Надсилає версію на перевірку. |
| Поле | Значення |
|---|---|
name | Назва для відображення. З неї утворюється slug. |
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>, де 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, а update з dependencies замінює збережений 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: виконуваний файл супровідного процесу як file з його platform, а сторінку як ui — архів .tar.gz папки ui/. Див. Застосунки.
Перевірка
submit потребує вмісту основного файлу й опису від 10 до 500 символів. Кожне подання сканується. Чисте сканування може бути схвалене автоматично; усе позначене йде на ручну перевірку. Схвалення підписує всі виконувані файли й робить версію активною. Відхилена версія повертається в чернетки.
| Статус продукту | Значення |
|---|---|
draft | Не подано або відхилено. |
pending_review, review | Очікує перевірки. |
active | Схвалено. Показується на маркетплейсі, коли видимість public. |
revoked | Знято з публікації. |
Коди встановлення
Кожен продукт отримує код встановлення під час створення: SKIL-, AGNT-, PLUG-, APPS-, CONN- або COLL-, а за ним вісім символів. Введення коду як повідомлення в чаті Nebo встановлює продукт; див. Основні поняття.