# Claude-GSC Connector Guide

## Portada
GUÍA NEO · GROWTH & SEO
Conecta Claude con Google Search Console
Guía práctica para usar el conector remoto MCP de NEO y consultar datos SEO reales desde Claude/Cowork.
El equipo de Growth, SEO y consultoría puede revisar performance, analizar queries, detectar oportunidades y generar primeros borradores de reportes.
Menos exportaciones manuales. Más análisis con datos reales.
| Paso | Icono |
| --- | --- |
| Consultor NEO | :icon-user: |
| Claude Desktop · Developer | :icon-monitor: |
| MCP cowork-gsc local | :icon-server: |
| Token local autorizado | :icon-key-round: |
| Google Search Console | :icon-search: |

## Qué es
01 · CONCEPTO
¿Qué es este conector?
El MCP de Google Search Console es un conector remoto desarrollado por NEO que permite que Claude consulte datos reales de Search Console a través de un servidor desplegado en Cloud Run.
El consultor no instala nada en su computadora ni conecta manualmente su cuenta. El acceso a los datos se realiza mediante una cuenta central autorizada de NEO.
| Icono | Punto |
| --- | --- |
| :icon-database: | Claude consulta datos reales de Search Console. |
| :icon-cloud: | La conexión vive en Cloud Run, no en tu computadora. |
| :icon-key-round: | La fuente de datos es analytics@neo.com.pe. |
| :icon-id-card: | Te identificas con tu correo NEO al conectar. |
| :icon-eye: | El conector es de solo lectura para análisis SEO. |
| :icon-gauge: | Reduce fricción operativa y acelera diagnósticos. |
En simple
El conector permite que Claude use datos de Search Console para ayudarte a analizar performance, queries, páginas y oportunidades SEO.

## Valor
03 · VALOR
Qué valor aporta al equipo
Este MCP no reemplaza el criterio del consultor. Reduce fricción operativa para que el equipo dedique más tiempo a diagnóstico, interpretación y recomendaciones.
Antes
Después
| Antes | Después |
| --- | --- |
| Exportar CSVs manualmente | Consultar datos desde Claude |
| Limpiar archivos | Obtener resúmenes iniciales |
| Repetir consultas | Reutilizar prompts |
| Copiar datos entre herramientas | Analizar en lenguaje natural |
| Empezar reportes desde cero | Generar borradores estructurados |
Menos tiempo moviendo datos. Más tiempo entendiendo qué hacer con ellos.

## Antes de empezar
04 · ANTES DE EMPEZAR
Antes de usarlo
Una checklist breve para llegar listo a tu primera consulta.
| Icono | Item |
| --- | --- |
| :icon-monitor: | Tener Claude Desktop instalado. |
| :icon-key-round: | Recibir el token local autorizado por NEO. |
| :icon-globe: | Saber qué propiedad de Search Console quieres analizar. |
| :icon-calendar-range: | Definir el periodo: 7, 28, 30 o 90 días. |
| :icon-target: | Tener claro el objetivo: resumen, queries, páginas, CTR o reporte. |
Nota importante
El token local será entregado o generado bajo supervisión del responsable técnico. No debe compartirse fuera del proceso autorizado de NEO.

## Conexión
05 · CONEXIÓN
Conexión paso a paso
En el workspace corporativo de Claude Teams la conexión se realiza desde Claude Desktop, en Settings → Developer → Edit Config. Cada equipo configura el MCP localmente hasta que un Owner habilite los custom connectors remotos.
Escenario A · Ya está configurado
Escenario B · Aún no está configurado
| Paso |
| --- |
| Abre Claude Desktop. |
| Entra a Settings → Developer. |
| Haz clic en Edit Config. |
| Verifica el servidor cowork-gsc-neo. |
| Reinicia Claude Desktop y abre un chat nuevo. |
| Ejecuta el prompt de validación. |
| Paso |
| --- |
| Instala o abre WSL si estás en Windows. |
| Ubica el proyecto cowork-gsc-mcp. |
| Genera o recibe el token local autorizado. |
| Abre claude_desktop_config.json. |
| Agrega el bloque MCP entregado por NEO. |
| Reinicia Claude Desktop. |
| Ejecuta el prompt de validación. |
Ruta del archivo · Windows
%APPDATA%\Claude\claude_desktop_config.json
Desde Claude Desktop: Settings → Developer → Edit Config
Prompt de prueba
Usa el MCP cowork-gsc-neo para listar las propiedades disponibles de Google Search Console. No muestres tokens ni credenciales.
Bloque MCP de ejemplo
{
  "mcpServers": {
    "cowork-gsc-neo": {
      "command": "wsl",
      "args": [
        "--", "bash",
        "/ruta/al/proyecto/cowork-gsc-mcp/scripts/mcp_stdio_wsl.sh"
      ],
      "env": {
        "CGSC_TOKEN": "PEGA_AQUI_TU_TOKEN_LOCAL",
        "WSLENV": "CGSC_TOKEN"
      }
    }
  }
}
Importante
Este flujo es local por Claude Desktop. No compartas tokens por chat, correo ni capturas. El endpoint remoto /mcp queda reservado para la fase futura, cuando un Owner habilite los custom connectors en el workspace.

## Primera prueba
06 · PRIMERA PRUEBA
Primera validación
Una vez conectado, haz una prueba simple antes de pedir análisis complejos.
Prompt 1 · Listar propiedades
Usa el MCP cowork-gsc-neo para listar las propiedades disponibles de Google Search Console. No muestres tokens ni credenciales.
Claude debería devolver una lista de propiedades disponibles, o indicar que no encontró propiedades.
Prompt 2 · Resumen inicial
Usa el MCP cowork-gsc-neo para analizar sc-domain:neoconsulting.ai en los últimos 28 días. Dame clicks, impresiones, CTR, posición promedio y top queries.
Claude debería devolver las métricas principales y un primer listado de queries.
Resultado esperado
Si algo falla
Si Claude no lista propiedades, revisa que Claude Desktop se reinició, que el bloque MCP esté bien pegado y que el token local sea válido.

## Casos de uso
07 · CASOS DE USO
Qué puedes hacer una vez conectado
| Icono | Número | Título | Descripción |
| --- | --- | --- | --- |
| :icon-list: | 01 | Ver propiedades disponibles | Saber qué sitios puede consultar el conector. |
| :icon-activity: | 02 | Revisar performance general | Consultar clicks, impresiones, CTR y posición promedio. |
| :icon-search: | 03 | Analizar queries | Detectar términos fuertes, con oportunidad o baja eficiencia. |
| :icon-file-text: | 04 | Analizar páginas | Encontrar páginas visibles con bajo CTR o baja posición. |
| :icon-trending-up: | 05 | Identificar oportunidades SEO | Priorizar títulos, snippets, contenidos y arquitectura. |
| :icon-file-pen: | 06 | Preparar borradores de reporte | Convertir datos en una estructura consultiva inicial. |

## Prompts
08 · PROMPTS
Prompts listos para usar
Selecciona un prompt, cópialo y reemplaza [SITE_URL] por la propiedad que devuelve el conector.
| Icono | Nombre | Prompt |
| --- | --- | --- |
| :icon-list: | Ver propiedades | Usa el MCP cowork-gsc-neo para listar las propiedades disponibles de Google Search Console y dime cuáles parecen tener datos recientes. No muestres tokens ni credenciales. |
| :icon-file-text: | Resumen general | Analiza la propiedad [SITE_URL] en los últimos 28 días usando Google Search Console. Dame: 1) resumen ejecutivo, 2) clicks, 3) impresiones, 4) CTR, 5) posición promedio, 6) principales hallazgos. |
| :icon-mouse-pointer-click: | Oportunidades de CTR | Analiza [SITE_URL] en los últimos 28 días. Detecta queries o páginas con muchas impresiones, bajo CTR y posición promedio razonable. Entrega: query/página, clicks, impresiones, CTR, posición, hipótesis del problema y acción recomendada. |
| :icon-search: | Principales queries | Muéstrame las principales queries de [SITE_URL] en los últimos 28 días, ordenadas por clicks. Incluye clicks, impresiones, CTR, posición promedio y una lectura rápida de oportunidad. |
| :icon-layout-list: | Principales páginas | Revisa las páginas principales de [SITE_URL]. Identifica: páginas con más impresiones, con más clicks, con mejor CTR, con oportunidad de mejora y recomendaciones priorizadas. |
| :icon-presentation: | Borrador para cliente | Con los datos de Google Search Console de [SITE_URL], genera un borrador de análisis para cliente con: resumen ejecutivo, principales hallazgos, oportunidades, riesgos, acciones recomendadas y próximos pasos. Usa tono consultivo y no inventes datos que no aparezcan en Search Console. |
| :icon-git-compare: | Comparativo de periodos | Compara el desempeño de [SITE_URL] entre los últimos 28 días y el periodo anterior. Identifica variaciones relevantes en clicks, impresiones, CTR, posición promedio, queries y páginas principales. Entrega una lectura ejecutiva y acciones recomendadas. |
Copiar prompt
Copiado

## Interpretar datos
09 · INTERPRETAR DATOS
Cómo leer los datos
Métricas principales
| Icono | Métrica | Qué significa |
| --- | --- | --- |
| :icon-mouse-pointer-click: | Clicks | Veces que una persona hizo clic en Google hacia el sitio. |
| :icon-eye: | Impressions | Veces que una página o query apareció en resultados. |
| :icon-percent: | CTR | Relación entre clicks e impresiones: ¿el resultado atrae clics? |
| :icon-arrow-up-narrow-wide: | Position | Posición promedio. Mientras más cerca de 1, mejor. |
Señales comunes
| Señal | Posible lectura |
| --- | --- |
| Muchas impresiones + bajo CTR | Hay visibilidad, pero el resultado no atrae suficientes clics. |
| Buena posición + bajo CTR | Oportunidad de mejorar title y meta description. |
| Muchas impresiones + posición media | Potencial de optimización SEO. |
| Muchos clicks + buen CTR | Tema o página fuerte. |
| Impresiones sin clicks | El contenido aparece, pero no captura interés. |
Claude acelera el análisis, pero el criterio final sigue siendo del consultor.

## Errores frecuentes
10 · ERRORES FRECUENTES
Errores frecuentes y solución
Situación
Qué significa
Qué hacer
| Icono | Situación | Qué significa | Qué hacer |
| --- | --- | --- | --- |
| :icon-plug-zap: | No aparece el servidor MCP | El bloque no quedó en claude_desktop_config.json | Revisar el JSON en Settings → Developer |
| :icon-refresh-cw: | Cambios no se aplican | Claude Desktop no se reinició | Cerrar por completo y volver a abrir |
| :icon-database: | No aparecen propiedades | El MCP no pudo consultar GSC | Validar token local y logs del servidor |
| :icon-globe: | Propiedad no encontrada | El site_url no coincide | Usar exactamente el valor listado por Claude |
| :icon-clock: | Token inválido | El token local expiró o es incorrecto | Solicitar un nuevo token al responsable técnico |
| :icon-terminal: | Error de WSL | La ruta o la distro no son correctas | Verificar la ruta del script y la distro en el JSON |
| :icon-message-square: | Respuesta genérica | El prompt fue poco específico | Indicar propiedad, periodo y objetivo |
| :icon-lock: | Error de permisos | Acceso no habilitado o propiedad restringida | Escalar al responsable técnico de NEO |

## Seguridad
11 · SEGURIDAD
Seguridad, permisos y datos
Qué sí puede hacer
| Item |
| --- |
| Leer propiedades disponibles. |
| Consultar métricas de Search Console. |
| Analizar queries, páginas y periodos. |
| Generar resúmenes y borradores. |
| Ayudar a estructurar oportunidades SEO. |
Qué no debe hacer
| Item |
| --- |
| Modificar propiedades o configuraciones. |
| Exponer tokens. |
| Compartir credenciales. |
| Usar datos fuera del alcance autorizado. |
| Enviar reportes a cliente sin revisión humana. |
Mensaje importante
La cuenta analytics@neo.com.pe es la fuente de datos. Tu correo NEO identifica quién está usando el conector.
Nota técnica
Hoy la conexión es local, vía Claude Desktop (Settings → Developer). El token vive en tu equipo y no debe compartirse. El endpoint remoto /mcp queda para la fase futura, habilitada por un Owner.