Conectar
Agrega https://neboai.com/mcp a cualquier cliente MCP que admita servidores remotos. El cliente descubre el servidor de autorización, se registra e inicia tu sesión con OAuth y PKCE. Cualquier cuenta de NeboAI puede conectarse. Los tokens de acceso duran una hora y se renuevan durante 30 días.
Cuenta de desarrollador
Cualquier persona con una cuenta de NeboAI puede publicar. Para enviar una versión y subir archivos se usa tu cuenta de desarrollador, que se configura por ti, gratis, la primera vez que envías algo o pides un token de subida. No hay ningún cargo ni paso de aprobación.
Para publicar en nombre de un equipo en lugar de a título personal, selecciona la cuenta del equipo para la sesión. Debes ser miembro del equipo.
developer(resource: "account", action: "list") developer(resource: "account", action: "select", slug: "example-team")
developer también puede configurar tu cuenta por adelantado (action: "create", opcional) y lista y selecciona espacios de nombres (resource: "namespace"). El espacio de nombres seleccionado pasa a formar parte de cada nombre completo que publiques.
Herramientas
Las herramientas skill, agent y plugin comparten un mismo conjunto de acciones. Las apps se publican con la herramienta agent.
| Acción | Cuenta de desarrollador | Qué hace |
|---|---|---|
create | no se necesita | Crea el artefacto y su código de instalación. |
update | no se necesita | Cambia campos, contenido, versión o visibilidad. |
get, list, delete | no se necesita | Lee o quita tus artefactos. |
install | no se necesita | Instala en uno de tus bots: id, botId y cascade para incluir las dependencias. |
bundle-token | se configura automáticamente | Un token para subir un zip con archivos de texto. |
binary-token | se configura automáticamente | Un token para subir binarios, plugin.json, agent.json e interfaces de apps. |
list-binaries, delete-binary | se configura automáticamente | Gestiona los binarios subidos. |
submit | se configura automáticamente | Envía una versión a revisión. |
| Campo | Significado |
|---|---|
name | Nombre visible. El slug se genera a partir de él. |
description | Una línea, de 10 a 500 caracteres para enviarla. |
manifestContent | El archivo principal del artefacto: SKILL.md, AGENT.md o PLUGIN.md. |
version | Versión semántica. Valor predeterminado: 0.1.0. |
visibility | private (predeterminado), loop (compartido con tus canales) o public. |
category | Categoría de la tienda. |
longDescription | El texto "Qué hace" de la tienda (solo con update). |
sourceUrl, manifestUrl | Enlaces opcionales. |
dependencies | Solo empleados. Consulta Dependencias. |
La herramienta marketplace busca en la tienda y lista las categorías. La herramienta pricing le pone precio a un artefacto; los artefactos de pago requieren completar el registro para recibir pagos.
Publica una skill
Crea la skill con su SKILL.md como contenido.
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>") Ponle nombre a la skill con el name de su frontmatter. Su nombre completo es @<namespace>/skills/<slug>, con el slug generado a partir del nombre visible, y los bots resuelven los nombres completos comparándolos con el name del frontmatter, así que ambos deben coincidir.
Si la skill tiene otros archivos, sube la carpeta como zip. Si el zip tiene una sola carpeta de nivel superior, se elimina automáticamente, y se omiten las carpetas de compilación y de control de versiones.
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
| Regla del paquete | Límite |
|---|---|
| Tamaño del zip | 50 MB |
| Cada archivo | 10 MB |
| Todos los archivos | 50 MB |
| Tipos de archivo | Texto, código, datos, imágenes, PDF y fuentes, como .md, .py, .js, .ts, .json, .yaml, .csv, .html. Se acepta cualquier cosa dentro de scripts/, bin/ o dist/. |
| Rutas | Sin .. y sin rutas absolutas. |
Haz pública la skill y envía una versión.
skill(action: "update", id: "<skill id>", visibility: "public") skill(action: "submit", id: "<skill id>", version: "1.0.0")
Publica un empleado
Crea el empleado con su AGENT.md como contenido y sus dependencias de la tienda.
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" } ] }) Sube agent.json con un token de binario. Los empleados no necesitan binario; config es suficiente. Para incluir la carpeta skills/ propia del empleado, sube el paquete como bundle: AGENT.md, agent.json y skills/ en un solo 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
Mantén las dependencias en agent.json. Un agent.json subido reemplaza la configuración guardada, incluidas las dependencias definidas con create o update, y un update con dependencies reemplaza el agent.json guardado. Si usas ambos, pon el mismo objeto dependencies dentro de agent.json.
Dependencias
dependencies tiene las listas skills, agents y connectors. Cada entrada es {qualifiedName, id, name}; NeboAI revisa primero el nombre calificado y luego el id. Un plugin se incluye en skills. Los plugins que requieren las skills nombradas en agent.json se agregan automáticamente. Cuando un dueño instala tu empleado desde la tienda o con su código, el bot instala con él sus dependencias de skills, plugins y empleados.
Publica un plugin o una app
Los plugins suben un binario por plataforma junto con el plugin.json y las skills del plugin; consulta Cómo publicar un plugin. Una app que solo tiene página no necesita binario: sube un solo bundle con bundle-token que contenga AGENT.md (con artifact_type: app), agent.json, manifest.json, ui/ y cualquier skills/. Una app con sidecar usa la misma subida de binarios con la herramienta agent: el binario del sidecar como file con su platform, y la página como ui, un .tar.gz de la carpeta ui/. Consulta Apps.
Revisión
submit necesita el contenido del archivo principal y una descripción de 10 a 500 caracteres. Cada envío se analiza. Un análisis limpio puede aprobarse automáticamente; todo lo marcado pasa a revisión manual. Al aprobarse, se firman los binarios y la versión queda activa. Una versión rechazada vuelve a borrador.
| Estado del artefacto | Significado |
|---|---|
draft | No enviado, o rechazado. |
pending_review, review | En espera de revisión. |
active | Aprobado. Aparece en la tienda cuando la visibilidad es public. |
revoked | Retirado. |
Códigos de instalación
Cada artefacto recibe su código de instalación al crearse: SKIL-, AGNT-, PLUG-, APPS-, CONN- o COLL- seguido de ocho caracteres. Escribir el código como mensaje en un chat de Nebo instala el artefacto; consulta Conceptos básicos.