Skip to content
Plak
Esc
↑↓navigate↵open⌘Jpreview
On this page

WP-MCP

El plugin de Plak que expone las abilities del sitio por REST para que un agente las ejecute.

WP-MCP es el plugin de WordPress que convierte un sitio Plak en un sitio agent-ready: expone abilities (capacidades) por la REST API para que un asistente las descubra y ejecute con wp-mcp-cli, en lugar de adivinar URLs o tocar la base de datos a mano. El protocolo completo se detalla en MCP; esta página documenta el plugin en sí.

Instalado por plak add --agent y plak agent

Qué expone

Una vez activo, WP-MCP publica las abilities del sitio por REST. Cada ability tiene nombre, categoría, esquema de entrada y salida, y anotaciones (solo lectura, destructiva, idempotente). Las familias disponibles son:

  • 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.
  • 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.

Cómo lo instala Plak

plak add --agent (o por defecto cuando wp-mcp-cli está instalado) y plak agent <sitio> para reparar un sitio existente ejecutan estos pasos, de forma idempotente:

  1. Descarga y activa WP-MCP y HTML Editor desde downloads.plak.io (con el User-Agent PlakCLI/<versión>) y comprueba que cada uno está realmente activo, no solo instalado.
  2. Repara la REST API fijando una estructura de enlaces permanentes estándar (/%postname%/) solo si no hay ninguna.
  3. Activa las abilities (wp_mcp_ai_abilities_enabled = 1) y las vincula al dominio del sitio.
  4. Crea la credencial y el perfil: genera una Application Password del usuario admin con el nombre Plak CLI (agent) (rotando la anterior si existe), la envía por variables de entorno (nunca en argv) a wp-mcp auth login --name <sitio> y verifica con wp-mcp --site <sitio> discover que las abilities se descubren de verdad.

El resultado queda marcado con un fichero agent-ready en el sitio, que es lo que muestran plak list y el dashboard.

Operar con Plak CLI

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

--yes confirma las operaciones destructivas. --site <nombre>, variable WPMCP_SITE, o el único perfil si solo hay uno.

Was this page helpful?