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ón | Cuenta de desarrollador | Qué hace |
|---|---|---|
create | no es necesaria | Crea el elemento y su código de instalación. |
update | no es necesaria | Cambia campos, contenido, versión o visibilidad. |
get, list, delete | no es necesaria | Lee o elimina tus elementos. |
install | no es necesaria | 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 de 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 elemento: 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 update). |
sourceUrl, manifestUrl | Enlaces opcionales. |
dependencies | Solo 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 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 | Nada 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 elemento | Significado |
|---|---|
draft | No enviado, o rechazado. |
pending_review, review | Pendiente de revisión. |
active | Aprobado. Aparece en la tienda cuando la visibilidad es public. |
revoked | Retirado. |
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.