Tech & Performance
MCP Ahrefs : brancher Claude à ses données SEO
MCP Ahrefs avec Claude : plan requis, connexion par OAuth ou par clé, groupes d’outils, unités d’API consommées et garde-fous avant d’analyser son SEO e-commerce.
Ahrefs publie un serveur MCP hébergé : une fois branché à Claude, il met des données Ahrefs (backlinks, mots-clés organiques, pages principales, Site Audit) à portée de conversation. Il demande une offre Lite ou supérieure, certains appels consomment des unités d'API et il propose plus d'outils que certains clients n'en acceptent. Ce guide reprend la documentation d'Ahrefs, consultée le 11 novembre 2026, pour la connexion, les groupes d'outils et les limites. Il s'insère dans notre guide Claude et MCP pour le marketing e-commerce.
Ce que le serveur expose
Ahrefs décrit son MCP comme un moyen pour des agents IA d'accéder à l'API Ahrefs et d'enrichir leurs réponses avec ses données. Le serveur se connecte en Streamable HTTP à l'adresse https://api.ahrefs.com/mcp/mcp. Les outils sont rangés par groupes ; voici ceux que nous retenons pour un SEO e-commerce, avec la description d'Ahrefs traduite.
| Groupe | Description d'Ahrefs |
|---|---|
site-explorer-overview | Indicateurs principaux de Site Explorer : Domain Rating, statistiques de backlinks et de liens sortants, aperçu organique et payant, historique des métriques |
site-explorer-reports | Rapports détaillés de Site Explorer : backlinks, domaines référents, ancres, mots-clés organiques et concurrents, pages principales, domaines liés |
keywords-explorer | Recherche de mots-clés : aperçu, volume par pays et historique, termes correspondants et associés, suggestions de recherche |
serp-overview | Aperçu de la page de résultats pour un mot-clé |
rank-tracker | Rank Tracker : aperçu et rapports sur les concurrents |
site-audit | Site Audit : projets, problèmes, explorateur de pages, contenu des pages |
content-helper | Content Helper : les sujets principaux que couvrent les pages qui se classent sur un mot-clé |
gsc | Google Search Console : mots-clés, pages, positions et historique de performance |
Ahrefs documente une opération Content Gap accessible par API et MCP sur l'offre Enterprise, annoncée le 29 octobre 2026. Elle compare les classements organiques et payants d'une cible avec ceux de ses concurrents. Pour savoir ce qu'une telle analyse doit produire, voir notre comparatif des outils de keyword gap.
Connecter Claude
Avec Claude Code
- Lancer dans le terminal
claude mcp add ahrefs https://api.ahrefs.com/mcp/mcp -t http. - Ouvrir Claude et exécuter
/mcp, puis authentifier le serveur. - Se connecter à Ahrefs, choisir l'espace de travail et cliquer sur « Allow ».
- Vérifier avec une première requête que des résultats reviennent.
Avec Claude Desktop ou Claude sur le web
Ahrefs documente deux méthodes. La première passe par l'autorisation OAuth : dans la section de personnalisation de Claude, ouvrir « Connectors », ajouter un connecteur, chercher « Ahrefs » dans la liste des connecteurs approuvés, cliquer sur « Connect », choisir l'espace de travail et le compte, puis accepter dans la fenêtre de consentement. La seconde, qui concerne l'application de bureau, utilise une clé MCP : on la génère dans l'espace de travail Ahrefs, sous Account Settings puis API Keys, avec « Generate MCP key », puis on la place dans le fichier claude_desktop_config.json (ouvert par Settings, Developer, « Edit config » ; la configuration documentée par Ahrefs utilise npx et mcp-remote pour se connecter au serveur distant) avant de redémarrer l'application.
Dans les réglages des connecteurs de Claude, l'option de demande systématique de permission exige une autorisation avant chaque requête ; « Allow unsupervised » l'accorde automatiquement. À notre avis, le premier réglage convient tant que vous n'avez pas mesuré la consommation d'unités d'une session type.
Unités d'API et limites
- Chaque offre fixe un nombre maximal de lignes par requête accessibles à l'agent et un volume mensuel d'unités d'API ; plus l'offre est élevée, plus elle inclut d'unités. Les clients Enterprise peuvent acheter des unités supplémentaires.
- Les appels facturés d'une application tierce consomment des unités, comme un usage direct de l'API. L'opération Pages GSC est gratuite en unités.
- Les clés créées par OAuth pour le MCP ou par Ahrefs Connect reçoivent par défaut une limite mensuelle de 200 000 unités d'API par clé. Les administrateurs de l'espace de travail peuvent la modifier ou la retirer. Une clé créée à la main n'a pas de limite par clé par défaut, mais les limites de l'offre s'appliquent à toutes les clés.
- Le suivi de l'usage se trouve sous Account settings puis « Limits and usage ».
Limiter les outils proposés à Claude
Certains clients MCP limitent le nombre d'outils qu'un serveur peut annoncer, et le serveur d'Ahrefs dépasse cette limite pour beaucoup d'entre eux. Le paramètre d'URL tools permet de choisir les groupes, séparés par des virgules :
https://api.ahrefs.com/mcp/mcp?tools=site-explorer-overview,keywords-explorer
Sans ce paramètre, tous les outils sont annoncés ; les outils d'aide à la documentation et au rendu sont inclus quels que soient les groupes choisis. La valeur essentials sélectionne les outils les plus courants de tous les groupes ; elle s'emploie seule, et tools=essentials,site-audit est rejeté. Un nom de groupe inexistant fait refuser la connexion avec l'erreur invalid tool category. La valeur search-exec annonce les outils search,doc et exec, plus trois outils de rendu : search trouve une opération à partir de quelques mots-clés, doc donne ses schémas d'entrée et de sortie, exec l'exécute.
Une première série de demandes
La documentation d'Ahrefs donne comme exemple de demander, sous forme de tableau et avec l'outil site-explorer-refdomains, les dix premiers domaines référents d'un site sur les sept derniers jours. Les demandes ci-dessous sont nos suggestions non testées, à valider sur votre compte avant de s'y fier :
- Les dix pages de votre domaine au trafic organique estimé le plus élevé, avec leur principal mot-clé et la position associée.
- Sur l'offre Enterprise, utiliser Content Gap pour rechercher les mots-clés organiques d'un concurrent direct absents de votre domaine.
- Le volume de recherche par pays d'une liste de dix termes de catégorie.
- Les problèmes remontés par le dernier audit de site, regroupés par type.
- Le croisement entre les pages de l'audit et leurs positions moyennes Search Console, pour un projet connecté à GSC ou un portefeuille de projets connectés, par le groupe
gsc, en vérifiant les périodes et les périmètres comparés.
Garde-fous
- Surveiller la consommation : les administrateurs de l'espace de travail peuvent modifier la limite par clé, et « Limits and usage » permet de suivre l'usage après les premières sessions.
- Lire la section « Terms of use » de la page de présentation d'Ahrefs : elle indique que l'usage du point d'accès MCP externe par des scripts personnalisés, des passerelles ou des clients HTTP/JSON-RPC autonomes n'est pas pris en charge ni autorisé, et renvoie vers l'API publique pour un accès programmatique. Pour Claude Desktop, suivre la configuration avec
mcp-remotepubliée dans le guide d'installation d'Ahrefs. - À notre avis, la clé MCP n'a pas sa place dans un dépôt partagé. Le guide sur CLAUDE.md donne notre avis sur ce qu'un fichier de contexte ne doit pas contenir : ni identifiants de connexion ni mot de passe.
- Croiser avec la source de Google quand une décision en dépend : voir le guide du MCP Search Console.
Questions fréquentes sur le MCP Ahrefs
Faut-il un abonnement Ahrefs payant pour utiliser le MCP ?
Oui. La documentation d’Ahrefs indique que le serveur MCP distant est disponible sur les offres payantes à partir de Lite. Chaque offre fixe aussi un nombre maximal de lignes par requête et un volume mensuel d’unités d’API.
Les appels de Claude consomment-ils des unités d’API ?
Cela dépend de l’opération. Les appels facturés consomment votre allocation mensuelle, comme un usage direct de l’API ; l’opération Pages GSC est gratuite en unités. Le suivi se trouve dans les paramètres du compte, sous « Limits and usage ».
Peut-on limiter les outils que Claude voit ?
Oui, avec le paramètre d’URL tools, qui prend une liste de groupes séparés par des virgules. Sans ce paramètre, tous les outils sont proposés. La valeur essentials donne une sélection des outils les plus utilisés, mais elle ne se combine pas avec d’autres groupes. Un nom de groupe inexistant fait rejeter la connexion avec l’erreur invalid tool category.
Le MCP Ahrefs remplace-t-il Search Console ?
À notre avis, non. Ahrefs propose un groupe d’outils gsc pour lire des données Google Search Console, mais la source reste celle de Google. Notre guide sur le MCP Search Console décrit la voie directe par l’API Search Analytics, avec ses quotas.