Ferramentas de IA

O EmDash tem um servidor 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

O servidor MCP está habilitado por padrão — a rota em /_emdash/api/mcp é montada a menos que você o desabilite explicitamente. Sempre requer autenticação, então nenhum conteúdo é exposto sem credenciais válidas.

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

emdash({
  mcp: false,
})

Configuração

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.

O que você pode fazer

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 pelo conteúdo — “Mostre-me os últimos 10 posts do blog” ou “Encontre todas as páginas em rascunho”
• Ler conteúdo — “Busque o post chamado ‘hello-world’ e resuma”
• Criar conteúdo — “Escreva um novo post sobre nossa promoção de verão” ou “Crie uma página de rascunho 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?” (quando i18n está habilitado)

Mídia

• Navegar pela mídia — “Liste todas as imagens enviadas” ou “Mostre-me os PDFs na biblioteca de mídia”
• Verificar detalhes — “Obtenha os detalhes deste item de mídia”
• Registrar uploads — “Registre o arquivo que acabei de enviar para media/2026/banner.png como um item de mídia”
• Atualizar metadados — “Defina o texto alt da imagem hero como ‘Pôr do sol na montanha’”
• Remover arquivos — “Delete a imagem antiga do banner”

Pesquisa

• Encontrar conteúdo — “Pesquise posts que mencionam ‘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 baixo da categoria ‘guias’” ou “Desconecte ‘react’ do seu pai”
• Deletar termos — “Delete 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 ‘barra lateral’”
• Editar menus — “Renomeie o menu ‘principal’ para ‘Navegação primária’”
• Definir itens — “Substitua os itens do menu principal por Início, Blog, Sobre e Contato”
• Deletar menus — “Delete 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 enviá-la com media_upload)
• Padrões de SEO — “Defina a imagem OG padrão como o novo banner” ou “Atualize o separador de título para uma barra vertical”
• Contas sociais — “Adicione nossos links do Mastodon e YouTube às configurações sociais”

Schema (apenas Admin)

• Inspecionar — “Que coleções existem?” ou “Mostre-me os campos da coleção de posts”
• Criar coleções — “Crie uma nova coleção ‘depoimentos’ com campos de nome e citação”
• Modificar schema — “Adicione um campo booleano ‘destaque’ 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, todas as permissões solicitadas são selecionadas por padrão. Desmarque qualquer permissão que o cliente não precisa antes de aprovar o acesso. O token resultante é limitado às permissões que você mantém selecionadas e às permissões permitidas pela sua função EmDash, então conceder menos permissões nunca aumenta o que o cliente pode fazer.

Se você tentar algo para o qual não tem acesso, a IA informará.

Dicas

• Seja específico sobre as 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 de quais campos uma coleção tem, pergunte “Quais campos a coleção de posts tem?” antes de criar ou editar conteúdo.
• Revise antes de publicar. Peça à IA para criar conteúdo como rascunho, revise no painel admin, depois peça à IA para publicar — ou publique você mesmo.
• Use a comparação para revisão. Antes de publicar, pergunte “Compare as versões publicada e 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.