VOLTAR_AO_ARSENAL
ARSENAL OPEN-SOURCEAGENTES-DE-IACLOUDFLARE

EmDash 1.0: como instalar e usar o CMS da Cloudflare

Passo a passo para instalar o EmDash 1.0 e usar o registro de plugins: o que o sandbox resolve, os comandos, o painel, o MCP embutido e os limites do 1.0.

29_DE_SET_DE_2026 4_MIN
Mauro Mequelussi

Mauro Mequelussi

EmDash 1.0: como instalar e usar

Ressalva de método. Este guia é uma leitura da documentação oficial do lançamento (blog da Cloudflare e docs do EmDash), não um teste independente. O que foi conferido: versão 1.0 estável, licença MIT, comandos citados, campos do painel e as três portas de entrada (Astro, admin e agente). O que não foi testado: instalação em produção, plugin de terceiro em uso real e migração completa de um site WordPress existente.

O problema que o EmDash resolve

No WordPress o plugin roda dentro do mesmo processo PHP do site, com acesso direto ao banco, ao sistema de arquivos e à rede. Um plugin de formulário de contato consegue, tecnicamente, ler posts não publicados, alterar outro plugin ou mandar dados para qualquer servidor. Você instala e torce para que ele — e as próximas versões dele — se comportem.

O EmDash 1.0 inverte isso: cada plugin roda isolado e só ganha o que declarar e o administrador aprovar. Instalar plugin passa a ser parecido com instalar app de celular: o app pede, você libera.

Passo a passo

1. Antes de começar

Você precisa de Node.js com npm/npx disponível e uma conta na Cloudflare (o plano gratuito atende). Para rodar só na sua máquina, não precisa de nada além do Node.

2. Criar o site

npm create emdash@latest

O comando gera um projeto sobre Astro com o painel de administração, o banco e a camada de mídia já ligados. Não é preciso montar essas peças à mão.

3. Rodar localmente e publicar

Suba o projeto no seu ambiente de desenvolvimento, abra o painel de administração que vem junto e crie o primeiro conteúdo. A publicação padrão acontece em Workers, na Cloudflare. Em ambiente Node.js, o EmDash usa o workerd (o motor aberto dos Workers) como processo separado para isolar os plugins — ou seja, o modelo de sandbox vale nos dois cenários.

4. Instalar plugins pelo registro

Os plugins são descobertos e instalados de dentro do próprio EmDash, no registro de plugins. Antes de instalar, leia a lista de acessos que o plugin pede: conteúdo, mídia, usuários, e-mail e rede são permissões independentes — liberar mídia não expõe usuários.

O catálogo é descentralizado: quem publica plugin mantém a própria identidade e o histórico de versões em uma conta Atmosphere (AT Protocol, o protocolo do Bluesky), e o EmDash confere a assinatura e o conteúdo baixado antes de instalar. A moderação do catálogo cuida de nome, descrição, link e imagem — ela não reescreve release nem toma posse do plugin.

5. Usar com agente

Existem três portas de entrada, e elas convivem:

  • Editor usa o painel de administração.
  • Desenvolvedor constrói em Astro.
  • Agente trabalha pela API, pela linha de comando (CLI) ou pelo servidor MCP embutido no EmDash.

O caminho mais direto para um agente cuidar do conteúdo é apontá-lo para o MCP embutido: ele lê e atualiza o conteúdo do site sem você abrir o painel.

6. Plataforma de sites (vários clientes)

Se o objetivo é revender site — hospedagem, agência, produto de criação —, o EmDash foi desenhado para rodar em cima do Workers for Platforms: cada site de cliente vira um Worker, sem servidor por cliente. O dono da padaria pede o horário novo em português e o agente da plataforma atualiza o site.

Limites e cuidados

  • Catálogo só de plugins gratuitos por enquanto. Plugins pagos são objetivo declarado, ainda não disponível.
  • EmDash Build está em alfa: serve para testar, não para apostar a operação.
  • Descentralizado não é sinônimo de conferido. O registro confere assinatura e checksum, mas ler as permissões antes de aprovar continua sendo seu trabalho.
  • Ecossistema jovem: já existe tema (44 templates Astro com variantes EmDash), o primeiro plugin de e-commerce e plataformas parceiras, mas a oferta é muito menor que a do WordPress.
  • Migração não vem no pacote: existem Agent Skills que aceleram a conversão (a Avulux relatou menos de um dia em um microsite), mas cada site é um caso.

Por onde começar

Se o seu caso é um site institucional pequeno: crie o projeto, suba local, publique uma página e só depois discuta plugin. Se o caso é agência ou plataforma, o caminho que faz diferença é entender o sandbox de plugins e o Workers for Platforms antes de prometer ao cliente.