MCP & ChatGPT app

AutoPSEO gestisce un unico server MCP (Model Context Protocol) all'indirizzo https://app.autopseo.com/mcp. Qualsiasi assistente che supporti MCP su HTTP può collegarsi, accedendo con il tuo account AutoPSEO oppure con una chiave API apk_live_, e lavora poi con le tue stesse proprietà, gli stessi permessi e lo stesso piano. Il server registra 72 strumenti in tre gruppi: report di Search Console e GA4, dati di ricerca e content engine, tramite il quale la tua AI può scrivere articoli per il tuo sito.

Connessione tramite login

Gli strumenti che supportano il login MCP non richiedono alcuna chiave. Aggiungi l'indirizzo, accedi ad AutoPSEO quando lo strumento lo chiede e approva: da quel momento lo strumento mantiene e rinnova da sé il proprio accesso.

• Claude Code: esegui claude mcp add --transport http autopseo https://app.autopseo.com/mcp, poi digita /mcp, scegli autopseo e seleziona Authenticate.
• Claude sul web o desktop: Settings → Connectors → Add custom connector, incolla https://app.autopseo.com/mcp, quindi Connect e accedi.
• Cursor: aggiungi il server a ~/.cursor/mcp.json (tutti i progetti) o a .cursor/mcp.json (un solo progetto), poi usa il pulsante Connect che Cursor mostra accanto.

{ "mcpServers": { "autopseo": { "url": "https://app.autopseo.com/mcp" } } }

Ogni strumento collegato in questo modo compare sotto Signed-in tools nella pagina MCP & API, dove Sign out ne interrompe subito l'accesso. Una buona prima richiesta è «Elenca le proprietà di Search Console del mio account»: la risposta conferma che la connessione funziona e fornisce all'assistente i nomi esatti delle proprietà che gli altri strumenti si aspettano.

ChatGPT

ChatGPT si collega tramite la sua modalità sviluppatore, e la pagina MCP & API ti guida nei passaggi sotto ChatGPT app. In breve: in ChatGPT apri Settings → Apps & Connectors → Advanced settings e attiva Developer mode (l'app indica ChatGPT Plus, Pro, Business, Enterprise ed Edu), scegli Create, assegna un nome al connettore, imposta come URL del server MCP https://app.autopseo.com/mcp e come autenticazione OAuth, quindi accedi ad AutoPSEO quando ChatGPT lo richiede. I connettori di ChatGPT prevedono solo OAuth oppure nessuna autenticazione, quindi le chiavi API qui non funzionano. Trovi maggiori dettagli nella pagina su ChatGPT.

Connessione con una chiave API

Le chiavi servono per script, job pianificati e macchine senza browser. In MCP & API → API keys dai un nome alla chiave e scegli il suo ambito:

• Read only: interroga i dati ed esegue report; non può aggiungere, modificare o eliminare nulla.
• Read & write: tutto ciò che fa una chiave di lettura, più gli strumenti che modificano dati o consumano crediti di ricerca.

La chiave completa, apk_live_ seguito da 32 caratteri esadecimali, viene mostrata una sola volta; AutoPSEO ne conserva soltanto l'hash SHA-256. L'elenco delle chiavi indica quando ciascuna è stata creata, quando è stata usata l'ultima volta e quante richieste ha effettuato, e Revoke blocca subito una chiave. Puoi avere fino a 25 chiavi attive. Invia la chiave come Authorization: Bearer apk_live_... (funziona anche un header x-api-key):

claude mcp add --transport http autopseo https://app.autopseo.com/mcp --header "Authorization: Bearer apk_live_..."

La pagina contiene anche snippet per la OpenAI Responses API, per JSON-RPC puro con curl (il server usa il trasporto Streamable HTTP) e per la REST API all'indirizzo https://app.autopseo.com/v1, che espone i 19 strumenti di Search Console e GA4 con le stesse chiavi e un documento OpenAPI 3.1 in /v1/openapi.json.

Gli strumenti

La pagina MCP & API elenca sempre i nomi aggiornati degli strumenti; al momento della stesura di questa pagina erano 72.

Search Console e GA4 (19 strumenti)

list_properties, search_analytics, top_queries, top_pages, top_countries, compare_periods, content_decay, cannibalization, ctr_benchmark, page_poaching, rank_changes, new_lost_rankings, url_inspection, sitemaps, annotations, create_annotation, ga4_overview, ga4_breakdown e ga4_key_events. Non costano crediti. Se non indichi le date, coprono gli ultimi 28 giorni consolidati a confronto con i 28 precedenti, e chiunque può provarli sulla proprietà demo sc-domain:demo.autopseo.app. Nonostante il nome, content_decay appartiene a questo gruppo: individua le pagine che stanno perdendo clic.

Ricerca (33 strumenti)

• Account e progetti: whoami, create_project, get_project_context, update_project_context
• Parole chiave: research_keywords, get_keyword_metrics, get_ranked_keywords, get_domain_keyword_suggestions, save_keywords, list_saved_keywords
• Domini, pagine dei risultati e link: get_domain_overview, get_serp_results, find_serp_competitors, get_backlinks_overview, get_backlinks_profile
• Monitoraggio delle posizioni: create_rank_tracker, get_rank_tracker, add_rank_tracking_keywords, remove_rank_tracking_keywords, estimate_rank_tracker_cost, run_rank_tracker
• Ricerca locale: search_local_businesses, get_local_serp_results, get_local_rank_grid, get_business_profile, get_business_reviews, get_business_updates, get_google_business_questions, list_business_categories
• Audit del sito: run_site_audit, get_audit_status, get_audit_issues, get_audit_pages

Molti di questi strumenti acquistano dati da DataForSEO e attingono ai tuoi crediti di ricerca: mantieni quindi le richieste mirate e verifica prima di lanciare grandi lotti.

Content engine (20 strumenti)

Permettono alla tua AI di lavorare sulla stessa coda del writer di AutoPSEO: content_list_tasks, content_claim, content_get_brief, content_submit, content_publish, content_unpublish, content_get_page, content_report, content_find_pages, content_add_topics, content_decline, content_merge, content_cover, content_set_cover, content_get_translation, content_submit_translation, content_instructions, content_propose_value, content_submit_value e content_remove_path. Il server offre inoltre cinque prompt: write-articles, optimize-page, revise-draft, connect-repo e refresh-decayed.

Una sessione tipica elenca i task, ne prende in carico uno (la presa in carico lo riserva per due ore), legge il brief, scrive, invia e corregge ciò che i controlli rimandano indietro, e pubblica solo quando lo decidi tu. Copertine e traduzioni hanno strumenti dedicati. Gli articoli scritti in questo modo superano gli stessi controlli di quelli di AutoPSEO e non consumano la tua quota di articoli, anche se la prima chiamata per un brief legge i risultati di ricerca in tempo reale usando crediti di ricerca. Il flusso completo è descritto in Scrivere con la tua AI.

Strumenti di lettura, scrittura e a pagamento

Ogni strumento ha una classe di accesso. Gli strumenti read si limitano a consultare (sono 33), quelli write modificano il tuo workspace (22) e quelli paid si limitano a leggere ma acquistano dati di ricerca (17). Una chiave di sola lettura può chiamare solo strumenti read. Anche un membro del team con accesso Read può chiamare solo strumenti read, qualunque chiave o login utilizzi, e ogni membro raggiunge soltanto le proprietà indicate nel suo invito (Condivisione e accesso del team).

Limiti ed errori

Le chiamate sono limitate a 60 al minuto per chiave e a 1.000 all'ora per account, su tutte le sue chiavi. Superato uno dei due limiti, il server risponde con HTTP 429 e un header Retry-After, e la maggior parte dei client attende e riprova da sola; gli handshake initialize e ping non vengono conteggiati. Quando una prova gratuita termina senza un abbonamento, gli strumenti rispondono «subscription required». Il fornitore di un assistente riceve i tuoi dati solo per le richieste che effettui; per interrompere l'accesso, disconnetti lo strumento o revoca la sua chiave. Altri esempi sono nella pagina su Search Console MCP.