CDN.MN

Ao vivo agora

Registro por código de dispositivo, acesso com escopos definidos, 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 SKILL.md), e o servidor MCP com 23 ferramentas — as leituras, análise de imagens de sites públicos + estimativas de economia, criação de projetos, limpeza de cache, verificação de domínio e toda mutação de produção protegida por 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 opera de forma autônoma para um agente — exceto dinheiro, que sempre aguarda sua aprovação — ou abre um cartão de aprovação quando você pede para estar no controle. O @cdnmn/cli + @cdnmn/sdk publicados permitem que um agente detecte, configure, reescreva, teste e verifique diretamente do projeto — respeitando o AGENTS.md do repositório.

Em implementação

O conjunto de ferramentas de planejamento de integração + pré-visualização (planos de integração, pré-visualizações fora de produção) e o caminho de registro anônimo sem reivindicação estão no roadmap — marcados abaixo onde aparecem.

Superfícies voltadas para máquinas

Autenticação e descoberta estão ativas em locais bem conhecidos — um agente pode registrar e manter 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 pelo aplicativo CDN.MN

Dois caminhos ativos: o caminho simples de reivindicação de 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 registra com provision_workspace para obter um workspace e token ativos imediatamente, sem etapa humana, que você adota por e-mail depois. Cobrança e exclusão permanecem bloqueadas até você adotar.

O fluxo de trabalho da habilidade do agente ao vivo

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

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 SKILL.md está ativo hoje.

Escopos precisos, não chaves mestras

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:readVisualizar configuração de origem

origin:writeConfigurar ou alterar uma origem

integration:planGerar um plano de integração

integration:previewCriar uma pré-visualização fora de produção

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

domain:readVisualizar status do domínio

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

domain:activateAtivar 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

Escopos em vermelho (origin:write, integration:apply, domain:activate, billing:write, project:delete, files:publish) 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" na conexão para manter um cartão de aprovação por uso. Dinheiro (billing:write) sempre exige essa aprovação — sua válvula está travada e não pode ser desativada.

Como um agente entra

Seguindo o modelo auth.md — com alternativas práticas, não alegações de "funciona com todos os agentes".

01 · WORKSPACE PROVISIONADO

Ao vivo

Sem etapa humana para começar

Um agente com seu e-mail 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 por e-mail depois; cobrança, exclusão e origens personalizadas permanecem bloqueadas até você adotar.

owner_email + provision_workspace → token na primeira consulta · adotar por e-mail · não adotado varrido em ~72h

02 · REIVINDICADO PELO USUÁRIO

Ao vivo

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

O agente registra um código de dispositivo e mostra um link de reivindicação. Você entra no CDN.MN, vê exatamente os escopos que ele solicitou e aprova — o agente então consulta e recebe um token bearer com escopo. Um caminho ativo quando você prefere conceder acesso antecipadamente.

cerimônia de código de dispositivo em uma página de propriedade 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 um cliente possua. O caminho sem reivindicação e suas ferramentas de plano/pré-visualização ainda estão em implementação.

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

04 · VERIFICADO POR AGENTE

Planejado

Provedor atesta identidade

Onde o provedor do agente suporta afirmação de identidade, o agente solicitará uma afirmação específica de público após 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 23 ferramentas ativas

23 ferramentas são chamáveis hoje em /api/mcp — as leituras, análise de imagens de sites públicos, criação de projetos, verificação de domínio, limpeza de cache e toda mutação sensível de produção. Uma ferramenta sensível opera 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 controle; as ferramentas de plano de integração + pré-visualização ainda estão em implementação, e o agente nunca monta configuração 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

create_preview

generate_integration_plan

verify_image_delivery

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

Toda ferramenta de mutação suporta

Projetado para ser difícil criar duplicatas acidentalmente, rotear para a origem errada ou produzir uma conta ilimitada. Ativo 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 executa 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

Eles aparecem na página inicial, repositório de código, habilidade do agente e guias de estrutura.

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 seu projeto

AGENTS.md é a convenção emergente para dar a agentes de codificação orientação persistente de projeto. Se seu agente a honra, adicione esta seção para que toda mudança 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.