MCP y sitios agent-ready

Qué es MCP, cómo funciona dentro de Plak CLI y cómo preparar y usar sitios con WP-MCP y wp-mcp-cli.

MCP (Model Context Protocol) es el protocolo abierto que usan los asistentes de código (Claude, Codex, Cursor, OpenCode, Pi y otros) para pedirle acciones a WordPress en lugar de adivinar URLs o tocar la base de datos a mano. Plak CLI lo integra de serie: un sitio “agent-ready” expone sus capacidades por REST y el agente las ejecuta con wp-mcp-cli.

Qué es cada pieza

Un sitio agent-ready combina cuatro piezas. Conviene distinguirlas porque cada una falla de una forma distinta:

MCP como protocolo define el cómo se piden las cosas (herramientas con nombre, esquema de entrada y salida). WP-MCP es la implementación para WordPress (wp_get_ability($name)->execute($input) en el servidor). wp-mcp-cli es el cliente de terminal que usa Plak: misma ejecución en el servidor, pero por REST + Basic Auth en lugar de JSON-RPC, lo que funciona en cualquier terminal, CI o sesión SSH sin un cliente MCP persistente.

Cómo funciona dentro de Plak CLI

plak install instala wp-mcp-cli (y su dependencia jq) junto a la pila local. A partir de ahí, cada sitio WordPress nuevo nace agent-ready por defecto cuando wp-mcp-cli está disponible, sin que tengas que recordar ninguna bandera:

plak add mi-sitio              # agent-ready si wp-mcp-cli está instalado
plak add mi-sitio --no-agent   # opta por no prepararlo
plak add mi-sitio --agent      # fuérzalo de forma explícita

Con --agent (o por defecto), Plak ejecuta estos pasos en orden, y cada uno es idempotente (puedes repetirlo sin duplicar nada):

El resultado queda marcado con un fichero agent-ready en el sitio, que es lo que muestran plak list y el dashboard. Si la preparación falla después de crear el sitio, el sitio se conserva y el error indica cómo repararlo (ver Reparar más abajo): nunca se borra un WordPress válido porque falle un plugin del agente.

--agent exige WordPress y no se puede combinar con --plain (sitio estático) ni con --multisite. plak import y plak clone preparan igual los WordPress que crean (o te dicen cómo hacerlo), y plak list muestra la columna de estado.

Cómo se utiliza

1. Descubrir qué puede hacer el sitio

wp-mcp --site mi-sitio --json discover

Devuelve la lista de abilities con su categoría, descripción y esquema. Es el equivalente a “¿qué herramientas tengo?”. En un sitio Plak con Fluent Forms y Slim SEO instalados, verás unas 50 abilities entre site, filesystem, code-execution, gutenberg, fluentforms, slimseo, memory y otras (el catálogo exacto depende de lo instalado: ver Temas, editores y plugins).

2. Leer la ficha de una ability

wp-mcp --site mi-sitio describe wp-mcp/list-directory

Muestra el esquema de entrada (input_schema), la salida esperada y sus anotaciones (si es de solo lectura, si es destructiva, si es idempotente). Lee siempre esta ficha antes de ejecutar algo destructivo.

3. Ejecutar una ability

wp-mcp --site mi-sitio run wp-mcp/list-directory --input '{"path":"/"}'
wp-mcp --site mi-sitio run wp-mcp/run-wp-cli --input '{"args":["plugin","list","--format=json"]}' --yes

--yes confirma las operaciones destructivas (igual que en Plak CLI). --json fuerza salida JSON para scripts. La selección del sitio sigue este orden: --site <nombre>, variable WPMCP_SITE, o el único perfil si solo hay uno.

Otros comandos útiles:

wp-mcp sites list                    # perfiles guardados
wp-mcp auth status                   # perfil activo y resumen de credencial
wp-mcp doctor                        # diagnostica bash, jq, curl, config, credenciales y alcance
wp-mcp skill install opencode        # instala la skill oficial de wp-mcp para tu agente

plak skill install ya instala la skill de Plak y la de wp-mcp para cada agente (codex, claude-code, opencode, hermes, pi, global, all).

Requisitos que suelen fallar

Reparar un sitio

plak agent mi-sitio
plak agent mi-sitio --json

Hace exactamente lo mismo que la preparación inicial (instala y activa plugins, fija permalinks, habilita abilities, rota la Application Password, refresca el perfil y verifica), pero pensado para reintentar sobre un sitio existente. En modo --json el progreso va a STDERR y STDOUT queda como un único objeto ({"success":true,"site":...,"profile":...,"url":...}) para scripts.

Qué puede hacer un agente con esto

Una vez listo, el agente ya no necesita adivinar llamadas REST: descubre, describe y ejecuta.

• Ficheros: wp-mcp/read-file, write-file, edit-file, delete-file, list-directory, create-upload-link, disable-file, enable-file.
• Comandos: wp-mcp/run-wp-cli (cualquier comando WP-CLI, síncrono o en segundo plano con get-wp-cli-job) y wp-mcp/execute-php (PHP arbitrario: úsalo con cuidado).
• Contenido: gutenberg-get-content, gutenberg-write-content y la cola de borradores (create-pending-batch, add-pending-change, enable-batch-finalization…) para componer con bloques reales en lugar de HTML crudo.
• Formularios y SEO: abilities dedicadas de Fluent Forms y Slim SEO cuando esos plugins están instalados (ver Temas, editores y plugins).
• Memoria: memory-search|list|get|write|edit|delete|summarize para guardar contexto entre sesiones (nunca secretos, tokens ni datos personales).
• Acceso: create-admin-access-link genera enlaces de acceso de un solo uso, igual que plak login.

Continúa en Temas, editores y plugins para saber qué integraciones tienen abilities dedicadas y cuáles se operan por la vía genérica, o en Plugins para los plugins propios de Plak.