Docs de GSC Magic

Qué es GSC Magic

GSC Magic es un servidor MCP alojado. Inicias sesión una vez, añades una URL a tu cliente de IA y el agente puede leer tus datos de búsqueda directamente, en lugar de trabajar con exportaciones CSV y capturas de pantalla.

Por el camino, el panel de app.gscmagic.com muestra los mismos datos en gráficos, guarda un historial más largo que los 16 meses de Google, envía alertas y registra todo lo que hacen tus agentes.

Inicio rápido

1. Crea tu cuenta. Abre el panel y continúa con Google, o crea una cuenta con correo electrónico y contraseña (confirmarás la dirección por correo). Usa la cuenta de Google que es propietaria de tus propiedades de Search Console.
2. Permite el acceso. El primer inicio de sesión pide a Google, una sola vez, acceso a Search Console (lectura y escritura) y a Google Analytics 4 en solo lectura. Las herramientas de escritura solo se ofrecen en Pro y Agency, y puedes desactivarlas en Settings → Write access.
3. Importa tus sitios. En la pantalla de bienvenida (Welcome), elige las propiedades que quieres añadir. GSC Magic muestra primero las de más actividad y respeta el límite de sitios de tu plan. Los sitios de Bing y las propiedades de GA4 con el mismo host se vinculan automáticamente.
4. Conecta tu cliente de IA. Sigue la sección Clientes de IA más abajo. El endpoint es https://mcp.gscmagic.com/mcp.
5. Pregunta algo. Empieza con «Lista mis sitios en GSC Magic». Después prueba un prompt de Prompts de ejemplo.

La página Connect del panel contiene las mismas instrucciones, con botones de un clic y una prueba de conexión.

Clientes de IA

El endpoint es el mismo en todas partes:

https://mcp.gscmagic.com/mcp

Los clientes compatibles con OAuth te hacen iniciar sesión a través de una página de GSC Magic. Para los que no lo son, usa un token de acceso.

Claude (claude.ai, escritorio y móvil)

1. Usa Add to Claude: abre GSC Magic en el directorio de conectores de Claude. O abre Customize → Connectors → Add custom connector, ponle el nombre GSC Magic y pega el endpoint.
2. Haz clic en Connect junto a GSC Magic, continúa con Google (o con correo electrónico) y permite el acceso.
3. En un chat nuevo, activa GSC Magic en + → Connectors y pregunta «Lista mis sitios en GSC Magic».

En los planes Team y Enterprise solo un Owner puede añadir el conector (Organization settings → Connectors → Add → Custom); después, cada miembro hace clic en Connect por su cuenta. Los conectores añadidos en la web aparecen en las aplicaciones de escritorio y móvil.

ChatGPT

1. En chatgpt.com abre Plugins, haz clic en + y elige Add custom MCP server. No hace falta el modo desarrollador (Developer mode).
2. Ponle el nombre GSC Magic, pega la URL del servidor de arriba y elige OAuth. Deja vacíos el ID y el secreto de cliente, acepta el aviso de riesgo y haz clic en Create.
3. Inicia sesión con Google (o con tu correo y tu contraseña de GSC Magic) cuando ChatGPT abra la página de GSC Magic y luego escribe @ en un chat nuevo y elige GSC Magic.

Los servidores MCP personalizados requieren un plan de pago de ChatGPT; en Business solo los propietarios y administradores del espacio de trabajo pueden añadirlos. ChatGPT no tiene un campo para una cabecera personalizada, así que no puede usar un token de acceso. Si tu cuenta todavía muestra el flujo antiguo <em>Settings → Apps → Create app</em>, usa ahí el mismo nombre, la misma URL y la misma configuración de OAuth.

Claude Code

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp

Después escribe /mcp, elige gsc-magic y selecciona Authenticate. Con un token en lugar de iniciar sesión en el navegador:

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp \
  --header "Authorization: Bearer gsm_YOUR_TOKEN"

Cursor

Añade esto a ~/.cursor/mcp.json y luego haz clic en Connect junto a gsc-magic en Settings → MCP:

{
  "mcpServers": {
    "gsc-magic": {
      "url": "https://mcp.gscmagic.com/mcp"
    }
  }
}

Las versiones antiguas de Cursor terminan el inicio de sesión en cursor://, que GSC Magic no acepta. En ellas usa un token:

{
  "mcpServers": {
    "gsc-magic": {
      "url": "https://mcp.gscmagic.com/mcp",
      "headers": {
        "Authorization": "Bearer gsm_YOUR_TOKEN"
      }
    }
  }
}

VS Code, Windsurf y otros

Funciona cualquier cliente que hable MCP remoto por Streamable HTTP. Dale el endpoint y, si no admite OAuth, esta cabecera de solicitud:

Authorization: Bearer gsm_YOUR_TOKEN

La página Connect del panel incluye fragmentos listos para VS Code, Windsurf, Hermes Agent, OpenClaw, Grok y DeepSeek.

Tokens de acceso

Un token de acceso (gsm_…) permite que un cliente se conecte sin iniciar sesión en el navegador. Es ideal para scripts, herramientas de automatización y clientes sin OAuth.

• Crea uno en el panel, en Connect → Access tokens (propietario o administrador del espacio de trabajo). El token completo se muestra una sola vez. Guárdalo en la propia configuración del cliente, nunca en un chat.
• Los tokens caducan a los 365 días por defecto. Puedes elegir otra duración de hasta 730 días, o ninguna.
• Marca Read-only para que un token no pueda escribir, sea cual sea lo que permita tu plan.
• Un token funciona solo en el endpoint MCP, no en la API del panel, y se puede revocar en cualquier momento. La revocación surte efecto de inmediato.
• El botón Test connection de la página Connect comprueba que un endpoint y un token funcionan.

Fuentes de datos

Conectado no es vinculado. El acceso a GA4 o una clave de Bing solo hace que las propiedades se puedan descubrir. Para ver datos en la página Overview, vincula una propiedad de GA4 y un sitio de Bing a cada sitio en Sites. Sources muestra cuántos sitios están vinculados.

Cada fuente tiene Reconnect y Disconnect. Al desconectar GA4, GSC Magic deja de leerlo y elimina las filas de GA4 que habíamos almacenado; tu conexión con Google y Search Console no cambian.

Panel

Historial. Cuando añades un sitio, GSC Magic recupera hasta 16 meses de datos diarios (14 días en Free) y después los actualiza cada seis horas. Al subir de plan se incorporan los meses más antiguos. Puedes exportar o eliminar tu historial almacenado en cualquier momento.

Alertas y resumen

En Pro y Agency, GSC Magic revisa tus sitios tras cada sincronización y te escribe cuando algo requiere atención. El envío se hace por correo electrónico al propietario del espacio de trabajo. Cada mensaje incluye un enlace para darte de baja.

• Caída de tráfico: una página perdió una gran parte de sus clics (30 % por defecto).
• Indexación: una página que tenía tráfico dejó de aparecer.
• Canibalización: dos de tus páginas empezaron a repartirse una consulta.
• Posicionamiento: una consulta importante bajó varias posiciones.
• Tráfico de IA: las sesiones de asistentes de IA se dispararon (requiere GA4).

Puedes editar los umbrales, desactivar reglas y eliminarlas (con la opción de deshacer durante unos segundos). Un resumen semanal sintetiza tus sitios. En Free, la tarjeta What changed de Overview muestra una vista previa de lo que encontrarían estas reglas. Cada hallazgo se notifica una vez por semana.

Prompts de ejemplo

Sustituye example.com por tu sitio. Tu agente elige las herramientas adecuadas por sí solo.

Más ideas en la biblioteca de prompts.

Referencia de herramientas

Las herramientas marcadas con escritura cambian algo en Google, Bing o IndexNow. Solo se ofrecen al agente en Pro y Agency mientras el modo de escritura está activado en Settings (se activa en cuanto Google concede el acceso completo a Search Console al iniciar sesión) y la fuente lo permite. Todo lo demás es de solo lectura.

Planes y límites

• Prueba de Pro de 7 días en las cuentas nuevas, sin tarjeta. Al terminar, la cuenta vuelve a Free. Una prueba por dirección de correo electrónico.
• Cada llamada a una herramienta cuenta, también las que fallan. El límite diario se restablece a medianoche UTC.
• Si termina un plan y tienes más sitios de los que permite el nuevo, el panel te pregunta cuáles conservar y el endpoint MCP queda en pausa hasta que elijas.
• Polar gestiona los pagos y las facturas. Cancela cuando quieras; el plan sigue activo hasta el final del periodo que pagaste.

Equipos y roles

El plan Agency incluye cinco puestos, contando al propietario. Todos trabajan en el espacio de trabajo, los datos y el plan del propietario.

Los grupos de clientes restringen a una persona a determinados sitios. Un miembro o administrador de un grupo solo ve esos sitios en el panel, en las alertas y a través de MCP, y nada más. Los subdominios cuentan como sitios distintos, así que puedes asignar a.com a un cliente y blog.a.com a otro. Las invitaciones se envían por correo electrónico y son válidas durante siete días.

Seguridad y privacidad

• Las credenciales de Google y Bing se cifran en reposo. Los tokens de acceso se almacenan solo como hashes.
• Tu agente solo ve datos de las cuentas que conectaste, limitados a tu espacio de trabajo y a tu rol.
• Las cuentas Free son de solo lectura. En Pro y Agency, las herramientas de escritura están disponibles hasta que el propietario desactiva el modo de escritura en Settings; los miembros son siempre de solo lectura y cada token puede forzarse a solo lectura.
• Las sesiones caducan tras 14 días de inactividad. Las acciones sensibles, como eliminar tu cuenta, requieren un inicio de sesión reciente.
• Exporta todo lo que guardamos sobre ti desde Settings, o elimina allí tu cuenta y tus datos. Antes hay que cancelar las suscripciones de pago activas.

Los detalles están en la política de privacidad y en los términos. Para informar de una vulnerabilidad, escribe a support@gscmagic.com.

Solución de problemas

¿Sigues atascado? Escribe a support@gscmagic.com indicando el cliente que usas y el mensaje de error. No incluyas nunca un token de acceso.

Respuestas rápidas