Documentation

Resolución de problemas — Search Console

Soluciones a los problemas más comunes. Si tu problema no aparece listado, envíanos un mensaje vía el formulario de contacto.

«Tool result could not be submitted. The request may have expired.»

Causa: la consulta superó el timeout PHP del servidor (ej.: get_campaign_performance a 90 días en una cuenta grande).

Solución:

• Reduce el rango de fechas: pide last_7_days en lugar de last_90_days
• Filtra por campaña: añade campaign_id al prompt
• Refresca la página de Claude y reintenta

«No accessible Search Console accounts for this token»

Causa: no autorizaste ninguna cuenta para esta sesión OAuth, o la cuenta fue desconectada del lado de gadspilot.

Solución: vuelve a conectarte desde Claude (Settings → Connectors → Disconnect → Re-add) y selecciona las cuentas durante la pantalla de consentimiento de gadspilot.

«Session expired» y luego reconexión automática

Comportamiento normal: access token de 30 días, tras la expiración Claude lanza el OAuth automáticamente. Ves «session expired» durante 1-2 segundos, luego se reanuda.

El favicon de gadspilot no aparece en Claude

Causa: Claude.ai cachea la ausencia de favicon en el momento en que añades el conector.

Solución: Settings → Connectors → ⋯ → Remove (no solo «Disconnect»), luego vuelve a añadirlo. Hard-refresh Claude (Ctrl+Shift+R) si es necesario.

Página Insights vacía o 0 resultados

Causas posibles:

• GSC tiene un retraso oficial de 2-3 días en los datos. Para la última semana, elige «Últimos 30 días» en lugar de «Últimos 7 días»
• Token OAuth expirado (vuelve a la página de conexión)
• Caché obsoleto: haz clic en «Refresh» en la esquina superior derecha para saltar el caché de 1h

«Pause campaign» se ejecuta en dry-run aunque diga «execute it»

Causa: dry_run_default está activado en tu cuenta (seguridad por defecto).

Solución:

• En el prompt, sé explícito: «Pause campaign X with dry_run=false»
• O desactiva el valor por defecto: tarjeta de la cuenta → Settings → desmarca «Dry-run by default» → Save

«Property not found» en una propiedad GSC añadida recientemente

Causa: una nueva propiedad GSC tarda hasta 24h en aparecer en la API.

Solución: espera 24h, luego vuelve a conectar gadspilot para que recargue la lista.

¿Cómo veo el historial de mis llamadas MCP?

Todas las llamadas write (reales y dry-run) se loggean en /logs. Puedes filtrar por nombre de tool, cuenta o periodo.

Nada funciona, tengo otro error

→ Contáctanos vía el formulario in-app con el error exacto. Respondemos en menos de 24h.