Documentazione

Grok: collegare AutoPSEO tramite MCP

Usa il server MCP di AutoPSEO da Grok: aggiungilo come connettore personalizzato su grok.com, registralo in Grok Build oppure collegalo come strumento remoto nell'API di xAI.

MCP & API3 min di lettura

Grok accede ad AutoPSEO tramite lo stesso server MCP di tutti gli altri assistenti, all'indirizzo https://app.autopseo.com/mcp. Non occorre installare nulla di specifico per Grok: xAI permette di collegare server MCP remoti in tre punti, su grok.com, nell'agente da terminale Grok Build e nell'API di xAI, e AutoPSEO funziona in tutti e tre con gli strumenti, i permessi e il piano del tuo account. Questa pagina descrive i passaggi per ciascuno e che cosa controllare quando una connessione non funziona.

Grok sul web

La guida ai connettori di xAI descrive i connettori personalizzati in tre passaggi:

Vai su grok.com/connectors.
Scegli New Connector, poi Custom.
Inserisci https://app.autopseo.com/mcp come URL del server MCP e completa l'accesso. Si apre la pagina di accesso e approvazione di AutoPSEO: approva con l'account che contiene le tue proprietà.

Secondo xAI, i connettori sono disponibili per tutti gli utenti di Grok e, con i piani Business ed Enterprise, un amministratore del team deve rendere disponibile il connettore prima che i membri possano usarlo. Una volta collegato, chiedi a Grok di "elencare le proprietà Search Console del mio account" per verificare che abbia raggiunto l'account giusto e che conosca i nomi esatti delle proprietà.

Grok Build

Grok Build, l'agente da terminale di xAI, aggiunge un server remoto con un solo comando (guida MCP di xAI):

grok mcp add --transport http autopseo https://app.autopseo.com/mcp

La prima volta che si usa uno strumento, Grok Build apre l'accesso nel browser e conserva il token autonomamente. Su una macchina senza browser, passa invece una chiave API e tienila in una variabile d'ambiente:

grok mcp add --transport http autopseo https://app.autopseo.com/mcp --header "Authorization: Bearer ${AUTOPSEO_API_KEY}"

Grok Build carica anche i server configurati per Claude Code (~/.claude.json), per Cursor (.cursor/mcp.json) e nel file .mcp.json del progetto, quindi un server AutoPSEO già aggiunto in uno di questi punti compare senza ulteriori passaggi. Nella sua interfaccia, /mcps elenca i server e permette di autenticarne uno.

L'API di xAI

Gli agenti creati con l'API di xAI possono richiamare AutoPSEO come strumento MCP remoto. xAI lo supporta nel proprio SDK nativo e nella Responses API compatibile con OpenAI tramite Streamable HTTP, con server_url, server_label e un valore authorization facoltativo per il token (strumenti MCP remoti). Una voce nell'array tools ha questo aspetto:

{
  "type": "mcp",
  "server_label": "autopseo",
  "server_url": "https://app.autopseo.com/mcp",
  "authorization": "apk_live_..."
}

xAI non supporta il parametro require_approval della Responses API, quindi nulla si ferma in attesa di approvazione prima dell'esecuzione di uno strumento. Assegna agli agenti una chiave Read only, a meno che non debbano modificare qualcosa: AutoPSEO rifiuta una chiave di sola lettura per ogni strumento che scrive o che consuma crediti di ricerca.

Quale accesso dare a Grok

Uso	Collegamento tramite
Domande nelle chat su grok.com	Accesso con account
Grok Build sul tuo computer	Accesso con account, oppure una chiave su una macchina senza browser
Agenti non presidiati sull'API di xAI	Una chiave Read only, oppure Read & write quando l'agente deve agire

Le connessioni effettuate con l'accesso compaiono in MCP & API sotto Signed-in tools, dove puoi disconnetterne una, e le chiavi si revocano nella stessa pagina. I gruppi di strumenti, le classi di accesso e i limiti sono descritti in MCP & ChatGPT, e la guida alla connessione con Grok contiene esempi di prompt.

Risoluzione dei problemi

Grok non riesce a raggiungere il server. xAI richiede un server raggiungibile da internet pubblica, e quello di AutoPSEO lo è, quindi controlla l'indirizzo: inserisci https://app.autopseo.com/mcp esattamente com'è, compreso /mcp.
Non compare nessuna proprietà. Chiedi lo strumento whoami per vedere quale account AutoPSEO usa la connessione. Se è quello giusto, collega prima Search Console a quell'account.
Uno strumento viene rifiutato. Una chiave di sola lettura non può scrivere né consumare crediti, e un membro del team con accesso Read può solo leggere.
HTTP 429. I limiti sono 60 chiamate al minuto per chiave e 1,000 all'ora per account.
Abbonamento richiesto. La prova dell'account è terminata: scegli un piano in Subscription & billing.

Le visite che Grok invia al tuo sito sono conteggiate nel report LLM Traffic di GA4.