Ferramentas de IA

EmDash tem um servidor Model Context Protocol (MCP) integrado que permite que assistentes de IA trabalhem diretamente com o conteúdo do seu site. Você pode pedir ao Claude, ChatGPT ou outras ferramentas para redigir posts, atualizar páginas, gerenciar mídia, pesquisar seu conteúdo e mais — tudo através de conversa natural.

O servidor MCP do seu site

O servidor MCP está habilitado por padrão. EmDash monta /_emdash/api/mcp a menos que você o desative. O endpoint aceita tokens bearer OAuth ou de acesso pessoal; uma sessão de admin no navegador sozinha não autentica uma requisição MCP. OAuth permite que a pessoa conectando o cliente escolha escopos antes que o EmDash emita o token.

Para desabilitá-lo, defina mcp: false na sua configuração Astro:

emdash({
	mcp: false,
});

Conectar um cliente de IA

A URL do servidor MCP do seu site é:

https://example.com/_emdash/api/mcp

Substitua example.com pelo seu domínio. Para desenvolvimento local, use http://localhost:4321/_emdash/api/mcp.

codex mcp add emdash-site --url https://example.com/_emdash/api/mcp
codex mcp login emdash-site

Trabalhar com conteúdo do site

Uma vez conectado, você pode pedir ao assistente de IA para realizar qualquer uma dessas operações em linguagem natural. Você não precisa saber os nomes das ferramentas — apenas descreva o que deseja.

Conteúdo

• Navegar no conteúdo — “Mostre-me os últimos 10 posts do blog” ou “Encontre todas as páginas em rascunho”
• Ler conteúdo — “Pegue o post chamado ‘hello-world’ e resuma-o”
• Criar conteúdo — “Escreva um novo post de blog sobre nossa promoção de verão” ou “Crie um rascunho de página para a seção Sobre”
• Editar conteúdo — “Atualize a página de preços para mencionar o novo plano” ou “Corrija o erro de digitação no post de FAQ”
• Publicar e agendar — “Publique o post da promoção de verão”, “Agende o anúncio para 1 de junho às 9h” ou “Cancele o agendamento do post de lançamento”
• Comparar versões — “Mostre-me o que mudou na página inicial desde a última publicação”
• Gerenciar rascunhos — “Descarte as alterações do rascunho na página Sobre” ou “Duplique o template da newsletter”
• Traduções — “Que traduções existem para o post de boas-vindas?” ou “Crie um rascunho em francês vinculado a este post em inglês” (quando i18n está habilitado)

Assinaturas

• Navegar assinaturas — “Liste os colaboradores convidados cujos nomes contêm ‘Lee’”
• Creditar conteúdo — “Adicione Priya Shah como assinatura principal neste post”
• Gerenciar assinaturas — “Crie uma assinatura de convidado para Sam Rivera” ou “Atualize a bio deste colaborador”
• Traduzir assinaturas — “Mostre as variantes de localidade desta assinatura”

Criar, atualizar, excluir e traduzir assinaturas requer o papel de Editor. Ferramentas de escrita de conteúdo aceitam IDs de assinaturas existentes quando o chamador tem permissão para criar ou editar esse conteúdo.

Mídia

• Navegar mídia — “Liste todas as imagens carregadas” ou “Mostre-me os PDFs na biblioteca de mídia”
• Verificar detalhes — “Obtenha os detalhes deste item de mídia”
• Carregar arquivos — “Carregue esta imagem base64 como banner.png” ou “Importe a imagem desta URL pública”
• Registrar objetos de armazenamento existentes — “Registre media/2026/banner.png como item de mídia”
• Atualizar metadados — “Defina o texto alt da imagem hero para ‘Pôr do sol na montanha’”
• Remover arquivos — “Delete a imagem de banner antiga”

media_upload aceita bytes codificados em base64 ou uma URL HTTP(S) pública. Armazena o arquivo, registra o item de mídia e retorna o ID e URL. media_create apenas registra metadados para um arquivo que já está no armazenamento. Importações por URL rejeitam alvos de rede privada e re-verificam redirecionamentos; ambos os caminhos aplicam os limites de tipo MIME e tamanho de upload do site.

Contribuidores podem usar media_upload. Registrar um objeto de armazenamento existente com media_create requer o papel de Autor ou superior.

Pesquisa

• Encontrar conteúdo — “Pesquise posts que mencionem ‘acessibilidade’” ou “Encontre tudo sobre TypeScript em todas as coleções”

Taxonomias

• Navegar — “Liste todas as categorias” ou “Mostre-me as tags”
• Criar termos — “Adicione uma tag ‘tutoriais’” ou “Crie uma subcategoria ‘Frontend’ sob ‘Engenharia’”
• Renomear termos — “Renomeie a categoria ‘frontend’ para ‘Web Frontend’”
• Mover termos — “Mova a tag ‘tutoriais’ para sob a categoria ‘guias’” ou “Desconecte ‘react’ do seu pai”
• Excluir termos — “Exclua a tag ‘arquivo’ não utilizada”

Menus

• Ver menus — “Mostre-me o menu de navegação principal” ou “O que tem no menu do rodapé?”
• Criar menus — “Crie um novo menu ‘sidebar’”
• Editar menus — “Renomeie o menu ‘main’ para ‘Navegação principal’”
• Definir itens — “Substitua os itens no menu principal por Início, Blog, Sobre e Contato”
• Excluir menus — “Exclua o menu ‘mobile’ não utilizado”

Configurações do site

• Inspecionar — “Qual é o título atual do site?” ou “Mostre-me os links sociais”
• Atualizar identidade — “Defina o título do site como ‘Acme Blog’ e o slogan como ‘Histórias da equipe’”
• Definir logo / favicon — “Use esta imagem como logo do site” (após carregá-la com media_upload)
• Padrões SEO — “Defina a imagem OG padrão como o novo banner” ou “Atualize o separador de título para uma barra vertical”
• Links sociais — “Adicione nossos links do GitHub e YouTube às configurações sociais”

Schema (apenas Admin)

• Inspecionar — “Que coleções existem?” ou “Mostre-me os campos da coleção posts”
• Criar coleções — “Crie uma nova coleção ‘testimonials’ com campos de nome e citação”
• Modificar schema — “Adicione um campo booleano ‘featured’ aos posts”

Revisões

• Ver histórico — “Mostre o histórico de revisões deste post”
• Restaurar — “Restaure o post para sua versão anterior”

Permissões

Quando um cliente MCP abre a página de consentimento OAuth, cada permissão solicitada está selecionada por padrão. Desmarque qualquer permissão que o cliente não precise antes de aprovar o acesso. O token resultante é limitado às permissões que você mantém selecionadas e às permissões permitidas pelo seu papel EmDash, então conceder menos permissões nunca aumenta o que o cliente pode fazer.

EmDash rejeita uma chamada de ferramenta quando o escopo do token ou o papel do usuário é insuficiente. Um cliente pode explicar esse erro, mas EmDash permanece como a autoridade que o aplica.

Dicas

• Seja específico sobre coleções. Diga “crie um post de blog” em vez de “crie um post” se você tem múltiplas coleções.
• Pergunte sobre o schema primeiro. Se não tem certeza dos campos de uma coleção, pergunte “Que campos a coleção posts tem?” antes de criar ou editar conteúdo.
• Revise antes de publicar. Peça à IA para criar conteúdo como rascunho, revise-o no painel de admin, depois peça à IA para publicá-lo — ou publique você mesmo.
• Use comparar para revisão. Antes de publicar, pergunte “Compare as versões ao vivo e em rascunho deste post” para ver exatamente o que vai mudar.
• Campos de texto rico usam Portable Text. A IA pode escrever conteúdo para campos de texto rico, mas formatação complexa é melhor feita no editor admin.

Para desenvolvedores

O endpoint do servidor MCP, métodos de autenticação, descoberta OAuth, parâmetros de ferramentas e tratamento de erros estão documentados na Referência do servidor MCP.