MCP en WordPress.com

Este texto fue traducido usando IA. Si deseas ver el texto original en inglés, haz clic aquí.

WordPress.com incluye un servidor MCP (Model Context Protocol) integrado, que permite una integración fluida con agentes de IA compatibles con MCP como Claude Desktop, VS Code, Cursor y más.

¿Qué es MCP?

MCP es un protocolo abierto que estandariza la forma en que las aplicaciones proporcionan contexto a los LLM (modelos de lenguaje de gran tamaño). Conectar tu agente de IA a WordPress.com te permite interactuar con tu cuenta y sitios web de WordPress.com utilizando las interfaces de lenguaje natural que estas aplicaciones de IA proporcionan.

A grandes rasgos, así es como MCP añade contexto a tus solicitudes de IA:

• Le pides a tu agente de IA información sobre tu cuenta o sitios de WordPress.com
• El agente de IA utiliza un LLM para comprender la solicitud y determina que necesita más contexto. Verifica si hay herramientas MCP que pueda usar para habilitar ese contexto.
• Encuentra la herramienta MCP adecuada e intenta solicitarla. El agente de IA te pide permiso para realizar esa solicitud.
• Una vez que das permiso, se realiza la solicitud a la herramienta MCP y se devuelven los datos específicos que la herramienta puede proporcionar. Esos datos se incluyen entonces en la solicitud al LLM.
• El LLM utiliza tu solicitud original y el contexto de la herramienta MCP para generar su respuesta.

En ningún momento se comparten datos entre el servidor MCP y el LLM sobre los que no tengas control total. Tampoco se utilizan los datos de las herramientas MCP para entrenar modelos de IA; los datos se usan solo una vez como parte de la solicitud original.

Requisitos

Para conectar tu aplicación de agente de IA a WordPress.com, simplemente necesitas:

• Una cuenta de WordPress.com con un plan de pago
• MCP habilitado en tu cuenta (consulta Habilitar MCP en WordPress.com a continuación)
• Un cliente de IA compatible con MCP como Claude Desktop, ChatGPT, VS Code o Cursor

El servidor MCP de WordPress.com utiliza OAuth 2.1 para la autenticación, que gestiona la conexión y la autorización a través de tu navegador web; no se requiere la instalación de software adicional.

Conectar tu cliente de IA

Después de habilitar MCP en tu cuenta de WordPress.com, puedes conectar cualquier cliente de IA compatible con MCP utilizando la URL del servidor MCP de WordPress.com:

https://public-api.wordpress.com/wpcom/v2/mcp/v1

Claude Desktop

Claude Desktop se conecta a WordPress.com a través del directorio de conectores integrado. Para obtener instrucciones de configuración paso a paso, consulta Edita tu sitio con Claude.

Claude Code

Claude Code se conecta añadiendo el servidor MCP de WordPress.com a tu archivo de configuración local.

Ejecuta el siguiente comando en tu terminal para añadir el servidor MCP

claude mcp add --transport http wpcom-mcp https://public-api.wordpress.com/wpcom/v2/mcp/v1

Luego, al usar Claude Code, ejecuta el comando de barra /mcp para autenticar el servidor wpcom-mcp con tu cuenta de WordPress.com.

ChatGPT

Conectar ChatGPT a WordPress.com requiere habilitar el Modo Desarrollador, crear una aplicación de WordPress.com a través de la URL de MCP y seleccionar el conector. Se necesita un plan ChatGPT Plus, Pro, Team o Enterprise. Para ver el tutorial completo, consulta Edita tu sitio con ChatGPT.

Codex

Codex se conecta añadiendo el servidor MCP de WordPress.com a tu archivo de configuración local.

Ejecuta el siguiente comando en tu terminal para añadir el servidor MCP:

codex mcp add wpcom-mcp --url https://public-api.wordpress.com/wpcom/v2/mcp/v1

Codex detectará automáticamente que el servidor MCP de WordPress.com necesita autenticación y activará el flujo de autenticación OAuth.

Sin embargo, si necesitas autenticarte manualmente, puedes ejecutar el siguiente comando en la terminal:

codex mcp login wpcom-mcp

Cursor

Para conectar Cursor a WordPress.com usando el directorio MCP de Cursor:

1. Abre un navegador web y ve a https://cursor.com/docs/context/mcp/directory

2. Busca «WordPress» y haz clic en el botón «+Add to Cursor».

2. Esto activará una acción del navegador que abrirá tu aplicación Cursor y añadirá la configuración MCP a los ajustes de Tools & MCP.

2. Haz clic en Install para iniciar el flujo de autorización entre Cursor y tu cuenta de WordPress.com.
3. Concede a Cursor acceso a tu cuenta de WordPress.com a través de tu navegador.

2. Una vez que la conexión esté completa, Cursor tendrá acceso a tus sitios de WordPress.com a través de las herramientas MCP.

Otros clientes

Para otros clientes compatibles con MCP, consulta la documentación de tu cliente sobre cómo añadir un servidor MCP y luego utiliza la URL:

https://public-api.wordpress.com/wpcom/v2/mcp/v1

El flujo de autenticación OAuth 2.1 te guiará automáticamente a través de la autorización basada en el navegador.

Clientes compatibles

Puedes usar cualquier aplicación cliente de IA compatible con MCP para conectarte a WordPress.com. Si aún no tienes una, a continuación hemos listado algunas de las más populares.

• Claude Desktop
• VS Code
• Cursor

Herramientas MCP disponibles

Todas las herramientas MCP de WordPress.com están listadas en la documentación de Referencia de herramientas MCP de WordPress.com.

Habilitar MCP en WordPress.com

Para usar MCP en WordPress.com, necesitas completar los siguientes pasos:

1. Habilitar MCP en tu cuenta de WordPress.com
2. Conectar tu cliente de IA compatible con MCP
3. Aceptar la solicitud de autenticación OAuth

Para habilitar MCP en tu cuenta de WordPress.com, navega a los ajustes de MCP aquí, o:

1. Inicia sesión en tu escritorio de WordPress.com.
2. Pasa el cursor sobre tu nombre en la esquina superior derecha y luego haz clic en «Mi cuenta de WordPress.com».
3. Haz clic en MCP en la página de Mi perfil.

Para habilitar MCP en tu cuenta:

1. Activa «Habilitar acceso MCP».

2. De forma predeterminada, todas las herramientas MCP de solo lectura están habilitadas, y las herramientas de escritura están deshabilitadas.

3. Puedes habilitar o deshabilitar herramientas específicas de lectura o escritura haciendo clic en el panel correspondiente.

4. Para configurar un cliente MCP, haz clic en el botón «Conectar asistente de IA externo».
5. En la página Conectar agente de IA, selecciona el cliente que deseas configurar en el menú desplegable. La página mostrará una opción de Configuración rápida y/o una opción de Configuración manual.
   • Configuración rápida: Esta opción te permite establecer la configuración MCP con un solo clic para algunos de los clientes disponibles.
   • Configuración manual: Se trata de una configuración JSON manual que deberás pegar en tu aplicación cliente. Consulta las instrucciones de configuración enlazadas para asegurarte de que configuras correctamente la conexión MCP en tu aplicación cliente.

Desactivar el acceso MCP para sitios específicos

Debajo de los ajustes de herramientas de lectura y escritura, también puedes desactivar el acceso MCP a sitios específicos.

Desactivar el acceso a sitios específicos bloqueará todas las herramientas MCP para todos los usuarios en ese sitio, y anulará los ajustes de tu cuenta para ese sitio.

Para bloquear el acceso MCP de un sitio:

1. Busca o selecciona un sitio de la lista de sitios disponibles
2. El sitio se añadirá automáticamente a la lista de Sitios restringidos

3. Puedes habilitar el acceso MCP para sitios específicos de la misma manera, haciendo clic en «Eliminar» junto al sitio en la lista de Sitios restringidos.

Autenticación

El servidor MCP de WordPress.com utiliza OAuth 2.1 para una autenticación segura. OAuth 2.1 es el estándar OAuth más reciente, que incorpora las mejores prácticas de seguridad modernas, incluyendo:

• PKCE (Proof Key for Code Exchange): Protege contra la interceptación de códigos de autorización
• Registro dinámico de clientes: Tu cliente de IA puede registrarse automáticamente
• Rotación de tokens: Seguridad mejorada mediante la actualización automática de tokens
• Sin necesidad de secretos de cliente: Autenticación segura sin almacenar credenciales sensibles

Cómo funciona

1. Cuando añadas el servidor MCP de WordPress.com a tu cliente de IA, el cliente intentará conectarse
2. Tu navegador web se abrirá automáticamente en la página de autorización de WordPress.com
3. Inicia sesión en tu cuenta de WordPress.com (si aún no has iniciado sesión)
4. Revisa y autoriza la conexión
5. Serás redirigido de vuelta a tu cliente de IA, que ahora podrá acceder a tus sitios de WordPress.com

Gestión de conexiones

Puedes desconectar tu cliente de IA en cualquier momento a través de tu cuenta de WordPress.com:

1. Ve a Seguridad → Aplicaciones conectadas
2. Busca tu cliente de IA en la lista (puede aparecer como «MCP Client» o con el nombre de tu cliente)
3. Haz clic en Desconectar para revocar el acceso

El flujo de OAuth 2.1 garantiza que tus credenciales de WordPress.com nunca se almacenen en tu ordenador ni se compartan con tu cliente de IA; solo se utilizan tokens de acceso seguros y con fecha de expiración.

Solución de problemas

Problemas de conexión

Si tienes problemas para conectarte al servidor MCP de WordPress.com:

1. Verifica que MCP esté habilitado: Comprueba que MCP esté habilitado en tu cuenta de WordPress.com
2. Comprueba la URL: Asegúrate de que estás usando la URL correcta del servidor: https://public-api.wordpress.com/wpcom/v2/mcp/v1
3. Revisa la autorización: Asegúrate de haber completado el flujo de autorización OAuth en tu navegador
4. Comprueba las aplicaciones conectadas: Visita Aplicaciones conectadas para verificar que tu cliente esté conectado
5. Reinicia tu cliente: Intenta reiniciar la aplicación de tu cliente de IA
6. Consulta los registros del cliente: Revisa la documentación de tu cliente de IA para saber cómo ver los registros de conexión

Desactivación de herramientas

Si desactivas alguna herramienta en tu cuenta o desactivas MCP en algún sitio, tendrás que reiniciar la conexión del servidor MCP en tu cliente de IA. Esto permite que el cliente de la aplicación actualice la lista de herramientas disponibles.