NeboAI
NeboAI
Empezar

Publicación

Se publica en la tienda de NeboAI a través del servidor MCP de NeboAI. Conecta un cliente MCP, crea el elemento, sube sus archivos y envía una versión a revisión. Las mismas herramientas sirven para skills, empleados, plugins y apps.

Conectar

Añade 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

Cualquiera 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 cuota ni paso de aprobación.

Para publicar en nombre de un equipo en lugar de en el tuyo, selecciona la cuenta del equipo para la sesión. Tienes que ser miembro del equipo.

developer(resource: "account", action: "list")
developer(resource: "account", action: "select", slug: "example-team")

developer también puede configurar tu cuenta con antelación (action: "create", opcional) y enumera 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ónCuenta de desarrolladorQué hace
createno es necesariaCrea el elemento y su código de instalación.
updateno es necesariaCambia campos, contenido, versión o visibilidad.
get, list, deleteno es necesariaLee o elimina tus elementos.
installno es necesariaInstala en uno de tus bots: id, botId y cascade para incluir las dependencias.
bundle-tokense configura automáticamenteUn token para subir un zip de archivos de texto.
binary-tokense configura automáticamenteUn token para subir binarios, plugin.json, agent.json e interfaces de apps.
list-binaries, delete-binaryse configura automáticamenteGestiona los binarios subidos.
submitse configura automáticamenteEnvía una versión a revisión.
CampoSignificado
nameNombre visible. El slug se genera a partir de él.
descriptionUna línea, de 10 a 500 caracteres para enviarla.
manifestContentEl archivo principal del elemento: SKILL.md, AGENT.md o PLUGIN.md.
versionVersión semántica. Valor predeterminado: 0.1.0.
visibilityprivate (predeterminado), loop (compartido con tus canales) o public.
categoryCategoría de la tienda.
longDescriptionEl texto «Qué hace» de la tienda (solo update).
sourceUrl, manifestUrlEnlaces opcionales.
dependenciesSolo empleados. Consulta Dependencias.

La herramienta marketplace busca en la tienda y enumera las categorías. La herramienta pricing pone precio a un elemento; los elementos de pago requieren completar el alta 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 única carpeta raíz, 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 paqueteLímite
Tamaño del zip50 MB
Cada archivo10 MB
Todos los archivos50 MB
Tipos de archivoTexto, 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/.
RutasNada de .. ni de 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 binarios. Los empleados no necesitan binario; basta con config. Para incluir la carpeta skills/ propia del empleado, sube el paquete como bundle: AGENT.md, agent.json y skills/ en un mismo 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 sustituye a la configuración guardada, incluidas las dependencias establecidas con create o update, y un update con dependencies sustituye al 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 comprueba primero el nombre cualificado y después el id. Un plugin se incluye en skills. Los plugins que requieren las skills indicadas en agent.json se añaden automáticamente. Cuando un propietario 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 con el plugin.json y las skills del plugin; consulta Publicar un plugin. Una app que solo tiene página no necesita binario: sube un único bundle con bundle-token que contenga AGENT.md (con artifact_type: app), agent.json, manifest.json, ui/ y las skills/ que tenga. 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 que se marque pasa a revisión manual. La aprobación firma los binarios que haya y activa la versión. Una versión rechazada vuelve a borrador.

Estado del elementoSignificado
draftNo enviado, o rechazado.
pending_review, reviewPendiente de revisión.
activeAprobado. Aparece en la tienda cuando la visibilidad es public.
revokedRetirado.

Códigos de instalación

Cada elemento 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 elemento; consulta Conceptos básicos.