Connexion
Ajoutez https://neboai.com/mcp à n'importe quel client MCP qui prend en charge les serveurs distants. Le client découvre le serveur d'autorisation, s'enregistre et vous connecte avec OAuth et PKCE. N'importe quel compte NeboAI peut se connecter. Les jetons d'accès durent une heure et s'actualisent pendant 30 jours.
Compte développeur
Toute personne disposant d'un compte NeboAI peut publier. La soumission d'une version et le téléversement de fichiers utilisent votre compte développeur, qui est créé pour vous, gratuitement, la première fois que vous soumettez ou demandez un jeton de téléversement. Il n'y a ni frais ni étape d'approbation.
Pour publier au nom d'une équipe plutôt qu'en votre nom, sélectionnez le compte de l'équipe pour la session. Vous devez être membre de l'équipe.
developer(resource: "account", action: "list") developer(resource: "account", action: "select", slug: "example-team")
developer peut aussi créer votre compte à l'avance (action: "create", facultatif) et liste et sélectionne les espaces de noms (resource: "namespace"). L'espace de noms sélectionné fait partie de chaque nom qualifié que vous publiez.
Outils
Les outils skill, agent et plugin partagent un même ensemble d'actions. Les applications sont publiées avec l'outil agent.
| Action | Compte développeur | Rôle |
|---|---|---|
create | non requis | Crée l'élément et son code d'installation. |
update | non requis | Modifie les champs, le contenu, la version ou la visibilité. |
get, list, delete | non requis | Lit ou supprime vos éléments. |
install | non requis | Installe sur l'un de vos bots : id, botId, et cascade pour inclure les dépendances. |
bundle-token | créé automatiquement | Un jeton pour téléverser un zip de fichiers texte. |
binary-token | créé automatiquement | Un jeton pour téléverser des binaires, plugin.json, agent.json et des interfaces d'application. |
list-binaries, delete-binary | créé automatiquement | Gère les binaires téléversés. |
submit | créé automatiquement | Soumet une version pour examen. |
| Champ | Signification |
|---|---|
name | Nom affiché. Le slug en est dérivé. |
description | Une ligne, de 10 à 500 caractères pour la soumission. |
manifestContent | Le fichier principal de l'élément : SKILL.md, AGENT.md ou PLUGIN.md. |
version | Version sémantique. Par défaut 0.1.0. |
visibility | private (par défaut), loop (partagé avec vos Canaux) ou public. |
category | Catégorie de la boutique. |
longDescription | Le texte « Ce qu'il fait » de la boutique (update uniquement). |
sourceUrl, manifestUrl | Liens facultatifs. |
dependencies | Employés uniquement. Voir Dépendances. |
L'outil marketplace recherche dans la boutique et liste les catégories. L'outil pricing fixe un prix pour un élément ; les éléments payants nécessitent de terminer la configuration des versements.
Publier un skill
Créez le skill avec son SKILL.md comme contenu.
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>") Nommez le skill avec le champ name de son en-tête. Son nom qualifié est @<namespace>/skills/<slug>, le slug étant dérivé du nom affiché, et les bots résolvent les noms qualifiés à partir du name de l'en-tête : les deux doivent donc correspondre.
Si le skill comporte d'autres fichiers, téléversez le dossier sous forme de zip. Un dossier racine unique dans le zip est retiré automatiquement, et les dossiers de build et de gestion de versions sont ignorés.
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
| Règle du bundle | Limite |
|---|---|
| Taille du zip | 50 MB |
| Chaque fichier | 10 MB |
| Tous les fichiers | 50 MB |
| Types de fichiers | Texte, code, données, images, PDF et polices, comme .md, .py, .js, .ts, .json, .yaml, .csv, .html. Tout ce qui se trouve sous scripts/, bin/ ou dist/ est accepté. |
| Chemins | Pas de .. ni de chemins absolus. |
Rendez le skill public et soumettez une version.
skill(action: "update", id: "<skill id>", visibility: "public") skill(action: "submit", id: "<skill id>", version: "1.0.0")
Publier un employé
Créez l'employé avec son AGENT.md comme contenu et ses dépendances de la boutique.
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" } ] }) Téléversez agent.json avec un jeton de binaire. Les employés n'ont pas besoin de binaire ; config suffit. Pour inclure le dossier skills/ propre à l'employé, téléversez plutôt le package sous forme de bundle : AGENT.md, agent.json et skills/ dans un seul 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
Gardez les dépendances dans agent.json. Un agent.json téléversé remplace la configuration stockée, y compris les dépendances définies avec create ou update, et un update avec dependencies remplace l’agent.json stocké. Si vous utilisez les deux, placez le même objet dependencies dans agent.json.
Dépendances
dependencies contient les listes skills, agents et connectors. Chaque entrée est de la forme {qualifiedName, id, name} ; NeboAI vérifie d'abord le nom qualifié, puis l'identifiant. Un plugin se déclare sous skills. Les plugins requis par les skills nommées dans agent.json sont ajoutés automatiquement. Quand un propriétaire installe votre employé depuis la boutique ou avec son code, le bot installe avec lui ses dépendances de skills, de plugins et d'employés.
Publier un plugin ou une application
Les plugins téléversent un binaire par plateforme avec le plugin.json et les skills du plugin ; voir Livrer un plugin. Une application composée d'une seule page n'a pas besoin de binaire : téléversez un seul bundle avec bundle-token contenant AGENT.md (avec artifact_type: app), agent.json, manifest.json, ui/ et les éventuels skills/. Une application avec un sidecar utilise le même téléversement de binaire avec l'outil agent : le binaire du sidecar en tant que file avec sa platform, et la page en tant que ui, un .tar.gz du dossier ui/. Voir Applications.
Examen
submit nécessite le contenu du fichier principal et une description de 10 à 500 caractères. Chaque soumission est analysée. Une analyse sans problème peut être approuvée automatiquement ; tout élément signalé passe en examen manuel. L'approbation signe les éventuels binaires et active la version. Une version refusée repasse à l'état de brouillon.
| Statut de l'élément | Signification |
|---|---|
draft | Non soumis, ou refusé. |
pending_review, review | En attente d'examen. |
active | Approuvé. Référencé sur la boutique lorsque la visibilité est public. |
revoked | Retiré. |
Codes d'installation
Chaque élément reçoit son code d'installation dès sa création : SKIL-, AGNT-, PLUG-, APPS-, CONN- ou COLL- suivi de huit caractères. Taper le code comme message dans une discussion Nebo installe l'élément ; voir Concepts clés.