Herramientas de IA

EmDash tiene un servidor Model Context Protocol (MCP) integrado que permite a los asistentes de IA trabajar directamente con el contenido de tu sitio. Puedes pedir a Claude, ChatGPT u otras herramientas que redacten publicaciones, actualicen páginas, gestionen medios, busquen en tu contenido y más — todo a través de conversación natural.

El servidor MCP de tu sitio

El servidor MCP está habilitado por defecto. EmDash monta /_emdash/api/mcp a menos que lo desactives. El endpoint acepta tokens bearer de OAuth o de acceso personal; una sesión de administrador en el navegador por sí sola no autentica una solicitud MCP. OAuth permite a la persona que conecta el cliente elegir scopes antes de que EmDash emita el token.

Para desactivarlo, establece mcp: false en tu configuración de Astro:

emdash({
	mcp: false,
});

Conectar un cliente de IA

La URL del servidor MCP de tu sitio es:

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

Reemplaza example.com con tu dominio. Para desarrollo local, usa http://localhost:4321/_emdash/api/mcp.

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

Trabajar con el contenido del sitio

Una vez conectado, puedes pedir al asistente de IA que realice cualquiera de estas operaciones en lenguaje natural. No necesitas conocer los nombres de las herramientas — solo describe lo que quieres.

Contenido

• Explorar contenido — “Muéstrame las últimas 10 publicaciones del blog” o “Encuentra todas las páginas en borrador”
• Leer contenido — “Obtén la publicación llamada ‘hello-world’ y resúmela”
• Crear contenido — “Escribe una nueva publicación de blog sobre nuestra oferta de verano” o “Crea un borrador de página para la sección Acerca de”
• Editar contenido — “Actualiza la página de precios para mencionar el nuevo plan” o “Corrige el error tipográfico en la publicación de FAQ”
• Publicar y programar — “Publica la publicación de oferta de verano”, “Programa el anuncio para el 1 de junio a las 9am” o “Cancela la programación de la publicación de lanzamiento”
• Comparar versiones — “Muéstrame qué cambió en la página de inicio desde la última publicación”
• Gestionar borradores — “Descarta los cambios del borrador en la página Acerca de” o “Duplica la plantilla del newsletter”
• Traducciones — “¿Qué traducciones existen para la publicación de bienvenida?” o “Crea un borrador en francés vinculado a esta publicación en inglés” (cuando i18n está habilitado)

Firmas

• Explorar firmas — “Lista los colaboradores invitados cuyos nombres contengan ‘Lee’”
• Acreditar contenido — “Añade a Priya Shah como firma principal en esta publicación”
• Gestionar firmas — “Crea una firma de invitado para Sam Rivera” o “Actualiza la biografía de este colaborador”
• Traducir firmas — “Muestra las variantes de idioma de esta firma”

Crear, actualizar, eliminar y traducir firmas requiere el rol de Editor. Las herramientas de escritura de contenido aceptan IDs de firmas existentes cuando el llamante tiene permiso para crear o editar ese contenido.

Medios

• Explorar medios — “Lista todas las imágenes subidas” o “Muéstrame los PDFs en la biblioteca de medios”
• Verificar detalles — “Obtén los detalles de este elemento multimedia”
• Subir archivos — “Sube esta imagen base64 como banner.png” o “Importa la imagen de esta URL pública”
• Registrar objetos de almacenamiento existentes — “Registra media/2026/banner.png como elemento multimedia”
• Actualizar metadatos — “Establece el texto alternativo de la imagen hero como ‘Atardecer en la montaña’”
• Eliminar archivos — “Elimina la imagen de banner antigua”

media_upload acepta bytes codificados en base64 o una URL HTTP(S) pública. Almacena el archivo, registra el elemento multimedia y devuelve el ID y la URL. media_create solo registra metadatos para un archivo que ya está en el almacenamiento. Las importaciones por URL rechazan objetivos de red privada y vuelven a verificar las redirecciones; ambas rutas aplican los límites de tipo MIME y tamaño de subida del sitio.

Los contribuidores pueden usar media_upload. Registrar un objeto de almacenamiento existente con media_create requiere el rol de Autor o superior.

Búsqueda

• Encontrar contenido — “Busca publicaciones que mencionen ‘accesibilidad’” o “Encuentra todo sobre TypeScript en todas las colecciones”

Taxonomías

• Explorar — “Lista todas las categorías” o “Muéstrame las etiquetas”
• Crear términos — “Añade una etiqueta ‘tutoriales’” o “Crea una subcategoría ‘Frontend’ bajo ‘Ingeniería’”
• Renombrar términos — “Renombra la categoría ‘frontend’ a ‘Web Frontend’”
• Mover términos — “Mueve la etiqueta ‘tutoriales’ bajo la categoría ‘guías’” o “Desvincula ‘react’ de su padre”
• Eliminar términos — “Elimina la etiqueta ‘archivo’ sin usar”

Menús

• Ver menús — “Muéstrame el menú de navegación principal” o “¿Qué hay en el menú del pie de página?”
• Crear menús — “Crea un nuevo menú ‘sidebar’”
• Editar menús — “Renombra el menú ‘main’ a ‘Navegación principal’”
• Establecer elementos — “Reemplaza los elementos en el menú principal con Inicio, Blog, Acerca de y Contacto”
• Eliminar menús — “Elimina el menú ‘mobile’ sin usar”

Configuración del sitio

• Inspeccionar — “¿Cuál es el título actual del sitio?” o “Muéstrame los enlaces sociales”
• Actualizar identidad — “Establece el título del sitio como ‘Acme Blog’ y el eslogan como ‘Historias del equipo’”
• Establecer logo / favicon — “Usa esta imagen como logo del sitio” (después de subirla con media_upload)
• Valores predeterminados SEO — “Establece la imagen OG predeterminada como el nuevo banner” o “Actualiza el separador de título a una barra vertical”
• Redes sociales — “Añade nuestros enlaces de GitHub y YouTube a la configuración social”

Esquema (solo Admin)

• Inspeccionar — “¿Qué colecciones existen?” o “Muéstrame los campos de la colección posts”
• Crear colecciones — “Crea una nueva colección ‘testimonials’ con campos de nombre y cita”
• Modificar esquema — “Añade un campo booleano ‘featured’ a posts”

Revisiones

• Ver historial — “Muestra el historial de revisiones de esta publicación”
• Restaurar — “Restaura la publicación a su versión anterior”

Permisos

Cuando un cliente MCP abre la página de consentimiento OAuth, cada permiso solicitado está seleccionado por defecto. Desmarca cualquier permiso que el cliente no necesite antes de aprobar el acceso. El token resultante está limitado a los permisos que mantengas seleccionados y los permisos permitidos por tu rol de EmDash, así que otorgar menos permisos nunca aumenta lo que el cliente puede hacer.

EmDash rechaza una llamada de herramienta cuando el scope del token o el rol del usuario es insuficiente. Un cliente puede explicar ese error, pero EmDash sigue siendo la autoridad que lo aplica.

Consejos

• Sé específico con las colecciones. Di “crea una publicación de blog” en lugar de “crea una publicación” si tienes múltiples colecciones.
• Pregunta primero por el esquema. Si no estás seguro de qué campos tiene una colección, pregunta “¿Qué campos tiene la colección posts?” antes de crear o editar contenido.
• Revisa antes de publicar. Pide a la IA que cree contenido como borrador, revísalo en el panel de administración, luego pide a la IA que lo publique — o publícalo tú mismo.
• Usa comparar para revisar. Antes de publicar, pregunta “Compara las versiones en vivo y borrador de esta publicación” para ver exactamente qué cambiará.
• Los campos de texto enriquecido usan Portable Text. La IA puede escribir contenido para campos de texto enriquecido, pero el formato complejo se hace mejor en el editor de administración.

Para desarrolladores

El endpoint del servidor MCP, métodos de autenticación, descubrimiento OAuth, parámetros de herramientas y manejo de errores están documentados en la Referencia del servidor MCP.