Подключение
Добавьте 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 | Отображаемое имя. Из него формируется слаг. |
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-архив. Единственная папка верхнего уровня в архиве удаляется автоматически, а папки сборки и системы контроля версий пропускаются.
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/. Приложение с sidecar использует ту же загрузку бинарных файлов через инструмент agent: бинарный файл sidecar как file с его platform, а страницу как ui — архив .tar.gz папки ui/. См. Приложения.
Проверка
Для submit нужно содержимое главного файла и описание длиной от 10 до 500 символов. Каждая отправка сканируется. Чистая проверка может быть одобрена автоматически; всё отмеченное уходит на ручную проверку. При одобрении бинарные файлы подписываются, а версия становится активной. Отклонённая версия возвращается в черновик.
| Статус объекта | Значение |
|---|---|
draft | Не отправлен или отклонён. |
pending_review, review | Ожидает проверки. |
active | Одобрен. Размещается в маркетплейсе, если видимость — public. |
revoked | Снят с публикации. |
Коды установки
Каждый объект получает код установки при создании: SKIL-, AGNT-, PLUG-, APPS-, CONN- или COLL- и восемь символов после префикса. Если отправить код сообщением в чат Nebo, объект установится; см. Основные понятия.