Guía rápida

De cero a tu primer briefing de puntuación GEO en unos cinco minutos. Necesitas una cuenta de geOracle (gratis) y uno de los agentes compatibles.

Requisitos previos

Una cuenta de geOracle (regístrate gratis)
Claude Code, Cursor o Codex CLI instalado
La URL de tu sitio en producción

1. Consigue tu clave

Ejecuta el asistente de configuración y elige MCP, o genera una clave en la configuración del equipo. Las claves se muestran una sola vez: cópiala en un lugar seguro.

2. Añade el servidor a tu agente

Elige tu cliente. El comando añade el servidor geOracle MCP con tu clave como cabecera.

terminal

claude mcp add --transport http georacle https://georacle.ai/api/mcp --header "Authorization: Bearer YOUR_KEY"

Claude Code

/plugin marketplace add georacle/claude-plugin
/plugin install georacle@georacle
/georacle:setup

Instala el plugin de geOracle en Claude Code y /georacle:setup lo configura todo, incluida la rutina semanal.

3. Verifica la conexión

Pide a tu agente que llame a get_dashboard_summary, o usa el botón Probar conexión del asistente. Una llamada exitosa aparece en tu panel en segundos.

4. Ejecuta tu primer flujo de trabajo

En Claude Code, instala el plugin y ejecuta /georacle:setup para la ruta guiada (conexión del sitio, primera optimización, rutina semanal). O simplemente pide a tu agente que conecte tu sitio y puntúe tus tres páginas más débiles.

Solución de problemas

401 Unauthorized: La clave es incorrecta, está revocada o le falta el scope mcp. Genera una clave nueva en la configuración del equipo y actualiza la configuración de tu cliente.
payment_required en una herramienta: Esa herramienta pertenece al nivel de pago. El nivel gratuito cubre análisis y puntuación; mejora tu plan en el asistente o usa el acceso incluido de tu plan PRO o ENTERPRISE.
Timeouts en get_site_snapshot: Los sitios grandes se analizan de forma asíncrona. La herramienta devuelve un id de trabajo; tu agente lo consulta periódicamente. Es normal.
stale_briefing al enviar: El contenido cambió entre el briefing y el envío. Obtén un briefing nuevo y vuelve a enviarlo.

Próximos pasos

Lee el recurso de primeros pasos que tu agente puede ver (georacle://docs/getting-started)
Configura la rutina semanal con /georacle:setup
Abre tu panel para revisar lo que envía tu agente