CDN.MN

Disponível agora

Registro por código de dispositivo, acesso com escopo, uma válvula de aprovação por escopo e revogação instantânea, descoberta legível por máquina (auth.md, llms.txt, OpenAPI e o fluxo de trabalho do SKILL.md) e o servidor MCP com 43 ferramentas — as leituras, análise de imagens de sites públicos + estimativas de economia, criação de projeto, limpeza de cache, verificação de domínio e toda mutação de produção por trás de um escopo sensível: ativação de hostname, adição de fundos, configuração de origem, arquivamento de projeto e aplicação da configuração de entrega. Cada uma roda por conta própria para um agente autônomo — exceto dinheiro, que sempre aguarda sua aprovação — ou abre um cartão de aprovação quando você pede para estar no loop. O @cdnmn/cli + @cdnmn/sdk publicados permitem que um agente detecte, configure, reescreva, teste e verifique diretamente a partir do projeto — respeitando o AGENTS.md do repositório.

Em implantação gradual

O conjunto de ferramentas de planejamento de integração + pré-visualização (planos de integração, pré-visualizações não produtivas) e o caminho de registro anônimo sem reivindicação estão no roteiro — rotulados abaixo onde quer que apareçam.

Superfícies voltadas para máquinas

Autenticação e descoberta estão disponíveis em locais bem conhecidos — um agente pode se registrar e obter um token com escopo hoje:

GET  /auth.md                → the human-readable access guide
GET  /llms.txt               → machine index of the agent surfaces
GET  /openapi.json           → OpenAPI 3.1 for the REST endpoints
GET  /.well-known/oauth-protected-resource
GET  /.well-known/oauth-authorization-server
POST /api/agent/register     → device_code + user_code
POST /api/agent/token        → poll → cdnmn_at_… bearer token
POST /api/mcp                → MCP 2025-06-18: tools/list, tools/call

Servido ao vivo pelo app CDN.MN

Duas formas ativas de entrada: o caminho simples de reivindicação por dispositivo vincula o agente à sua conta — você abre o link de reivindicação (/agents/claim) e concede os escopos; ou um agente com seu e-mail se registra com provision_workspace para obter um workspace ativo e um token imediatamente, sem etapa humana, que você adota a partir de um e-mail depois. Cobrança e exclusão permanecem bloqueadas até você adotá-lo.

O fluxo de trabalho da skill do agente disponível

O fluxo de trabalho de instalação está publicado em /SKILL.md — um guia passo a passo sobre as ferramentas ativas (verificar → ativar → financiar). As referências de plataforma empacotadas e os scripts de verificação abaixo ainda estão em implantação gradual:

cdn-mn-agent/
├── SKILL.md
├── scripts/
│   ├── detect-platform
│   ├── analyze-images
│   ├── create-preview
│   └── verify-installation
├── references/
│   ├── nextjs.md · wordpress.md · nuxt.md
│   ├── static-sites.md · nginx.md
│   └── rollback.md
└── assets/
    ├── config-templates/
    └── report-template.md

Layout empacotado planejado — o fluxo de trabalho do SKILL.md está disponível hoje.

Escopos precisos, não chaves mestras

Os agentes solicitam exatamente a capacidade de que precisam. Nada genérico como api.write.

site:analyzeAnalisar um site público ou origem

project:readInspecionar um projeto CDN.MN

project:createCriar um novo projeto

origin:readVer a configuração de origem

origin:writeConfigurar ou alterar uma origem

integration:planGerar um plano de integração

integration:previewCriar uma pré-visualização não produtiva

integration:applyAplicar alterações aprovadas em produção

domain:readVer o status do domínio

domain:verifyExecutar a verificação de propriedade de origem para um site

domain:activateAtivar a entrega em produção

analytics:readLer dados de uso e economia

cache:purgeLimpar objetos selecionados

billing:readLer plano e uso

billing:writeAlterar plano ou autorizar gastos

project:deleteExcluir um projeto

files:readListar coleções de arquivos e arquivos

files:writeCriar coleções e enviar arquivos

files:publishTornar uma coleção pública ou privada

precheck:readExecutar as pré-verificações do CDN.MN Domains e ler o status de acesso

precheck:downloadListar e baixar conjuntos de dados aprovados do Domains

precheck:writeSolicitar acesso ao Domains ou o download de um conjunto de dados

registry:readLer feeds e execuções do registro

registry:writeEnviar atualizações ao vivo, fazer upload de arquivos de zona (cada upload precisa da sua aprovação), alterar configurações de feed e solicitar uma busca

Escopos em vermelho (origin:write, integration:apply, domain:activate, billing:write, project:delete, files:publish, precheck:write, registry:write) nunca são concedidos por padrão. Quando você concede um, o agente age por conta própria dentro dele — a menos que você marque "exigir minha aprovação a cada vez" no momento da conexão para manter um cartão de aprovação por uso. Dinheiro (billing:write) sempre exige essa aprovação — sua válvula fica travada e não pode ser desativada.

Como um agente entra

Seguindo o modelo do auth.md — com alternativas práticas, não alegações de "funciona com todo agente".

01 · WORKSPACE PROVISIONADO

Disponível

Nenhuma etapa humana para começar

Um agente com seu e-mail se registra com provision_workspace e obtém um workspace ativo + um token com escopo imediatamente — ele pode analisar, criar um projeto, verificar um domínio e servir com um crédito inicial único de $5 sem aprovação para começar. Você adota o workspace a partir de um e-mail depois; cobrança, exclusão e origens personalizadas permanecem bloqueadas até você fazer isso.

owner_email + provision_workspace → token na primeira consulta · adoção por e-mail · não adotados removidos em ~72h

02 · REIVINDICADO PELO USUÁRIO

Disponível

Você confirma um código de reivindicação

O agente se registra para obter um código de dispositivo e mostra a você um link de reivindicação. Você entra no CDN.MN, vê exatamente os escopos solicitados e aprova — o agente então consulta e recebe um token bearer com escopo. Um caminho ativo para quando você preferir conceder acesso de antemão.

cerimônia de código de dispositivo em uma página do CDN.MN · tokens armazenados com hash

03 · PRÉ-VISUALIZAÇÃO ANÔNIMA

Planejado

Sem identidade de usuário

Os escopos de pré-visualização somente leitura que um agente pode solicitar antes de qualquer humano estar envolvido — analisar um site público, mas não tocar em nada que pertença a um cliente. O caminho sem reivindicação e suas ferramentas de plano/pré-visualização ainda estão em implantação gradual.

site:analyze · analytics:read · billing:read (escopos de plano/pré-visualização reservados até que suas ferramentas sejam lançadas)

04 · VERIFICADO PELO AGENTE

Planejado

O provedor atesta a identidade

Onde o provedor do agente oferece suporte à asserção de identidade, o agente solicitará uma asserção específica de audiência após o seu consentimento; o CDN.MN a verifica e retorna uma credencial com escopo. Planejado, e nunca o único caminho.

chega conforme os provedores adotam — os caminhos acima sempre funcionam

Ferramentas MCP de alto nível e idempotentes 43 ferramentas disponíveis

43 ferramentas são chamáveis hoje em /api/mcp — as leituras, análise de imagens de sites públicos, criação de projeto, verificação de domínio, limpeza de cache e toda mutação sensível de produção. Uma ferramenta sensível roda por conta própria para um agente autônomo — exceto adicionar fundos, que sempre aguarda sua aprovação — ou abre um cartão de aprovação quando você pediu para estar no loop; as ferramentas de plano de integração + pré-visualização ainda estão em implantação gradual, e o agente nunca monta configurações de baixo nível às cegas:

list_projects

get_analytics

get_billing

get_domains

get_approval_status

activate_hostname

verify_domain

add_funds

change_plan

configure_origin

delete_project

apply_integration

purge_urls

create_project

rollback_configuration

analyze_website

estimate_image_savings

detect_integration_strategy

list_collections

list_files

create_collection

upload_file

set_collection_access

get_share_access_log

list_share_links

get_share_agreement

revoke_share_link

create_share_link

publish_share_agreement

invite_to_share_link

revoke_share_invite

check_domains

check_label

get_domains_access

list_domain_downloads

request_domains_access

request_domain_download

list_registry_feeds

push_registry_updates

fetch_registry_feed

update_registry_feed

create_domain_zone_upload

get_domains_stats

create_preview

generate_integration_plan

verify_image_delivery

verde = chamável agora · cinza = em implantação gradual

Toda ferramenta de mutação suporta

Projetado para que seja difícil criar duplicatas acidentalmente, rotear para a origem errada ou gerar uma cobrança ilimitada. Disponível hoje em toda ferramenta sensível (activate_hostname mostrado aqui): dry_run e idempotency_key são aceitos e vinculados à ação, e uma chamada repetida com a mesma chave nunca é executada duas vezes.

accepted on every sensitive tool (example: activate_hostname):
  site_id: "s_..."
  dry_run: true
  idempotency_key: "..."

→ returns now, when autonomous:
  status: executed · execution.hostname
  (the action ran inline)

→ returns now, when you require approval:
  approval_required · approval_id
  poll_with: get_approval_status

→ every sensitive action returns a self-describing contract:
  proposed_changes · warnings
  rollback_plan · verification_steps
  (on the tool response, on get_approval_status,
   and on the owner's approval card)

Prompts de agente copiáveis

Estes aparecem na página inicial, no repositório de código, na skill do agente e nos guias de frameworks.

Add CDN.MN to this website.

Keep the current origin and existing application behavior. Analyze the
image pipeline, estimate potential savings, detect the safest
integration strategy, create the CDN.MN project, configure responsive
image delivery and modern formats, run the project tests, and ask me
before changing DNS, billing, or production deployment.

Trecho opcional de AGENTS.md para o seu projeto

AGENTS.md é a convenção emergente para fornecer orientação persistente de projeto a agentes de codificação. Se o seu agente a respeita, adicione esta seção para que toda alteração no CDN.MN siga as regras do seu projeto — sua instrução direta sempre tem prioridade.

## CDN.MN image delivery

- Read the current CDN.MN project configuration before changing image URLs.
- Keep the existing image origin as the fallback unless explicitly instructed.
- Never commit CDN.MN access tokens, claim tokens, or API credentials.
- Create integration changes in a separate branch.
- Run the project build, tests, and broken-image verification before completion.
- Use a CDN.MN preview before requesting production activation.
- Do not modify DNS, billing, or production deployment without explicit approval.
- Report all changed files, configuration changes, verification results,
  and rollback steps.