Cómo conectar XOVI a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → XOVI, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

XOVI + Cursor

Datos SEO de XOVI Suite, de solo lectura: saldo de créditos de la API, historial del índice de visibilidad (OVI), keywords posicionadas, valor de ranking e historial de keywords de cualquier dominio, y la monitorización diaria de keywords de tus proyectos.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

XOVI_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. La API de XOVI requiere una cuenta XOVI Pro, Business o Enterprise.

1. En XOVI Suite abre Account > API Dashboard y crea tu clave de API personal.
2. Pégala en XOVI_API_KEY. El conector la envía como parámetro key en cada llamada a https://suite.xovi.net/api.
3. Instala el conector y ejecuta xovi_get_credit_state, que no gasta créditos, para comprobar la clave.

Qué lee: el saldo de créditos de la API y los límites de uso de tu cuenta; el análisis semanal de cualquier dominio: el índice de visibilidad (OVI) a lo largo del tiempo, las keywords por las que posiciona un dominio o una URL con posición, volumen de búsqueda, CPC y competencia, su valor de ranking, el historial de sus rankings, el historial de una sola keyword y la página de resultados de una keyword; y la monitorización diaria de keywords de tus proyectos: proyectos con sus competidores, etiquetas, dominios monitorizados, keywords monitorizadas con su última posición, el historial diario de una keyword, el top 100 de una keyword monitorizada en un día y el OVI de monitorización de un dominio del proyecto.

Créditos: la mayoría de llamadas se pagan con el presupuesto de créditos de API de tu cuenta, por llamada o por bloque de filas (ver cada función en la referencia de XOVI); las llamadas que solo leen los datos de tu propia cuenta son gratuitas. Antes de exportaciones grandes, la IA comprueba el saldo con xovi_get_credit_state y xovi_get_limits, mantiene limit bajo y no recorre muchos dominios sin tu visto bueno. Las plazas de keywords de la monitorización se cuentan aparte: xovi_get_monitoring_keyword_limits.

Análisis semanal de dominios: la IA elige el host del buscador con xovi_list_search_engines (semanal, p. ej. google.de) y después usa xovi_get_ovi_trend para la visibilidad en el tiempo, xovi_list_ranking_keywords para las keywords de un dominio, xovi_get_ranking_value, xovi_get_ranking_trend, xovi_get_keyword_trend para una keyword y xovi_get_keyword_serp para la página de resultados de una keyword. urlpattern acepta un host (www.example.com), todos los subdominios (example.com/*) o un directorio (www.example.com/blog/*). Los datos de una semana se publican el domingo, y date es ese domingo.

Monitorización diaria: xovi_list_projects da el hash del proyecto, xovi_list_labels las etiquetas y xovi_list_search_engines con intervalo daily el sengineid numérico; después la IA usa xovi_list_monitoring_domains, xovi_list_monitoring_keywords, xovi_get_monitoring_keyword_trend, xovi_get_monitoring_serp y xovi_get_monitoring_ovi_trend.

Solo lectura: las 17 herramientas solo leen. En tus proyectos de XOVI no cambia nada, así que no hay nada que confirmar y ninguna herramienta está desactivada al instalar.

Paginación: limit es como máximo 1000 filas; skip cuenta páginas de limit filas, así que skip 1 con limit 100 devuelve las filas 101 a 200. Los resultados incluyen resultCount con el total sin filtrar.

Errores comunes: XOVI responde HTTP 200 con apiErrorCode y apiErrorMessage, y el conector los convierte en errores. param invalid en key significa una clave de API incorrecta o eliminada; no permission significa que la clave o el plan no pueden usar esa función; cost error significa que el presupuesto de créditos se ha agotado hasta la próxima recarga; param missing o param invalid en otro campo indica el campo que hay que corregir. result empty es una llamada correcta sin datos, por ejemplo un dominio sin rankings.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de XOVI.

Herramientas disponibles

Ejemplos de prompts

• "¿Cómo ha evolucionado el índice de visibilidad de example.de en google.de en los últimos 12 meses?"
• "¿Por qué keywords posiciona www.example.de/blog/ en la primera página, con volumen de búsqueda y CPC?"*
• "Compara el valor de ranking de example.de y competidor.de en la última semana."
• "¿Qué keywords monitorizadas de nuestro proyecto han perdido más de 3 posiciones desde ayer?"
• "¿Cuántos créditos de API nos quedan, y cuándo fue la última recarga?"

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Gemini
• Conectar a Meta Muse
• Conectar a Microsoft Copilot