---
title: "EmDash 1.0: como instalar e usar o CMS da Cloudflare"
description: "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."
url: "https://www.escoladeaplicativos.com.br/arsenal/emdash-cms-guia-instalar"
author: "Mauro Mequelussi"
---

# 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.

- **Organização:** Escola de Aplicativos (https://www.escoladeaplicativos.com.br)
- **Autores:** Mauro Mequelussi
- **Página canônica:** https://www.escoladeaplicativos.com.br/arsenal/emdash-cms-guia-instalar
- **Publicado em:** 2026-09-29T03:10:25.886822964Z
- **Atualizado em:** 2026-09-29T03:10:25.88688595Z
- **Tags:** open-source, agentes-de-ia, cloudflare, astro, cms, plugins

---

# EmDash 1.0: como instalar e usar

::callout{type="warning"}
**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

::code-demo{lang="bash" title="criar um site EmDash novo"}
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.

::callout{type="tip"}
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.

- Blog do lançamento: https://blog.cloudflare.com/emdash-cms-plugin-registry/
- Código (MIT): https://github.com/emdash-cms/emdash
- Documentação: https://docs.emdashcms.com/
