Conectar
Adicione https://neboai.com/mcp a qualquer cliente MCP que aceite servidores remotos. O cliente descobre o servidor de autorização, se registra e faz seu login com OAuth e PKCE. Qualquer conta NeboAI pode se conectar. Os tokens de acesso duram uma hora e são renovados por 30 dias.
Conta de desenvolvedor
Qualquer pessoa com uma conta NeboAI pode publicar. Enviar uma versão e enviar arquivos usam sua conta de desenvolvedor, que é configurada para você, de graça, na primeira vez que você envia algo ou pede um token de envio. Não há taxa nem etapa de aprovação.
Para publicar em nome de uma equipe em vez de você mesmo, selecione a conta da equipe na sessão. Você precisa ser membro da equipe.
developer(resource: "account", action: "list") developer(resource: "account", action: "select", slug: "example-team")
developer também pode configurar sua conta com antecedência (action: "create", opcional) e lista e seleciona namespaces (resource: "namespace"). O namespace selecionado passa a fazer parte de todo nome qualificado que você publicar.
Ferramentas
As ferramentas skill, agent e plugin compartilham o mesmo conjunto de ações. Os apps são publicados com a ferramenta agent.
| Ação | Conta de desenvolvedor | Faz |
|---|---|---|
create | não é necessária | Cria o item e o código de instalação dele. |
update | não é necessária | Altera campos, conteúdo, versão ou visibilidade. |
get, list, delete | não é necessária | Lê ou remove seus itens. |
install | não é necessária | Instala em um dos seus bots: id, botId e cascade para incluir as dependências. |
bundle-token | configurada automaticamente | Um token para enviar um zip de arquivos de texto. |
binary-token | configurada automaticamente | Um token para enviar binários, plugin.json, agent.json e interfaces de apps. |
list-binaries, delete-binary | configurada automaticamente | Gerencia os binários enviados. |
submit | configurada automaticamente | Envia uma versão para revisão. |
| Campo | Significado |
|---|---|
name | Nome de exibição. O slug é gerado a partir dele. |
description | Uma linha, de 10 a 500 caracteres para enviar. |
manifestContent | O arquivo principal do item: SKILL.md, AGENT.md ou PLUGIN.md. |
version | Versão semântica. Padrão 0.1.0. |
visibility | private (padrão), loop (compartilhado com seus Canais) ou public. |
category | Categoria na loja. |
longDescription | O texto “O que faz” da loja (somente update). |
sourceUrl, manifestUrl | Links opcionais. |
dependencies | Só para funcionários. Veja Dependências. |
A ferramenta marketplace faz buscas na loja e lista as categorias. A ferramenta pricing define o preço de um item; itens pagos exigem concluir o cadastro para recebimentos.
Publique uma skill
Crie a skill com o SKILL.md dela como conteúdo.
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>") Dê nome à skill com o name do frontmatter. O nome qualificado dela é @<namespace>/skills/<slug>, com o slug gerado a partir do nome de exibição, e os bots resolvem os nomes qualificados com base no name do frontmatter, então os dois precisam coincidir.
Se a skill tiver outros arquivos, envie a pasta como um zip. Se o zip tiver uma única pasta no nível superior, ela é removida automaticamente, e as pastas de build e de controle de versão são ignoradas.
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
| Regra do pacote | Limite |
|---|---|
| Tamanho do zip | 50 MB |
| Cada arquivo | 10 MB |
| Todos os arquivos | 50 MB |
| Tipos de arquivo | Texto, código, dados, imagens, PDF e fontes, como .md, .py, .js, .ts, .json, .yaml, .csv, .html. Tudo o que estiver em scripts/, bin/ ou dist/ é aceito. |
| Caminhos | Sem .. e sem caminhos absolutos. |
Torne a skill pública e envie uma versão.
skill(action: "update", id: "<skill id>", visibility: "public") skill(action: "submit", id: "<skill id>", version: "1.0.0")
Publique um funcionário
Crie o funcionário com o AGENT.md dele como conteúdo e as dependências da loja.
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" } ] }) Envie o agent.json com um token de binário. Funcionários não precisam de binário; config basta. Para incluir a pasta skills/ própria do funcionário, envie o pacote como bundle: AGENT.md, agent.json e skills/ em um único 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
Mantenha as dependências no agent.json. Um agent.json enviado substitui a configuração armazenada, incluindo as dependências definidas com create ou update, e um update com dependencies substitui o agent.json armazenado. Quando usar os dois, coloque o mesmo objeto dependencies dentro do agent.json.
Dependências
dependencies tem as listas skills, agents e connectors. Cada entrada é {qualifiedName, id, name}; a NeboAI verifica primeiro o nome qualificado e depois o id. Um plugin fica listado em skills. Os plugins exigidos pelas skills citadas em agent.json são adicionados automaticamente. Quando um dono instala seu funcionário pela loja ou com o código dele, o bot instala junto as dependências de skills, plugins e funcionários.
Publique um plugin ou um app
Os plugins enviam um binário por plataforma com o plugin.json e as skills do plugin; veja Como distribuir um plugin. Um app só de página não precisa de binário: envie um bundle com bundle-token contendo AGENT.md (com artifact_type: app), agent.json, manifest.json, ui/ e qualquer skills/. Um app com sidecar usa o mesmo envio de binário com a ferramenta agent: o binário do sidecar como file com a platform dele, e a página como ui, um .tar.gz da pasta ui/. Veja Apps.
Revisão
O submit precisa do conteúdo do arquivo principal e de uma descrição de 10 a 500 caracteres. Cada envio é verificado. Uma verificação limpa pode ser aprovada automaticamente; tudo o que for sinalizado vai para revisão manual. A aprovação assina os binários e ativa a versão. Uma versão recusada volta a ser rascunho.
| Status do item | Significado |
|---|---|
draft | Não enviado, ou recusado. |
pending_review, review | Aguardando revisão. |
active | Aprovado. Listado na loja quando a visibilidade é public. |
revoked | Retirado. |
Códigos de instalação
Todo item recebe o código de instalação quando é criado: SKIL-, AGNT-, PLUG-, APPS-, CONN- ou COLL- seguido de oito caracteres. Digitar o código como mensagem em um chat do Nebo instala o item; veja Conceitos principais.