Saltar al contenido Saltar a la navegación

Conecta asistentes de IA a tu sitio WordPress con el servidor MCP de SEOPress

Desde la versión 10.3, SEOPress incluye un servidor MCP integrado. MCP (Model Context Protocol) es el estándar abierto que utilizan los asistentes de IA para comunicarse con herramientas externas. Una vez conectado tu sitio, Claude, ChatGPT, Cursor o cualquier otro cliente MCP puede leer y gestionar tus datos SEO directamente desde una conversación: títulos, meta descripciones, directivas robots, metadatos sociales, análisis de contenido, redirecciones, datos estructurados y más. Desde SEOPress 10.4, esto también incluye los términos de tus taxonomías: categorías, etiquetas, categorías de producto y taxonomías personalizadas.

El servidor MCP viene incluido en SEOPress Free. SEOPress PRO añade sus propias herramientas. No hay ningún plugin adicional que instalar, ningún servicio de terceros de por medio y ninguna clave de API que pagar: el cliente de IA habla directamente con tu sitio.

Qué puedes hacer con él

Algunas peticiones que puedes escribir en tu cliente de IA una vez conectado el sitio:

  • «Lista las páginas que no tienen meta descripción y redacta una para cada una.»
  • «¿Qué entradas están en noindex? Dime si alguna parece un error.»
  • «Ejecuta el análisis de contenido de la entrada 123 para la palabra clave “seo wordpress” y dime qué hay que corregir.»
  • «Reescribe los títulos SEO de mis 10 últimas entradas para que no superen los 60 caracteres.»
  • «Lista las categorías de producto que no tienen meta descripción y redacta una para cada una.» (SEOPress 10.4)
  • «Crea una redirección 301 de /pagina-antigua/ a /pagina-nueva/.» (SEOPress PRO)
  • «Ejecuta la auditoría técnica del sitio y resume los problemas por prioridad.» (SEOPress PRO)

El asistente elige por sí mismo las herramientas adecuadas. Tú mantienes el control de lo que puede hacer, como se explica más abajo.

Requisitos

  • SEOPress 10.3 o superior (SEOPress PRO 10.3 o superior para las herramientas PRO). Las herramientas de términos de taxonomía necesitan SEOPress 10.4, y las sugerencias con IA para términos, SEOPress PRO 10.4.
  • WordPress 6.9 o superior. El servidor MCP se basa en la API Abilities de WordPress, incluida en WordPress 6.9.
  • Un sitio servido por HTTPS. Los clientes que funcionan en la nube (claude.ai, chatgpt.com) necesitan una dirección HTTPS pública para llegar a tu sitio.
  • Una cuenta de usuario de WordPress con los permisos correspondientes a lo que quieres que haga el asistente.

Los sitios locales (localhost, 127.0.0.1, *.localhost) funcionan sin HTTPS con los clientes instalados en tu propio equipo: Claude Code, la aplicación de escritorio de Claude y Cursor. claude.ai y chatgpt.com funcionan en sus propios servidores y no pueden ver un sitio local.

Paso 1: activa el servidor MCP

El servidor MCP está desactivado por defecto. No se expone nada hasta que lo activas.

  1. Ve a SEO > Avanzado, pestaña Avanzado.
  2. En la sección Abilities API, activa Exponer capacidades a agentes de IA y herramientas externas.
  3. Haz clic en Guardar cambios.
  4. Abre la pestaña MCP de la misma página.

La pestaña MCP reúne todo lo que necesitas: el estado de la conexión, las comprobaciones de disponibilidad, la URL del servidor MCP, las instrucciones para cada cliente, una sección de solución de problemas, los clientes conectados y la lista de herramientas.

Desde SEOPress 10.4, también puedes abrirla desde el escritorio de SEO (SEO > Escritorio). En la sección Módulos de SEO, el grupo Técnico tiene una tarjeta Servidor MCP: «Gestiona tu SEO desde tu asistente de IA: Claude, ChatGPT, Cursor o cualquier cliente MCP.» Su enlace Ajustes abre la pestaña MCP. A diferencia de la mayoría de los módulos, esta tarjeta no tiene interruptor de activación: el servidor se activa y desactiva con el ajuste Exponer capacidades a agentes de IA y herramientas externas mencionado arriba.

La URL de tu servidor MCP tiene este aspecto:

https://example.com/wp-json/seopress/mcp/v1

Si tus enlaces permanentes están en «Simple», la URL usa la forma con parámetro de consulta (https://example.com/?rest_route=/seopress/mcp/v1). También funciona: cópiala exactamente como la muestra la pestaña MCP.

Paso 2: conecta tu cliente de IA

En la sección Conexión de la pestaña MCP, elige tu cliente: Claude, ChatGPT o Cursor. Cada uno se configura de forma distinta, por lo que solo se muestran las instrucciones del que elijas. Desde SEOPress 10.4, cada cliente tiene además una línea Cómo inicia sesión: que indica lo que necesita de tu sitio.

Cuando tu sitio puede usar OAuth, todos los clientes inician sesión de esa forma. Pegas la URL, tu navegador abre tu propio sitio, accedes a WordPress y apruebas la conexión. No hay ninguna contraseña ni clave de API que crear o copiar. Si tu sitio no puede usar OAuth, las pestañas de Claude y de Cursor pasan por sí solas a una contraseña de aplicación: consulta Cuando tu sitio no puede usar OAuth más abajo.

Claude (claude.ai, aplicación de escritorio, Claude Code)

Claude existe como aplicación de chat, en claude.ai o instalada en tu ordenador, y como Claude Code en un terminal. Desde SEOPress 10.4, la pestaña de Claude tiene un bloque para cada uno: sigue el de la aplicación que utilizas. claude.ai y la pantalla Connectors de la aplicación de escritorio se conectan desde los servidores de Anthropic, por lo que tu sitio necesita una dirección HTTPS pública para ellos. Claude Code inicia sesión desde tu propio equipo.

claude.ai y la aplicación de escritorio de Claude

  1. Abre Settings > Connectors y después Add custom connector.
  2. Pega la URL de tu servidor MCP. Deja vacíos todos los demás campos: tu sitio registra el cliente por sí mismo y le indica dónde iniciar sesión.
  3. Tu navegador se redirige a tu sitio. Accede a WordPress si es necesario y aprueba la conexión.

Claude Code (terminal)

Ejecuta en un terminal el comando que muestra la pestaña MCP. Tiene este aspecto:

claude mcp add --transport http --scope user SEOPress "https://example.com/wp-json/seopress/mcp/v1"

Después inicia Claude Code, escribe /mcp, elige SEOPress e inicia sesión en tu sitio en la ventana del navegador que se abre.

ChatGPT

ChatGPT inicia sesión solo mediante OAuth: no se puede usar una contraseña de aplicación. chatgpt.com se conecta desde los servidores de OpenAI, por lo que necesita tu sitio en una dirección HTTPS pública. Desde SEOPress 10.4, la pestaña de ChatGPT da pasos distintos para la aplicación de escritorio y para chatgpt.com.

La aplicación de escritorio de ChatGPT

  1. Abre Settings y después Plugins, en Integrations. Haz clic en Add y elige Add MCP server.
  2. Ponle un nombre, elige el tipo Streamable HTTP, pega la URL de tu servidor MCP y guarda. Deja vacíos los campos de token (bearer token) y de cabeceras: tu sitio firma la conexión mediante OAuth por sí mismo.
  3. Haz clic en Authenticate junto al servidor, accede a tu sitio y aprueba la conexión.

chatgpt.com

  1. Los servidores MCP personalizados solo aparecen en el modo desarrollador. Abre Settings y activa Developer mode en la sección de seguridad e inicio de sesión.
  2. Desde la página Plugins, abre el formulario para crear un plugin personalizado: según tu cuenta, un botón +, o Browse directory y después Add.
  3. Rellénalo con un nombre y la URL de tu servidor MCP como URL del servidor, deja OAuth como método de autenticación, confirma el aviso de riesgo y créalo.
  4. Accede a tu sitio cuando tu navegador se redirija a él y aprueba la conexión.

Cursor

Cursor lee sus servidores MCP de un archivo JSON que editas tú mismo. Inicia sesión mediante OAuth la primera vez que usa el servidor, así que no hay nada que crear de antemano.

  1. Abre o crea el archivo .cursor/mcp.json (solo este proyecto) o ~/.cursor/mcp.json (todos los proyectos).
  2. Añade el servidor SEOPress que aparece a continuación. Si el archivo ya contiene un objeto mcpServers, añade la entrada SEOPress dentro de él en lugar de reemplazar el archivo.
{
    "mcpServers": {
        "SEOPress": {
            "type": "http",
            "url": "https://example.com/wp-json/seopress/mcp/v1"
        }
    }
}

Después reinicia Cursor, abre Settings > Customize > MCPs, haz clic en Authenticate junto a SEOPress y aprueba la conexión.

Cuando tu sitio no puede usar OAuth

OAuth no puede funcionar cuando el sitio no se sirve por HTTPS (salvo los sitios locales), cuando el servidor OAuth está desactivado o cuando tu alojamiento responde él mismo a las direcciones de descubrimiento /.well-known/ en lugar de pasarlas a WordPress. Desde SEOPress 10.4, la pestaña MCP tiene en cuenta el resultado de las comprobaciones de disponibilidad y adapta las pestañas de los clientes:

  • ChatGPT, claude.ai y la pantalla Connectors de la aplicación de escritorio de Claude no pueden conectarse. Su pestaña indica qué falta y qué hay que corregir.
  • Claude Code, la aplicación de escritorio de Claude y Cursor siguen funcionando: se ejecutan en tu propio equipo y envían en su lugar una contraseña de aplicación de WordPress. Las pestañas de Claude y de Cursor muestran entonces las configuraciones para este método.

Crear la contraseña de aplicación

En la pestaña de Claude o de Cursor, dale a la contraseña un Nombre (SEOPress MCP por defecto, el nombre con el que aparece en tu perfil) y haz clic en Crear una contraseña de aplicación. WordPress la crea para tu cuenta y las configuraciones de la pestaña se rellenan solas con ella: no queda nada que reemplazar. La contraseña se muestra una sola vez y SEOPress nunca la almacena: copia lo que necesites antes de recargar la página.

¿Ya has creado una contraseña de aplicación desde tu perfil? Mientras no crees una en la pestaña, las configuraciones llevan el marcador BASE64_OF_USERNAME_COLON_APPLICATION_PASSWORD. La pestaña ofrece un comando que te pide la contraseña e imprime el Base64 que debes pegar en su lugar. En macOS o Linux, ejecútalo en un terminal (la pestaña escribe tu propio nombre de usuario en lugar de USERNAME):

read -rsp 'Application password: ' SEOPRESS_PW && printf '%s' "USERNAME:$SEOPRESS_PW" | base64 && unset SEOPRESS_PW

En Windows, ejecuta este otro en PowerShell:

$pw = Read-Host 'Application password' -AsSecureString; [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes('USERNAME:' + [Net.NetworkCredential]::new('', $pw).Password)); Remove-Variable pw

Aplicación de escritorio de Claude

El archivo de configuración de la aplicación de escritorio solo inicia servidores en tu propio equipo, así que llega a tu sitio a través de mcp-remote, un pequeño puente que necesita Node.js.

  1. Instala Node.js (la versión LTS de nodejs.org) si tu ordenador aún no lo tiene. El puente se ejecuta con npx, que viene incluido.
  2. En la aplicación de escritorio, abre Settings, después Developer, y haz clic en Edit Config. En macOS, Settings está en el menú Claude; en Windows, en el menú de la parte superior izquierda de la ventana, en File. Te muestra el archivo claude_desktop_config.json: ábrelo en un editor de texto. El archivo está en ~/Library/Application Support/Claude/ en macOS, %APPDATA%\Claude\ en Windows y ~/.config/Claude/ en Linux.
  3. Pega en él la configuración de la pestaña MCP. Si el archivo ya contiene un objeto mcpServers, añade la entrada SEOPress dentro de él en lugar de reemplazar el archivo.
  4. Cierra la aplicación por completo y vuelve a abrirla: cerrar su ventana la deja en ejecución. En macOS, elige Quit Claude en el menú Claude. En Windows, haz clic derecho en el icono de Claude de la bandeja del sistema, junto al reloj, y elige Quit.
  5. Vuelve a abrir Settings > Developer: SEOPress debería aparecer en ejecución. Si en su lugar muestra un error, su log, que se abre desde ahí, indica el motivo.

La configuración tiene este aspecto:

{
    "mcpServers": {
        "SEOPress": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://example.com/wp-json/seopress/mcp/v1",
                "--header",
                "Authorization:${AUTH_HEADER}"
            ],
            "env": {
                "AUTH_HEADER": "Basic BASE64_OF_USERNAME_COLON_APPLICATION_PASSWORD"
            }
        }
    }
}

Claude Code (terminal)

Claude Code envía la contraseña de aplicación por sí mismo, así que no necesita ningún puente. Ejecuta el comando que muestra la pestaña MCP:

claude mcp add --transport http --scope user SEOPress "https://example.com/wp-json/seopress/mcp/v1" --header "Authorization: Basic BASE64_OF_USERNAME_COLON_APPLICATION_PASSWORD"

Después inicia Claude Code y escribe /mcp: SEOPress debería aparecer como conectado.

Cursor

Pega la configuración de la pestaña de Cursor en .cursor/mcp.json o ~/.cursor/mcp.json, como antes. Lleva la contraseña en una cabecera:

{
    "mcpServers": {
        "SEOPress": {
            "type": "http",
            "url": "https://example.com/wp-json/seopress/mcp/v1",
            "headers": {
                "Authorization": "Basic BASE64_OF_USERNAME_COLON_APPLICATION_PASSWORD"
            }
        }
    }
}

Reinicia Cursor y abre Settings > Customize > MCPs: SEOPress debería aparecer con sus herramientas.

Otros clientes MCP

Cualquier cliente compatible con el transporte Streamable HTTP puede conectarse. Si es compatible con OAuth, dale la URL del servidor MCP y encontrará por sí mismo la página de inicio de sesión.

En caso contrario, puedes autenticarte con una contraseña de aplicación de WordPress, enviada en una cabecera Authorization de tipo Basic, como en la configuración de Cursor anterior:

{
    "mcpServers": {
        "SEOPress": {
            "type": "http",
            "url": "https://example.com/wp-json/seopress/mcp/v1",
            "headers": {
                "Authorization": "Basic BASE64_OF_USERNAME_COLON_APPLICATION_PASSWORD"
            }
        }
    }
}

La cabecera lleva Basic, un espacio y después el Base64 de tu nombre de usuario, dos puntos y la contraseña de aplicación. Los comandos Base64 anteriores imprimen ese valor por ti.

La pantalla de aprobación: solo lectura, o lectura y modificación

Cuando un cliente se conecta mediante OAuth, tu sitio muestra una pantalla de aprobación. Indica qué cliente hace la solicitud, en nombre de qué cuenta de WordPress actuará y la lista de herramientas que obtendrá. A continuación eliges lo que la conexión puede hacer:

  • Leer y cambiar: todas las herramientas están disponibles.
  • Solo lectura: solo se sirven las herramientas que leen datos. Las herramientas que modifican datos no se muestran a esta conexión, y se rechazan si el cliente pide una por su nombre.

Haz clic en Permitir esta conexión para terminar, o en Rechazar para cancelar.

El cliente elige su propio nombre al registrarse y nada permite verificarlo. Aprueba únicamente una conexión que acabes de iniciar tú.

Paso 3: comprueba que funciona

Pregunta a tu asistente qué herramientas tiene. Debería listar las que aparecen en la sección Herramientas expuestas de la pestaña MCP.

Si no aparece nada, abre el panel Diagnósticos en la parte superior de la pestaña MCP y haz clic en Ejecutar las comprobaciones. Cada línea ámbar o roja indica qué hay que cambiar en tu sitio. Desde SEOPress 10.4, una línea azul significa que el resultado es el esperado para la configuración de tu sitio y que no hay nada que corregir.

Herramientas disponibles

Los nombres de las herramientas llevan el prefijo seopress__. Por ejemplo, la ability seopress/get-post-title-description se sirve como la herramienta seopress__get-post-title-description.

SEOPress Free

Herramienta Qué hace Acceso Quién puede usarla
get-post-title-description Lee el título SEO y la meta descripción personalizados de una entrada Solo lectura Usuarios que pueden editar la entrada
update-post-title-description Define o vacía el título SEO y la meta descripción de una entrada Puede modificar datos Usuarios que pueden editar la entrada, si su perfil no está bloqueado en las cajas meta de SEO
get-post-robots-settings Lee las directivas robots de una entrada (noindex, nofollow, URL canónica, categoría principal…) Solo lectura Usuarios que pueden editar la entrada
update-post-robots-settings Actualiza las directivas robots de una entrada Puede modificar datos Usuarios que pueden editar la entrada, si su perfil no está bloqueado en las cajas meta de SEO
get-post-social-settings Lee los metadatos de Facebook/Open Graph y X/Twitter de una entrada Solo lectura Usuarios que pueden editar la entrada
update-post-social-settings Actualiza los metadatos de Facebook/Open Graph y X/Twitter de una entrada Puede modificar datos Usuarios que pueden editar la entrada, si su perfil no está bloqueado en las cajas meta de SEO
analyze-post-content Ejecuta el análisis de contenido de una entrada y devuelve la puntuación, las comprobaciones y las recomendaciones Solo lectura Usuarios que pueden editar la entrada
list-posts-missing-metadata Lista las entradas sin título SEO y/o sin meta descripción personalizados Solo lectura Usuarios que pueden editar entradas
list-posts-by-content-score Lista las entradas con el veredicto de su último análisis de contenido Solo lectura Usuarios que pueden editar entradas
list-posts-noindexed Lista las entradas con una directiva noindex explícita Solo lectura Usuarios que pueden editar entradas
get-term-title-description Lee el título SEO y la meta descripción personalizados de un término de taxonomía (categoría, etiqueta, categoría de producto…). Desde 10.4 Solo lectura Usuarios que pueden editar el término
update-term-title-description Define o vacía el título SEO y la meta descripción de un término de taxonomía. Desde 10.4 Puede modificar datos Usuarios que pueden editar el término, si su perfil no está bloqueado en las cajas meta de SEO
get-term-robots-settings Lee las directivas robots de un término de taxonomía (noindex, nofollow, nosnippet, noimageindex, URL canónica). Desde 10.4 Solo lectura Usuarios que pueden editar el término
update-term-robots-settings Actualiza las directivas robots de un término de taxonomía. Una directiva forzada por los ajustes globales no se escribe. Desde 10.4 Puede modificar datos Usuarios que pueden editar el término, si su perfil no está bloqueado en las cajas meta de SEO
get-term-social-settings Lee el título, la descripción y la imagen de Facebook/Open Graph y X/Twitter de un término de taxonomía. Desde 10.4 Solo lectura Usuarios que pueden editar el término
update-term-social-settings Actualiza el título, la descripción y la imagen de Facebook/Open Graph y X/Twitter de un término de taxonomía. Desde 10.4 Puede modificar datos Usuarios que pueden editar el término, si su perfil no está bloqueado en las cajas meta de SEO
list-terms-missing-metadata Lista los términos de taxonomía sin título SEO y/o sin meta descripción personalizados. Desde 10.4 Solo lectura Usuarios que pueden editar los términos de una taxonomía (solo se listan esas taxonomías)
get-global-titles-settings Lee las plantillas globales de títulos y meta descripciones Solo lectura Usuarios que pueden gestionar los ajustes de Títulos y metas
get-sitemap-settings Lee la configuración de los sitemaps XML y HTML Solo lectura Usuarios que pueden gestionar los ajustes de Sitemap XML / HTML
get-instant-indexing-settings Lee la configuración del indexado instantáneo y el registro de envíos. Las claves de API nunca se devuelven Solo lectura Usuarios que pueden gestionar los ajustes del indexado instantáneo
get-global-social-settings Lee el Knowledge Graph y los ajustes sociales por defecto Solo lectura Usuarios que pueden gestionar los ajustes de Redes sociales

Las herramientas de términos funcionan con las taxonomías públicas cuya caja meta de SEO está activada. Una taxonomía en la que está marcada la opción Desactivar caja meta de SEO en SEO > Títulos y metas, pestaña Taxonomías, se rechaza.

SEOPress PRO

Herramienta Qué hace Acceso Quién puede usarla
list-redirections Lista las redirecciones y los errores 404 detectados, con paginación, búsqueda y filtros Solo lectura Usuarios que pueden leer las redirecciones
get-redirection Lee una redirección Solo lectura Usuarios que pueden leer las redirecciones
create-redirection Crea una redirección de una URL de origen a una URL de destino Puede modificar datos Usuarios que pueden publicar redirecciones
update-redirection Actualiza una redirección existente Puede modificar datos Usuarios que pueden editar la redirección
delete-redirection Elimina una redirección de forma permanente Puede modificar datos Usuarios que pueden eliminar la redirección
get-post-schemas Lee los datos estructurados manuales (schema.org) de una entrada Solo lectura Usuarios que pueden editar la entrada
update-post-schemas Reemplaza los datos estructurados manuales de una entrada Puede modificar datos Usuarios que pueden editar la entrada
update-target-keywords Actualiza las palabras clave objetivo de una entrada Puede modificar datos Usuarios que pueden editar la entrada
generate-seo-title Genera una sugerencia de título SEO con IA. La sugerencia no se guarda Solo lectura Usuarios que pueden editar la entrada, si su perfil puede usar la generación con IA
generate-meta-description Genera una sugerencia de meta descripción con IA. La sugerencia no se guarda Solo lectura Usuarios que pueden editar la entrada, si su perfil puede usar la generación con IA
generate-term-seo-title Genera con IA una sugerencia de título SEO para un término de taxonomía. La sugerencia no se guarda: guárdala con update-term-title-description. Desde 10.4 Solo lectura Usuarios que pueden editar el término, si su perfil puede usar la generación con IA
generate-term-meta-description Genera con IA una sugerencia de meta descripción para un término de taxonomía. La sugerencia no se guarda: guárdala con update-term-title-description. Desde 10.4 Solo lectura Usuarios que pueden editar el término, si su perfil puede usar la generación con IA
generate-alt-text Genera un texto alternativo y una leyenda para una imagen con IA. La sugerencia no se guarda Solo lectura Usuarios que pueden editar la imagen, si su perfil puede usar la generación con IA
upload-image Descarga una imagen desde una URL y la añade a la biblioteca de medios Puede modificar datos Usuarios que pueden subir archivos (y editar la entrada, cuando la imagen se adjunta a una)
get-technical-audit Ejecuta las comprobaciones técnicas globales del sitio y devuelve una lista de control estructurada Solo lectura Usuarios que pueden gestionar las herramientas de auditoría de SEOPress PRO

Los ajustes y las herramientas de auditoría están reservados por defecto a los administradores. Las cinco herramientas generate-* utilizan el proveedor de IA configurado en SEOPress PRO.

Desde SEOPress 10.4, las herramientas MCP respetan las restricciones por perfil de SEO > Avanzado, pestaña Seguridad, igual que la administración de WordPress:

  • Un perfil marcado en Cajas meta de SEO: perfiles bloqueados no puede usar las herramientas que modifican los ajustes SEO de una entrada o de un término. Sí puede seguir usando las que los leen.
  • Con SEOPress PRO, cuando hay perfiles marcados en Generación con IA, solo esos perfiles (y los administradores) pueden usar las herramientas generate-*.

Seguridad y permisos

El servidor MCP está diseñado para que conectar un cliente de IA nunca le dé más poder del que tú ya tienes.

  • Desactivado por defecto. El endpoint rechaza todas las peticiones hasta que activas la exposición.
  • Tus propios permisos, nunca más. Una conexión actúa en nombre de la cuenta de WordPress que la aprobó. Cada llamada a una herramienta pasa por las mismas comprobaciones de permisos que la administración de WordPress, incluidas las restricciones por perfil de la pestaña Seguridad. Un editor conectado por MCP no puede leer los ajustes de SEOPress reservados a los administradores, y un autor no puede editar las entradas de otra persona.
  • Conexiones de solo lectura. Se eligen en la pantalla de aprobación y el servidor las impone durante toda la vida de la conexión.
  • Solo herramientas de SEOPress. El servidor solo sirve las abilities de SEOPress. Las registradas por otros plugins quedan retenidas, salvo que decidas servirlas.
  • Control herramienta por herramienta. Puedes desactivar cualquier herramienta para todo el sitio.
  • Ningún secreto sale de tu sitio. Las claves de API almacenadas en los ajustes de SEOPress nunca se devuelven en una herramienta. Las contraseñas de aplicación creadas desde la pestaña MCP van de WordPress a tu navegador y SEOPress nunca las almacena ni las registra.
  • OAuth 2.1 estándar. El inicio de sesión utiliza PKCE, registro dinámico de clientes y tokens vinculados a la dirección de tu sitio. Los tokens de acceso duran una hora y se renuevan automáticamente. Una conexión que no se ha usado durante 30 días tiene que iniciar sesión de nuevo.
  • Revocable en cualquier momento. Un clic en la pestaña MCP corta el acceso de un cliente de inmediato.

Las herramientas que modifican datos guardan en tu sitio en producción, exactamente como si hubieras editado la entrada tú mismo. Pide a tu asistente que te muestre lo que piensa cambiar antes de hacerlo, y usa una conexión de solo lectura cuando solo necesites una auditoría.

Gestionar la conexión

Clientes conectados

La sección Clientes conectados de la pestaña MCP lista cada cliente que tiene un token para tu cuenta: su nombre, para qué fue aprobado (solo lectura, o lectura y modificación), cuándo se conectó y cuándo se usó por última vez. Haz clic en Revocar para cortarle el acceso. El efecto es inmediato.

Cada usuario solo ve y revoca sus propias conexiones. Una cuenta puede tener hasta 25 conexiones.

Si cambias la dirección de tu sitio, las conexiones emitidas para la dirección antigua se marcan como Ya no es válido. Revócalas y conéctate de nuevo.

Esta lista solo muestra las conexiones OAuth. Un cliente que inicia sesión con una contraseña de aplicación se revoca desde tu perfil de WordPress, con el enlace Gestionar las contraseñas de aplicación de la pestaña MCP.

Elegir qué herramientas se sirven

La sección Herramientas expuestas lista cada herramienta con su nivel de acceso. Usa el interruptor Servido al final de una fila para desactivar una herramienta y después guarda. Una herramienta desactivada deja de mostrarse a todos los clientes y no se puede llamar, sean cuales sean los permisos del usuario.

Es útil para reservarte una herramienta sensible, por ejemplo delete-redirection.

Abilities de otros plugins

Otros plugins pueden registrar sus propias abilities en WordPress. Por defecto, el servidor MCP de SEOPress no las sirve, de modo que activar tus herramientas SEO nunca entregue por accidente a un cliente de IA las herramientas de otro plugin.

Para servirlas también, activa También ofrece capacidades registradas por otros plugins en la sección Herramientas expuestas. Antes de que guardes, la pestaña MCP lista las herramientas que esto añadiría. Lee la lista: algunas pueden modificar o eliminar datos.

Solución de problemas

El panel Diagnósticos ejecuta nueve comprobaciones y te indica qué corregir en cada una de las que fallan.

Comprobación Si falla
API de capacidades de WordPress Actualiza WordPress a la versión 6.9 o superior.
Capacidades expuestas a clientes externos Activa Exponer capacidades a agentes de IA y herramientas externas en la pestaña Avanzado y guarda.
Ruta MCP registrada Otro plugin está eliminando rutas de la API REST de WordPress. Permite la ruta /seopress/mcp/v1.
Respuesta de la variable de MCP Un plugin de seguridad, un firewall o una CDN bloquea la petición, o tu alojamiento bloquea las peticiones de bucle local (loopback). Permite las peticiones POST a la URL del servidor MCP. Aquí se espera una respuesta HTTP 401: la comprobación llama al endpoint sin credenciales.
Contraseñas de aplicación Solo son necesarias para los clientes que no inician sesión mediante OAuth. WordPress solo las ofrece por HTTPS, y un plugin de seguridad puede desactivarlas.
HTTPS Instala un certificado TLS y cambia la dirección de WordPress y la dirección del sitio a https.
Enlaces permanentes Solo es un aviso: la URL funciona en su forma con parámetro de consulta. Elige cualquier estructura distinta de «Simple» para obtener una URL más corta.
OAuth para clientes de navegador OAuth necesita HTTPS (o un sitio local). Desde SEOPress 10.4, si el servidor OAuth se desactivó a propósito con el filtro seopress_mcp_oauth_enabled, esta línea aparece en azul: es lo esperado si te conectas con una contraseña de aplicación.
Documento de descubrimiento de OAuth Tu servidor no dirige las peticiones /.well-known/ a WordPress. Elige una estructura de enlaces permanentes distinta de «Simple». Si WordPress está instalado en un subdirectorio, añade una regla que le reenvíe las peticiones /.well-known/. Algunos alojamientos responden ellos mismos a las direcciones /.well-known/, antes de que se ejecute WordPress: pide al tuyo que deje pasar /.well-known/oauth-protected-resource y /.well-known/oauth-authorization-server hasta WordPress. Mientras tanto, las pestañas de Claude y de Cursor pasan a una contraseña de aplicación.

Cuando las comprobaciones están en verde pero un cliente falla

Las comprobaciones de disponibilidad llaman a tu sitio desde el propio sitio, por lo que un firewall o una CDN situados delante nunca las ven. Desde SEOPress 10.4, la pestaña MCP tiene una sección Diagnóstico, debajo de los pasos de conexión, que parte del mensaje que muestra tu cliente:

  • claude.ai o ChatGPT es rechazado aunque todas las comprobaciones están en verde (por ejemplo Dynamic client registration failed: registration endpoint returned 403). claude.ai y ChatGPT llaman a tu sitio desde sus propios servidores, sin navegador, y la protección contra bots lo trata como un bot. Permite las peticiones GET y POST a las direcciones de registro (Registration), de token (Token) y del servidor MCP que lista la pestaña, desde cualquier dirección IP. En Cloudflare, mira en Security, Events: si Bot Fight Mode las bloqueó con un desafío, desactívalo (en el plan Free, una regla WAF personalizada no puede omitirlo) o, en un plan de pago, añade una regla WAF que omita la protección contra bots para esas direcciones. Después vuelve a añadir el servidor en tu cliente.
  • claude.ai o ChatGPT encuentra el sitio, pero no puede iniciar sesión. El cliente no pudo leer los documentos de descubrimiento de OAuth. Abre en un navegador las dos direcciones que lista la pestaña: ambas deben responder con JSON, no con una página «no encontrada». Si no es así, pide a tu alojamiento que las deje pasar hasta WordPress.
  • La aplicación de escritorio de Claude no lista el servidor. Su archivo de configuración solo acepta servidores que ella misma inicia: una entrada con una url no es compatible y puede hacer que la aplicación descarte todos los servidores del archivo. Usa la configuración mcp-remote de la pestaña de Claude, comprueba que Node.js está instalado (npx --version imprime un número de versión), cierra la aplicación por completo y vuelve a abrirla, y después lee el log del servidor en Settings > Developer.
  • Claude Code, la aplicación de escritorio o Cursor es rechazado con un HTTP 401. La cabecera Authorization es incorrecta: un marcador que quedó en la configuración, el nombre de usuario de otra cuenta o una contraseña revocada. Crea una nueva contraseña de aplicación en la pestaña, o vuelve a ejecutar el comando Base64 y pega su resultado en lugar del marcador.

Otras situaciones habituales:

  • El cliente se conecta pero no lista ninguna herramienta. Revisa la sección Herramientas expuestas y que tu cuenta de WordPress tenga los permisos necesarios.
  • «Esta conexión se aprobó solo para lectura». La conexión se aprobó como solo lectura. Elimínala en tu cliente, conéctate de nuevo y elige Leer y cambiar.
  • «No tienes permiso para usar esta herramienta». Tu cuenta de WordPress no tiene el permiso que requiere la herramienta, o su perfil está restringido en la pestaña Seguridad.
  • El conector falla en el primer intento. Abre las dos direcciones listadas en Documentos de descubrimiento, dentro de la sección Clientes conectados. Ambas deben responder con JSON. Si no es así, un plugin de seguridad, una caché o una regla del servidor lo está impidiendo.
  • Una caché o una capa de seguridad delante del sitio. Excluye /wp-json/seopress/mcp/ y /.well-known/oauth-* de la caché de página, y no elimines la cabecera Authorization.
  • Otro plugin ejecuta su propio servidor MCP en el mismo sitio. Actualiza a SEOPress 10.4 o superior. Las versiones anteriores también respondían a las peticiones de descubrimiento OAuth destinadas al otro servidor, por lo que sus clientes recibían los documentos de descubrimiento de SEOPress en lugar de los suyos. Ahora SEOPress solo responde a las direcciones de descubrimiento de su propio servidor y deja las demás al plugin al que pertenecen.

Para desarrolladores

El servidor implementa el transporte MCP Streamable HTTP en una única ruta REST (POST /wp-json/seopress/mcp/v1) y es compatible con las revisiones 2025-06-18, 2025-03-26 y 2024-11-05 del protocolo. Solo expone herramientas (ni recursos ni prompts).

Cada herramienta es una ability de WordPress registrada con wp_register_ability() en el espacio de nombres seopress. Los siguientes filtros permiten ajustar el comportamiento:

Filtro Función
seopress_abilities_api_rest_enabled Forzar la activación o desactivación de la exposición, diga lo que diga el ajuste.
seopress_mcp_read_only Forzar todas las conexiones a solo lectura.
seopress_mcp_disabled_abilities Desactivar abilities por su nombre.
seopress_mcp_served_abilities Última palabra sobre la lista de abilities servidas a los clientes.
seopress_mcp_exposed_namespaces Añadir espacios de nombres de abilities que servir además de seopress.
seopress_mcp_foreign_namespaces_enabled Servir, o no, las abilities de todos los demás plugins.
seopress_mcp_allowed_origins Orígenes autorizados a llegar al endpoint desde un navegador.
seopress_mcp_oauth_enabled Desactivar el servidor OAuth.
seopress_mcp_oauth_transport_is_secure Indicar al servidor OAuth que el sitio se sirve de forma segura, por ejemplo detrás de un proxy que termina el TLS.
seopress_remove_feature_mcp Devuelve false para ocultar la tarjeta Servidor MCP del escritorio de SEO. Desde 10.4.

Ejemplo: poner todas las conexiones MCP en solo lectura en un sitio en producción.

add_filter( 'seopress_mcp_read_only', '__return_true' );

Ejemplo: servir las abilities de tu propio plugin junto a las de SEOPress.

add_filter( 'seopress_mcp_exposed_namespaces', function ( $namespaces ) {
	$namespaces[] = 'my-plugin';

	return $namespaces;
} );

FAQ

¿El servidor MCP está disponible en SEOPress Free?

Sí. El servidor y 21 herramientas vienen incluidos en SEOPress Free. SEOPress PRO añade 15 herramientas (redirecciones, datos estructurados, palabras clave objetivo, generación con IA para entradas, términos e imágenes, subida de imágenes, auditoría técnica).

¿SEOPress envía mi contenido a un proveedor de IA?

No. SEOPress se limita a responder a las peticiones del cliente de IA que has conectado. Lo que tu cliente haga con las respuestas depende de ese cliente y de su proveedor.

¿Necesito una clave de API de OpenAI o Anthropic?

No. Utilizas tu propio plan de ChatGPT, Claude o Cursor. Solo las cinco herramientas generate-* de SEOPress PRO dependen del proveedor de IA configurado en SEOPress PRO. Ten en cuenta que una suscripción a ChatGPT o a Claude no incluye créditos de API.

¿Pueden varios usuarios conectar su propio cliente?

Sí. Cada conexión está vinculada a la cuenta de WordPress que la aprobó y limitada a los permisos de esa cuenta.

¿Funciona en una red multisitio?

Cada sitio de la red tiene su propia URL de servidor MCP y su propio ajuste.

¿Cómo lo desactivo todo?

Desactiva Exponer capacidades a agentes de IA y herramientas externas y guarda. El endpoint y el servidor OAuth dejan de responder de inmediato.