Bludit en Agente de IA usando MCP

Introducción

Bludit guarda todo el contenido en archivos planos y trae un plugin de API que expone el blog por REST. Sobre esa API existe bludit-mcp, un servidor MCP (Model Context Protocol) que traduce esos endpoints en herramientas que un agente de IA puede llamar directamente.

El resultado es que desde la terminal, sin abrir el panel de administración, puedo pedirle al agente cosas como "busca el post que habla de ssh" o "pasa a markdown los posts que están escritos en HTML", y las ejecuta contra el blog. De hecho este mismo post fue creado así.

Hacen falta tres cosas: activar el plugin de API, sacar el token de autenticación del usuario admin y registrar el servidor MCP en Claude Code.

Activar Plugin de API

El plugin ya viene incluido en Bludit, pero está desactivado por defecto.

  1. Entrar al panel de administración y abrir Plugins.
  2. Buscar el plugin API y activarlo.
  3. Abrir sus Settings: ahí aparece el API Token.

Ese token es el de la instalación completa y hace falta en todas las peticiones, tanto de lectura como de escritura. Para comprobar que quedó funcionando:

curl "https://bludit_url.com/api/pages?token=api_token"

Ojo: si se reinstala el plugin, el API Token se regenera y hay que actualizarlo en el cliente.

Extraer API auth de usuario admin

El API Token solo alcanza para leer. Para crear, editar o borrar contenido la API pide además el token del usuario, que tiene que tener rol de Administrador:

Panel de administración → Manage → Users → admin → Security → Authentication Token

Las peticiones de escritura lo mandan en el campo authentication, junto al token:

{
  "token": "api_token",
  "authentication": "auth_token",
  "title": "Título de ejemplo"
}

Sin ese campo, o con un valor inválido, la API responde 401 Unauthorized.

Los dos tokens son credenciales y quedan guardados en texto plano en la configuración del cliente, así que no van a un repositorio.

Instalar Bludit-MCP en Claude-code:

claude mcp add bludit \
  -e BLUDIT_URL=https://bludit_url.com \
  -e BLUDIT_API_TOKEN=api_token \
  -e BLUDIT_AUTH_TOKEN=auth_token \
  -- npx -y bludit-mcp

Por defecto el servidor queda registrado solo para el proyecto actual; agregando -s user queda disponible en todas las sesiones.

Para verificar, claude mcp list desde la terminal, o el comando /mcp dentro de Claude Code, que muestra el estado de la conexión y las herramientas que expone.

Comandos de MCP incluidos en bludit

Comando Qué hace
list_pages Lista las páginas, con filtros por tipo (published, draft, static, sticky, scheduled), filtro untagged y paginación (pageNumber, numberOfItems, donde -1 devuelve todas). Responde también con total y hasMore.
get_page Devuelve una página por su key, que es el slug y puede ser jerárquico (padre/hijo).
create_page Crea una página. Solo title es obligatorio; content va en markdown y además acepta slug, tags, category, description, date, type, coverImage, parent, position y template. Si no se indica type, queda publicada.
edit_page Edita una página existente: el key más únicamente los campos que se quieren cambiar.
delete_page Borra la página con ese key.
get_website_settings Devuelve la configuración del sitio: nombre, descripción, idioma y demás ajustes.

Los tres comandos de escritura y get_website_settings necesitan el BLUDIT_AUTH_TOKEN; para listar y leer páginas basta con el BLUDIT_API_TOKEN.