GSC Search Insights

npx add-mcp 'https://api.gscmcpserver.com/mcp'

Antes de comenzar

Necesitas tres cosas: acceso a al menos una propiedad verificada en Google Search Console o Bing Webmaster Tools, una aplicación de IA que admita servidores MCP remotos, y una cuenta de GSC MCP Server para actuar como intermediario entre ambos.

• Acceso a Search Console. Cualquier nivel de permiso sirve para leer datos. Si puedes abrir el informe de Rendimiento de una propiedad, el servidor puede leerla en tu nombre.
• Un cliente compatible con MCP. Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex, Gemini CLI, Windsurf y Cline son compatibles. Los espacios de trabajo de negocios y empresas a veces necesitan que un administrador permita conectores personalizados.
• Tu endpoint de servidor. Después de iniciar sesión, la página Configuración del cliente en tu panel muestra tu URL de MCP y la configuración exacta para cada cliente.

¿Nuevo en el concepto? Lee primero qué es un servidor MCP de Search Console. Explica las partes involucradas en lenguaje sencillo.

Paso 1: Conecta Google y Bing

1. Inicia sesión con Google o GitHub.
2. Abre Fuentes de datos y elige Conectar Google o Conectar Bing.
3. Aprueba la pantalla de consentimiento de solo lectura. Serás devuelto al panel con tus propiedades listadas.
4. Ponle a la conexión una etiqueta que reconozcas en la conversación, como "Cliente – Acme" o "Blog personal". Las etiquetas facilitan indicarle al asistente qué sitio quieres decir.

Puedes probar la conexión inmediatamente en el Playground del panel, que ejecuta las mismas herramientas que usará tu asistente, antes de configurar cualquier cliente.

Claude (web y escritorio)

Claude admite servidores MCP remotos como conectores personalizados, e inicia sesión mediante OAuth, por lo que no necesitas pegar ninguna clave.

1. En Claude, abre Personalizar → Conectores, selecciona + y luego Agregar conector personalizado.
2. Nómbralo gscmcpserver y pega tu URL de MCP desde el panel.
3. Completa la solicitud de inicio de sesión y elige Permitir para acceso de lectura.
4. En un nuevo chat, habilita el conector desde el menú de herramientas y haz tu primera pregunta.

[!note] Nota Por qué localhost falla en Claude Claude se conecta a servidores MCP desde la nube de Anthropic, incluso en la aplicación de escritorio. Un servidor que se ejecuta en tu propia máquina es inalcanzable, así que usa el endpoint alojado o una implementación HTTPS pública.

ChatGPT

ChatGPT se conecta a servidores MCP remotos como complementos personalizados (también llamados conectores), usando OAuth con registro dinámico de clientes.

1. Abre Personalizar → Complementos → Agregar y elige crear un complemento personalizado. Si la opción no aparece, tu administrador de espacio de trabajo puede necesitar habilitarla.
2. Ingresa gscmcpserver como nombre, pega tu URL HTTPS pública de MCP y selecciona OAuth. Deja la detección activada; el alcance de solo lectura es search:read.
3. Inicia sesión en tu cuenta de GSC MCP Server y elige Permitir acceso de lectura.
4. Agrega el complemento a una conversación y pregunta sobre tu rendimiento de búsqueda.

Puedes revocar el acceso de ChatGPT en cualquier momento desde Clientes de IA conectados en la página de configuración, sin afectar a otros asistentes.

Cursor

Cursor lee servidores MCP desde un archivo JSON. Usa .cursor/mcp.json para un proyecto o ~/.cursor/mcp.json para todos los proyectos.

1. Crea una clave de API en la página de configuración del panel. Trátala como una contraseña y nunca la subas a un repositorio.
2. Agrega una entrada gscmcpserver al objeto mcpServers con tu endpoint como url y la clave como un encabezado Authorization: Bearer. La página de configuración genera este fragmento por ti.
3. Abre la configuración de MCP de Cursor, verifica que el servidor esté en verde y habilita sus herramientas para el agente.

Los desarrolladores obtienen el máximo provecho de Cursor cuando los datos de búsqueda están junto al código que produce las páginas. Nuestra guía de SEO técnico en Cursor y VS Code cubre ese flujo de trabajo.

VS Code con GitHub Copilot

1. Abre la Paleta de comandos y ejecuta MCP: Agregar servidor.
2. Elige HTTP, pega tu endpoint y nómbralo gscmcpserver.
3. Guárdalo en tu configuración de usuario o en el .mcp.json del espacio de trabajo.
4. Agrega tu clave de API como un encabezado Authorization: Bearer, ejecuta MCP: Listar servidores para iniciarlo y habilita las herramientas en el selector de herramientas de Copilot Chat.

Claude Code, Codex y Gemini CLI

Los agentes de terminal registran servidores remotos con un solo comando. Tu panel genera el comando exacto con tu endpoint ya completado. La forma es:

• Claude Code: claude mcp add --transport http --scope user gscmcpserver <url>, luego ejecuta /mcp para verificar.
• Codex: codex mcp add gscmcpserver --url <url>, luego codex mcp list.
• Gemini CLI: gemini mcp add --transport http --scope user gscmcpserver <url>, luego /mcp.

Cada uno necesita tu clave de API configurada como un encabezado de portador en su configuración de MCP. Windsurf y Cline siguen el mismo patrón a través de sus paneles de configuración de MCP.

Tus primeros cinco mensajes

Ejecútalos en orden. Confirman que la conexión funciona y te dan una instantánea útil del sitio en pocos minutos.

Prueba este mensaje

Enumera mis propiedades de búsqueda conectadas y dime a qué cuenta pertenece cada una.

Prueba este mensaje

Dame un resumen de búsqueda de los últimos 28 días: clics, impresiones, CTR y posición promedio, más el cambio respecto a los 28 días anteriores.

Prueba este mensaje

¿Cuáles son mis 20 consultas principales y mis 20 páginas de destino principales por clics este mes? Señala cualquier cosa que haya caído más del 20%.

Prueba este mensaje

Encuentra oportunidades de distancia de alcance: consultas en las posiciones 8–20 con impresiones significativas. ¿Qué tres páginas debería mejorar primero?

Prueba este mensaje

Revisa mis sitemaps en Google y Bing. ¿Hay errores y cuántas URL enviadas están indexadas?

El mensaje cuatro es el comienzo de un flujo de trabajo más amplio. Nuestra guía de palabras clave de distancia de alcance lo convierte en un proceso repetible.

Solución de problemas

Síntoma	Causa probable	Solución
"No se pudo alcanzar el servidor" en Claude o ChatGPT	URL de localhost o HTTP sin cifrar	Usa el endpoint HTTPS público del panel
401 No autorizado en un editor	Encabezado de portador faltante o mal escrito	Vuelve a copiar la clave de API; el encabezado debe decir Authorization: Bearer <key>
Las herramientas cargan pero no devuelven propiedades	No hay cuenta de Google o Bing conectada, o está deshabilitada	Conéctala o vuelve a habilitarla en Fuentes de datos
Falta una propiedad	La cuenta de Google con la que iniciaste sesión no tiene acceso a ella	Agrega esa cuenta como usuario en Search Console y luego vuelve a conectar
"Límite de uso alcanzado"	Se agotó la asignación mensual de llamadas a herramientas	Espera al reinicio o mejora tu plan en la sección de precios
Falta la opción de conector personalizado	Política del espacio de trabajo	Pide a tu administrador de espacio de trabajo que la permita

¿Diriges una agencia? Una vez que la conexión funcione, el flujo de trabajo de informes para clientes de IA muestra cómo usar varias cuentas de clientes en una sola conversación.

Preguntas frecuentes

¿Puedo conectar Google Search Console a ChatGPT gratis?

Sí. El plan gratuito de GSC MCP Server conecta una cuenta de Google o Bing e incluye 30 llamadas a herramientas al mes. Tu plan de ChatGPT y la configuración de tu espacio de trabajo determinan si los conectores personalizados están disponibles para ti.

¿Por qué ChatGPT o Claude rechazan mi URL de localhost?

Claude y ChatGPT se conectan desde su propia nube, por lo que no pueden alcanzar un servidor que se ejecuta en tu computadora portátil. Usa el endpoint alojado, implementa tu servidor autoalojado en una dirección HTTPS pública o usa un túnel.

¿Necesito una clave de API?

Claude y ChatGPT inician sesión mediante OAuth, por lo que no se necesita clave. Los editores de código y agentes de terminal como Cursor, VS Code, Claude Code y Codex suelen usar una clave de API enviada como encabezado Authorization: Bearer, que creas en la página de configuración de tu panel.

¿Puedo conectar varias cuentas de Search Console?

Sí. Cada cuenta de Google o Bing que conectes cuenta como una conexión, y cada propiedad verificada dentro de ella queda disponible. El plan Pro admite 5 cuentas y el plan Agency admite 20.

¿Se usan mis datos para entrenar modelos de IA?

GSC MCP Server no entrena modelos con tus datos. Si tu proveedor de IA usa el contenido de las conversaciones para entrenamiento depende de la configuración de ese proveedor y de tu plan, así que revisa sus controles de datos.