Documentation

Grok : connecter AutoPSEO via MCP

Utilisez le serveur MCP d'AutoPSEO depuis Grok : ajoutez-le comme connecteur personnalisé sur grok.com, enregistrez-le dans Grok Build ou rattachez-le comme outil distant dans l'API xAI.

MCP & API3 min de lecture

Grok accède à AutoPSEO par le même serveur MCP que tous les autres assistants, à l'adresse https://app.autopseo.com/mcp. Rien de spécifique à Grok n'est à installer : xAI permet de rattacher des serveurs MCP distants à trois endroits, sur grok.com, dans l'agent de terminal Grok Build et dans l'API xAI, et AutoPSEO fonctionne dans chacun avec les outils, les permissions et l'offre de votre compte. Cette page détaille les étapes pour chaque cas, ainsi que les vérifications à faire quand une connexion échoue.

Grok sur le web

Le guide des connecteurs de xAI décrit les connecteurs personnalisés en trois étapes :

Rendez-vous sur grok.com/connectors.
Choisissez New Connector, puis Custom.
Saisissez https://app.autopseo.com/mcp comme URL du serveur MCP et terminez la connexion. La page de connexion et d'autorisation d'AutoPSEO s'ouvre ; validez avec le compte qui contient vos propriétés.

Selon xAI, les connecteurs sont ouverts à tous les utilisateurs de Grok, et sur les offres Business et Enterprise, un administrateur de l'équipe doit d'abord provisionner un connecteur avant que les membres puissent l'utiliser. Une fois la connexion établie, demandez à Grok de « lister les propriétés Search Console de mon compte » pour vérifier qu'il a bien accédé au bon compte et qu'il connaît les noms exacts des propriétés.

Grok Build

Grok Build, l'agent de terminal de xAI, ajoute un serveur distant avec une seule commande (guide MCP de xAI) :

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

À la première utilisation d'un outil, Grok Build ouvre la page de connexion dans votre navigateur et conserve lui-même le jeton. Sur une machine sans navigateur, transmettez plutôt une clé API et conservez-la dans une variable d'environnement :

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

Grok Build charge aussi les serveurs configurés pour Claude Code (~/.claude.json), pour Cursor (.cursor/mcp.json) et dans le fichier .mcp.json du projet : un serveur AutoPSEO que vous y avez déjà ajouté apparaît donc sans autre manipulation. Dans son interface, /mcps liste les serveurs et permet d'en authentifier un.

L'API xAI

Les agents construits sur l'API xAI peuvent appeler AutoPSEO comme outil MCP distant. xAI prend cela en charge dans son SDK natif et dans son API Responses compatible OpenAI, via Streamable HTTP, avec server_url, server_label et une valeur authorization facultative pour le jeton (outils MCP distants). Une entrée du tableau tools se présente ainsi :

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

xAI ne prend pas en charge le paramètre require_approval de l'API Responses : rien ne demande donc de confirmation avant l'exécution d'un outil. Donnez aux agents une clé Read only, sauf s'ils doivent modifier quelque chose : AutoPSEO refuse une clé en lecture seule pour tout outil qui écrit ou qui consomme des crédits de recherche.

Quel accès donner à Grok

Usage	Connexion à utiliser
Questions dans les conversations sur grok.com	Connexion par identifiants
Grok Build sur votre propre ordinateur	Connexion par identifiants, ou une clé sur une machine sans navigateur
Agents autonomes sur l'API xAI	Une clé Read only, ou Read & write quand l'agent doit agir

Les connexions établies par identifiants apparaissent dans MCP & API, sous Signed-in tools, où vous pouvez en déconnecter une ; les clés se révoquent sur la même page. Les groupes d'outils, les classes d'accès et les limites sont décrits dans MCP & ChatGPT, et le guide de connexion de Grok propose des exemples de requêtes.

Dépannage

Grok n'atteint pas le serveur. xAI exige un serveur accessible depuis l'internet public, ce qui est le cas de celui d'AutoPSEO ; vérifiez donc l'adresse : saisissez https://app.autopseo.com/mcp exactement, y compris /mcp.
Aucune propriété n'apparaît. Demandez l'outil whoami pour savoir quel compte AutoPSEO la connexion utilise. S'il s'agit du bon, connectez d'abord Search Console à ce compte.
Un outil est refusé. Une clé en lecture seule ne peut ni écrire ni consommer de crédits, et un membre de l'équipe disposant de l'accès Read ne peut que lire.
HTTP 429. Les limites sont de 60 appels par minute et par clé, et de 1,000 par heure et par compte.
Abonnement requis. La période d'essai du compte est terminée ; choisissez une offre dans Abonnement et facturation.

Les visites que Grok envoie vers votre site sont comptabilisées dans le rapport LLM Traffic de GA4.