Serveur MCP
Utilisez Autoranko depuis votre assistant IA (MCP)
Autoranko fait tourner un serveur MCP distant : des assistants comme Claude, ChatGPT, Claude Code, Cursor et VS Code peuvent auditer des pages, rechercher des mots-clés et rédiger ou publier des articles sur votre compte. Claude et ChatGPT se connectent par OAuth ; les autres clients peuvent utiliser un jeton d’API.
- Environ 5 minutes pour se connecter (estimation)
- Dernière vérification : 8 novembre 2026
Comment la connexion fonctionne
Le Model Context Protocol (MCP) permet à un assistant IA d’appeler les outils d’un autre service. Le serveur MCP d’Autoranko est distant, il n’y a donc rien à installer : votre client envoie ses requêtes en Streamable HTTP à https://autoranko.com/api/mcp, connecté par OAuth ou avec un jeton d’API dans l’en-tête Authorization, et le serveur répond avec les résultats des outils.
Les outils sont générés à partir de la même référence que l’API REST et le fichier OpenAPI : ils correspondent donc toujours à ce que permet l’API. Les outils qui enregistrent des résultats les placent dans Tableau de bord → Settings → API & Apps → Saved results ; ceux qui créent ou publient des articles agissent sur vos vrais sites et consomment les quotas de votre offre.
Connecter votre assistant
- 1
Choisissez le mode de connexion
Claude et ChatGPT se connectent par OAuth : vous approuvez l’accès sur un écran de consentement Autoranko et choisissez ce que l’app peut faire, en lecture seule si vous préférez. Pour Claude Code, Cursor ou VS Code, vous pouvez plutôt créer un jeton dans Tableau de bord → API & Apps, limité aux droits et aux sites nécessaires.
- 2
Ajoutez le serveur à votre client
Dans Claude, ajoutez un connecteur personnalisé avec l’URL https://autoranko.com/api/mcp (Personnaliser → Connecteurs). Dans ChatGPT, ajoutez-le comme serveur MCP personnalisé avec OAuth. Les clients à jeton ajoutent un serveur distant (HTTP) avec la même URL et un en-tête Authorization contenant Bearer et le jeton ; dans Claude Code, une commande claude mcp add suffit. La documentation MCP donne les étapes exactes.
- 3
Vérifiez la connexion
Demandez à l’assistant à quel compte Autoranko il est connecté : il appelle whoami et affiche votre compte et votre offre. Si les outils n’apparaissent pas, consultez la section de dépannage ci-dessous.
- 4
Confiez-lui du vrai travail
Demandez-lui d’auditer une page, de trouver des idées de mots-clés pour un site connecté ou de rédiger un article et de le laisser en relecture. Demandez une confirmation avant de publier : publish_job modifie votre site en ligne.
Ce que votre assistant peut faire
Le serveur MCP propose 34 outils, générés à partir de la même référence que l’API REST :
whoamiGet the current accountlist_sitesList sitesget_siteGet a site with usagelist_articlesList synced articlesget_articleGet an articlelist_article_jobsList jobscreate_article_jobCreate a jobget_article_jobGet a jobpublish_jobPublish a jobsite_keyword_researchResearch keywordsgeo_list_promptsList tracked promptsgeo_add_promptsAdd promptsgeo_start_runStart a rungeo_list_runsList runsgeo_get_runGet a run with its answersgeo_statsGet visibility metricsgeo_competitorsList the names AI answers givegeo_ai_trafficGet AI-assistant traffic (GA4)seo_analyzeAudit a pageseo_keyword_researchResearch keywords for any siteseo_write_articleWrite a long-form articleseo_write_short_articleWrite a short articleseo_meta_tagsWrite title and meta description variantsseo_open_graphGenerate Open Graph and Twitter tagsseo_schemaGenerate JSON-LD structured dataseo_headingsPlan the heading structureseo_content_briefCreate a content briefseo_rewriteRewrite copy for SEOseo_alt_textsWrite image alt textrobots_sitemapGenerate robots.txt and a sitemapserp_previewPreview a Google resultlist_seo_analysesList saved analysesget_seo_analysisGet a saved analysislist_ai_modelsList AI models
Limites et mises en garde honnêtes
Les apps connectées par OAuth n’obtiennent que les droits que vous approuvez, et vous pouvez les déconnecter à tout moment dans Tableau de bord → API & Apps. Les clients qui ne font tourner que des serveurs locaux (stdio) ont besoin d’une passerelle vers un serveur distant ; notre propre paquet npm n’est pas encore publié.
Les requêtes sont limitées par jeton, comme pour l’API REST. Les tâches longues, comme la rédaction d’un article complet, prennent quelques minutes, pendant lesquelles l’assistant attend l’outil ou interroge la tâche. Les métriques de mots-clés renvoyées par les outils sont des estimations de l’IA, signalées comme telles.
Dépannage
Les messages ci-dessous sont exactement ceux qu’Autoranko affiche dans le tableau de bord ou que renvoie l’API (en anglais), avec leur sens et la façon de les résoudre.
missing_token- La requête est arrivée sans identifiants. Les clients OAuth lancent la connexion à partir de cette réponse ; les clients à jeton doivent envoyer Authorization: Bearer ar_live_…
invalid_token- Le jeton est mal formé, révoqué, expiré ou mal saisi. Reconnectez l’app, ou créez un nouveau jeton dans Tableau de bord → API & Apps et mettez à jour la configuration du client.
rate_limited- L’assistant a envoyé trop de requêtes en peu de temps. Attendez le nombre de secondes indiqué par l’en-tête Retry-After, et demandez moins d’appels en parallèle si cela se reproduit.
- Le client n’affiche aucun outil Autoranko
- Assurez-vous que le serveur est configuré comme serveur HTTP distant (Streamable HTTP), et non comme commande locale, et que l’URL se termine par /api/mcp. Redémarrez le client après avoir modifié sa configuration.
Questions
Quels assistants fonctionnent ?+
Est-il prudent de donner accès à un assistant ?+
Cela coûte-t-il plus cher ?+
Pour aller plus loin
Intégrations associées
Connectez votre site en quelques minutes
Commencez avec l’offre gratuite — sans carte — et publiez votre premier article sur votre propre plateforme.