Conectar GSC mediante MCP

¿Cómo puedo conectar los datos de Google Search Console mediante un MCP?

Apunta cualquier asistente compatible con MCP a https://mcp.gscwizard.com/mcp, autentícate con un inicio de sesión o una clave de API y leerá tus datos reales de Search Console. Los análisis se ejecutan en el servidor, así que el asistente recibe respuestas terminadas en lugar de filas en bruto.

Funciona con ChatGPT, Claude, Grok, Gemini CLI, Cursor, VS Code, Windsurf y cualquier otro cliente MCP.

La respuesta corta

Tres cosas te dejan conectado, sea cual sea el cliente:

  1. Conecta Search Console una vez dentro de GSC Wizard. La autorización vive ahí, no en el asistente.
  2. Añade el endpoint https://mcp.gscwizard.com/mcp a tu cliente.
  3. Autentícate: inicia sesión con OAuth 2.1 donde el cliente lo admita, o envía Authorization: Bearer gscw_live_...

El servidor habla HTTP en streaming, así que la mayoría de los clientes no necesitan instalación local, ni proceso de Node, ni puente stdio.

Endpoint HTTP en streaming

https://mcp.gscwizard.com/mcp

Inicio de sesión con OAuth 2.1

Para ChatGPT, la interfaz de conectores de Claude, los conectores de Grok y Gemini CLI. El cliente se registra por sí mismo y te guía por un inicio de sesión de Google. Nada que copiar ni guardar.

Cabecera con clave de API

Para clientes con archivo de configuración como Claude Code, Cursor, VS Code y Windsurf, y para Meta Muse: envía Authorization: Bearer gscw_live_...

Vídeo

Mira la configuración de principio a fin

La configuración y una primera pregunta, de principio a fin: el conector añadido, el inicio de sesión hecho y un análisis terminado como respuesta en lugar de filas en bruto.

Configuración

Tres pasos para conectar

Los mismos tres pasos valen para todos los clientes. Solo cambia la sintaxis de la configuración.

  1. 1

    Conecta tus propiedades

    Inicia sesión en tool.gscwizard.com con Google y elige las propiedades de Search Console que quieras tener disponibles. Es el único sitio donde se concede la autorización.

  2. 2

    Crea una clave de API, o prepárate para iniciar sesión

    Crea una clave en Cuenta → Claves de API para los clientes con archivo de configuración. Los clientes que admiten OAuth remoto (ChatGPT, la interfaz de conectores de Claude, los conectores de Grok, Gemini CLI) solo necesitan la URL.

  3. 3

    Añade el servidor a tu cliente

    Apunta el cliente a https://mcp.gscwizard.com/mcp. Los nombres de las claves cambian de un cliente a otro, pero la URL y la cabecera bearer nunca cambian.

Copiar y pegar

Configuración para cada cliente

Sustituye gscw_live_... por la clave que creaste en Cuenta → Claves de API.

Claude Code

Un comando, cabecera con clave de API.

claude mcp add --transport http gsc-wizard \
  https://mcp.gscwizard.com/mcp \
  --header "Authorization: Bearer gscw_live_..."

Claude web y de escritorio

Ajustes → Conectores → Añadir conector personalizado. Pega la URL y deja en blanco el ID de cliente y el secreto de OAuth: Claude se registra por sí mismo y te inicia sesión.

https://mcp.gscwizard.com/mcp

ChatGPT

Ajustes → Apps, modo desarrollador, añade una app con la autenticación en OAuth. Requiere un plan de pago. No hay campo para la clave de API: ChatGPT no puede enviar bearer tokens estáticos. O sáltate todo esto e instala la app de GSC Wizard desde la App Store de ChatGPT.

https://mcp.gscwizard.com/mcp

Grok

Ve a grok.com/connectors, haz clic en New Connector y elige Custom. Pega la URL y completa el inicio de sesión: Grok se registra por sí mismo mediante OAuth 2.1, así que no hay ID de cliente ni secreto que rellenar. Después Grok descubre las herramientas y las ofrece en tus conversaciones. Guía completa: conectar GSC a Grok.

https://mcp.gscwizard.com/mcp

Microsoft Copilot Studio

Añade a tu agente una herramienta Model Context Protocol con OAuth 2.0 y el tipo de configuración Manual. Crea el ID de cliente y el secreto en Cuenta → Claves de API del MCP → Microsoft Copilot Studio, donde también aparecen todas las URLs que hay que pegar, y guarda en esa conexión la URL de redirección que te da Copilot Studio. Guía completa: datos SEO en Microsoft Copilot Studio.

https://mcp.gscwizard.com/mcp

Meta Muse

Muse no tiene una pantalla de ajustes para conectores personalizados: pídele en una conversación que construya una integración personalizada con la URL de abajo, HTTP remoto con autenticación por Bearer token. Crea una clave de API de solo lectura y pégala en el cuadro seguro de credenciales de Muse, nunca en el chat. Guías completas: el conector de Muse para Search Console SEO y el conector de Muse para Google Analytics.

URL:  https://mcp.gscwizard.com/mcp
Auth: Bearer gscw_live_... (read-only key)

Gemini CLI

Añádelo a ~/.gemini/settings.json. Gemini CLI usa httpUrl para HTTP en streaming.

{
  "mcpServers": {
    "gsc-wizard": {
      "httpUrl": "https://mcp.gscwizard.com/mcp",
      "headers": { "Authorization": "Bearer gscw_live_..." }
    }
  }
}

OpenAI Codex

Añádelo a ~/.codex/config.toml (compartido por el CLI de Codex, la extensión de IDE y la app) con la clave en una variable de entorno, o ejecuta codex mcp add gsc-wizard --url https://mcp.gscwizard.com/mcp e inicia sesión con codex mcp login gsc-wizard. Guía completa: GSC MCP para Codex.

[mcp_servers.gsc-wizard]
url = "https://mcp.gscwizard.com/mcp"
bearer_token_env_var = "GSCW_API_KEY"

Cursor

Añádelo a ~/.cursor/mcp.json (global) o a .cursor/mcp.json en un proyecto.

{
  "mcpServers": {
    "gsc-wizard": {
      "url": "https://mcp.gscwizard.com/mcp",
      "headers": { "Authorization": "Bearer gscw_live_..." }
    }
  }
}

VS Code (modo agente de Copilot)

Añádelo a .vscode/mcp.json. VS Code usa servers, no mcpServers, y puede pedirte la clave para que no acabe en el control de versiones.

{
  "inputs": [
    { "id": "gscw-key", "type": "promptString", "description": "GSC Wizard MCP key", "password": true }
  ],
  "servers": {
    "gsc-wizard": {
      "type": "http",
      "url": "https://mcp.gscwizard.com/mcp",
      "headers": { "Authorization": "Bearer ${input:gscw-key}" }
    }
  }
}

Windsurf

Añádelo a ~/.codeium/windsurf/mcp_config.json. Windsurf usa serverUrl para los servidores remotos.

{
  "mcpServers": {
    "gsc-wizard": {
      "serverUrl": "https://mcp.gscwizard.com/mcp",
      "headers": { "Authorization": "Bearer gscw_live_..." }
    }
  }
}

Cualquier otro cliente MCP

Apúntalo al endpoint HTTP streamable y envía tu clave como bearer token. Los nombres de las claves varían (transport frente a type, url frente a serverUrl); la URL y la cabecera no.

URL:    https://mcp.gscwizard.com/mcp
Header: Authorization: Bearer gscw_live_...

Guías paso a paso: ChatGPT, Claude, Gemini, Grok, Meta Muse. ChatGPT tiene sus propias reglas adicionales (solo servidores remotos, OAuth en lugar de claves de API y modo desarrollador en un plan de pago), todas explicadas en Conectores de ChatGPT para datos de Search Console en 2026. Para Claude en concreto, la referencia del servidor MCP de Claude para Search Console cubre los detalles del protocolo que esta página resume.

Autenticación y scopes

Cada clave lleva un scope que eliges al crearla, así que tú decides hasta dónde puede llegar el asistente.

Solo lectura

Consulta datos y ejecuta informes. Una clave de lectura no puede invocar físicamente una herramienta de escritura, así que la conexión es de solo lectura por diseño. Es la opción adecuada para un agente compartido o un despliegue de cara al cliente.

Lectura y escritura

Todo lo que puede hacer una clave de lectura, más modificaciones: añadir sitios, enviar URLs a IndexNow, gestionar clústeres temáticos, grupos de contenido y anotaciones. Cada modificación queda registrada en el log de auditoría de tu cuenta.

Las claves se muestran una sola vez al crearlas, se pueden revocar en cualquier momento y solo llegan a las propiedades de Search Console que ya están conectadas a tu cuenta de GSC Wizard.

Por qué este MCP es diferente

El análisis se ejecuta antes de que el modelo vea los datos

La mayoría de los servidores MCP de SEO devuelven al asistente las filas en bruto. Los modelos de lenguaje no están hechos para hacer cálculos sobre tablas grandes: es lento, gasta tokens y los errores son difíciles de detectar.

Muchos menos tokens

Una sola llamada a una herramienta devuelve una respuesta compacta y terminada, en lugar de decenas de miles de filas que el modelo tiene que leer, mantener en contexto y pagar.

Mucho más rápido

Las agregaciones se ejecutan en el almacén de datos en milisegundos: un informe SEO completo sobre un conjunto de datos de 4 GB en unos 4,4 segundos, en vez de paginar la API de GSC lote a lote.

Sin riesgo de errores

Los cálculos son deterministas. Las cifras salen de consultas reales, así que no hay riesgo de que el modelo cuente mal o se invente totales.

Conjuntos de datos más grandes a tu alcance

Como el trabajo pesado nunca entra en la ventana de contexto, el servidor puede analizar meses de datos y millones de filas que nunca cabrían en un prompt.

Qué puede usar el asistente

El catálogo completo, con argumentos de ejemplo para cada herramienta, está en mcp.gscwizard.com.

Analítica de búsqueda Principales consultas y páginas Cambios de ranking Canibalización de palabras clave Detección de decaimiento de contenido Striking distance / page poaching Análisis de la curva de CTR Puntuación de oportunidades Inspección masiva de URLs Seguimiento de indexación Envíos a IndexNow Grupos de contenido y clústeres temáticos Desgloses por país y dispositivo Rendimiento de los sitemaps Informes SEO automatizados División de marca y sin marca Distribución de posiciones Comparación de migraciones Informes para clientes que se pueden compartir Google Analytics 4 Core Web Vitals (CrUX) Previsiones y detección de anomalías Bing Webmaster Tools

Si no se conecta

Las herramientas no aparecen

La mayoría de los clientes solo leen los ajustes de MCP al arrancar. Cierra la aplicación por completo (no solo la ventana) y vuelve a abrirla después de editar un archivo de configuración.

401 no autorizado

Comprueba que la cabecera es exactamente Authorization: Bearer gscw_live_..., que la clave no se ha revocado y que la cuenta sigue teniendo una suscripción o una prueba activa.

Claude Desktop dice que la configuración no es válida

Su archivo de configuración solo lanza servidores stdio locales, así que una entrada "type": "http" se rechaza. Usa la interfaz de Conectores o haz de puente con mcp-remote: consulta la guía de Claude o la referencia del MCP de Claude para Search Console para saber por qué el archivo de configuración rechaza una entrada HTTP.

Una herramienta de escritura devuelve 403

La clave es de solo lectura. Crea una clave de lectura y escritura si el asistente de verdad necesita modificar datos, o conserva la clave de lectura y haz el cambio en la app.

Falta una propiedad

El MCP solo ve las propiedades que ya están conectadas en GSC Wizard. Añádela primero en la app y luego pide al asistente que vuelva a listar los sitios. Las propiedades de dominio llevan el prefijo sc-domain:.

Los mismos datos, otros asistentes

¿Vas a conectar otra herramienta de IA?

Una conexión con Search Console, todos los asistentes. Elige tu cliente y sigue la guía paso a paso.

Consulta también la visión general del MCP de Google Search Console, el MCP de GA4, el MCP de Yandex Webmaster, el MCP de Merchant Center, la app de ChatGPT (instálala en ChatGPT), los conectores de Meta Muse para Search Console y Google Analytics, mi recopilación de los mejores servidores MCP de SEO y por qué GSC Wizard es el mejor MCP de Search Console en 2026.

Preguntas frecuentes

¿Qué es un servidor MCP?

Un servidor MCP (Model Context Protocol) es un conector estándar que permite a un asistente de IA leer datos en vivo y usar herramientas. Un MCP de Google Search Console expone tus propiedades de Search Console al asistente, de modo que pueda obtener cifras reales de clics, impresiones, posición y CTR en lugar de inventárselas.

¿Qué clientes se pueden conectar?

Cualquier cliente que admita servidores MCP remotos: ChatGPT, Claude y Claude Code, Grok, Gemini CLI, Cursor, VS Code en modo agente de Copilot, Windsurf, Gemini Enterprise y agentes personalizados creados con los SDK de OpenAI, Anthropic o Google. El endpoint habla HTTP streamable.

¿Clave de API u OAuth? ¿Cuál necesito?

Los clientes con archivo de configuración (Claude Code, Cursor, VS Code, Windsurf, Gemini CLI) envían una clave de API en una cabecera Authorization: Bearer. Los clientes con interfaz de conectores (ChatGPT, la app web y de escritorio de Claude, Grok) usan OAuth 2.1 y registro dinámico de clientes, así que solo tienes que iniciar sesión y dejar en blanco el ID y el secreto del cliente.

¿Puedo hacer que la conexión sea de solo lectura?

Sí. Cada clave de API lleva un scope que se elige al crearla. Una clave de solo lectura no puede invocar ninguna herramienta de escritura, así que la conexión es de solo lectura por diseño. Las claves de lectura y escritura añaden modificaciones como añadir sitios, enviar URLs a IndexNow y gestionar clústeres, y todas ellas quedan registradas en el log de auditoría.

¿Qué tan recientes son los datos?

Las lecturas respaldadas por el almacén de datos van unos dos días por detrás del propio Search Console, y cada respuesta indica hasta qué fecha están consolidados los datos. Las peticiones que el almacén no puede atender recurren automáticamente a la API de GSC en vivo, y cada respuesta indica de qué fuente viene.

¿Por qué no dejar que el modelo lea directamente la API de GSC?

La mayoría de los MCP de Search Console recorren la API de GSC lote a lote, lentamente, y vuelcan las filas en bruto en el contexto del modelo, lo que es lento, choca con el muestreo y los límites de filas, y deja margen para alucinaciones. GSC Wizard calcula cada análisis en SQL en el servidor y devuelve el resultado terminado: un informe SEO completo sobre un conjunto de datos de 4 GB en unos 4,4 segundos.

Una herramienta no aparece en mi cliente. ¿Qué hago?

Reinicia el cliente por completo después de editar su configuración, ya que la mayoría solo lee los ajustes de MCP al arrancar. Después comprueba que la clave sigue siendo válida y no está revocada, que has usado la ruta /mcp en la URL y que la herramienta que buscas no es una herramienta de escritura bloqueada por una clave de solo lectura.

¿Hay una opción HTTP normal?

Sí. El mismo servidor expone una superficie REST en https://mcp.gscwizard.com/v1 con las mismas claves, scopes, límites de uso y log de auditoría, con un documento OpenAPI 3,1 en /v1/openapi.json generado a partir de los mismos esquemas con los que valida el servidor.

Conecta tus datos de Search Console a cualquier cliente de IA

Un endpoint, dos formas de autenticarte y respuestas terminadas en lugar de filas en bruto. Lo configuras en unos dos minutos.

Consejos de Search Console en tu bandeja de entrada

Flujos de trabajo prácticos con GSC y GA4, novedades del producto y experimentos SEO. Sin spam, date de baja cuando quieras.