Menú de la documentaciónConecta Claude o Cursor a tu sitio

Conecta Claude o Cursor a tu sitio

Paso a paso, conecta Claude Code, Claude Desktop o Cursor al servidor MCP de Vireo, haz tus primeras preguntas sobre tu tráfico y resuelve los problemas de conexión.

En esta página

Vireo ejecuta un servidor MCP en tu sitio WordPress. Cuando un asistente de IA está conectado a él, puedes preguntar por tu tráfico en lenguaje normal, y el asistente responde con tus propias cifras llamando a las herramientas de Vireo. Todas las herramientas son de solo lectura: el asistente puede mirar, nunca cambiar nada.

Necesitarás unos diez minutos, un acceso de administrador y el asistente que quieras usar.

1. Elige el usuario con el que inicia sesión el asistente

El asistente inicia sesión como un usuario de WordPress y ve exactamente lo que ese usuario puede ver en el panel de Vireo. Solo se pueden conectar los usuarios que pueden abrir el panel: los administradores, más cualquier rol que hayas marcado en Ajustes, General, «Perfiles con acceso». Consulta Quién puede ver los números.

Si no quieres que el asistente use una cuenta de administrador, crea un usuario con un rol que tenga acceso al panel y nada más, y conéctate con él.

2. Crea una contraseña de aplicación

  1. En WordPress, ve a Usuarios, Perfil (o edita el usuario del paso 1).
  2. Baja hasta Contraseñas de aplicación. Escribe un nombre con el del asistente, como «Claude Desktop», y haz clic en «Añadir nueva contraseña de aplicación».
  3. Copia la contraseña que muestra WordPress. Solo se muestra una vez. Los espacios pueden quedarse.

Los ajustes de Vireo enlazan directamente a este punto: Vireo Analytics, Ajustes, Search Console y API, «Conectar un asistente de IA», «Crea una en tu perfil».

Para cortar el acceso de un asistente más adelante, revoca su contraseña en el mismo sitio.

3. Copia tu endpoint y la configuración

Ve a Vireo Analytics, Ajustes, abre la pestaña Search Console y API y busca «Conectar un asistente de IA». Muestra:

  • tu «Endpoint MCP», que es la dirección de tu sitio seguida de /wp-json/vireo-analytics/mcp
  • un comando listo para Claude Code
  • una configuración lista para Claude Desktop, Cursor y otros

Tu nombre de usuario ya está rellenado. Cada uno tiene un botón Copiar. Pega tu contraseña de aplicación donde el fragmento dice APP_PASSWORD.

4. Añádelo a Claude Code

Ejecuta en un terminal el comando de la pantalla de ajustes. Tiene este aspecto:

claude mcp add --transport http vireo-analytics https://example.com/wp-json/vireo-analytics/mcp --header "Authorization: Basic $(printf 'your-username:APP_PASSWORD' | base64)"

Ejecuta claude mcp list para comprobar que está conectado, abre Claude Code y empieza a preguntar.

O añádelo a Claude Desktop

Claude Desktop se conecta a través de @automattic/mcp-wordpress-remote, un proxy pequeño que se ejecuta en tu ordenador y habla con tu sitio por HTTPS. Necesita tener instalado Node.js.

  1. Abre los ajustes de Claude Desktop, Developer, y haz clic en Edit Config.
  2. Pega la configuración de la pantalla de ajustes en claude_desktop_config.json. Si el archivo ya tiene una sección mcpServers, añade dentro de ella la entrada vireo-analytics.
{
  "mcpServers": {
    "vireo-analytics": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wordpress-remote@latest"],
      "env": {
        "WP_API_URL": "https://example.com/wp-json/vireo-analytics/mcp",
        "WP_API_USERNAME": "your-username",
        "WP_API_PASSWORD": "APP_PASSWORD"
      }
    }
  }
}
  1. Cierra y vuelve a abrir Claude Desktop. Las herramientas de Vireo aparecen en el menú de herramientas de un chat nuevo.

O añádelo a Cursor

Añade la misma entrada mcpServers a ~/.cursor/mcp.json para todos los proyectos, o a .cursor/mcp.json en uno solo. Abre los ajustes de Cursor, MCP, para comprobar que el servidor aparece como conectado.

5. Haz tu primera pregunta

Empieza por algo general:

¿Cómo va el sitio este mes comparado con el mes pasado?

El asistente debería llamar a vireo-analytics-get-changes y responder con el cambio en páginas vistas, las páginas y fuentes que lo explican y cualquier aviso, como que el seguimiento se ha detenido.

Preguntas para probar

Pregunta Herramientas que probablemente llamará
¿Qué entradas tuvieron más vistas la semana pasada? get-top-pages
¿De dónde vinieron los visitantes este mes? get-traffic-sources, y luego get-top-referrers
¿Qué nos envió Hacker News y a qué entradas? get-referrer-detail
¿Qué buscó la gente en Google para encontrar mi página de precios? get-search-console
¿Cuánto se llevan los rastreadores de IA en comparación con los lectores que envían los asistentes de IA? get-ai-referrals, get-bot-stats
¿Tengo enlaces rotos? get-404s
¿Por qué se disparó el tráfico el día 3? get-daily-stats, get-annotations, get-changes
¿Cuáles de mis páginas van lentas para los visitantes reales? get-vitals
Escríbeme un resumen de mi año. get-year-review

Los nombres de las herramientas en el servidor empiezan por vireo-analytics-, por ejemplo vireo-analytics-get-top-pages. La lista completa está en la referencia de la API.

Las preguntas sobre Search Console necesitan Search Console conectado. Si no lo está, la herramienta lo indica y el asistente debería decírtelo.

Qué añade Vireo Pro

Con una licencia de Vireo Pro activa, el mismo servidor ofrece también las herramientas de Pro, así que puedes preguntar:

Pregunta Herramientas
¿Qué fuentes generaron ingresos el mes pasado? get-revenue-by-source
¿Qué entradas del blog llevan a ventas? get-revenue-by-landing-page
¿Cuánta gente hay ahora mismo en el sitio? get-realtime
¿Trajo tráfico la campaña del boletín de octubre? get-campaigns
¿Dónde abandona la gente mi embudo de compra? get-funnels, get-store-funnel
¿Qué páginas lee la gente de verdad hasta el final? get-engagement

Las herramientas de tienda aparecen cuando WooCommerce, Easy Digital Downloads, FluentCart o Freemius está activo.

Si los sitios de tus clientes informan a esta instalación como sitios conectados, la misma conexión puede responder sobre todos ellos: consulta Pregunta a un solo asistente de IA por todos los sitios de tus clientes. En un sitio gratuito, el servidor le indica al asistente qué preguntas responde Pro.

Con Vireo Pro también puedes saltarte la configuración y preguntar dentro de WordPress: Ask Vireo usa las mismas herramientas a través del proveedor de IA que configures en Ajustes, Conectores. Si los sitios de tus clientes son hijos de MainWP, conecta el asistente al panel de MainWP: consulta Con un panel de MainWP. Pregunta a Claude por tu analítica de WordPress muestra las preguntas con las que empezar, y preguntar desde wp-admin muestra lo mismo con Ask Vireo.

Si recibes un error 401

WordPress no ha aceptado el inicio de sesión. Comprueba que:

  • el nombre de usuario es el de inicio de sesión, no el correo ni el nombre público
  • la contraseña de aplicación está pegada completa y no se ha revocado
  • en Claude Code, la parte de printf es username:password entre comillas simples, sin espacios de más alrededor de los dos puntos

Si recibes un error 403

WordPress sabe quién eres, pero ese usuario no puede ver las cifras de Vireo. Conéctate como administrador, o da acceso al rol del usuario en Ajustes, General, «Perfiles con acceso».

Si faltan las contraseñas de aplicación en el perfil

WordPress solo ofrece contraseñas de aplicación en sitios servidos por HTTPS, salvo que el sitio esté marcado como entorno de desarrollo local. Algunos plugins de seguridad y algunos hostings también desactivan las contraseñas de aplicación o bloquean la API REST para las peticiones sin sesión. Permite las contraseñas de aplicación, y permite las peticiones a /wp-json/vireo-analytics/, para el usuario con el que te conectas.

Si la dirección empieza por http://

Usa el endpoint exacto de la pantalla de ajustes, con https://. Si escribes http:// y tu sitio redirige a HTTPS, algunos clientes pierden el inicio de sesión en la redirección y reciben un 401.

Si no aparecen las herramientas

  • Claude Desktop y Cursor necesitan Node.js, porque el proxy se ejecuta con npx. Instálalo y reinicia la aplicación.
  • Reinicia el asistente después de editar su configuración.
  • Si la pantalla de ajustes dice «El adaptador MCP incluido falta en esta instalación», vuelve a instalar Vireo desde su paquete de la versión.

Si ha dejado de funcionar la conexión MCP de otro plugin

Rank Math, y WooCommerce con su función MCP activada, sirven sus propias herramientas a través del endpoint compartido del MCP Adapter en /wp-json/mcp/mcp-adapter-default-server. Actualiza Vireo Analytics a la 0.12.5 o posterior, que le deja ese endpoint compartido a cualquier otro plugin que use el adaptador. El endpoint propio de Vireo está en /wp-json/vireo-analytics/mcp.

Si las cifras parecen incorrectas

El asistente ve las mismas cifras que tu panel. Si una respuesta no te cuadra, abre el mismo rango en el Resumen. Las fechas usan por defecto los últimos 30 días, en la zona horaria de tu sitio.