Verbinden
Füge https://neboai.com/mcp zu einem beliebigen MCP-Client hinzu, der Remote-Server unterstützt. Der Client ermittelt den Autorisierungsserver, registriert sich und meldet dich mit OAuth und PKCE an. Jedes NeboAI-Konto kann sich verbinden. Zugriffstokens gelten eine Stunde und werden 30 Tage lang erneuert.
Entwicklerkonto
Jeder mit einem NeboAI-Konto kann veröffentlichen. Das Einreichen einer Version und das Hochladen von Dateien nutzen dein Entwicklerkonto, das beim ersten Einreichen oder bei der ersten Anfrage nach einem Upload-Token kostenlos für dich eingerichtet wird. Es gibt keine Gebühr und keinen Freigabeschritt.
Um für ein Team statt für dich selbst zu veröffentlichen, wähle das Konto des Teams für die Sitzung aus. Du musst Mitglied des Teams sein.
developer(resource: "account", action: "list") developer(resource: "account", action: "select", slug: "example-team")
developer kann dein Konto auch vorab einrichten (action: "create", optional) und listet Namensräume auf und wählt sie aus (resource: "namespace"). Der ausgewählte Namensraum wird Teil jedes qualifizierten Namens, den du veröffentlichst.
Tools
Die Tools skill, agent und plugin teilen sich einen Satz von Aktionen. Apps werden mit dem Tool agent veröffentlicht.
| Aktion | Entwicklerkonto | Funktion |
|---|---|---|
create | nicht nötig | Erstellt das Artefakt und seinen Installationscode. |
update | nicht nötig | Ändert Felder, Inhalt, Version oder Sichtbarkeit. |
get, list, delete | nicht nötig | Liest oder entfernt deine Artefakte. |
install | nicht nötig | Installiert auf einem deiner Bots: id, botId und cascade, um Abhängigkeiten einzuschließen. |
bundle-token | wird automatisch eingerichtet | Ein Token zum Hochladen eines Zips mit Textdateien. |
binary-token | wird automatisch eingerichtet | Ein Token zum Hochladen von Binärdateien, plugin.json, agent.json und App-Oberflächen. |
list-binaries, delete-binary | wird automatisch eingerichtet | Verwaltet hochgeladene Binärdateien. |
submit | wird automatisch eingerichtet | Reicht eine Version zur Prüfung ein. |
| Feld | Bedeutung |
|---|---|
name | Anzeigename. Daraus wird der Slug gebildet. |
description | Eine Zeile, zum Einreichen 10 bis 500 Zeichen. |
manifestContent | Die Hauptdatei des Artefakts: SKILL.md, AGENT.md oder PLUGIN.md. |
version | Semantische Version. Standard 0.1.0. |
visibility | private (Standard), loop (mit deinen Kanälen geteilt) oder public. |
category | Marktplatz-Kategorie. |
longDescription | Der Text „Was es macht“ im Marktplatz (nur update). |
sourceUrl, manifestUrl | Optionale Links. |
dependencies | Nur Mitarbeiter. Siehe Abhängigkeiten. |
Das Tool marketplace durchsucht den Marktplatz und listet Kategorien auf. Das Tool pricing legt einen Preis für ein Artefakt fest; kostenpflichtige Artefakte erfordern ein abgeschlossenes Onboarding für Auszahlungen.
Einen Skill veröffentlichen
Erstelle den Skill mit seiner SKILL.md als Inhalt.
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>") Benenne den Skill mit dem name in seinem Frontmatter. Sein qualifizierter Name ist @<namespace>/skills/<slug>, wobei der Slug aus dem Anzeigenamen gebildet wird, und Bots lösen qualifizierte Namen anhand des name im Frontmatter auf; beide müssen also übereinstimmen.
Wenn der Skill weitere Dateien hat, lade den Ordner als Zip hoch. Ein einzelner Ordner auf oberster Ebene im Zip wird automatisch entfernt, und Build- und Versionskontrollordner werden übersprungen.
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
| Bundle-Regel | Grenze |
|---|---|
| Zip-Größe | 50 MB |
| Jede Datei | 10 MB |
| Alle Dateien | 50 MB |
| Dateitypen | Text, Code, Daten, Bilder, PDF und Schriften, etwa .md, .py, .js, .ts, .json, .yaml, .csv, .html. Alles unter scripts/, bin/ oder dist/ wird akzeptiert. |
| Pfade | Kein .. und keine absoluten Pfade. |
Mach den Skill öffentlich und reiche eine Version ein.
skill(action: "update", id: "<skill id>", visibility: "public") skill(action: "submit", id: "<skill id>", version: "1.0.0")
Einen Mitarbeiter veröffentlichen
Erstelle den Mitarbeiter mit seiner AGENT.md als Inhalt und seinen Marktplatz-Abhängigkeiten.
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" } ] }) Lade agent.json mit einem Binary-Token hoch. Mitarbeiter brauchen keine Binärdatei; config reicht. Um den eigenen Ordner skills/ des Mitarbeiters einzuschließen, lade das Paket stattdessen als Bundle hoch: AGENT.md, agent.json und skills/ in einem 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
Halte Abhängigkeiten in agent.json. Eine hochgeladene agent.json ersetzt die gespeicherte Konfiguration, einschließlich der mit create oder update gesetzten Abhängigkeiten, und ein update mit dependencies ersetzt die gespeicherte agent.json. Wenn du beides nutzt, lege dasselbe dependencies-Objekt in agent.json ab.
Abhängigkeiten
dependencies enthält die Listen skills, agents und connectors. Jeder Eintrag ist {qualifiedName, id, name}; NeboAI prüft zuerst den qualifizierten Namen, dann die ID. Ein Plugin wird unter skills aufgeführt. Plugins, die von Skills in agent.json benötigt werden, werden automatisch hinzugefügt. Wenn ein Inhaber deinen Mitarbeiter aus dem Marktplatz oder mit seinem Code installiert, installiert der Bot die Skill-, Plugin- und Mitarbeiter-Abhängigkeiten gleich mit.
Ein Plugin oder eine App veröffentlichen
Plugins laden eine Binärdatei pro Plattform zusammen mit der plugin.json und den Skills des Plugins hoch; siehe Ein Plugin ausliefern. Eine App, die nur aus einer Seite besteht, braucht keine Binärdatei: Lade mit bundle-token ein Bundle hoch, das AGENT.md (mit artifact_type: app), agent.json, manifest.json, ui/ und eventuelle skills/ enthält. Eine App mit Sidecar nutzt denselben Binär-Upload mit dem Tool agent: die Sidecar-Binärdatei als file mit ihrer platform und die Seite als ui, ein .tar.gz des Ordners ui/. Siehe Apps.
Prüfung
submit braucht den Inhalt der Hauptdatei und eine Beschreibung mit 10 bis 500 Zeichen. Jede Einreichung wird gescannt. Ein sauberer Scan kann automatisch freigegeben werden; alles Markierte geht in die manuelle Prüfung. Die Freigabe signiert eventuelle Binärdateien und macht die Version aktiv. Eine abgelehnte Version wird wieder zum Entwurf.
| Status des Artefakts | Bedeutung |
|---|---|
draft | Nicht eingereicht oder abgelehnt. |
pending_review, review | Wartet auf Prüfung. |
active | Freigegeben. Im Marktplatz gelistet, wenn die Sichtbarkeit public ist. |
revoked | Zurückgezogen. |
Installationscodes
Jedes Artefakt erhält beim Erstellen seinen Installationscode: SKIL-, AGNT-, PLUG-, APPS-, CONN- oder COLL-, gefolgt von acht Zeichen. Wenn du den Code als Nachricht in einem Nebo-Chat eingibst, wird das Artefakt installiert; siehe Grundkonzepte.