Guida rapida

Da zero al Suo primo briefing di punteggio GEO in circa cinque minuti. Servono un account geOracle (gratuito) e uno degli agenti supportati.

Prerequisiti

Un account geOracle (registrazione gratuita)
Claude Code, Cursor o Codex CLI installato
L'URL del Suo sito in produzione

1. Ottenga la Sua chiave

Esegua la procedura guidata di configurazione e scelga MCP, oppure generi una chiave nelle impostazioni del team. Le chiavi vengono mostrate una sola volta: la copi in un luogo sicuro.

2. Aggiunga il server al Suo agente

Scelga il Suo client. Il comando aggiunge il server geOracle MCP con la Sua chiave come header.

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

Installi il plugin geOracle in Claude Code e /georacle:setup configura tutto questo, inclusa la routine settimanale.

3. Verifichi la connessione

Chieda all'agente di chiamare get_dashboard_summary, oppure usi il pulsante Prova connessione nella procedura guidata. Una chiamata riuscita compare nella Sua dashboard in pochi secondi.

4. Esegua il Suo primo flusso di lavoro

In Claude Code, installi il plugin ed esegua /georacle:setup per il percorso guidato (connessione del sito, prima ottimizzazione, routine settimanale). Oppure chieda semplicemente all'agente di collegare il Suo sito e assegnare un punteggio alle tre pagine più deboli.

Risoluzione dei problemi

401 Unauthorized: La chiave è errata, revocata o priva dello scope mcp. Generi una nuova chiave nelle impostazioni del team e aggiorni la configurazione del client.
payment_required su uno strumento: Quello strumento appartiene al livello a pagamento. Il livello gratuito copre analisi e punteggio; esegua l'upgrade nella procedura guidata oppure usi l'accesso incluso nel Suo piano PRO o ENTERPRISE.
Timeout su get_site_snapshot: I siti grandi vengono analizzati in modo asincrono. Lo strumento restituisce un job id; l'agente lo interroga periodicamente. È normale.
stale_briefing all'invio: Il contenuto è cambiato tra il briefing e l'invio. Recuperi un briefing aggiornato e invii di nuovo.

Prossimi passi

Legga la risorsa introduttiva visibile al Suo agente (georacle://docs/getting-started)
Configuri la routine settimanale con /georacle:setup
Apra la Sua dashboard per rivedere ciò che l'agente invia