Esta guía se centra en las partes específicas de WordPress.com: cómo autenticar y qué endpoint MCP llamar. Para obtener una orientación general sobre cómo crear un cliente MCP, consulta la documentación oficial del cliente MCP.

Descripción general

WordPress.com expone un servidor MCP a través de HTTPS y lo protege con OAuth 2.1, usando:

• Registro dinámico de clientes: Esto te permite registrar clientes de forma programática.
• Flujo de código de autorización con PKCE: Proof Key for Code Exchange (PKCE) se recomienda para clientes públicos como aplicaciones de escritorio y CLI.

El flujo sigue estos pasos:

1. Registra tu cliente con WordPress.com para obtener un client_id
2. Envía al usuario a través del paso de autorización OAuth (con PKCE)
3. Intercambia el code de autorización por un access_token
4. Llama al endpoint MCP de WordPress.com con Authorization: Bearer …

Endpoints de WordPress.com

Todos los siguientes endpoints están alojados en:

• URL base: https://public-api.wordpress.com

OAuth 2.1

• Registrar cliente: POST /oauth2-1/register
• Autorizar: GET /oauth2-1/authorize
• Token: POST /oauth2-1/token

MCP

• Servidor MCP de WordPress.com: POST /wpcom/v2/mcp/v1

Paso 1: Registra tu cliente OAuth

WordPress.com admite el registro dinámico de clientes, lo que significa que tu cliente MCP puede registrarse sin un paso de configuración manual separado.

Solicitud

• POST https://public-api.wordpress.com/oauth2-1/register  
• Content-Type: application/json

Ejemplo:

curl -X POST "https://public-api.wordpress.com/oauth2-1/register" \
  -H "Content-Type: application/json" \
  --data '{
    "client_name": "Mi cliente MCP",
    "redirect_uris": ["http://localhost:8080/callback"],
    "grant_types": ["authorization_code", "refresh_token"]
  }'

Lo que recibes

La respuesta incluye un client_id y otros metadatos. WordPress.com está diseñado para admitir clientes públicos, y las respuestas de registro típicamente indican:

• token_endpoint_auth_method: "none"

Es decir, las solicitudes de token no requieren un secreto de cliente. PKCE proporciona la seguridad para el intercambio del código de autorización.

Como mínimo, almacena el client_id que recibes durante el registro y asegúrate de usar consistentemente uno de los valores exactos de redirect_uri que registraste. Opcionalmente, puedes conservar el resto de la respuesta de registro (por ejemplo, marcas de tiempo o el URI del cliente de registro) si ayuda con la solución de problemas o la inspección de la configuración del cliente más adelante.

Paso 2: Envía al usuario a través de la autorización

Para autenticar a un usuario, tu cliente:

1. Generará un code_verifier de PKCE
2. Derivará un code_challenge usando el método S256
3. Abrirá (o redirigirá) al usuario a la página de autorización de WordPress.com

Solicitud de autorización

• GET https://public-api.wordpress.com/oauth2-1/authorize

Ejemplo:

https://public-api.wordpress.com/oauth2-1/authorize?
  response_type=code&
  client_id=YOUR_CLIENT_ID&
  redirect_uri=http://localhost:8080/callback&
  code_challenge=YOUR_CODE_CHALLENGE&
  code_challenge_method=S256&
  scope=auth

Después de que el usuario apruebe el acceso, WordPress.com redirige el navegador de vuelta a tu redirect_uri con un parámetro de consulta code. Tu redirect_uri debe coincidir exactamente con una de las URIs que registraste.

Paso 3: Intercambia el código de autorización por tokens

Una vez que tu cliente recibe el código de autorización, intercámbialo por un token de acceso en el endpoint del token.

Solicitud de token

• POST https://public-api.wordpress.com/oauth2-1/token  
• Content-Type: application/x-www-form-urlencoded

Ejemplo: 

curl -X POST "https://public-api.wordpress.com/oauth2-1/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data "grant_type=authorization_code&code=AUTHORIZATION_CODE&redirect_uri=http://localhost:8080/callback&code_verifier=YOUR_CODE_VERIFIER&client_id=YOUR_CLIENT_ID"

Resultado

El endpoint del token devuelve una respuesta OAuth que contiene un access_token y también puede incluir campos como expires_in y un refresh_token.

Usa el access_token para autenticar llamadas al endpoint MCP de WordPress.com mediante Authorization: Bearer YOUR_ACCESS_TOKEN.

Paso 4: Llama al servidor MCP de WordPress.com

Accedes al servidor MCP de WordPress.com a través de HTTP mediante el envío de solicitudes MCP mediante POST al endpoint MCP, autenticadas con tu token de acceso OAuth.

Solicitud MCP

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

Cabeceras:

• Authorization: Bearer YOUR_ACCESS_TOKEN
• Content-Type: application/json

Ejemplo:

{
  "method": "tools/call",
  "params": {
    "name": "wpcom-mcp-posts-search",
    "arguments": {
      "wpcom_site": "yoursite.wordpress.com",
      "search": "recent updates"
    }
  }
}

En este ejemplo, tu cliente está pidiendo al servidor MCP de WordPress.com que ejecute la herramienta llamada wpcom-mcp-posts-search con los argumentos dados.

Notas de implementación

• PKCE es obligatorio para clientes públicos. No incrustes secretos en aplicaciones distribuidas.
• Todas las llamadas MCP deben incluir Authorization: Bearer … con un token de acceso válido de WordPress.com.
• Las URIs de redirección deben coincidir con el registro. Si usas http://localhost durante el desarrollo, registra exactamente esa URL de callback.

Primeros pasos

• «¿Cuál de mis sitios recibe más tráfico?»
• «Encuentra todos mis sitios con dominios personalizados».

Configuración del sitio

• «Comprueba los ajustes de comentarios en mi sitio de portafolio».
• «¿Está habilitado el registro de usuarios en mi sitio de comunidad?»

Gestión de usuarios

• «¿Quiénes son los administradores en el blog de mi empresa?»
• «Lista todos los editores en ejemplo.com».
• «Encuentra usuarios que no hayan iniciado sesión recientemente en mi sitio»

Gestión de plugins

• «¿Qué plugins están instalados en mi sitio principal?»
• «¿Qué plugins están actualmente activos en mi tienda?»

Búsqueda de entradas

• «Encuentra todas mis entradas sobre inteligencia artificial».
• «Muéstrame las entradas que publiqué el mes pasado».
• «Lista mis entradas programadas en todos los sitios».
• «Encuentra entradas del autor Juan en el blog de mi empresa».

Recuperación de entradas específicas

• «Recupera mi última entrada publicada con sus comentarios».
• «Obtén la página acerca de mi sitio de portafolio».

Gestión de comentarios

• «Muéstrame los comentarios pendientes en mi blog».
• «Encuentra todos los comentarios de la última semana».
• «Busca comentarios que mencionen «excelente»».

Búsquedas multisitio

• «Busca entradas sobre «consejos de WordPress» en todos mis sitios»
• «Muéstrame las entradas que he publicado hoy en todos los sitios»
• «Encuentra páginas sobre «contacto» en todos mis sitios web».

Análisis comparativo

• «¿Cuál de mis sitios tiene más entradas publicadas?»
• «Muéstrame los sitios que no se han actualizado recientemente».
• «Muéstrame qué entradas están generando más discusión».

Análisis de contenido

• «Encuentra todas las entradas en la categoría «Tecnología»».
• «Muéstrame las entradas modificadas en los últimos 3 días».

Actividad de usuario

• «Muéstrame los autores que publicaron esta semana».
• «¿Quiénes son mis autores más productivos y sobre qué están escribiendo?»
• «Busca editores inactivos en el blog de mi equipo».

Monitoreo del sitio

• «Comprueba qué sitios tienen comentarios pendientes».
• «Encuentra sitios archivados o suspendidos en mi cuenta».

Auditoría de contenido

• «Crea un informe de todos los borradores de entradas con más de 30 días».
• «Encuentra títulos de entradas duplicados en mis sitios».
• «Lista todas las entradas sin categorías».
• «Muéstrame entradas que no se han actualizado en un año».

Tareas de mantenimiento

• «Encuentra todos los comentarios de spam en mis sitios para limpiar».
• «Lista plugins que están inactivos pero aún instalados».
• «Muéstrame sitios que necesitan atención (actualizaciones, comentarios, etc.)».
• «Comprueba si hay entradas atascadas en estado pendiente».
• «Dame un informe completo de estado de ejemplo.com».

Investigación y descubrimiento

• «Encuentra todas las entradas que mencionan el nombre de un competidor».
• «Busca contenido sobre tendencias emergentes en mis blogs».
• «Lista todas las entradas con vídeos o archivos adjuntos».
• «Encuentra todo el contenido sobre IA en mis sitios y muéstrame cuál necesita actualizarse».
• «Encuentra mis borradores de entradas más populares que merecen ser publicados».
• «Compara mi blog de tecnología con mi blog personal».

Sitios de usuario (wpcom-mcp-user-sites)

Descripción: Listar y gestionar sitios de usuario con filtrado y métricas

Entradas:

• page (entero, mín: 1, predeterminado: 1): Número de página para paginación
• per_page (entero, mín: 1, máx: 100, predeterminado: 10): Número de sitios por página
• filters (objeto, opcional):
• search (cadena): Buscar en nombres de sitio y URL
• status (enumerado: active/suspended/archived): Filtrar por estado del sitio
• is_private (booleano): Filtrar por ajuste de privacidad
• has_custom_domain (booleano): Filtrar por presencia de dominio personalizado
• sort (objeto, opcional):
• field (enumerado: name/url/created/updated, predeterminado: updated): Campo por el que ordenar
• order (enumerado: asc/desc, predeterminado: desc): Orden de clasificación
• include_metrics (booleano, predeterminado: false): Incluir métricas del sitio en la respuesta

Salidas:

• success (booleano): Estado de éxito de la operación
• sites (array): Objetos de sitio con blog_id, site_url, blogname, descripción, dominio, ruta, ajustes de privacidad, estado, fechas, idioma, métricas opcionales (visitas, entradas, almacenamiento, estado)
• pagination (objeto): total_sites, total_pages, current_page, per_page
• summary (objeto): total_sites, active_sites, private_sites, custom_domains

Logros de usuario (wpcom-mcp-user-achievements)

Descripción: Acceder a logros de usuario y seguimiento de progreso

Entradas:

• action (enumerado: list/get_progress/get_stats/get_trophy_case/get_feats, predeterminado: list): Acción de logro a realizar
• achievement_type (enumerado: all/achievements/feats, predeterminado: all): Tipo de logros a recuperar
• limit (entero, mín: 1, máx: 100, predeterminado: 20): Número de elementos a devolver
• blog_id (entero, opcional): Logros específicos del sitio

Salidas:

• success (booleano): Estado de éxito de la operación
• achievements (array): Objetos de logro con id, nombre, badge_type, nivel, achieved_at, blog_id, descripción
• feats (array): Objetos de hazaña con id, nombre, nivel, best_level, achieved_at, blog_id
• progress (objeto): total_achievements, total_feats, highest_level, recent_activity
• trophy_case (objeto): featured_badges, badge_count, showcase

Usuarios del sitio (wpcom-mcp-site-users)

Descripción: Listar usuarios de un sitio específico con roles, permisos y métricas de actividad

Entradas:

• wpcom_site (cadena, requerido): ID o URL del sitio del que obtener usuarios
• page (entero, mín: 1, predeterminado: 1): Número de página para paginación
• per_page (entero, mín: 1, máx: 50, predeterminado: 10): Número de usuarios por página
• role (cadena, opcional): Filtrar por rol de usuario (administrador, editor, autor, etc.)
• search (cadena, opcional): Buscar en nombres de usuario, correos electrónicos, nombres para mostrar
• status (enumerado: active/inactive, opcional): Filtrar por estado de usuario
• registration_after (cadena, formato de fecha, opcional): Filtrar por fecha de registro
• registration_before (cadena, formato de fecha, opcional): Filtrar por fecha de registro
• orderby (enumerado: registered/display_name/email/login, predeterminado: registered): Campo de ordenación
• order (enumerado: asc/desc, predeterminado: desc): Dirección de ordenación
• include_contact_info (booleano, predeterminado: false): Incluir información de correo electrónico/contacto
• include_activity_metrics (booleano, predeterminado: false): Incluir último inicio de sesión, recuentos de entradas

Salidas:

• success (booleano): Estado de éxito de la operación
• users (array): Detalles de usuario con user_id, login, display_name, roles, capabilities, registration_date, email opcional/last_login/post_count/comment_count
• pagination (objeto): Total de usuarios/páginas, página actual, per_page

Perfil de usuario (wpcom-mcp-user-profile)

Descripción: Obtener información completa del perfil de usuario

Entradas:

• fields (array, opcional): Campos específicos a recuperar
• include_preferences (booleano, predeterminado: false): Incluir preferencias y ajustes de usuario
• include_stats (booleano, predeterminado: false): Incluir estadísticas básicas de cuenta
• include_account (booleano, predeterminado: false): Incluir información de cuenta y suscripción
• include_social (booleano, predeterminado: false): Incluir datos de participación social y comunitaria
• include_activity (booleano, predeterminado: false): Incluir métricas de actividad y participación

Salidas:

• success (booleano): Estado de éxito de la operación
• profile (objeto): Perfil básico de usuario (id, username, email, display_name, avatar_url, locale, timezone)
• preferences (objeto, opcional): Language, color_scheme, admin_interface, notifications, privacy_settings
• stats (objeto, opcional): Total de sitios/entradas/páginas/comentarios, member_since, last_active
• account (objeto, opcional): Plan, suscripciones, almacenamiento, ancho de banda, is_paying_customer
• social (objeto, opcional): Recuentos de seguidos/seguidores, suscripciones de lector, me gusta, comentarios
• activity (objeto, opcional): Sitio más activo, frecuencia de publicación, total de visitas/visitantes, actividad reciente

Conexiones de usuario (wpcom-mcp-user-connections)

Descripción: Gestionar conexiones sociales de usuario e integraciones

Entradas:

• action (enumerado: list/get/test, predeterminado: list): Acción a realizar
• connection_id (entero, opcional): ID de conexión para acciones get/test
• service (cadena, opcional): Filtrar conexiones por nombre de servicio
• status (enumerado: active/inactive/error, opcional): Filtrar conexiones por estado
• force_refresh (booleano, predeterminado: false): Forzar actualización de datos de conexión desde servicios externos
• include_capabilities (booleano, predeterminado: false): Incluir información detallada de capacidades

Salidas:

• success (booleano): Estado de éxito de la operación
• connections (array): Objetos de conexión con id, service, external_id/name/display, status, connected_date, last_tested, capabilities, información de estado
• total (entero): Recuento total de conexiones
• summary (objeto): Conexiones totales/activas, servicios conectados, última prueba de conexión

Notificaciones de usuario (wpcom-mcp-user-notifications)

Descripción: Acceder y filtrar notificaciones de usuario

Entradas:

• action (enumerado: list/get_settings/get_devices/test_delivery, predeterminado: list): Acción a realizar
• channel (enumerado: email/timeline/push/all, opcional): Canal de notificación a consultar
• blog_id (entero, opcional): Ajustes específicos del sitio
• setting_type (enumerado: blogs/other/wpcom, opcional): Tipo de ajustes de notificación
• device_id (cadena, opcional): ID de dispositivo para notificaciones push

Salidas:

• success (booleano): Estado de éxito de la operación
• notification_settings (objeto): Ajustes de blog, otros ajustes (comment_like/reply), ajustes de wpcom (marketing/research/community/digest/news/reports)
• devices (array): Información de dispositivo con device_id/name/type, estado habilitado, last_seen
• summary (objeto): Total de sitios, sitios con correo habilitado, dispositivos push, recuento de notificaciones de wpcom

Bandeja de entrada de notificaciones de usuario (wpcom-mcp-user-notifications-inbox)

Descripción: Gestión completa de bandeja de entrada de notificaciones

Entradas:

• action (enumerado: list/get_summary, predeterminado: list): Acción de notificación a realizar
• limit (entero, mín: 1, máx: 100, predeterminado: 20): Número de notificaciones a devolver
• unread_only (booleano, predeterminado: false): Devolver solo notificaciones no leídas
• type (enumerado: like/follow/comment/mention/achievement/store_order/reblog/trophy, opcional): Filtrar por tipo de notificación
• since (entero, opcional): Obtener notificaciones después de esta marca de tiempo
• before (entero, opcional): Obtener notificaciones antes de esta marca de tiempo

Salidas:

• success (booleano): Estado de éxito de la operación
• notifications (array): Objetos de notificación detallados con id, user_id/name, estado no leído, type, timestamp, subject/body (text/html), meta (información de blog/entrada)
• summary (objeto): Total de notificaciones, recuento de no leídas, última marca de tiempo, desglose de tipos
• total (entero): Total de notificaciones
• has_more (booleano): Más notificaciones disponibles

Seguridad de usuario (wpcom-mcp-user-security)

Descripción: Acceder a ajustes de seguridad de usuario y estado de 2FA

Entradas:

• action (enumerado: get_status/list_sessions/get_login_history, predeterminado: get_status): Acción de seguridad a realizar
• limit (entero, mín: 1, máx: 100, predeterminado: 10): Número de elementos a devolver para listas
• days (entero, mín: 1, máx: 90, predeterminado: 30): Número de días para historial de inicio de sesión

Salidas:

• success (booleano): Estado de éxito de la operación
• security_status (objeto): Doble factor habilitado, seguridad mejorada, recuento de contraseñas de aplicación, sesiones activas, último inicio de sesión, antigüedad de cuenta, puntuación de seguridad
• two_factor (objeto): Estado habilitado, métodos, recuento de códigos de respaldo, seguridad mejorada
• sessions (array): Detalles de sesión con session_id, ip_address, user_agent, location, last_seen, is_current
• app_passwords (array): Detalles de contraseña de aplicación con uuid, app_id, name, fechas created/last_used, last_ip
• login_history (array): Intentos de inicio de sesión con timestamp, ip_address, user_agent, location, method, status

Suscripciones de usuario (wpcom-mcp-user-subscriptions)

Descripción: Gestionar suscripciones de usuario e información de facturación

Entradas:

• action (enumerado: list/get_details/get_billing_history/get_usage/get_payment_methods, predeterminado: list): Acción de suscripción a realizar
• subscription_id (entero, opcional): ID de suscripción para consultas detalladas
• limit (entero, mín: 1, máx: 100, predeterminado: 10): Número de elementos a devolver
• status (enumerado: active/cancelled/expired/all, predeterminado: active): Filtrar suscripciones por estado

Salidas:

• success (booleano): Estado de éxito de la operación
• subscriptions (array): Detalles de suscripción con id, product_name/slug, site_id/url, status, cost/currency, billing_period, fechas de pago, auto_renew, features
• billing_history (array): Historial de transacciones con transaction_id, date, amount/currency, description, status, payment_method, receipt_url
• payment_methods (array): Detalles de método de pago con id, type, last4, brand, fechas de caducidad, is_default
• usage_data (objeto): Almacenamiento/ancho de banda usado/límites, recuento/límite de sitios
• summary (objeto): Suscripciones totales/activas, costes mensuales/anuales, siguiente fecha de pago, is_paying_customer

Búsqueda de entradas (wpcom-mcp-posts-search)

Descripción: Buscar entradas en todos los sitios de usuario

Entradas:

• wpcom_site (cadena, opcional): ID o URL del sitio donde buscar entradas (si no se proporciona, usa el sitio actual)
• search (cadena, opcional): Consulta de búsqueda para encontrar entradas por título, contenido o extracto
• post_type (enumerado: post/page/attachment/any, predeterminado: post): Tipo de entrada a buscar
• posts_per_page (entero, mín: 1, máx: 50, predeterminado: 10): Número de entradas a devolver
• paged (entero, mín: 1, predeterminado: 1): Número de página para paginación
• order (enumerado: ASC/DESC, predeterminado: DESC): Orden de clasificación
• orderby (enumerado: date/title/menu_order/modified/ID/relevance, predeterminado: date): Campo de ordenación
• category (cadena, opcional): Slug o ID de categoría para filtrar entradas
• tag (cadena, opcional): Slug o ID de etiqueta para filtrar entradas
• post_status (enumerado: publish/private/draft/pending/future, predeterminado: publish): Filtro de estado de entrada
• author (entero, opcional): ID de autor para filtrar entradas por
• meta_key (cadena, opcional): Clave de campo personalizado para filtrar por
• meta_value (cadena, opcional): Valor de campo personalizado para filtrar por

Salidas:

• posts (array): Objetos de entrada con ID, title, content, excerpt, status, type, dates, permalink, información de autor, categorías, etiquetas
• found_posts (entero): Total de entradas encontradas
• max_pages (entero): Páginas máximas disponibles
• current_page (entero): Número de página actual
• site_info (objeto): ID de blog, nombre del sitio, URL del sitio

Obtener entrada (wpcom-mcp-post-get)

Descripción: Recuperar una sola entrada por ID o URL de cualquier sitio de WordPress.com

Entradas:

• wpcom_site (cadena, opcional): ID o URL del sitio del que obtener entrada (si no se proporciona, usa el sitio actual)
• post_id (entero, mín: 1, opcional): ID de entrada a recuperar
• post_url (cadena, opcional): URL de entrada a recuperar
• include_comments (booleano, predeterminado: false): Incluir comentarios de entrada en respuesta
• Nota: Se debe proporcionar post_id o post_url

Salidas:

• post (objeto): Datos completos de entrada con ID, title, content, excerpt, status, type, dates, permalink, información de autor, categorías, etiquetas, array de comentarios opcional
• site_info (objeto): ID de blog, nombre del sitio, URL del sitio

Búsqueda de comentarios del sitio (wpcom-mcp-site-comments-search)

Descripción: Buscar comentarios dentro de un sitio de WordPress.com con filtrado y soporte de hilos

Entradas:

• wpcom_site (cadena, requerido): ID o URL del sitio de WordPress.com sobre el que operar
• search (cadena, opcional): Buscar contenido de comentarios e información de autor
• status (enumerado: approved/pending/spam/trash/all, predeterminado: approved): Filtro de estado de comentario
• post_id (entero, opcional): Filtrar comentarios por ID de entrada específico
• author (entero, opcional): ID de autor para filtrar comentarios por
• comments_per_page (entero, mín: 1, máx: 50, predeterminado: 10): Número de comentarios a devolver
• paged (entero, mín: 1, predeterminado: 1): Número de página para paginación
• order (enumerado: ASC/DESC, predeterminado: DESC): Orden de clasificación
• orderby (enumerado: date/author/post, predeterminado: date): Campo de ordenación
• date_after (cadena, formato de fecha, opcional): Filtrar comentarios después de esta fecha
• date_before (cadena, formato de fecha, opcional): Filtrar comentarios antes de esta fecha
• meta_key (cadena, opcional): Clave de campo personalizado para filtrar por
• meta_value (cadena, opcional): Valor de campo personalizado para filtrar por

Salidas:

• comments (array): Objetos de comentario con comment_ID, content, date, información de autor, parent, post_ID, status, type, post_title
• found_comments (entero): Total de comentarios encontrados
• max_pages (entero): Páginas máximas disponibles
• current_page (entero): Número de página actual
• site_info (objeto): ID de blog, nombre del sitio, URL del sitio

Plugins del sitio (wpcom-mcp-site-plugins)

Descripción: Obtener información de los plugins instalados para un sitio de WordPress.com, incluido el estado, detalles y disponibilidad de actualizaciones

Entradas:

• wpcom_site (cadena, requerido): ID o URL del sitio de WordPress.com
• status (enumerado: active/inactive/all, predeterminado: all): Filtrar plugins por estado
• include_updates (booleano, predeterminado: true): Incluir información de disponibilidad de actualización

Salidas:

• plugins (array): Detalles de plugin con name, plugin_uri, version, description, información de autor, text_domain, domain_path, estado de red, requisitos, status, plugin_file, permisos de activación, información de actualización
• summary (objeto): Total de plugins activos/inactivos, recuento de actualizaciones disponibles

Ajustes del sitio (wpcom-mcp-site-settings)

Descripción: Obtener ajustes y configuración completos del sitio, incluidos ajustes generales, opciones de privacidad, ajustes de comentarios, estructura de enlaces permanentes y configuraciones de zona horaria

Entradas:

• wpcom_site (cadena, requerido): ID o URL del sitio de WordPress.com para obtener ajustes
• include_general (booleano, predeterminado: true): Incluir ajustes generales (blogname, blogdescription, admin_email, etc.)
• include_writing (booleano, predeterminado: false): Incluir ajustes de escritura (categoría predeterminada, formato de entrada)
• include_reading (booleano, predeterminado: false): Incluir ajustes de lectura (página de inicio, entradas por página, blog_public)
• include_discussion (booleano, predeterminado: false): Incluir ajustes de discusión (comentarios, pingbacks, moderación)
• include_media (booleano, predeterminado: false): Incluir ajustes de medios (tamaños de imagen, rutas de carga)
• include_permalinks (booleano, predeterminado: false): Incluir ajustes de enlaces permanentes (estructura, base de categoría/etiqueta)
• include_privacy (booleano, predeterminado: false): Incluir ajustes de privacidad (página de política, manejo de datos)

Salidas:

• success (booleano): Estado de éxito de la operación
• site_info (objeto): ID de blog, URL del sitio, nombre del sitio, estado de privacidad
• general (objeto, opcional): Correo de administrador, nombre/descripción del blog, registro de comentarios, formatos de fecha/hora, desplazamiento GMT, zona horaria, ajustes de registro de usuario
• writing (objeto, opcional): Categorías predeterminadas, categorías de correo/enlace, ajustes de app/xmlrpc, etiquetas de balance, emoticones
• reading (objeto, opcional): Charset del blog, compresión, ajustes de página principal, entradas por página/RSS, ajustes de idioma/extracto RSS
• discussion (objeto, opcional): Ajustes de avatar, moderación de comentarios, ajustes de notificación, hilos, paginación, requisitos de aprobación
• media (objeto, opcional): Ajustes de incrustación, dimensiones de tamaño de imagen (miniatura, mediana, grande), ajustes de recorte
• permalinks (objeto, opcional): Estructura de enlaces permanentes, base de categoría, base de etiqueta
• privacy (objeto, opcional): Ajuste público del blog y opciones de visibilidad

Estadísticas del sitio (wpcom-mcp-site-statistics)

Descripción: Obtener estadísticas completas del sitio, incluidas visitas, visitantes, contenido principal, referentes y métricas de rendimiento

Entradas:

• wpcom_site (cadena, requerido): ID o URL del sitio de WordPress.com
• period (enumerado: day/week/month/year, predeterminado: day): Período de tiempo para estadísticas
• num_periods (entero, mín: 1, máx: 365, predeterminado: 30): Número de períodos a incluir
• include_views (booleano, predeterminado: true): Incluir datos de visitas y visitantes
• include_top_content (booleano, predeterminado: true): Incluir entradas y páginas principales
• include_referrers (booleano, predeterminado: false): Incluir datos de referentes principales
• include_geographic (booleano, predeterminado: false): Incluir datos geográficos
• include_devices (booleano, predeterminado: false): Incluir desglose de dispositivos y navegadores
• include_all_time (booleano, predeterminado: false): Incluir estadísticas de todos los tiempos
• max_items (entero, mín: 1, máx: 50, predeterminado: 10): Elementos máximos para listas

Salidas:

• success (booleano): Estado de éxito de la operación
• site_info (objeto): ID de blog, URL del sitio, nombre del sitio
• period_stats (objeto): Período, num_periods, fechas de inicio/fin
• views_data (objeto, opcional): Total de visitas/visitantes, promedio diario, tendencia, array de datos diarios
• top_content (objeto, opcional): Matrices de entradas/páginas principales con title, URL, views, post_id
• referrers (array, opcional): Datos de referente y visitas
• geographic (objeto, opcional): Países/ciudades principales con visitas
• devices (objeto, opcional): Desglose de tipos de dispositivos y navegadores
• all_time (objeto, opcional): Estadísticas totales, fecha de primera entrada, antigüedad del sitio

Recursos del sitio (wpcom-mcp-user-sites-resource)

Tipo: Recurso Descripción: Representación de recurso de datos de sitios de usuario

Entradas: Ninguna Salidas: Devuelve formato de MCP TextResourceContents con datos de sitios en formato JSON, incluidos metadatos de mimeType y URI

¿Qué es MCP?

MCP es un protocolo abierto que estandariza cómo 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 usando las interfaces de lenguaje natural que proporcionan estas aplicaciones de IA.

A un nivel general, 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 usa un LLM para comprender la solicitud y determina que necesita más contexto. Comprueba 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 hacer esa solicitud.
• Una vez que das permiso, se realiza la solicitud de 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 usa 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 completo. Tampoco usa los datos de las herramientas MCP para entrenar modelos de IA; los datos se usan solo una vez como parte de la solicitud original.

Acceso a las herramientas MCP

En WordPress.com, el acceso a herramientas MCP específicas está restringido por las mismas restricciones aplicadas a los roles de usuario:

Herramienta	Administrador	Editor	Autor	Colaborador	Responsable de tienda	Suscriptor	Cliente	Ninguno
Ajustes del sitio
Estadísticas del sitio
Usuarios del sitio
Búsqueda de entradas
Detalles de entradas
Búsqueda de comentarios
Plugins

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 más abajo)
• Un cliente de IA compatible con MCP como Claude Desktop, ChatGPT, VS Code o Cursor

El servidor MCP de WordPress.com usa OAuth 2.1 para la autenticación, que gestiona la conexión y 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 usando la URL del servidor MCP de WordPress.com:

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

Claude Desktop

Para conectar Claude Desktop a WordPress.com usando Claude Connectors:

1. Abre Claude Desktop
2. Haz clic en el icono de ajustes () en la esquina inferior izquierda
3. Ve a la pestaña Conectores
4. Haz clic en el botón Añadir conector personalizado

5. Introduce los siguientes detalles:
   • Nombre: WordPress.com (o cualquier nombre que prefieras)
   • URL: https://public-api.wordpress.com/wpcom/v2/mcp/v1
6. Haz clic en Añadir.

7. Haz clic en Conectar para comenzar el flujo de autenticación entre Claude Desktop y tu cuenta de WordPress.com.

8. Concede a Claude acceso a tu cuenta de WordPress.com a través de tu navegador.

9. Reinicia Claude Desktop
10. Claude Desktop tendrá acceso a tus sitios de WordPress.com a través de las herramientas MCP.

ChatGPT

Para conectar ChatGPT a WordPress.com:

1. Abre ChatGPT
2. Haz clic en el icono de tu perfil en la esquina inferior izquierda
3. Selecciona Configuración
4. Ve a la pestaña Aplicaciones y haz clic en Configuración avanzada

5. Habilita el Modo de desarrollador (esto es necesario para permitirte crear una aplicación personalizada)

6. Haz clic en Regresar para volver a la pestaña Aplicaciones y haz clic en el botón Crear aplicación.

7. Introduce los siguientes detalles:
   • Nombre: WordPress.com (o cualquier nombre que prefieras)
   • URL: https://public-api.wordpress.com/wpcom/v2/mcp/v1

8. Haz clic en Crear para comenzar el flujo de autorización entre ChatGPT y tu cuenta de WordPress.com
9. Concede a ChatGPT acceso a tu cuenta de WordPress.com a través de tu navegador.
   

10. ChatGPT tendrá acceso a tus sitios de WordPress.com a través de las herramientas MCP.

11. Asegúrate de seleccionar tu conector de WordPress.com al iniciar un nuevo chat en modo Desarrollador.

Cursor

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

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

2. Busca «WordPress» y haz clic en el botón «+Añadir a 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 «Herramientas & MCP».

2. Haz clic en Instalar para comenzar 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 completada la conexión, 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 para saber cómo añadir un servidor MCP, luego usa 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 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 enumerado algunas de las más populares.

• Claude Desktop
• VS Code
• Cursor

Herramientas MCP disponibles

Todas las herramientas MCP de WordPress.com están enumeradas en el documento 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 tus ajustes de MCP aquí, o:

1. Inicia sesión en tu escritorio de WordPress.com.
2. Pasa el ratón 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 «Activar el acceso a las herramientas de MCP».

2. Una vez habilitado, también puedes habilitar o deshabilitar herramientas MCP específicas.
3. Para configurar un cliente MCP, haz clic en el botón «Configurar el cliente de MCP».
4. En la página Configuración MCP, selecciona el cliente que deseas configurar en el menú desplegable. La página mostrará una opción de Configuración rápida o una opción de Configuración manual.
   • Configuración rápida: Esta opción te permite configurar la configuración MCP en un solo clic para algunos de los clientes disponibles.
   • Configuración manual: Esta es una configuración JSON manual que necesitarás pegar en tu aplicación cliente. Consulta las instrucciones de configuración vinculadas para asegurarte de que configuras la conexión MCP en tu aplicación cliente correctamente.

Deshabilitar el acceso MCP para sitios específicos

En la parte inferior de la página de ajustes de cuenta MCP, también puedes deshabilitar el acceso MCP a sitios específicos.

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

Para bloquear el acceso MCP para un sitio:

1. Busca o selecciona un sitio de la lista de sitios disponibles.
2. Activa «Deshabilitar el acceso MCP para este sitio».

Puedes habilitar el acceso MCP para sitios específicos de la misma manera, desactivando «Deshabilitar el acceso MCP para este sitio» de nuevo.

Autenticación

El servidor MCP de WordPress.com usa OAuth 2.1 para una autenticación segura. OAuth 2.1 es el último estándar OAuth, que incorpora prácticas de seguridad modernas que incluyen:

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

Cómo funciona

1. Cuando añades 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 puede acceder a tus sitios de WordPress.com.

Gestionar 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. Encuentra 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 OAuth 2.1 asegura que tus credenciales de WordPress.com nunca se almacenen en tu ordenador ni se compartan con tu cliente de IA; solo se usan tokens de acceso seguros y con caducidad.

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 de servidor correcta: https://public-api.wordpress.com/wpcom/v2/mcp/v1
3. Revisa la autorización: Asegúrate de que completaste el flujo de autorización OAuth en tu navegador
4. Comprueba las aplicaciones conectadas: Visita las Aplicaciones conectadas para verificar que tu cliente está conectado
5. Reinicia tu cliente: Intenta reiniciar tu aplicación cliente de IA
6. Revisa los registros del cliente: Consulta la documentación de tu cliente de IA para saber cómo ver los registros de conexión

Deshabilitar herramientas

Si deshabilitas cualquier herramienta en tu cuenta o deshabilitas MCP en cualquier sitio, necesitarás reiniciar la conexión del servidor MCP en tu cliente de IA. Esto permite que la aplicación cliente actualice la lista de herramientas disponibles.

Instalación

Instalar CLI es una acción única que se realiza de forma diferente según tu sistema operativo. Una vez instalado, CLI se actualiza al mismo tiempo que la aplicación Studio, de forma que no es necesario instalarlo más de una vez.

macOS

1. Abre el menú principal de la aplicación.
2. Haz clic en la opción «Instalar CLI…».
3. Se te pedirá que introduzcas la contraseña de tu cuenta para completar la instalación.
4. Cuando la instalación se haya completado correctamente, puedes ejecutar el comando studio desde cualquier terminal.

Windows

Studio instala la CLI de forma automática al actualizar correctamente a la versión 1.5.0 o superior.

Utilización

Para utilizar Studio CLI, usa el comando studio. Actualmente, se pueden utilizar una serie de comandos relacionados con los sitios de vista previa:

• studio preview create
• studio preview update <host>
• studio preview delete <host>
• studio preview list

Para crear, actualizar y eliminar sitios de vista previa es necesario que hayas iniciado sesión en tu cuenta de WordPress.com en Studio. De lo contrario, al ejecutar el comando, CLI mostrará un mensaje de error con un enlace para iniciar sesión.

Puedes ejecutar estos comandos desde el directorio raíz de cualquier sitio de Studio. Para ejecutar comandos en un directorio distinto al actual, utiliza el parámetro --path con la ruta del directorio raíz del sitio de Studio.

La mejor forma de explorar todas las opciones disponibles con cada comando de CLI es ejecutar studio --help en el terminal tras la instalación. También puedes añadir la opción --help a comandos específicos para ver instrucciones sobre su uso. 

Vista general

La función de compatibilidad con SSL de WordPress Studio te permite:

• Crear sitios con HTTPS
• Utilizar dominios personalizados con los certificados SSL adecuados
• Gestionar los certificados de forma automática
• Comprobar compatibilidades sin advertencias de seguridad (cuando estén marcados como de confianza)

Así funciona

WordPress Studio implementa la compatibilidad con SSL a través de los siguientes componentes:

• Autoridad de certificación (CA): Studio crea su propia autoridad de certificación que señala los certificados de confianza de tus sitios locales.
• Certificados de dominios: cada sitio que tenga HTTPS activado recibe su propio certificado firmado por la autoridad de certificación.
• Confiar en el certificado: con este sistema, puedes confiar en el certificado en tu sistema operativo.
• Redirección HTTPS: el tráfico se redirige automáticamente de HTTP a HTTPS en los sitios con SSL activado.

Activar HTTPS en un sitio

Ten en cuenta que HTTPS necesita un dominio personalizado, ya que no puede usarse en las direcciones localhost predeterminadas.

Para activar HTTPS en un sitio nuevo o en uno ya existente:

1. Crea un nuevo sitio o edita uno que ya tengas con el botón «Editar sitio» en la pestaña Configuración.
2. Si has creado un sitio nuevo, expande la sección «Ajustes avanzados» en la ventana que aparece.
3. Marca la opción «Utilizar un dominio personalizado».
4. Si todavía no lo has hecho, introduce un nombre de dominio (debe terminar en .local) o utiliza la que se genera automáticamente.
5. Marca la opción «Habilitar HTTPS».

6. Haz clic en el botón «Añadir sitio» o «Guardar», según si estás creando un sitio nuevo o editando uno ya existente. 
7. Cuando se te pida, da permiso a Studio para modificar el archivo hosts del sistema. Studio configurará todo lo demás automáticamente. 
8. Se generará e instalará una autoridad de certificación para las conexiones HTTPS. En macOS, tendrás que instalar manualmente el certificado para evitar advertencias de seguridad del navegador. Consulta esta guía para ver más detalles.
9. Utiliza el dominio personalizado para navegar a tu sitio.

Confiar en el certificado en cada plataforma

Windows

En Windows, WordPress Studio añade automáticamente la autoridad de certificación al almacén de certificados del sistema. Para este proceso son necesarios permisos de administrador, por lo que es posible que aparezca un aviso de control de acceso de usuarios al activar HTTPS.

macOS

En macOS, debes confiar en la autoridad de certificación de forma manual. Para hacerlo, localiza el archivo del certificado que Studio instala automáticamente en el sistema:

1. Navega a la pestaña Configuración del sitio con SSL activado.
2. Haz clic en el enlace «Confiar en el certificado» en la sección «Detalles del sitio».

3. Se abrirá la carpeta que contiene el archivo del certificado (studio-ca.crt). Haz doble clic en el archivo para instalar el certificado y abrir automáticamente la herramienta Acceso a Llaveros de tu ordenador.
4. Busca el certificado WordPress Studio CA. Puedes utilizar la palabra studio para filtrar elementos.

5. Haz clic dos veces en el certificado y expande la sección Confiar.
6. Establece «SSL (Secure Sockets Layer)» en «Confiar siempre». Puedes dejar los demás ajustes como están.

7. Cierra la ventana de diálogo e introduce tu contraseña para confirmar los cambios.

Cuando se haya confiado en el certificado, tu navegador lo reconocerá e indicará que tus sitios HTTPS son seguros.

Solución de problemas

Advertencias de seguridad del navegador

Si, cuando visitas tu sitio con HTTPS activado, aparecen advertencias de seguridad del navegador:

• Comprueba que has confiado en el certificado WordPress Studio CA en tu sistema operativo.
• Reinicia el navegador una vez hayas confiado en el certificado.
• Si siguen apareciendo advertencias de seguridad, limpia la caché del navegador.

Con Studio, podrás crear y mantener fácilmente webs locales de WordPress sin tener que configurar manualmente el servidor o las herramientas. También te permite compartir tu trabajo públicamente (por ejemplo: con clientes, compañeros de equipo o diseñadores) a través de sitios de demostración temporales alojados en WordPress.com y sincronizar fácilmente los sitios locales de Studio con sitios alojados.

Inicio rápido

Para instalar Studio, visita la página oficial de Studio y descarga el instalador para tu sistema operativo macOS o Windows. También puedes instalar Studio para Windows directamente desde la Microsoft Store.

Instalar Studio para macOS

Para instalar y utilizar Studio en macOS:

1. Descarga el instalador adecuado según las especificaciones de tu ordenador: Silicon o Intel.
2. Abre el archivo descargado.
3. Arrastra la aplicación Studio a la carpeta Aplicaciones.
4. Haz doble clic en el icono de Studio para iniciar la aplicación Studio.
5. Ponle nombre a tu primer sitio y haz clic en Continuar.

Instalar Studio para Windows

Puedes instalar Studio directamente desde la Microsoft Store o desde WordPress.com.

Para instalar y utilizar Studio en Windows desde Microsoft Store:

1. Accede a Studio en la Microsoft Store desde tu ordenador con Windows.
2. Haz clic en Instalar.
3. Una vez instalado, inicia Studio desde el menú de Inicio.
4. Ponle nombre a tu primer sitio y haz clic en Continuar.

Para instalar y utilizar Studio en Windows desde WordPress.com:

1. Descarga el instalador de Windows.
2. Abre el archivo de configuración .exe.
3. Espera a que Studio se instale; se iniciará automáticamente cuando la instalación haya finalizado. 
4. Ponle nombre a tu primer sitio y haz clic en Continuar.

Conectar a WordPress.com

Al conectar tu cuenta de WordPress.com a Studio, puedes empezar a usar los sitios de demostración, además de tener acceso inmediato a cualquier función futura que dependa de una conexión a WordPress.com.

Si aún no tienes una cuenta de WordPress.com, puedes crear una gratis aquí.

Para conectar Studio a WordPress.com:

1. Haz clic en el botón de WordPress.com en la barra lateral de Studio.
2. Se abrirá una nueva ventana del navegador. Inicia sesión en WordPress.com.
3. En la pantalla de autorización, haz clic en Aprobar para conectar Studio a tu cuenta.
4. Una vez aprobado, aparecerá una ventana que te pedirá abrir la aplicación Studio. Haz clic en la opción «Abrir Studio» para finalizar el proceso. Si los ajustes de «Compartir» no cambian al iniciar sesión en WordPress.com, es posible que tengas que reiniciar la aplicación de escritorio.

Próximos pasos y comentarios

Esperamos que Studio se integre sin esfuerzo en tu flujo de desarrollo local. No te pierdas los demás documentos sobre otras características específicas de Studio:

• Sitios
• Sitios de demostración
• Studio Sync
• Importar y exportar
• Studio Assistant
• Preguntas frecuentes sobre Studio

Studio es un proyecto de código abierto que recibe con alegría todo tipo de contribuciones. Si encuentras un error o echas en falta alguna función en Studio:

• Ponte en contacto con nuestros Happiness Engineers si tienes alguna duda específica sobre el uso de Studio.
• Abre un issue en el repositorio para informar de errores, sugerir ideas o solicitar nuevas funciones.

Como ya sabes, Studio es un proyecto de código abierto que con alegría todo tipo de contribuciones. Si encuentras un error o echas en falta alguna función en Studio:

• Ponte en contacto con nuestros Happiness Engineers si tienes alguna duda específica sobre el uso de Studio.
• Abre un issue en el repositorio para informar de errores, sugerir ideas o solicitar nuevas funciones.

Preguntas frecuentes generales

Aquí tienes algunas respuestas a preguntas comunes sobre Studio:

¿Cómo puedo exportar un tema que he creado en Studio?

Los temas creados en Studio son iguales que los temas creados en sitios de WordPress tradicionales. Puedes exportar tu tema siguiendo estos pasos:

1. Selecciona el sitio local en Studio.
2. Asegúrate de que tu sitio esté en ejecución.
3. Haz clic en la pestaña Vista general.
4. Haz clic en el botón Editor del sitio.
5. Una vez que el editor del sitio cargue en tu navegador, expándelo haciendo clic en cualquier lugar de la vista previa del sitio.

6. Haz clic en el botón del menú Opciones, representado por tres puntos apilados (⋮). 
7. Haz clic en Exportar, y tu navegador descargará un archivo .zip con el tema.

Después, puedes subir tu tema a cualquier sitio de WordPress activo o de pruebas siguiendo estas instrucciones.

¿Cómo puedo publicar mi sitio de Studio para que pueda verlo todo el mundo?

Aunque los sitios de demostración tienen como finalidad ser compartidos con clientes para recibir las primeras impresiones durante hasta siete días, necesitas un plan de alojamiento para que tu sitio sea accesible de forma permanente.

Para publicar tu sitio local en WordPress.com, sigue los pasos descritos en el documento de Studio Sync.

Para publicar tu sitio local en otro hosting de WordPress, sigue la guía de Importar y exportar para crear una exportación de tu sitio original. Cuando la exportación esté lista, puedes importar ese contenido al sitio de destino, por ejemplo, siguiendo la guía para restaurar manualmente tu web desde un archivo de copia de seguridad de Jetpack en WordPress.com.

¿Cómo puedo gestionar la base de datos SQLite del sitio de Studio?

Studio utiliza SQLite en lugar de un servidor MySQL. SQLite es un motor de base de datos SQL ligero y autónomo que almacena tu base de datos en un solo archivo. Cada uno de tus sitios tendrá un archivo de base de datos en la siguiente ruta: wp-content/database/.ht.sqlite. Este es un archivo oculto y puede que no sea visible en tu explorador de archivos. En un Mac, pulsar cmd + shift + . para revelar los archivos ocultos en Finder.

Una vez que hayas localizado el archivo de base de datos SQLite, puedes gestionar la base de datos con cualquier aplicación compatible con SQLite. Te recomendamos usar SQLite3, siempre que no tengas problema en usar la terminal y SQLiteStudio como interfaz de usuario.

Conectarse directamente a la base de datos SQLite puede ser útil para ejecutar consultas SQL, pero el volcado generado por SQLiteStudio o ejecutar «sqlite3 wp-content/database/.ht.sqlite .dump > backup.sql» no es compatible directamente con MySQL.

SQLite3

SQLite se instala de forma predeterminada en sistemas Unix como Mac. En Windows, puedes descargarlo desde la página oficial.

Una vez que lo tengas instalado:

1. Selecciona el sitio local en Studio.
2. Haz clic en la pestaña Vista general.
3. Haz clic en el botón Terminal.
4. En la terminal, ejecuta el siguiente comando para interactuar con tu base de datos:
   sqlite3 wp-content/database/.ht.sqlite

Consulta más información sobre cómo usar SQLite3 desde la terminal en la documentación de SQLite3.

SQLiteStudio

Si prefieres usar una aplicación con interfaz de usuario, puedes usar SQLiteStudio.

Una vez que lo tengas instalado:

1. Localiza la carpeta wp-content/database/ en el explorador de archivos o Finder.
2. Asegúrate de que puedes ver archivos ocultos.
3. Abre SQLiteStudio.
4. Arrastra y suelta el archivo .ht.sqlite en la aplicación.

¿Cómo puedo usar Studio con el servidor MySQL que yo elija?

Studio es compatible de forma nativa con una base de datos SQLite, pero puedes usar el servidor MySQL que tú elijas, como Homebrew o Docker, para probar tu sitio con diferentes motores de base de datos.

Si tienes un sitio local ya configurado para trabajar con un servidor MySQL personalizado de tu elección, puedes añadirlo a Studio. Si los archivos del sitio incluyen un archivo wp-config.php, Studio omitirá la configuración de la base de datos SQLite y utilizará la base de datos ya configurada.

Si ya has creado un sitio en Studio y quieres cambiar de SQLite al servidor MySQL que hayas elegido, sigue los siguientes pasos:

1. Detén la ejecución del sitio.
2. Abre el directorio de tu sitio en Studio.
3. Navega al directorio wp-content y elimina el archivo db.php y el directorio database.
4. Navega al directorio mu-plugins y elimina el directorio sqlite-database-integration-main.
5. Actualiza el archivo wp-config.php e introduce las credenciales de tu servidor MySQL.
6. Inicia el sitio.
7. Inicia tu servidor MySQL.
8. Abre el sitio.

¿Cómo cambio la versión de PHP que se utiliza en mi sitio? 

Al crear un sitio, la versión actual de PHP se muestra en la pestaña de configuración del sitio, donde también puedes editar y cambiar la versión de PHP.

1. Selecciona el sitio que te interesa en la barra lateral. 
2. Haz clic en la sección Configuración. 
3. Haz clic en el botón Editar junto al elemento de la versión de PHP. 
4. Dentro del diálogo, selecciona la versión de PHP que quieres. 
5. Haz clic en el botón Guardar para aplicar los cambios. 

¿Por qué no aparece mi aplicación favorita en la sección «Abrir en»?

Los botones que están disponibles actualmente en la sección Abrir en… de cada uno de tus sitios locales son Finder (en macOS), Explorador de archivos (en Windows), y VS Code, Terminal y PhpStorm en ambas plataformas.

Studio, PhpStorm y VS Code deben estar en tu carpeta de aplicaciones para que aparezca el botón correspondiente en la sección Abrir en…

¿Cómo puedo hacer que Studio sea más rápido en Windows?

Si tienes activado el servicio de protección en tiempo real de Windows Defender en tu ordenador, es posible que el proceso de creación e inicio de un sitio se vea ralentizado, particularmente al ejecutar archivos PHP de WordPress. Para mejorar la velocidad del sitio, recomendamos ajustar la configuración de la siguiente manera:

Windows 11:

1. Selecciona Inicio, luego abre Configuración. En Privacidad y seguridad, selecciona Protección contra virus y amenazas.
2. En Configuración de protección contra virus y amenazas, selecciona Gestionar ajustes, y, bajo Exclusiones, selecciona Añadir o quitar exclusiones.
3. Selecciona Añadir una exclusión, y luego selecciona desde el proceso.
4. Escribe la ruta del archivo ejecutable de la aplicación Studio (por ejemplo, C:\Users\<YOUR_USER>\AppData\Local\studio\Studio.exe) y luego haz clic en el botón Añadir.

Windows 10:

1. Ve a Inicio > Configuración > Actualización y seguridad > Seguridad de Windows > Protección contra virus y amenazas.
2. Bajo Configuración de protección contra virus y amenazas, selecciona Gestionar configuraciones, y en Exclusiones, selecciona Añadir o quitar exclusiones.
3. Selecciona Añadir una exclusión, y después desde el proceso.
4. Escribe la ruta del archivo ejecutable de la aplicación Studio (por ejemplo, C:\Users\<YOUR_USER>\AppData\Local\studio\Studio.exe) y haz clic en el botón Añadir.

¿Cómo puedo regenerar las miniaturas?

Si al importar tu sitio faltan algunas miniaturas, puedes regenerarlas ejecutando el siguiente comando en WP-CLI:

wp media regenerate --yes --only-missing

Si no tienes instalado WP-CLI, puedes pedirle a Studio Assistant que ejecute este comando por ti. Solo tienes que pedirle: «Por favor, regenera mis imágenes usando WP-CLI.»

¿Cómo puedo acceder a los registros de Studio?

A veces, al realizar acciones como Push o Pull en la pestaña Sincronizar o Importar / Exportar, es posible que se produzcan fallos debido a diferentes razones relacionadas con PHP, la base de datos del sitio o algún problema con el código personalizado.

Si esto sucede, podrás abrir un registro en Studio, y es posible que se te pida que te pongas en contacto con el servicio de soporte. También puedes abrir los registros manualmente.

Si usas Studio en Mac:

1. Abre Terminal.
2. Introduce el comando:
   open ~/Library/Logs/Studio
3. Localiza el archivo de registro más reciente y ábrelo.

Si usas Studio en Windows:

1. Abre Terminal.
2. Introduce el comando:
   ii AppData\Roaming\Studio\logs
3. Localiza el archivo de registro más reciente y ábrelo.

¿Es posible cambiar el puerto o la URL de mi sitio de Studio?

No, no es posible cambiar el puerto de un sitio de Studio. Cada sitio recibe un puerto único comenzando desde el 8881. Por ejemplo, tu primer sitio de Studio recibirá la URL http://localhost:8881, y tu segundo sitio usará http://localhost:8882 y así sucesivamente. Aunque el puerto o la URL no pueden modificarse desde Studio, puedes cambiar la URL del sitio de WordPress desde la configuración general de WordPress. Solo asegúrate de que incluya el puerto correcto asignado por Studio y apunte a localhost.

Preguntas frecuentes sobre Studio Assistant

Estas son algunas respuestas a las preguntas más habituales sobre Studio Assistant. Échale un vistazo a la documentación de Studio Assistant para ver instrucciones paso a paso y otros consejos útiles sobre el funcionamiento de esta función.

¿De dónde vienen las respuestas de Studio Assistant?

Studio Assistant utiliza la infraestructura de WordPress.com y la documentación de WordPress para dar respuestas útiles utilizando la tecnología RAG (Retrieval-augmented generation). Por eso necesita estar conectado a Internet y a una cuenta de WordPress.com.

¿En qué idiomas está disponible Studio Assistant?

Los ejemplos de peticiones que aparecen al empezar a utilizar Studio Assistant están en el idioma que hayas elegido para Studio, pero puedes hablar con el asistente en el idioma que quieras. 

¿Puedo usar Studio Assistant sin una cuenta de WordPress.com?

No, debes iniciar sesión en Studio con tu cuenta de WordPress.com para utilizar Studio Assistant. Esto es porque utilizamos la infraestructura de WordPress.com para generar los mensajes y gestionar el acceso.

¿Utilizar Studio Assistant cuesta dinero?

Studio Assistant es gratuito para cualquier usuario de WordPress.com, independientemente del plan que tengas. 

¿Cuántas peticiones puedo realizar al mes?

Cada usuario dispone de 200 peticiones al mes para todos sus sitios de Studio. Si alcanzas este límite, deberás esperar a que se reinicie el próximo mes.

¿Dónde puedo dar mi opinión sobre las respuestas de Studio Assistant?

Hay dos formas de dar tu opinión sobre las respuestas del asistente.

Por un lado, hay un sistema de valoración integrado en las respuestas. Solo tienes que hacer clic en Sí o No al final de cada respuesta para dar tu opinión al equipo de Studio.

También puedes ponerte en contacto con el servicio de soporte para compartir comentarios sobre las respuestas de Studio Assistant. 

Preguntas frecuentes sobre Studio Sync

Estas son algunas respuestas a las preguntas más habituales sobre la función Studio Sync. Échale un vistazo a la documentación de Studio Sync para ver instrucciones paso a paso y otros consejos útiles sobre el funcionamiento de esta función.

¿Por qué no aparecen mis usuarios locales en el sitio de WordPress.com después de hacer push?

Al hacer push, Studio exporta todo el contenido y toda la base de datos, excepto las tablas wp_users y wp_usermeta. Esto es para garantizar que las funciones de Jetpack sigan funcionando en tu web de WordPress.com (como el inicio de sesión único o la optimización de imágenes) después del push.

También se puede actualizar un sitio de Studio ya existente desde un archivo de copia de seguridad de forma similar, o solo con el archivo .sql, en la pestaña Importar / Exportar.

Los archivos de copia de seguridad se pueden descargar desde tu sitio de WordPress.com o desde la página del registro de actividad de Jetpack. Contendrán los siguientes archivos y directorios:

• wp-config.php: El archivo de configuración de WordPress.
• wp-content/plugins: La carpeta que contiene los plugins de tu sitio.
• wp-content/themes: La carpeta que contiene los temas de tu sitio.
• wp-content/uploads: La carpeta que contiene las subidas de tu sitio.
• sql/: Un directorio con archivos .sql que contienen los datos de la base de datos de tu sitio.

Las exportaciones desde Studio también tendrán un archivo meta.json que contiene información sobre la versión de PHP preferida para el sitio.

Otros formatos compatibles son:

• El archivo .wpress del plugin All-in-One WP Migration and Backup
• El archivo .zip de la aplicación Local
• El archivo .zip de WordPress Playground

Cómo añadir un nuevo sitio a Studio desde una copia de seguridad

Para añadir un nuevo sitio a Studio desde una copia de seguridad, necesitarás un archivo .tar.gz o .zip:

1. Haz clic en el botón Añadir sitio en Studio.
2. Ponle nombre a tu sitio.
3. Selecciona el archivo de la copia de seguridad en el campo Importar copia de seguridad.
4. En ajustes avanzados, selecciona una Ruta local o acepta la que aparece por defecto (opcional).
5. Haz clic en Añadir sitio.

Cualquier sitio importado se inicia de forma predeterminada y estará visible en la barra lateral.

Cómo actualizar un sitio de Studio ya existente desde una copia de seguridad

Para actualizar un sitio de Studio ya existente desde una copia de seguridad, necesitarás un archivo .tar.gz, .zip o .sql:

1. Selecciona el sitio que quieres actualizar desde la barra lateral de Studio.
2. Abre la pestaña Importar / Exportar.
3. Haz clic en el cuadro de Importar para seleccionar el archivo de copia de seguridad. También puedes arrastrar y soltar el archivo en el cuadro de Importar.
4. Cuando aparezca el mensaje, haz clic en Importar para sobrescribir tu sitio de Studio con el archivo de la copia de seguridad.

El sitio de Studio será sustituido por la copia de seguridad .tar.gz o .zip proporcionada. Sin embargo, al importar un archivo .sql a un sitio previo, se volcará la base de datos sobre el sitio existente.

Cómo exportar un sitio desde Studio

Studio te permite exportar todo tu sitio local en un formato .tar.gz compatible con Jetpack Backup. También puedes exportar solo la base de datos en un archivo .sql compatible con MySQL.

Para exportar un sitio desde Studio:

1. Selecciona el sitio que quieres exportar desde la barra lateral de Studio.
2. Abre la pestaña Importar / Exportar.
3. Haz clic en el botón Exportar sitio completo para generar un archivo .tar.gz de todo el sitio o el botón Exportar base de datos para generar un archivo .sql.
4. Elige el destino y haz clic en Guardar.

Cuando haya terminado la exportación, Studio abrirá automáticamente el directorio que contiene el archivo de copia de seguridad.

Cómo subir una exportación de Studio a un sitio de WordPress alojado

Una vez que tengas el archivo de copia de seguridad, puedes desplegarlo en un sitio de WordPress alojado en cualquier lugar. Por ejemplo, si tienes un plan Business de WordPress.com, puedes seguir esta guía para restaurar manualmente tu sitio desde un archivo de copia de seguridad de Jetpack en WordPress.com.

Cómo importar un sitio si no uso Jetpack Backup

Si no utilizas Jetpack Backup, puedes importar un sitio a Studio desde un archivo de copia de seguridad creado manualmente:

1. Crea un directorio de importación temporal, por ejemplo, import-to-studio/.
2. Crea directorios sql/ y wp-content/ dentro del directorio.
3. Abre el directorio wp-content/ de tu sitio y copia plugins/, themes/ y uploads/ en el wp-content/ del directorio de importación temporal.
4. Copia el wp-config.php de tu sitio al directorio de importación temporal.
5. Exporta la base de datos de tu sitio usando tu herramienta MySQL favorita y pon el archivo de volcado en el directorio sql/.
6. Selecciona todos los archivos en el directorio de importación temporal y comprímelos como un archivo .zip.
7. Sigue los pasos de arriba para añadir un nuevo sitio desde un archivo de copia de seguridad.

Puedes crear hasta cinco sitios de vista previa a la vez en cada cuenta de WordPress.com, y puedes ver el número total de sitios de vista previa que tienes asociados a tu cuenta haciendo clic en tu avatar dentro de la aplicación Studio.

Aunque los sitios de vista previa tienen como finalidad ser compartidos con clientes para que puedan comentar sobre ellos durante hasta siete días, necesitas un plan de hosting para que tu sitio sea accesible de forma permanente. Utiliza Studio Sync o las funciones Importar/Exportar para conectar tu sitio de Studio a un plan de alojamiento.

Crear un sitio de vista previa

Para crear un sitio de vista previa: 

1. Selecciona el sitio local en Studio.
2. Haz clic en la pestaña «Vistas previas».
3. Accede a WordPress.com si aún no lo has hecho.
4. Haz clic en el botón «Crear sitio de vista previa».

Tu sitio de vista previa estará listo en unos segundos, y estará disponible para acceder públicamente durante siete días.

Cambiar el nombre a un sitio de vista previa

Puedes crear varios sitios de vista previa por cada sitio de Studio. Para diferenciarlos entre ellos, puedes cambiarles el nombre en Studio siguiendo los siguientes pasos:

1. Selecciona el sitio local en Studio.
2. Haz clic en la pestaña Vistas previas.
3. Haz clic en los tres puntos (⋮) de la fila del sitio de vista previa.
4. Haz clic en el botón Renombrar.
5. Introduce el nuevo nombre.
6. Haz clicl en el botón Guardar.

El sitio de vista previa tendrá ese nombre en tu lista de sitios de vista previa, mientras que la vista previa remota mantendrá el mismo nombre.

Eliminar un sitio de vista previa

Para eliminar un sitio de vista previa: 

1. Selecciona el sitio local en Studio.
2. Haz clic en la pestaña Vistas previas.
3. Haz clic en los tres puntos (⋮) de la fila del sitio de vista previa.
4. Haz clic en el botón Eliminar.

El sitio de previa será eliminado y desaparecerá de la lista.

Actualizar tu sitio de vista previa

Aunque los sitios de vista previa se generan como una instantánea de un momento concreto de tu trabajo, es posible sincronizar los cambios en el sitio local en tu sitio de demostración: 

1. Selecciona el sitio local en Studio.
2. Haz clic en la pestaña Vistas previas.
3. Haz clic en los tres puntos (⋮) de la fila del sitio de vista previa.
4. Haz clic en Actualizar y confírmalo.

Tu sitio de vista previa se actualizará con los cambios de tu sitio local en unos segundos. También se reiniciará la fecha de caducidad del sitio de demostración a siete días.

Caducidad del sitio de vista previa

Los sitios de vista previa son temporales, y cada uno de ellos será eliminado automáticamente tras siete días desde la última actualización. Esto sirve para garantizar que los entornos de vista previa se utilizan para recibir comentarios y revisiones a corto plazo.

Eliminar todos los sitios de vista previa

Para eliminar todos los sitios de demostración de Studio:

1. Haz clic en tu avatar en Studio.
2. Haz clic en los tres puntos (⋮) junto a tus sitios de vista previa.
3. Haz clic en el botón Eliminar todos los sitios de vista previa.