Docs GSC Magic

Qu’est-ce que GSC Magic ?

GSC Magic est un serveur MCP hébergé. Vous vous connectez une fois, ajoutez une URL à votre client IA, et l’agent lit directement vos données de recherche au lieu de travailler à partir d’exports CSV et de captures d’écran.

En parallèle, le tableau de bord sur app.gscmagic.com présente les mêmes données sous forme de graphiques, conserve un historique plus long que les 16 mois de Google, envoie des alertes et journalise tout ce que font vos agents.

Démarrage rapide

1. Créez votre compte. Ouvrez le tableau de bord et continuez avec Google, ou créez un compte avec une adresse e-mail et un mot de passe (vous confirmerez l’adresse par e-mail). Utilisez le compte Google propriétaire de vos propriétés Search Console.
2. Autorisez l’accès. La première connexion demande une seule fois à Google l’accès à Search Console (lecture et écriture) et à Google Analytics 4 en lecture seule. Les outils d’écriture ne sont proposés que sur Pro et Agency, et vous pouvez les désactiver dans Settings → Write access.
3. Importez vos sites. Sur l’écran « Welcome », choisissez les propriétés à ajouter. GSC Magic affiche d’abord les plus fréquentées et respecte la limite de sites de votre plan. Les sites Bing et les propriétés GA4 ayant le même hôte sont associés automatiquement.
4. Connectez votre client IA. Suivez la section Clients IA ci-dessous. L’endpoint est https://mcp.gscmagic.com/mcp.
5. Posez une première question. Commencez par « Liste mes sites dans GSC Magic. » Essayez ensuite un prompt de la section Exemples de prompts.

La page Connect du tableau de bord reprend les mêmes instructions, avec des boutons en un clic et un test de connexion.

Clients IA

L’endpoint est le même partout :

https://mcp.gscmagic.com/mcp

Les clients qui prennent en charge OAuth vous connectent via une page GSC Magic. Pour les autres, utilisez un jeton d’accès.

Claude (claude.ai, bureau et mobile)

1. Utilisez Add to Claude : le bouton ouvre GSC Magic dans l’annuaire des connecteurs de Claude. Ou ouvrez Customize → Connectors → Add custom connector, nommez-le GSC Magic et collez l’endpoint.
2. Cliquez sur Connect à côté de GSC Magic, continuez avec Google (ou par e-mail) et autorisez l’accès.
3. Dans une nouvelle conversation, activez GSC Magic sous + → Connectors et demandez : « Liste mes sites dans GSC Magic. »

Sur les plans Team et Enterprise, seul un Owner peut ajouter le connecteur (Organization settings → Connectors → Add → Custom) ; les membres cliquent ensuite eux-mêmes sur Connect. Les connecteurs ajoutés sur le web apparaissent dans les applications de bureau et mobiles.

ChatGPT

1. Sur chatgpt.com, ouvrez Plugins, cliquez sur + et choisissez Add custom MCP server. Le mode développeur n’est pas nécessaire.
2. Nommez-le GSC Magic, collez l’URL du serveur ci-dessus et choisissez OAuth. Laissez l’ID client et le secret vides, acceptez l’avertissement de risque et cliquez sur Create.
3. Connectez-vous avec Google (ou avec l’e-mail et le mot de passe de votre compte GSC Magic) lorsque ChatGPT ouvre la page GSC Magic, puis tapez @ dans une nouvelle conversation et choisissez GSC Magic.

Les serveurs MCP personnalisés exigent un plan ChatGPT payant ; sur Business, seuls les propriétaires et les administrateurs de l’espace de travail peuvent en ajouter un. ChatGPT n’a pas de champ pour un en-tête personnalisé : il ne peut donc pas utiliser de jeton d’accès. Si votre compte affiche encore l’ancien parcours <em>Settings → Apps → Create app</em>, utilisez-y les mêmes nom, URL et réglages OAuth.

Claude Code

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp

Tapez ensuite /mcp, choisissez gsc-magic puis Authenticate. Avec un jeton au lieu d’une connexion par navigateur :

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp \
  --header "Authorization: Bearer gsm_YOUR_TOKEN"

Cursor

Ajoutez ceci à ~/.cursor/mcp.json, puis cliquez sur Connect à côté de gsc-magic dans Settings → MCP :

{
  "mcpServers": {
    "gsc-magic": {
      "url": "https://mcp.gscmagic.com/mcp"
    }
  }
}

Les anciennes versions de Cursor terminent la connexion sur cursor://, que GSC Magic n’accepte pas. Utilisez-y un jeton :

{
  "mcpServers": {
    "gsc-magic": {
      "url": "https://mcp.gscmagic.com/mcp",
      "headers": {
        "Authorization": "Bearer gsm_YOUR_TOKEN"
      }
    }
  }
}

VS Code, Windsurf et autres

Tout client qui parle MCP distant via Streamable HTTP fonctionne. Donnez-lui l’endpoint et, s’il ne gère pas OAuth, cet en-tête de requête :

Authorization: Bearer gsm_YOUR_TOKEN

La page Connect du tableau de bord propose des extraits prêts à l’emploi pour VS Code, Windsurf, Hermes Agent, OpenClaw, Grok et DeepSeek.

Jetons d’accès

Un jeton d’accès (gsm_…) permet à un client de se connecter sans passer par un navigateur. Il convient aux scripts, aux outils d’automatisation et aux clients sans OAuth.

• Créez-en un dans le tableau de bord, sous Connect → Access tokens (propriétaire ou admin de l’espace de travail). Le jeton complet n’est affiché qu’une fois. Conservez-le dans la configuration du client, jamais dans une conversation.
• Les jetons expirent par défaut au bout de 365 jours. Vous pouvez choisir une autre durée, jusqu’à 730 jours, ou aucune.
• Cochez Read-only pour rendre un jeton incapable d’écrire, quoi que permette votre plan.
• Un jeton ne fonctionne que sur l’endpoint MCP, pas sur l’API du tableau de bord, et peut être révoqué à tout moment. La révocation est immédiate.
• Le bouton Test connection de la page Connect vérifie qu’un endpoint et un jeton fonctionnent.

Sources de données

Connecté ne veut pas dire associé. L’accès à GA4 ou une clé Bing rend seulement les propriétés repérables. Pour voir les données sur la page Overview, associez une propriété GA4 et un site Bing à chaque site sous Sites. Sources indique combien de sites sont associés.

Chaque source propose Reconnect et Disconnect. Déconnecter GA4 empêche GSC Magic de le lire et supprime les lignes GA4 que nous avions stockées ; votre connexion Google et Search Console restent inchangées.

Tableau de bord

Historique. Après l’ajout d’un site, GSC Magic récupère jusqu’à 16 mois de données quotidiennes (14 jours sur Free), puis les actualise toutes les six heures. Passer à un plan supérieur récupère les mois plus anciens. Vous pouvez exporter ou supprimer votre historique conservé à tout moment.

Alertes et récapitulatif

Sur Pro et Agency, GSC Magic vérifie vos sites après chaque synchronisation et vous envoie un e-mail lorsque quelque chose demande votre attention. L’envoi se fait par e-mail au propriétaire de l’espace de travail. Chaque message contient un lien de désabonnement.

• Baisse de trafic : une page a perdu une grande part de ses clics (30 % par défaut).
• Indexation : une page qui avait du trafic a cessé d’apparaître.
• Cannibalisation : deux de vos pages se sont mises à se partager une requête.
• Position : une requête importante a perdu plusieurs positions.
• Trafic IA : les sessions issues d’assistants IA ont fortement augmenté (nécessite GA4).

Vous pouvez modifier les seuils, désactiver les règles et les supprimer (avec un Undo de quelques secondes). Un récapitulatif hebdomadaire résume vos sites. Sur Free, la carte What changed de l’Overview montre un aperçu de ce que ces règles détecteraient. Chaque constat n’est signalé qu’une fois par semaine.

Exemples de prompts

Remplacez example.com par votre site. Votre agent choisit seul les bons outils.

Plus d’idées dans la bibliothèque de prompts.

Référence des outils

Les outils marqués écriture modifient quelque chose dans Google, Bing ou IndexNow. Ils ne sont proposés à l’agent que sur Pro et Agency, tant que le mode écriture est activé dans Settings (il s’active dès que Google accorde l’accès complet à Search Console lors de la connexion), et si la source le permet. Tous les autres sont en lecture seule.

Plans et limites

• Essai Pro de 7 jours sur les nouveaux comptes, sans carte bancaire. À la fin, le compte repasse sur Free. Un essai par adresse e-mail.
• Chaque appel à un outil compte, y compris ceux qui échouent. La limite quotidienne est réinitialisée à minuit UTC.
• Si un plan prend fin et que vous avez plus de sites que le nouveau plan n’en autorise, le tableau de bord vous demande lesquels conserver et l’endpoint MCP reste en pause tant que vous n’avez pas choisi.
• Les paiements et les factures sont gérés par Polar. Résiliation possible à tout moment ; le plan reste actif jusqu’à la fin de la période payée.

Équipes et rôles

Le plan Agency inclut cinq sièges, propriétaire compris. Tout le monde travaille sur l’espace de travail, les données et le plan du propriétaire.

Les groupes de clients limitent une personne à certains sites. Un membre ou un admin d’un groupe ne voit que ces sites dans le tableau de bord, dans les alertes et via MCP, et rien d’autre. Les sous-domaines comptent comme des sites distincts : vous pouvez donc confier a.com à un client et blog.a.com à un autre. Les invitations sont envoyées par e-mail et valables sept jours.

Sécurité et confidentialité

• Les identifiants Google et Bing sont chiffrés au repos. Les jetons d’accès ne sont stockés que sous forme d’empreintes (hash).
• Votre agent ne voit que les données des comptes que vous avez connectés, limitées à votre espace de travail et à votre rôle.
• Les comptes Free sont en lecture seule. Sur Pro et Agency, les outils d’écriture sont disponibles tant que le propriétaire ne désactive pas le mode écriture dans Settings ; les membres sont toujours en lecture seule et chaque jeton peut être forcé en lecture seule.
• Les sessions expirent après 14 jours d’inactivité. Les actions sensibles, comme la suppression de votre compte, exigent une connexion récente.
• Exportez depuis Settings tout ce que nous détenons sur vous, ou supprimez-y votre compte et vos données. Les abonnements payants actifs doivent d’abord être résiliés.

Les détails figurent dans la politique de confidentialité et les conditions d’utilisation. Pour signaler une vulnérabilité, écrivez à support@gscmagic.com.

Dépannage

Toujours bloqué ? Écrivez à support@gscmagic.com en indiquant le client utilisé et le message d’erreur. N’incluez jamais de jeton d’accès.

Réponses rapides